User.CreatePermissionAsync Método

Definición

Espacio de nombres:

Microsoft.Azure.Cosmos

Ensamblado:

Microsoft.Azure.Cosmos.Client.dll

Paquete:

Microsoft.Azure.Cosmos v3.36.0

Crea un permiso como una operación asincrónica en el servicio Azure Cosmos.

public abstract System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.PermissionResponse> CreatePermissionAsync (Microsoft.Azure.Cosmos.PermissionProperties permissionProperties, int? tokenExpiryInSeconds = default, Microsoft.Azure.Cosmos.RequestOptions requestOptions = default, System.Threading.CancellationToken cancellationToken = default);

abstract member CreatePermissionAsync : Microsoft.Azure.Cosmos.PermissionProperties * Nullable<int> * Microsoft.Azure.Cosmos.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.PermissionResponse>

Public MustOverride Function CreatePermissionAsync (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 permiso.

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 lectura.

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
400	BadRequest: esto significa que algo estaba mal con la solicitud proporcionada. Es probable que no se haya proporcionado un identificador para el nuevo permiso.
409	Conflicto: significa que PermissionProperties un con un identificador que coincide con el identificador que proporcionó ya existía.

Ejemplos

PermissionProperties permissionProperties = new PermissionProperties("permissionId", PermissionMode.All, database.GetContainer("containerId"), new PartitionKey("tenantId"))";

PermissionResponse response = await this.cosmosDatabase.GetUser("userId").CreatePermissionAsync(permissionProperties, tokenExpiryInSeconds: 9000);