Skip to content
Merged
Changes from 4 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 9 additions & 2 deletions Microsoft.Azure.Cosmos/src/RequestOptions/RequestOptions.cs
Original file line number Diff line number Diff line change
Expand Up @@ -17,15 +17,22 @@ public class RequestOptions
/// Gets or sets the If-Match (ETag) associated with the request in the Azure Cosmos DB service.
/// </summary>
/// <remarks>
/// Most commonly used with the Delete* and Replace* methods of <see cref="Container"/> such as <see cref="Container.ReplaceItemAsync{T}(T, string, PartitionKey?, ItemRequestOptions, System.Threading.CancellationToken)"/>.
/// Most commonly used with the Delete* and Replace* methods of <see cref="Container"/> such as <see cref="Container.ReplaceItemAsync{T}(T, string, PartitionKey?, ItemRequestOptions, System.Threading.CancellationToken)"/>.
///
/// <see cref="Container.CreateItemAsync{T}(T, PartitionKey?, ItemRequestOptions, System.Threading.CancellationToken)"/> will ignore <see cref="IfMatchEtag"/> if specificed.
/// </remarks>
public string IfMatchEtag { get; set; }

/// <summary>
/// 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.
/// </summary>
/// <remarks>
/// Most commonly used to detect changes to the resource
/// Most commonly used with reads such as <see cref="Container.ReadItemAsync{T}(string, PartitionKey, ItemRequestOptions, System.Threading.CancellationToken)"/>.
/// When Item Etag matches the specified <see cref="IfNoneMatchEtag"/> then 304 status code will be returned, otherwise existing Item will be returned with 200.
///
/// To match any Etag use "*"
/// If specified for writes (ex: Create, Replace, Delete) will be ignored.
/// </remarks>
public string IfNoneMatchEtag { get; set; }

Expand Down
Loading