DocumentClient.CreateTriggerAsync Método

Definição

Namespace:

Microsoft.Azure.Documents.Client

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>>
override this.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 essa solicitação.

Retornos

Task<ResourceResponse<Trigger>>

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

Implementações

CreateTriggerAsync(String, Trigger, RequestOptions)

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:

StatusCode	Motivo da exceção
400	BadRequest - 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.
403	Proibido – você atingiu sua cota de gatilhos para a coleção fornecida. Entre em contato com o suporte para aumentar essa cota.
409	Conflito – isso significa que um Trigger com uma ID correspondente à ID que você forneceu já existia.
413	RequestEntityTooLarge - Isso significa que o corpo do que Trigger 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

• ResourceResponse<TResource>
• Task
• Trigger
• RequestOptions

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>>
override this.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 Microsoft.Azure.Documents.Trigger.

options

RequestOptions

As opções de solicitação para a solicitação.

Retornos

Task<ResourceResponse<Trigger>>

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

Implementações

CreateTriggerAsync(Uri, Trigger, RequestOptions)