CosmosPermission.ReplaceAsync Método

Referencia

Definición

Espacio de nombres:: Azure.Cosmos

Ensamblado:: Azure.Cosmos.dll

Paquete:: Azure.Cosmos v4.0.0-preview3

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Reemplace un PermissionProperties elemento del servicio Azure Cosmos como una operación asincrónica. Esto no revocará los 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

Objeto PermissionProperties.

tokenExpiryInSeconds: Nullable<Int32>

(Opcional) Tiempo de expiración del token de recurso en segundos. Este valor puede oscilar entre 10 segundos y 24 horas (o 86 400 segundos). El valor predeterminado para esta es 1 hora (o 3600 segundos). Esto no cambia el valor predeterminado de los tokens futuros.

requestOptions: RequestOptions

(Opcional) Las opciones de la solicitud de usuario RequestOptions

cancellationToken: CancellationToken

(Opcional) CancellationToken que representa la cancelación de la solicitud.

Devoluciones

Task<PermissionResponse>

que Task contiene un PermissionResponse objeto que contiene PermissionProperties el registro de recursos de reemplazo.

Excepciones

CosmosException

Esta excepción puede encapsular muchos tipos diferentes de errores. Para determinar el error específico, examine siempre la propiedad StatusCode. Algunos códigos comunes que puede obtener al crear un permiso son:

StatusCode	Motivo de la excepción
404	NotFound: significa que el recurso o el recurso primario que intentó leer no existían.
429	TooManyRequests: esto significa que ha superado el número de unidades de solicitud por segundo. Consulte el valor DocumentClientException.RetryAfter para ver cuánto tiempo debe esperar antes de volver a intentar esta operación.

Ejemplos

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

Se aplica a

Compartir a través de