IDocumentClient.CreateUserAsync 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
| CreateUserAsync(String, User, RequestOptions) |
Cria um objeto de usuário como uma operação assíncrona no serviço do Azure Cosmos DB. |
| CreateUserAsync(Uri, User, RequestOptions) |
Cria um usuário como uma operação assíncrona no serviço do Azure Cosmos DB. |
CreateUserAsync(String, User, RequestOptions)
Cria um objeto de usuário 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.User>> CreateUserAsync (string databaseLink, Microsoft.Azure.Documents.User user, Microsoft.Azure.Documents.Client.RequestOptions options = default);abstract member CreateUserAsync : string * Microsoft.Azure.Documents.User * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.User>>Public Function CreateUserAsync (databaseLink As String, user As User, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of User))Parâmetros
- databaseLink
- String
O link do banco de dados no qual o usuário será criado. Por exemplo, dbs/db_rid/
- 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 criado User .
Exceções
Se ou databaseLinkuser 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 usuário para este banco de dados. Entre em contato com o suporte para aumentar essa cota. |
| 409 | Conflito – isso significa que um com uma User ID correspondente à ID que você forneceu já existia. |
Exemplos
//Create a new user called joeBloggs in the specified database
User user = await client.CreateUserAsync(databaseLink, new User { Id = "joeBloggs" });
Confira também
Aplica-se a
CreateUserAsync(Uri, User, RequestOptions)
Cria um usuário 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.User>> CreateUserAsync (Uri databaseUri, Microsoft.Azure.Documents.User user, Microsoft.Azure.Documents.Client.RequestOptions options = default);abstract member CreateUserAsync : Uri * Microsoft.Azure.Documents.User * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.User>>Public Function CreateUserAsync (databaseUri As Uri, user As User, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of User))Parâmetros
- databaseUri
- Uri
O URI do banco de dados no qual criar o usuário.
- 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