DocumentClient.UpsertTriggerAsync 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

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

UpsertTriggerAsync(String, Trigger, RequestOptions)

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

O link do DocumentCollection para upsert o gatilho. Por exemplo, dbs/db_rid/colls/col_rid/

trigger

Trigger

O Trigger objeto a ser upsert.

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

UpsertTriggerAsync(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 Trigger que você tentou inserir era muito grande.

Exemplos

//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
});

Confira também

• ResourceResponse<TResource>
• Task
• Trigger
• RequestOptions

UpsertTriggerAsync(Uri, Trigger, RequestOptions)

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

o URI da coleção de documentos para aumentar 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

UpsertTriggerAsync(Uri, Trigger, RequestOptions)