Référence sur la structure des événements

Les champs suivants apparaissent dans tous les événements transmis à un bus d'événements et comprennent les métadonnées de l'événement :

{
  "version": "0",
  "id": "UUID",
  "detail-type": "event name",
  "source": "event source",
  "compte": "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 utiliser id 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 fournis par CloudTrail ont AWS API Call via CloudTrail pour valeur dedetail-type.

source

Identifie le service qui a généré l'événement. Tous les événements provenant des services AWS 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 correcte source pour un AWS 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, la source valeur pour Amazon CloudFront estaws.cloudfront.

compte

Le numéro à 12 chiffres identifiant un AWS compte.

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.

region

Identifie la AWS région d'origine de l'événement.

resources

Un tableau JSON qui contient des ARN qui identifient les ressources liées à 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. Il peut être défini sur "{}".

AWS Les événements d'appel d'API comportent des objets détaillés contenant environ 50 champs imbriqués à plusieurs niveaux de profondeur.

Note

PutEventsaccepte les données au format JSON. Pour le type de données numérique (entier) JSON, les contraintes sont les suivantes : une valeur minimale de -9 223 372 036 854 775 808 et une valeur maximale de 9 223 372 036 854 775 807.

Exemple : Notification de changement d’état de l’instance Amazon EC2

L'événement suivant sur Amazon EventBridge indique la résiliation d'une instance 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"
  }
}

Informations minimales nécessaires pour un événement personnalisé valide

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

• detail

• detail-type

• source

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