Partager via


DocumentClient.UpsertUserAsync Méthode

Définition

Surcharges

UpsertUserAsync(String, User, RequestOptions)

Upserts une autorisation sur un objet utilisateur dans le service Azure Cosmos DB en tant qu’opération asychrone.

UpsertUserAsync(Uri, User, RequestOptions)

Upserts d’un utilisateur en tant qu’opération asynchrone dans le service Azure Cosmos DB.

UpsertUserAsync(String, User, RequestOptions)

Upserts une autorisation sur un objet utilisateur dans le service Azure Cosmos DB en tant qu’opération asychrone.

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.User>> UpsertUserAsync (string databaseLink, Microsoft.Azure.Documents.User user, Microsoft.Azure.Documents.Client.RequestOptions options = default);
abstract member UpsertUserAsync : string * Microsoft.Azure.Documents.User * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.User>>
override this.UpsertUserAsync : string * Microsoft.Azure.Documents.User * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.User>>
Public Function UpsertUserAsync (databaseLink As String, user As User, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of User))

Paramètres

databaseLink
String

Lien de la base de données dans laquelle effectuer l’upsert de l’utilisateur. Par exemple, dbs/db_rid/

user
User

Objet User à upsert.

options
RequestOptions

(Facultatif) Options de demande pour la demande.

Retours

Objet de tâche représentant la réponse de service pour l’opération asynchrone qui contient l’objet upserted User .

Implémente

Exceptions

Si ou databaseLinkuser n’est pas défini.

Représente une consolidation des échecs qui se sont produits pendant le traitement asynchrone. Recherchez la ou les exceptions réelles dans InnerExceptions

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 document :

StatusCodeRaison de l’exception
400BadRequest : cela signifie qu’un problème s’est produit avec la demande fournie.
403Interdit : vous avez atteint votre quota d’objets utilisateur pour cette base de données. Contactez le support technique pour augmenter ce quota.
409Conflit : cela signifie qu’un User avec un ID correspondant à l’ID que vous avez fourni existait déjà.

Exemples

//Upsert a new user called joeBloggs in the specified database
User user = await client.UpsertUserAsync(databaseLink, new User { Id = "joeBloggs" });

Voir aussi

S’applique à

UpsertUserAsync(Uri, User, RequestOptions)

Upserts d’un utilisateur en tant qu’opération asynchrone dans le service Azure Cosmos DB.

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.User>> UpsertUserAsync (Uri databaseUri, Microsoft.Azure.Documents.User user, Microsoft.Azure.Documents.Client.RequestOptions options = default);
abstract member UpsertUserAsync : Uri * Microsoft.Azure.Documents.User * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.User>>
override this.UpsertUserAsync : Uri * Microsoft.Azure.Documents.User * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.User>>
Public Function UpsertUserAsync (databaseUri As Uri, user As User, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of User))

Paramètres

databaseUri
Uri

URI de la base de données dans laquelle effectuer l’upsert de l’utilisateur.

user
User

Objet Microsoft.Azure.Documents.User.

options
RequestOptions

Options de demande pour la demande.

Retours

Objet de tâche représentant la réponse du service pour l’opération asynchrone.

Implémente

S’applique à