CosmosPermission.ReadAsync Méthode

Définition

Espace de noms:

Azure.Cosmos

Assembly:

Azure.Cosmos.dll

Paquet:

Azure.Cosmos v4.0.0-preview3

Lit un PermissionProperties à partir du service Azure Cosmos en tant qu’opération asynchrone. Chaque lecture retourne un nouveau ResourceToken avec son expiration respective.

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)

Paramètres

tokenExpiryInSeconds

Nullable<Int32>

(Facultatif) Heure d’expiration du jeton de ressource en secondes. Cette valeur peut aller de 10 secondes à 24 heures (ou 86 400 secondes). La valeur par défaut est 1 heure (ou 3 600 secondes). Cela ne modifie pas la valeur par défaut pour les jetons futurs.

requestOptions

RequestOptions

(Facultatif) Options de la demande d’autorisation RequestOptions

cancellationToken

CancellationToken

(Facultatif) CancellationToken représentant l’annulation de la demande.

Retours

Task<PermissionResponse>

Task contenant un PermissionResponse qui encapsule un PermissionProperties contenant l’enregistrement de ressource de lecture.

Exceptions

CosmosException

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’une autorisation :

StatusCode	Raison de l’exception
404	NotFound : cela signifie que la ressource ou la ressource parente que vous avez tenté de lire n’existait pas.
429	TooManyRequests : cela signifie que vous avez dépassé le nombre d’unités de requête par seconde. Consultez la valeur DocumentClientException.RetryAfter pour savoir combien de temps vous devez attendre avant de réessayer cette opération.

Exemples

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