Modèles d' EventBridge événements Amazon

Il est fort probable que vous ne souhaitiez pas traiter tous les événements livrés à un bus ou à une canalisation d'événements donné. Au contraire, 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/ou des attributs de ces événements.

Pour spécifier les événements à envoyer à une cible, vous devez créer un modèle d'événements. 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 d'é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.

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 EC2 instance-termination événements Amazon. Pour ce faire, le modèle d'événement spécifie trois exigences pour correspondre à un événement :

1. La source de l'événement doit être Amazon EC2.

2. L'événement doit être une notification de EC2 changement d'état d'Amazon.

3. L'état de l' EC2 instance Amazon doit êtreterminated.

{
  "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 provenant du corps de l'événement--. state

Important

Dans EventBridge, il est possible de créer des règles pouvant entraîner des higher-than-expected frais et des ralentissements. 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 ayez créé une règle pour détecter les modifications dans un compartiment Amazon S3 et que ACLs vous déclenchiez un logiciel pour les faire passer à l'état souhaité. Si la règle n'est pas écrite avec soin, la modification suivante la ACLs déclenche à nouveau, 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 Bonnes pratiques en matière de règles et Bonnes pratiques.

Modèles d'événements pour les bus dédiés aux événements

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. De cette façon, vous pouvez 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, aux métadonnées de l'événement et/ou aux valeurs détaillées de l'événement.

La vidéo suivante explique les principes de base des modèles d'événements pour les bus d'événements :

Modèles d'événements pour EventBridge Pipes

Pour les EventBridge tuyaux, vous pouvez définir des modèles d'événements afin de filtrer les événements de la source du canal que vous souhaitez transmettre au canal cible. Comme chaque canal possède une source d'événement unique, les modèles d'événements des canaux peuvent correspondre aux métadonnées et/ou aux valeurs de détail des événements.

Tous les champs d'événements ne peuvent pas être utilisés pour créer des modèles d'événements en chaîne. Pour de plus amples informations, veuillez consulter Le filtrage.