DocumentClient.UpsertTriggerAsync Methode

Definition

Namespace:

Microsoft.Azure.Documents.Client

Assemblys:

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

Pakete:

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

Überlädt

UpsertTriggerAsync(String, Trigger, RequestOptions)	Führt einen Trigger als asychronen Vorgang im Azure Cosmos DB-Dienst hoch.
UpsertTriggerAsync(Uri, Trigger, RequestOptions)	Führt einen Trigger als asynchronen Vorgang im Azure Cosmos DB-Dienst durch.

UpsertTriggerAsync(String, Trigger, RequestOptions)

Führt einen Trigger als asychronen Vorgang im Azure Cosmos DB-Dienst hoch.

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

Parameter

collectionLink

String

Der Link von DocumentCollection zum Upsertieren des Triggers in. Beispiel: dbs/db_rid/colls/col_rid/

trigger

Trigger

Das Trigger Objekt, das upsert werden soll.

options

RequestOptions

(Optional) Jeder RequestOptionsfür diese Anforderung.

Gibt zurück

Task<ResourceResponse<Trigger>>

Ein Taskobjekt, das die Dienstantwort für den asynchronen Vorgang darstellt.

Implementiert

UpsertTriggerAsync(String, Trigger, RequestOptions)

Ausnahmen

ArgumentNullException

Wenn oder collectionLinktrigger nicht festgelegt ist.

AggregateException

Stellt eine Konsolidierung von Fehlern dar, die während der asynchronen Verarbeitung aufgetreten sind. Suchen Sie in InnerExceptions nach den tatsächlichen Ausnahmen.

DocumentClientException

Diese Ausnahme kann viele verschiedene Fehlertypen kapseln. Um den spezifischen Fehler zu ermitteln, sehen Sie sich immer die StatusCode-Eigenschaft an. Einige häufige Codes, die Sie beim Erstellen eines Dokuments erhalten können, sind:

StatusCode	Grund für die Ausnahme
400	BadRequest: Dies bedeutet, dass mit der bereitgestellten Anforderung ein Fehler aufgetreten ist. Es ist wahrscheinlich, dass für den neuen Trigger keine ID angegeben wurde oder dass der Textkörper falsch formatiert wurde.
403	Verboten: Sie haben ihr Kontingent an Triggern für die angegebene Sammlung erreicht. Wenden Sie sich an den Support, um dieses Kontingent zu erhöhen.
409	Konflikt: Dies bedeutet, dass ein Trigger mit einer ID übereinstimmt, die der von Ihnen angegebenen ID entspricht, bereits vorhanden ist.
413	RequestEntityTooLarge: Dies bedeutet, dass der Text der , die Trigger Sie upsert versucht haben, zu groß war.

Beispiele

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

Weitere Informationen

• Trigger
• RequestOptions
• ResourceResponse<TResource>
• Task

UpsertTriggerAsync(Uri, Trigger, RequestOptions)

Führt einen Trigger als asynchronen Vorgang im Azure Cosmos DB-Dienst durch.

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

Parameter

documentCollectionUri

Uri

der URI der Dokumentauflistung, in der der Trigger aktiviert werden soll.

trigger

Trigger

das Microsoft.Azure.Documents.Trigger-Objekt.

options

RequestOptions

Die Anforderungsoptionen für die Anforderung.

Gibt zurück

Task<ResourceResponse<Trigger>>

Das Aufgabenobjekt, das die Dienstantwort für den asynchronen Vorgang darstellt.

Implementiert

UpsertTriggerAsync(Uri, Trigger, RequestOptions)