DocumentClient.UpsertUserAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
UpsertUserAsync(String, User, RequestOptions) |
Upserts un permiso para un objeto de usuario en el servicio Azure Cosmos DB como una operación asincrónica. |
UpsertUserAsync(Uri, User, RequestOptions) |
Upserts a un usuario como una operación asincrónica en el servicio Azure Cosmos DB. |
UpsertUserAsync(String, User, 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.User>> UpsertUserAsync (string databaseLink, Microsoft.Azure.Documents.User user, Microsoft.Azure.Documents.Client.RequestOptions options = default);
abstract member UpsertUserAsync : string * Microsoft.Azure.Documents.User * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.User>>
override this.UpsertUserAsync : 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 UpsertUserAsync (databaseLink As String, user As User, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of User))
Parámetros
- databaseLink
- String
Vínculo de la base de datos en la que se va a actualizar el usuario. Por ejemplo, dbs/db_rid/
- options
- RequestOptions
(Opcional) Las opciones de solicitud de la solicitud.
Devoluciones
Objeto de tarea que representa la respuesta del servicio para la operación asincrónica que contiene el objeto upserted User .
Implementaciones
Excepciones
Si se establece o databaseLink
user
no.
Representa una consolidación de errores que se produjeron durante el procesamiento asincrónico. Busque en InnerExceptions para buscar las excepciones reales.
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 usuario para esta base de datos. Póngase en contacto con el soporte técnico para aumentar esta cuota. |
409 | Conflicto: esto significa que un User elemento con un identificador que coincide con el identificador que proporcionó ya existía. |
Ejemplos
//Upsert a new user called joeBloggs in the specified database
User user = await client.UpsertUserAsync(databaseLink, new User { Id = "joeBloggs" });
Consulte también
Se aplica a
UpsertUserAsync(Uri, User, RequestOptions)
Upserts a un usuario 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.User>> UpsertUserAsync (Uri databaseUri, Microsoft.Azure.Documents.User user, Microsoft.Azure.Documents.Client.RequestOptions options = default);
abstract member UpsertUserAsync : Uri * Microsoft.Azure.Documents.User * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.User>>
override this.UpsertUserAsync : 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 UpsertUserAsync (databaseUri As Uri, user As User, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of User))
Parámetros
- databaseUri
- Uri
el URI de la base de datos en el que se va a actualizar el usuario.
- user
- User
El objeto Microsoft.Azure.Documents.User.
- options
- RequestOptions
Las opciones de solicitud de la solicitud.
Devoluciones
Objeto de tarea que representa la respuesta del servicio para la operación asincrónica.
Implementaciones
Se aplica a
Azure SDK for .NET
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de