Freigeben über


CosmosPermission.ReplaceAsync Methode

Definition

Ersetzen Sie einen PermissionProperties aus dem Azure Cosmos-Dienst als asynchronen Vorgang. Dadurch werden vorhandene ResourceTokens nicht widerrufen.

public abstract System.Threading.Tasks.Task<Azure.Cosmos.PermissionResponse> ReplaceAsync (Azure.Cosmos.PermissionProperties permissionProperties, int? tokenExpiryInSeconds = default, Azure.Cosmos.RequestOptions requestOptions = default, System.Threading.CancellationToken cancellationToken = default);
abstract member ReplaceAsync : Azure.Cosmos.PermissionProperties * Nullable<int> * Azure.Cosmos.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Cosmos.PermissionResponse>
Public MustOverride Function ReplaceAsync (permissionProperties As PermissionProperties, Optional tokenExpiryInSeconds As Nullable(Of Integer) = Nothing, Optional requestOptions As RequestOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of PermissionResponse)

Parameter

permissionProperties
PermissionProperties

Das PermissionProperties-Objekt.

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). Dadurch wird der Standardwert für zukünftige Token nicht geändert.

requestOptions
RequestOptions

(Optional) Die Optionen für die Benutzeranforderung RequestOptions

cancellationToken
CancellationToken

(Optional) CancellationToken stellt die Anforderungsabbruch dar.

Gibt zurück

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

Ausnahmen

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

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

Beispiele

PermissionProperties permissionProperties = permissionReadResponse;
permissionProperties.Id = "newuser";
PermissionResponse response = await permission.ReplaceAsync(permissionProperties, tokenExpiryInSeconds: 9000);
PermissionProperties replacedProperties = response;

Gilt für: