CosmosPermission.ReplaceAsync Método

Definição

Namespace:

Azure.Cosmos

Assembly:

Azure.Cosmos.dll

Pacote:

Azure.Cosmos v4.0.0-preview3

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;