CosmosPermission.ReplaceAsync 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.

Substitua um PermissionProperties do serviço do Azure Cosmos como uma operação assíncrona. Isso não revogará resourceTokens existentes.

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)

Parâmetros

permissionProperties: PermissionProperties

O objeto PermissionProperties.

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 do usuário 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 substituição.

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

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

Aplica-se a

Produto	Versões
Azure SDK for .NET	Preview

Compartilhar via