Поделиться через

RequestOptions.IfNoneMatchEtag Property

  • Reference

Definition

Namespace:
Microsoft.Azure.Cosmos
Assembly:
Microsoft.Azure.Cosmos.Client.dll
Package:
Microsoft.Azure.Cosmos v3.47.0
Source:
RequestOptions.cs

Most commonly used to detect changes to the resource Gets or sets the If-None-Match (ETag) associated with the request in the Azure Cosmos DB service.

public string IfNoneMatchEtag { get; set; }
member this.IfNoneMatchEtag : string with get, set
Public Property IfNoneMatchEtag As String

Property Value

String

Remarks

Most commonly used with reads such as ReadItemAsync<T>(String, PartitionKey, ItemRequestOptions, CancellationToken). When Item Etag matches the specified IfNoneMatchEtag then 304 status code will be returned, otherwise existing Item will be returned with 200. UpsertItemAsync<T>(T, Nullable<PartitionKey>, ItemRequestOptions, CancellationToken) will ignore IfNoneMatchEtag when materialized as Create, otherwise for Replace Etag constraint will be applied.

To match any Etag use "*" If specified for writes (ex: Create, Replace, Delete) will be ignored.

https://learn.microsoft.com/en-us/azure/cosmos-db/nosql/database-transactions-optimistic-concurrency#implementing-optimistic-concurrency-control-using-etag-and-http-headers

Applies to