Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Modèles d' EventBridge événements Amazon
Il y a de fortes chances que vous ne souhaitiez pas traiter chaque événement qui est livré à un bus ou à un tuyau d'événement donné. Vous souhaiterez probablement sélectionner un sous-ensemble de tous les événements organisés, en fonction de la source de l'événement, du type d'événement et des and/or attributs de ces événements.
Pour spécifier les événements à envoyer à une cible, vous créez un modèle d'événement. Un modèle d'événement définit les données EventBridge utilisées pour déterminer s'il faut envoyer l'événement à la cible. Si le modèle de l'événement correspond à l'événement, EventBridge envoie l'événement à la cible. Les modèles d’événement ont la même structure que les événements auxquels ils correspondent. Soit un modèle d’événement correspond à un événement, soit il n’y correspond pas.
Astuce
Vous pouvez utiliser le EventBridge Sandbox pour tester les modèles d'événements par rapport à des exemples d'événements avant de créer ou de mettre à jour des règles. Pour plus d’informations, consultez Tester les modèles d'événements à l'aide du EventBridge Sandbox.
Par exemple, considérez l'événement suivant d'Amazon EC2 :
{
"version": "0",
"id": "6a7e8feb-b491-4cf7-a9f1-bf3703467718",
"detail-type": "EC2 Instance State-change Notification",
"source": "aws.ec2",
"account": "111122223333",
"time": "2017-12-22T18:43:48Z",
"region": "us-west-1",
"resources": [
"arn:aws:ec2:us-west-1:123456789012:instance/i-1234567890abcdef0"
],
"detail": {
"instance-id": "i-1234567890abcdef0",
"state": "terminated"
}
}Le modèle d'événement suivant sélectionne tous les instance-termination événements Amazon EC2. Pour ce faire, le modèle d'événement spécifie trois exigences pour correspondre à un événement :
La source de l'événement doit être Amazon EC2.
L'événement doit être une notification de changement d'état Amazon EC2.
L'état de l'instance Amazon EC2 doit être
terminated.
{
"source": ["aws.ec2"],
"detail-type": ["EC2 Instance State-change Notification"],
"detail": {
"state": ["terminated"]
}
}Notez que dans cet exemple, le modèle d'événement inclut des champs relatifs à l'événement-- source et detail-type --ainsi qu'un champ du corps de l'événement--. state
Important
Dans EventBridge, il est possible de créer des règles qui peuvent entraîner des charges et des ralentissements plus élevés que prévu. Par exemple, vous pouvez créer par inadvertance une règle qui entraîne une boucle infinie, dans laquelle une règle est déclenchée de manière récursive sans fin. Supposons que vous avez créé une règle permettant de détecter que les listes ACL ont été modifiées sur un compartiment Amazon S3 et de déclencher un logiciel pour les modifier afin qu’elles aient l’état souhaité. Si la règle n'est pas correctement écrite, la modification suivante des listes de contrôle d'accès (ACL) déclenche à nouveau la règle, créant ainsi une boucle infinie.
Pour obtenir des conseils sur la façon d’écrire des règles et des modèles d’événements précis afin de réduire au maximum ces résultats inattendus, consultez Meilleures pratiques en matière de règles et Bonnes pratiques.
Modèles d'événements pour les bus événementiels
Pour les bus d'événements, vous pouvez spécifier un modèle d'événement pour chaque règle que vous créez pour le bus. Vous pouvez ainsi sélectionner les événements à envoyer à des cibles spécifiques. Les modèles d'événements pour les bus d'événements peuvent correspondre à la source de l'événement, à ses métadonnées et and/or à ses valeurs détaillées.
La vidéo suivante présente les principes de base des modèles d'événements pour les bus événementiels :
Modèles d'événements pour EventBridge Pipes
Pour les EventBridge tubes, vous pouvez spécifier des modèles d'événements afin de filtrer les événements provenant de la source du canal que vous souhaitez transmettre à la cible du canal. Étant donné que chaque canal possède une source d'événements unique, les modèles d'événements des canaux peuvent correspondre aux valeurs and/or détaillées des métadonnées des événements.
Les champs d'événements ne peuvent pas tous être utilisés pour créer des modèles d'événements de tuyauterie. Pour plus d’informations, consultez Filtrage.
