Package com.azure.cosmos.models
Class CosmosDatabaseRequestOptions
java.lang.Object
com.azure.cosmos.models.CosmosDatabaseRequestOptions
Encapsulates options that can be specified for a request issued to cosmos database.
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionGets the If-Match (ETag) associated with the request in the Azure Cosmos DB service.Gets the If-None-Match (ETag) associated with the request in the Azure Cosmos DB service.setIfMatchETag
(String ifMatchETag) Sets the If-Match (ETag) associated with the request in the Azure Cosmos DB service.setIfNoneMatchETag
(String ifNoneMatchETag) Sets the If-None-Match (ETag) associated with the request in the Azure Cosmos DB service.
-
Constructor Details
-
CosmosDatabaseRequestOptions
public CosmosDatabaseRequestOptions()
-
-
Method Details
-
getIfMatchETag
Gets the If-Match (ETag) associated with the request in the Azure Cosmos DB service. Most commonly used with replace and delete requests. This will be ignored if specified for create requests. For more details, refer to optimistic concurrency control documentation- Returns:
- the ifMatchETag associated with the request.
-
setIfMatchETag
Sets the If-Match (ETag) associated with the request in the Azure Cosmos DB service. Most commonly used with replace and delete requests. This will be ignored if specified for create requests. For more details, refer to optimistic concurrency control documentation- Parameters:
ifMatchETag
- the ifMatchETag associated with the request.- Returns:
- the current request options
-
getIfNoneMatchETag
Gets the If-None-Match (ETag) associated with the request in the Azure Cosmos DB service. Most commonly used to detect changes to the resource via read requests. When Item Etag matches the specified ifNoneMatchETag then 304 status code will be returned, otherwise existing Item will be returned with 200. To match any Etag use "*" This will be ignored if specified for write requests (ex: Create, Replace, Delete). For more details, refer to optimistic concurrency control documentation- Returns:
- the ifNoneMatchETag associated with the request.
-
setIfNoneMatchETag
Sets the If-None-Match (ETag) associated with the request in the Azure Cosmos DB service. Most commonly used to detect changes to the resource via read requests. When Item Etag matches the specified ifNoneMatchETag then 304 status code will be returned, otherwise existing Item will be returned with 200. To match any Etag use "*" This will be ignored if specified for write requests (ex: Create, Replace, Delete). For more details, refer to optimistic concurrency control documentation- Parameters:
ifNoneMatchETag
- the ifNoneMatchETag associated with the request.- Returns:
- the current request options
-