DocumentClient.UpsertTriggerAsync 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
UpsertTriggerAsync(String, Trigger, RequestOptions) |
Upserts un desencadenador como una operación asincrónica en el servicio Azure Cosmos DB. |
UpsertTriggerAsync(Uri, Trigger, RequestOptions) |
Upserts un desencadenador como una operación asincrónica en el servicio Azure Cosmos DB. |
UpsertTriggerAsync(String, Trigger, RequestOptions)
Upserts un desencadenador 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.Trigger>> UpsertTriggerAsync (string collectionLink, Microsoft.Azure.Documents.Trigger trigger, Microsoft.Azure.Documents.Client.RequestOptions options = default);
abstract member UpsertTriggerAsync : string * Microsoft.Azure.Documents.Trigger * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Trigger>>
override this.UpsertTriggerAsync : string * Microsoft.Azure.Documents.Trigger * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Trigger>>
Public Function UpsertTriggerAsync (collectionLink As String, trigger As Trigger, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of Trigger))
Parámetros
- collectionLink
- String
Vínculo del objeto en el DocumentCollection que se va a insertar el desencadenador. Por ejemplo, dbs/db_rid/colls/col_rid/
- options
- RequestOptions
(Opcional) Cualquiera RequestOptionspara esta solicitud.
Devoluciones
Objeto de tarea que representa la respuesta del servicio para la operación asincrónica.
Implementaciones
Excepciones
Si se establece o collectionLink
trigger
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. Es probable que no se haya proporcionado un identificador para el nuevo desencadenador o que el cuerpo tenga un formato incorrecto. |
403 | Prohibido: ha alcanzado la cuota de desencadenadores para la recopilación proporcionada. Póngase en contacto con el soporte técnico para aumentar esta cuota. |
409 | Conflicto: esto significa que un Trigger elemento con un identificador que coincide con el identificador que proporcionó ya existía. |
413 | RequestEntityTooLarge: esto significa que el cuerpo del Trigger que intentó upsert era demasiado grande. |
Ejemplos
//Upsert a trigger that validates the contents of a document as it is created and adds a 'timestamp' property if one was not found.
Trigger trig = await client.UpsertTriggerAsync(collectionLink, new Trigger
{
Id = "ValidateDocuments",
Body = @"function validate() {
var context = getContext();
var request = context.getRequest();
var documentToCreate = request.getBody();
// validate properties
if (!('timestamp' in documentToCreate)) {
var ts = new Date();
documentToCreate['timestamp'] = ts.getTime();
}
// update the document that will be created
request.setBody(documentToCreate);
}",
TriggerType = TriggerType.Pre,
TriggerOperation = TriggerOperation.Create
});
Consulte también
Se aplica a
UpsertTriggerAsync(Uri, Trigger, RequestOptions)
Upserts un desencadenador 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.Trigger>> UpsertTriggerAsync (Uri documentCollectionUri, Microsoft.Azure.Documents.Trigger trigger, Microsoft.Azure.Documents.Client.RequestOptions options = default);
abstract member UpsertTriggerAsync : Uri * Microsoft.Azure.Documents.Trigger * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Trigger>>
override this.UpsertTriggerAsync : Uri * Microsoft.Azure.Documents.Trigger * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Trigger>>
Public Function UpsertTriggerAsync (documentCollectionUri As Uri, trigger As Trigger, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of Trigger))
Parámetros
- documentCollectionUri
- Uri
el URI de la colección de documentos en el que se va a actualizar el desencadenador.
- trigger
- Trigger
El objeto Microsoft.Azure.Documents.Trigger.
- 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