CosmosPermission.ReadAsync Methode

Referenz

Definition

Namespace:: Azure.Cosmos

Assembly:: Azure.Cosmos.dll

Paket:: Azure.Cosmos v4.0.0-preview3

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Liest einen PermissionProperties aus dem Azure Cosmos-Dienst als asynchronen Vorgang. Jeder Lesevorgang gibt ein neues ResourceToken mit dem jeweiligen Ablauf zurück.

public abstract System.Threading.Tasks.Task<Azure.Cosmos.PermissionResponse> ReadAsync (int? tokenExpiryInSeconds = default, Azure.Cosmos.RequestOptions requestOptions = default, System.Threading.CancellationToken cancellationToken = default);

abstract member ReadAsync : Nullable<int> * Azure.Cosmos.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Cosmos.PermissionResponse>

Public MustOverride Function ReadAsync (Optional tokenExpiryInSeconds As Nullable(Of Integer) = Nothing, Optional requestOptions As RequestOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of PermissionResponse)

Parameter

tokenExpiryInSeconds: Nullable<Int32>

(Optional) Die Ablaufzeit für das Ressourcentoken in Sekunden. Dieser Wert kann zwischen 10 Sekunden und 24 Stunden (oder 86.400 Sekunden) liegen. Der Standardwert hierfür ist 1 Stunde (oder 3.600 Sekunden). Der Standardwert für zukünftige Token wird dadurch nicht geändert.

requestOptions: RequestOptions

(Optional) Die Optionen für die Berechtigungsanforderung RequestOptions

cancellationToken: CancellationToken

(Optional) CancellationToken stellt den Anforderungsabbruch dar.

Gibt zurück

Task<PermissionResponse>

Eine Task , die ein PermissionResponse enthält, das einen PermissionProperties umschließt, der den gelesenen Ressourcendatensatz enthält.

Ausnahmen

CosmosException

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 einer Berechtigung erhalten können, sind:

StatusCode	Grund für die Ausnahme
404	NotFound: Dies bedeutet, dass die Ressource oder die übergeordnete Ressource, die Sie lesen möchten, nicht vorhanden war.
429	TooManyRequests: Dies bedeutet, dass Sie die Anzahl der Anforderungseinheiten pro Sekunde überschritten haben. Lesen Sie den DocumentClientException.RetryAfter-Wert, um zu sehen, wie lange Sie warten sollten, bevor Sie diesen Vorgang wiederholen.

Beispiele

CosmosUser user = this.database.GetUser("userId");
CosmosPermission permission= user.GetPermission("permissionId");
PermissionProperties permissionProperties = await permission.ReadAsync(tokenExpiryInSeconds: 9000);

Gilt für:

Freigeben über