Partager via


CosmosDatabase.CreateUserAsync Méthode

Définition

Crée un utilisateur en tant qu’opération asynchrone dans le service Azure Cosmos.

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

Paramètres

id
String

ID d’utilisateur cosmos

requestOptions
RequestOptions

(Facultatif) Options de la demande de l’utilisateur RequestOptions

cancellationToken
CancellationToken

(Facultatif) CancellationToken représentant l’annulation de la demande.

Retours

Task contenant un UserResponse qui encapsule un UserProperties contenant l’enregistrement de ressource de lecture.

Exceptions

Si id n’est pas défini.

Cette exception peut encapsuler de nombreux types d’erreurs différents. Pour déterminer l’erreur spécifique, examinez toujours la propriété StatusCode. Voici quelques codes courants que vous pouvez obtenir lors de la création d’un utilisateur :

StatusCodeRaison de l’exception
400BadRequest : cela signifie qu’un problème s’est produit avec la demande fournie. Il est probable qu’aucun ID n’a été fourni pour le nouvel utilisateur.
409Conflit : cela signifie qu’un UserProperties avec un ID correspondant à l’ID que vous avez fourni existait déjà.

Exemples

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

S’applique à