DocumentClient.CreateTriggerAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| CreateTriggerAsync(String, Trigger, RequestOptions) |
Crée un déclencheur en tant qu’opération asychrone dans le service Azure Cosmos DB. |
| CreateTriggerAsync(Uri, Trigger, RequestOptions) |
Crée un déclencheur en tant qu’opération asychrone dans le service Azure Cosmos DB. |
CreateTriggerAsync(String, Trigger, RequestOptions)
Crée 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>> 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))Paramètres
- collectionLink
- String
Lien de pour DocumentCollection créer le déclencheur dans. Par exemple, dbs/db_rid/colls/col_rid/
- options
- RequestOptions
(Facultatif) N’importe lequel RequestOptionspour cette demande.
Retours
Objet de tâche représentant la réponse de service pour l’opération asynchrone.
Implémente
Exceptions
Si ou collectionLinktrigger n’est pas défini.
Représente une consolidation des échecs qui se sont produits pendant le traitement asynchrone. Recherchez la ou les exceptions réelles dans InnerExceptions
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 du Trigger que vous avez essayé de créer était trop grand. |
Exemples
//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
});
Voir aussi
S’applique à
CreateTriggerAsync(Uri, Trigger, RequestOptions)
Crée 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>> 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))Paramètres
- documentCollectionUri
- Uri
URI de la collection de documents dans laquelle créer le déclencheur.
- trigger
- Trigger
objet Microsoft.Azure.Documents.Trigger.
- options
- RequestOptions
Options de demande pour la demande.
Retours
Objet de tâche représentant la réponse du service pour l’opération asynchrone.
Implémente
S’applique à
Azure SDK for .NET