Share via


Database.UpsertUserAsync(String, RequestOptions, CancellationToken) Method

Definition

Upserts a user as an asynchronous operation in the Azure Cosmos service.

public abstract System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.UserResponse> UpsertUserAsync (string id, Microsoft.Azure.Cosmos.RequestOptions requestOptions = default, System.Threading.CancellationToken cancellationToken = default);
abstract member UpsertUserAsync : string * Microsoft.Azure.Cosmos.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.UserResponse>
Public MustOverride Function UpsertUserAsync (id As String, Optional requestOptions As RequestOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of UserResponse)

Parameters

id
String

The Cosmos user id.

requestOptions
RequestOptions

(Optional) The options for the user request.

cancellationToken
CancellationToken

(Optional) CancellationToken representing request cancellation.

Returns

A Task containing a UserResponse which wraps a UserProperties containing the read resource record.

Examples

UserResponse response = await this.cosmosDatabase.UpsertUserAsync(Guid.NewGuid().ToString());

Applies to