DocumentClient.UpsertPermissionAsync Método

Definição

Namespace:

Microsoft.Azure.Documents.Client

Assemblies:

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

Pacotes:

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

Sobrecargas

UpsertPermissionAsync(String, Permission, RequestOptions)	Aumenta uma permissão em um objeto de usuário no serviço do Azure Cosmos DB como uma operação assíncrona.
UpsertPermissionAsync(Uri, Permission, RequestOptions)	Aumenta uma permissão como uma operação assíncrona no serviço do Azure Cosmos DB.

UpsertPermissionAsync(String, Permission, RequestOptions)

Aumenta uma permissão em um objeto de usuário no serviço do Azure Cosmos DB como uma operação assíncrona.

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

O link do usuário para Upsert a permissão para. Por exemplo, dbs/db_rid/users/user_rid/

permission

Permission

O objeto Permission.

options

RequestOptions

(Opcional) As opções de solicitação para a solicitação.

Retornos

Task<ResourceResponse<Permission>>

Um objeto de tarefa que representa a resposta de serviço para a operação assíncrona que contém o objeto upserted Permission .

Implementações

UpsertPermissionAsync(String, Permission, RequestOptions)

Exceções

ArgumentNullException

Se ou userLinkpermission não estiver definido.

AggregateException

Representa uma consolidação de falhas que ocorreram durante o processamento assíncrono. Procure dentro de InnerExceptions para encontrar as exceções reais

DocumentClientException

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 um Documento são:

StatusCode	Motivo da exceção
400	BadRequest - Isso significa que algo estava errado com a solicitação fornecida.
403	Proibido – você atingiu sua cota de objetos de permissão. Entre em contato com o suporte para aumentar essa cota.
409	Conflito – isso significa que um Permission com uma ID correspondente à ID que você forneceu já existia.

Exemplos

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

Confira também

• ResourceResponse<TResource>
• Task
• Permission
• RequestOptions

UpsertPermissionAsync(Uri, Permission, RequestOptions)

Aumenta uma permissão como uma operação assíncrona no serviço do 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

o URI do usuário para o qual inserir a permissão.

permission

Permission

o objeto Microsoft.Azure.Documents.Permission.

options

RequestOptions

As opções de solicitação para a solicitação.

Retornos

Task<ResourceResponse<Permission>>

O objeto de tarefa que representa a resposta de serviço para a operação assíncrona.

Implementações

UpsertPermissionAsync(Uri, Permission, RequestOptions)