DocumentClient.CreatePermissionAsync Methode

Definition

Namespace:

Microsoft.Azure.Documents.Client

Assemblys:

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

Pakete:

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

Überlädt

CreatePermissionAsync(String, Permission, RequestOptions)	Erstellt eine Berechtigung für ein Benutzerobjekt als asychronen Vorgang im Azure Cosmos DB-Dienst.
CreatePermissionAsync(Uri, Permission, RequestOptions)	Erstellt eine Berechtigung als asychroner Vorgang im Azure Cosmos DB-Dienst.

CreatePermissionAsync(String, Permission, RequestOptions)

Erstellt eine Berechtigung für ein Benutzerobjekt als asychronen Vorgang im Azure Cosmos DB-Dienst.

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>>
override this.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))

Parameter

userLink

String

Der Link des Benutzers, für den die Berechtigung erstellt werden soll. z.B. dbs/db_rid/users/user_rid/

permission

Permission

Das Permission-Objekt.

options

RequestOptions

(Optional) Die Anforderungsoptionen für die Anforderung.

Gibt zurück

Task<ResourceResponse<Permission>>

Ein Taskobjekt, das die Dienstantwort für den asynchronen Vorgang darstellt, der das erstellte Permission Objekt enthält.

Implementiert

CreatePermissionAsync(String, Permission, RequestOptions)

Ausnahmen

ArgumentNullException

Wenn oder userLinkpermission nicht festgelegt ist.

AggregateException

Stellt eine Konsolidierung von Fehlern dar, die während der asynchronen Verarbeitung aufgetreten sind. Suchen Sie in InnerExceptions nach den tatsächlichen Ausnahmen.

DocumentClientException

Diese Ausnahme kann viele verschiedene Fehlertypen kapseln. Um den spezifischen Fehler zu ermitteln, sehen Sie sich immer die StatusCode-Eigenschaft an. Einige häufige Codes, die Sie beim Erstellen eines Dokuments erhalten können, sind:

StatusCode	Grund für die Ausnahme
400	BadRequest: Dies bedeutet, dass mit der bereitgestellten Anforderung ein Fehler aufgetreten ist.
403	Verboten: Sie haben Ihr Kontingent an Berechtigungsobjekten erreicht. Wenden Sie sich an den Support, um dieses Kontingent zu erhöhen.
409	Konflikt: Dies bedeutet, dass ein Permission mit einer ID übereinstimmt, die der von Ihnen angegebenen ID entspricht, bereits vorhanden ist.

Beispiele

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

Weitere Informationen

• Permission
• RequestOptions
• ResourceResponse<TResource>
• Task

CreatePermissionAsync(Uri, Permission, RequestOptions)

Erstellt eine Berechtigung als asychroner Vorgang im Azure Cosmos DB-Dienst.

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>>
override this.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))

Parameter

userUri

Uri

der URI des Benutzers, für den die Berechtigung erstellt werden soll.

permission

Permission

das Microsoft.Azure.Documents.Permission-Objekt.

options

RequestOptions

Die Anforderungsoptionen für die Anforderung.

Gibt zurück

Task<ResourceResponse<Permission>>

Das Aufgabenobjekt, das die Dienstantwort für den asynchronen Vorgang darstellt.

Implementiert

CreatePermissionAsync(Uri, Permission, RequestOptions)