IDocumentClient.UpsertPermissionAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| UpsertPermissionAsync(String, Permission, RequestOptions) |
Insere 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) |
Insere uma permissão como uma operação assíncrona no serviço do Azure Cosmos DB. |
UpsertPermissionAsync(String, Permission, RequestOptions)
Insere 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>>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 para a permissão. 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
Um objeto de tarefa que representa a resposta do serviço para a operação assíncrona que contém o objeto upserted Permission .
Exceções
Se ou userLinkpermission não estiver definido.
Representa uma consolidação de falhas que ocorreram durante o processamento assíncrono. Procure dentro de InnerExceptions para encontrar as exceções reais
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 com uma Permission 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
Aplica-se a
UpsertPermissionAsync(Uri, Permission, RequestOptions)
Insere 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>>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 upsert a permissão.
- permission
- Permission
O objeto Permission.
- options
- RequestOptions
(Opcional) O RequestOptions para a solicitação.
Retornos
O objeto de tarefa que representa a resposta do serviço para a operação assíncrona.
Aplica-se a
Azure SDK for .NET