CosmosPermission.ReadAsync Método

Referência

Definição

Namespace:: Azure.Cosmos

Assembly:: Azure.Cosmos.dll

Pacote:: Azure.Cosmos v4.0.0-preview3

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Lê um PermissionProperties do serviço do Azure Cosmos como uma operação assíncrona. Cada leitura retornará um novo ResourceToken com sua respectiva expiração.

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)

Parâmetros

tokenExpiryInSeconds: Nullable<Int32>

(Opcional) O tempo de expiração do token de recurso em segundos. Esse valor pode variar de 10 segundos a 24 horas (ou 86.400 segundos). O valor padrão para isso é 1 hora (ou 3.600 segundos). Isso não altera o valor padrão para tokens futuros.

requestOptions: RequestOptions

(Opcional) As opções para a solicitação de permissão RequestOptions

cancellationToken: CancellationToken

(Opcional) CancellationToken que representa o cancelamento da solicitação.

Retornos

Task<PermissionResponse>

Um Task que contém um PermissionResponse que encapsula um PermissionProperties que contém o registro de recurso de leitura.

Exceções

CosmosException

Essa exceção pode encapsular muitos tipos diferentes de erros. Para determinar o erro específico, sempre examine a propriedade StatusCode. Alguns códigos comuns que você pode obter ao criar uma permissão são:

StatusCode	Motivo da exceção
404	NotFound - Isso significa que o recurso ou o recurso pai que você tentou ler não existia.
429	TooManyRequests - Isso significa que você excedeu o número de unidades de solicitação por segundo. Consulte o valor DocumentClientException.RetryAfter para ver quanto tempo você deve aguardar antes de repetir essa operação.

Exemplos

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

Aplica-se a

Partilhar via