IDocumentClient.CreateTriggerAsync Método

  • Referência

Definição

Namespace:
Microsoft.Azure.Documents
Assemblies:
Microsoft.Azure.DocumentDB.Core.dll, Microsoft.Azure.Documents.Client.dll
Pacotes:
Microsoft.Azure.DocumentDB v2.18.0, Microsoft.Azure.DocumentDB.Core v2.18.0

Sobrecargas

CreateTriggerAsync(String, Trigger, RequestOptions)

Cria um gatilho como uma operação assíncrona no serviço do Azure Cosmos DB.
CreateTriggerAsync(Uri, Trigger, RequestOptions)

Cria um gatilho como uma operação assíncrona no serviço do Azure Cosmos DB.

CreateTriggerAsync(String, Trigger, RequestOptions)

Cria um gatilho 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.Trigger>> CreateTriggerAsync (string collectionLink, Microsoft.Azure.Documents.Trigger trigger, Microsoft.Azure.Documents.Client.RequestOptions options = default);
abstract member CreateTriggerAsync : 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 CreateTriggerAsync (collectionLink As String, trigger As Trigger, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of Trigger))

Parâmetros

collectionLink
String

O link do DocumentCollection no qual criar o gatilho. Por exemplo, dbs/db_rid/colls/col_rid/

trigger
Trigger

O Trigger objeto a ser criado.

options
RequestOptions

(Opcional) Qualquer RequestOptionspara esta solicitação.

Retornos

Task<ResourceResponse<Trigger>>

Um objeto de tarefa que representa a resposta do serviço para a operação assíncrona.

Exceções

ArgumentNullException

Se ou collectionLinktrigger não estiver definido.

AggregateException

Representa uma consolidação de falhas que ocorreram durante o processamento assíncrono. Procure dentro de InnerExceptions para encontrar as exceções reais

DocumentClientException

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:

StatusCodeMotivo da exceção
400BadRequest - Isso significa que algo estava errado com a solicitação fornecida. É provável que uma ID não tenha sido fornecida para o novo gatilho ou que o Corpo tenha sido malformado.
403Proibido – você atingiu sua cota de gatilhos para a coleção fornecida. Entre em contato com o suporte para aumentar essa cota.
409Conflito – isso significa que um com uma Trigger ID correspondente à ID que você forneceu já existia.
413RequestEntityTooLarge - Isso significa que o corpo do Trigger que você tentou criar era muito grande.

Exemplos

//Create 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.CreateTriggerAsync(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
});

Confira também

Aplica-se a

CreateTriggerAsync(Uri, Trigger, RequestOptions)

Cria um gatilho 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.Trigger>> CreateTriggerAsync (Uri documentCollectionUri, Microsoft.Azure.Documents.Trigger trigger, Microsoft.Azure.Documents.Client.RequestOptions options = default);
abstract member CreateTriggerAsync : 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 CreateTriggerAsync (documentCollectionUri As Uri, trigger As Trigger, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of Trigger))

Parâmetros

documentCollectionUri
Uri

O URI da coleção de documentos no qual criar o gatilho.

trigger
Trigger

O objeto Trigger.

options
RequestOptions

(Opcional) O RequestOptions para a solicitação.

Retornos

Task<ResourceResponse<Trigger>>

O objeto de tarefa que representa a resposta do serviço para a operação assíncrona.

Aplica-se a