IDocumentClient.UpsertTriggerAsync Método

Definición

Espacio de nombres:

Microsoft.Azure.Documents

Ensamblados:

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

Paquetes:

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

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>>

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 activar el desencadenador. Por ejemplo, dbs/db_rid/colls/col_rid/

trigger

Trigger

Objeto Trigger que se va a upsert.

options

RequestOptions

(Opcional) Cualquiera RequestOptionspara esta solicitud.

Devoluciones

Task<ResourceResponse<Trigger>>

Objeto de tarea que representa la respuesta del servicio para la operación asincrónica.

Excepciones

ArgumentNullException

Si se establece o collectionLinktrigger no.

AggregateException

Representa una consolidación de errores que se produjeron durante el procesamiento asincrónico. Busque en InnerExceptions para buscar las excepciones reales.

DocumentClientException

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 colección proporcionada. Póngase en contacto con el soporte técnico para aumentar esta cuota.
409	Conflicto: significa que Trigger un con un identificador que coincide con el identificador que proporcionó ya existía.
413	RequestEntityTooLarge: esto significa que el cuerpo del Trigger objeto 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

• Trigger
• RequestOptions
• ResourceResponse<TResource>
• Task

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>>

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 activar el desencadenador.

trigger

Trigger

Objeto Trigger.

options

RequestOptions

(Opcional) para RequestOptions la solicitud.

Devoluciones

Task<ResourceResponse<Trigger>>

Objeto de tarea que representa la respuesta del servicio para la operación asincrónica.