IDocumentClient.CreatePermissionAsync Méthode

Définition

Espace de noms:

Microsoft.Azure.Documents

Assemblys:

Microsoft.Azure.DocumentDB.Core.dll, Microsoft.Azure.Documents.Client.dll

Paquets:

Microsoft.Azure.DocumentDB v2.18.0, Microsoft.Azure.DocumentDB.Core v2.18.0

Surcharges

CreatePermissionAsync(String, Permission, RequestOptions)	Crée une autorisation sur un objet utilisateur en tant qu’opération asychrone dans le service Azure Cosmos DB.
CreatePermissionAsync(Uri, Permission, RequestOptions)	Crée une autorisation en tant qu’opération asychrone dans le service Azure Cosmos DB.

CreatePermissionAsync(String, Permission, RequestOptions)

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

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Permission>> CreatePermissionAsync (string userLink, Microsoft.Azure.Documents.Permission permission, Microsoft.Azure.Documents.Client.RequestOptions options = default);

abstract member CreatePermissionAsync : string * Microsoft.Azure.Documents.Permission * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Permission>>

Public Function CreatePermissionAsync (userLink As String, permission As Permission, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of Permission))

Paramètres

userLink

String

Lien de l’utilisateur pour lequel créer l’autorisation. Par exemple, dbs/db_rid/users/user_rid/

permission

Permission

Objet Permission.

options

RequestOptions

(Facultatif) Options de demande pour la demande.

Retours

Task<ResourceResponse<Permission>>

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

Exceptions

ArgumentNullException

Si ou userLinkpermission n’est pas défini.

AggregateException

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

DocumentClientException

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 :

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

Exemples

//Create a read-only permission object for a specific user
Permission p = await client.CreatePermissionAsync(userLink, new Permission { Id = "ReadPermission", PermissionMode = PermissionMode.Read });

Voir aussi

• Permission
• RequestOptions
• ResourceResponse<TResource>
• Task

CreatePermissionAsync(Uri, Permission, RequestOptions)

Crée une autorisation en tant qu’opération asychrone dans le service Azure Cosmos DB.

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Permission>> CreatePermissionAsync (Uri userUri, Microsoft.Azure.Documents.Permission permission, Microsoft.Azure.Documents.Client.RequestOptions options = default);

abstract member CreatePermissionAsync : Uri * Microsoft.Azure.Documents.Permission * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Permission>>

Public Function CreatePermissionAsync (userUri As Uri, permission As Permission, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of Permission))

Paramètres

userUri

Uri

URI de l’utilisateur pour lequel créer l’autorisation.

permission

Permission

Objet Permission.

options

RequestOptions

(Facultatif) RequestOptions pour la demande.

Retours

Task<ResourceResponse<Permission>>

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