IDocumentClient.UpsertTriggerAsync Méthode

Définition

Espace de noms:

Microsoft.Azure.Documents

Assemblys:

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

Paquets:

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

Surcharges

UpsertTriggerAsync(String, Trigger, RequestOptions)	Upserts un déclencheur en tant qu’opération asychrone dans le service Azure Cosmos DB.
UpsertTriggerAsync(Uri, Trigger, RequestOptions)	Upserts un déclencheur en tant qu’opération asychrone dans le service Azure Cosmos DB.

UpsertTriggerAsync(String, Trigger, RequestOptions)

Upserts un déclencheur en tant qu’opération asychrone dans le service 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))

Paramètres

collectionLink

String

Lien du DocumentCollection pour mettre le déclencheur à l’upsert dans. Par exemple, dbs/db_rid/colls/col_rid/

trigger

Trigger

Objet Trigger à upsert.

options

RequestOptions

(Facultatif) N’importe lequel RequestOptionspour cette demande.

Retours

Task<ResourceResponse<Trigger>>

Objet de tâche représentant la réponse de service pour l’opération asynchrone.

Exceptions

ArgumentNullException

Si ou collectionLinktrigger n’est pas défini.

AggregateException

Représente une consolidation des échecs qui se sont produits pendant le traitement asynchrone. Recherchez la ou les exceptions réelles dans InnerExceptions

DocumentClientException

Cette exception peut encapsuler de nombreux types d’erreurs différents. Pour déterminer l’erreur spécifique, examinez toujours la propriété StatusCode. Voici quelques codes courants que vous pouvez obtenir lors de la création d’un document :

StatusCode	Raison de l’exception
400	BadRequest : cela signifie qu’il y a eu un problème avec la demande fournie. Il est probable qu’un ID n’a pas été fourni pour le nouveau déclencheur ou que le corps a été mal formé.
403	Interdit : vous avez atteint votre quota de déclencheurs pour la collection fournie. Contactez le support technique pour augmenter ce quota.
409	Conflit : cela signifie qu’un Trigger avec un ID correspondant à l’ID que vous avez fourni existait déjà.
413	RequestEntityTooLarge - Cela signifie que le corps de l’upsert Trigger que vous avez essayé de upsert était trop grand.

Exemples

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

Voir aussi

• Trigger
• RequestOptions
• ResourceResponse<TResource>
• Task

UpsertTriggerAsync(Uri, Trigger, RequestOptions)

Upserts un déclencheur en tant qu’opération asychrone dans le service 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))

Paramètres

documentCollectionUri

Uri

URI de la collection de documents dans laquelle monter le déclencheur.

trigger

Trigger

Objet Trigger.

options

RequestOptions

(Facultatif) pour RequestOptions la demande.

Retours

Task<ResourceResponse<Trigger>>

Objet de tâche représentant la réponse du service pour l’opération asynchrone.