EventBridgeÉvénements Amazon

Un événement indique une modification dans un environnement tel qu'unAWS environnement, un service partenaire ou une application SaaS, ou dans l'une de vos applications ou services. Voici des exemples d'événements :

• Amazon EC2 génère un événement lorsqu'une instance passe de l'état d'attente à l'état en cours d'exécution.

• Amazon EC2 Auto Scaling génère des événements lorsqu'il lance des instances ou les résilie.

• AWS CloudTrailpublie des événements lorsque vous effectuez des appels d'API.

Vous pouvez également configurer des événements planifiés qui sont générés de façon périodique.

Pour obtenir la liste des services qui génèrent des événements, y compris des exemples d'événements pour chaque service, consultezÉvénements liés auxAWS services et suivez les liens du tableau.

Les événements sont représentés sous forme d'objets JSON et ils ont tous une structure similaire et les mêmes champs de niveau supérieur.

Le contenu du champ de niveau supérieur detail est différent en fonction du service à l'origine de l'événement et de l'événement lui-même. La combinaison des champs source et detail-type sert à identifier les champs et les valeurs trouvés dans le champ detail. Pour accéder à des exemples d'événement générés par des services AWS, veuillez consulter Événements liés auxAWS services.

Rubriques

• Structure d'évènements
• Informations minimales requises pour un événement personnalisé valide
• Modèles d'EventBridgeévénements Amazon
• Ajouter desEventBridge événements Amazon avecPutEvents

La vidéo suivante explique les bases des événements :

La vidéo suivante explique comment se déroulent les événementsEventBridge :

Structure d'évènements

Les champs suivants apparaissent dans un événement :

{
  "version": "0",
  "id": "UUID",
  "detail-type": "event name",
  "source": "event source",
  "account": "ARN",
  "time": "timestamp",
  "region": "region",
  "resources": [
    "ARN"
  ],
  "detail": {
    JSON object
  }
}

version ;

Par défaut, ce paramètre est défini sur 0 (zéro) pour tous les événements.

id

Un UUID version 4 généré pour chaque événement. Vous pouvez utiliserid pour suivre les événements au fur et à mesure qu'ils passent par les règles pour atteindre les cibles.

detail-type

Identifie, en combinaison avec le champ source, les champs et les valeurs qui apparaissent dans le champ detail.

Les événements organisés parCloudTrail ontAWS API Call via CloudTrail pour valeurdetail-type.

source

Identifie le service qui a généré l'événement. Tous les événements qui proviennentAWS des services commencent par « aws ». Les événements générés par un client peuvent avoir n'importe quelle valeur ici tant qu'elle ne commence pas par « aws ». Nous recommandons l'utilisation de chaînes Java domaine-nom inversées de style nom de package.

Pour trouver la valeur correctesource pour unAWS service, consultez le tableau des clés de condition, sélectionnez un service dans la liste et recherchez le préfixe du service. Par exemple, lasource valeur pour AmazonCloudFront estaws.cloudfront.

compte

Le nombre à 12 chiffres identifiant un compte AWS.

time

L'horodatage d'événement, qui peut être spécifié par le service à l'origine de l'événement. Si l'événement s'étend sur un intervalle de temps, le service peut signaler l'heure de début, donc cette valeur peut être antérieure à l'heure de réception de l'événement.

Région

Indique laAWS région à l'origine de l'événement.

resources

Un tableau JSON qui contient des ARN qui identifient les ressources impliquées dans l'événement. Le service qui génère l'événement détermine s'il faut inclure ces ARN. Par exemple, les changements de statut des instances Amazon EC2 incluent les ARN d'instances Amazon EC2, les événements incluent à la fois les ARN des instances et des groupes Auto Scaling, mais les appels d'API avec AWS CloudTrail n'incluent pas les ARN de ressources.

detail

Un objet JSON qui contient des informations sur l'événement. Le service qui génère l'événement détermine le contenu de ce champ. Le contenu détaillé peut être aussi simple que deux champs. AWS Les événements d'appel d'API ont des objets de détail comportant environ 50 champs imbriqués sur plusieurs niveaux.

Exemple : notification de changement d'état de l'instance Amazon EC2

L'événement suivant sur AmazonEventBridge indique qu'une instance Amazon EC2 est en cours de résiliation.

{
  "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"
  }
}

Informations minimales requises pour un événement personnalisé valide

Lorsque vous créez des événements personnalisés, ils doivent inclure les champs suivants :

{
  "detail-type": "event name",
  "source": "event source",
  "detail": {
  }
}

• detail— Un objet JSON qui contient des informations sur l'événement. Ça peut l'être"{}".

  Note

  PutEventsaccepte les données au format JSON. Pour le type de données JSON (Entier), les contraintes sont les suivantes : 9 223 775 807.

• detail-type— Chaîne qui identifie le type d'événement.

• source— Chaîne identifiant la source de l'événement. Les événements générés par un client peuvent avoir n'importe quelle valeur ici tant qu'elle ne commence pas par « aws ». Nous recommandons l'utilisation de chaînes Java domaine-nom inversées de style nom de package.