DocumentClient.UpsertPermissionAsync Método

Definición

Espacio de nombres:

Microsoft.Azure.Documents.Client

Ensamblados:

Microsoft.Azure.DocumentDB.Core.dll, Microsoft.Azure.Documents.Client.dll

Paquetes:

Microsoft.Azure.DocumentDB v2.18.0, Microsoft.Azure.DocumentDB.Core v2.18.0

Sobrecargas

UpsertPermissionAsync(String, Permission, RequestOptions)	Upserts un permiso para un objeto de usuario en el servicio Azure Cosmos DB como una operación asincrónica.
UpsertPermissionAsync(Uri, Permission, RequestOptions)	Upserts un permiso como una operación asincrónica en el servicio Azure Cosmos DB.

UpsertPermissionAsync(String, Permission, RequestOptions)

Upserts un permiso para un objeto de usuario en el servicio Azure Cosmos DB como una operación asincrónica.

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Permission>> UpsertPermissionAsync (string userLink, Microsoft.Azure.Documents.Permission permission, Microsoft.Azure.Documents.Client.RequestOptions options = default);

abstract member UpsertPermissionAsync : string * Microsoft.Azure.Documents.Permission * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Permission>>
override this.UpsertPermissionAsync : string * Microsoft.Azure.Documents.Permission * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Permission>>

Public Function UpsertPermissionAsync (userLink As String, permission As Permission, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of Permission))

Parámetros

userLink

String

Vínculo del usuario a Upsert para el permiso. Por ejemplo, dbs/db_rid/users/user_rid/

permission

Permission

Objeto Permission.

options

RequestOptions

(Opcional) Opciones de solicitud para la solicitud.

Devoluciones

Task<ResourceResponse<Permission>>

Objeto de tarea que representa la respuesta del servicio para la operación asincrónica que contiene el objeto upserted Permission .

Implementaciones

UpsertPermissionAsync(String, Permission, RequestOptions)

Excepciones

ArgumentNullException

Si se establece o userLinkpermission no.

AggregateException

Representa una consolidación de errores que se produjeron durante el procesamiento asincrónico. Busque en InnerExceptions para buscar las excepciones reales.

DocumentClientException

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 documento son:

StatusCode	Motivo de la excepción
400	BadRequest: esto significa que algo estaba mal con la solicitud proporcionada.
403	Prohibido: ha alcanzado la cuota de objetos de permiso. Póngase en contacto con el soporte técnico para aumentar esta cuota.
409	Conflicto: significa que Permission un con un identificador que coincide con el identificador que proporcionó ya existía.

Ejemplos

//Upsert a read-only permission object for a specific user
Permission p = await client.UpsertPermissionAsync(userLink, new Permission { Id = "ReadPermission", PermissionMode = PermissionMode.Read });

Consulte también

• ResourceResponse<TResource>
• Task
• Permission
• RequestOptions

UpsertPermissionAsync(Uri, Permission, RequestOptions)

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

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Permission>> UpsertPermissionAsync (Uri userUri, Microsoft.Azure.Documents.Permission permission, Microsoft.Azure.Documents.Client.RequestOptions options = default);

abstract member UpsertPermissionAsync : Uri * Microsoft.Azure.Documents.Permission * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Permission>>
override this.UpsertPermissionAsync : Uri * Microsoft.Azure.Documents.Permission * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Permission>>

Public Function UpsertPermissionAsync (userUri As Uri, permission As Permission, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of Permission))

Parámetros

userUri

Uri

el URI del usuario para el que se va a actualizar el permiso.

permission

Permission

Objeto Microsoft.Azure.Documents.Permission.

options

RequestOptions

Opciones de solicitud para la solicitud.

Devoluciones

Task<ResourceResponse<Permission>>

Objeto de tarea que representa la respuesta del servicio para la operación asincrónica.

Implementaciones

UpsertPermissionAsync(Uri, Permission, RequestOptions)