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.
Référence aux champs de métadonnées 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
-
Une version 4 UUID générée pour chaque événement. Vous pouvez utiliser
idpour 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 CloudTrailpour 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
sourcepour 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, lasourcevaleur 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 JSON tableau qui contient les ressources ARNs qui identifient les ressources impliquées dans l'événement. Le service qui génère l'événement détermine s'il convient de les inclureARNs. Par exemple, les changements d'état des instances Amazon incluent l'EC2instance AmazonARNs, les événements Auto Scaling incluent ARNs à la fois les instances et les groupes Auto Scaling, mais les API appels avec AWS CloudTrail n'incluent pas les ressourcesARNs. EC2
- detail
-
JSONObjet contenant 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 APIles événements d'appel comportent des objets détaillés contenant environ 50 champs imbriqués à plusieurs niveaux de profondeur.
Note
PutEventsaccepte les données au JSON format. Pour le type de données JSON numérique (entier), 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 d'une EC2 instance Amazon
L'événement suivant sur Amazon EventBridge indique la résiliation d'une EC2 instance Amazon.
{
"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 :
detaildetail-typesource
{
"detail-type": "event name",
"source": "event source",
"detail": {
}
}