Freigeben über


IDocumentClient.UpsertPermissionAsync Methode

Definition

Überlädt

UpsertPermissionAsync(String, Permission, RequestOptions)

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

UpsertPermissionAsync(Uri, Permission, RequestOptions)

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

UpsertPermissionAsync(String, Permission, RequestOptions)

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

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Permission>> UpsertPermissionAsync (string userLink, Microsoft.Azure.Documents.Permission permission, Microsoft.Azure.Documents.Client.RequestOptions options = default);
abstract member UpsertPermissionAsync : 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 UpsertPermissionAsync (userLink As String, permission As Permission, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of Permission))

Parameter

userLink
String

Der Link des Benutzers zu Upsert die Berechtigung für. 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

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

Ausnahmen

Wenn entweder userLink oder permission nicht festgelegt ist.

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

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, sind:

StatusCodeAusnahmegrund
400BadRequest: Dies bedeutet, dass mit der bereitgestellten Anforderung etwas nicht stimmte.
403Verboten: Sie haben Ihr Kontingent an Berechtigungsobjekten erreicht. Wenden Sie sich an den Support, um dieses Kontingent zu erhöhen.
409Konflikt: Dies bedeutet, dass eine Permission mit einer ID übereinstimmt, die der von Ihnen angegebenen ID entspricht, bereits vorhanden ist.

Beispiele

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

Weitere Informationen

Gilt für:

UpsertPermissionAsync(Uri, Permission, RequestOptions)

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

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Permission>> UpsertPermissionAsync (Uri userUri, Microsoft.Azure.Documents.Permission permission, Microsoft.Azure.Documents.Client.RequestOptions options = default);
abstract member UpsertPermissionAsync : 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 UpsertPermissionAsync (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 hochsert werden soll.

permission
Permission

Das Permission-Objekt.

options
RequestOptions

(Optional) Der RequestOptions für die Anforderung.

Gibt zurück

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

Gilt für: