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.
# Surveillez les événements de l'AMI à l'aide d'Amazon EventBridge
Lorsque l'état d'une Amazon Machine Image (AMI) change, Amazon EC2 génère un événement qui est envoyé à Amazon EventBridge (anciennement Amazon CloudWatch Events). Les événements sont envoyés au bus d' EventBridge événements par défaut au format JSON. Vous pouvez utiliser Amazon EventBridge pour détecter ces événements et y réagir. Pour ce faire, vous devez créer des règles EventBridge qui déclenchent une action en réponse à un événement. Par exemple, vous pouvez créer une EventBridge règle qui détecte la fin du processus de création de l'AMI, puis qui invoque une rubrique Amazon SNS pour vous envoyer une notification par e-mail.
Amazon EC2 génère un `EC2 AMI State Change` événement lorsqu'une AMI entre dans l'un des états suivants :
+ `available`
+ `failed`
+ `deregistered`
+ `disabled`
Les événements sont générés sur la base du meilleur effort.
Le tableau suivant répertorie les opérations d’AMI et les états dans lesquels une AMI peut basculer. Dans le tableau, **Oui** indique les états dans lesquels l’AMI peut basculer lors de l’exécution de l’opération correspondante.
| Opérations de l’AMI | available | failed | deregistered | disabled |
| --- | --- | --- | --- | --- |
| CopyImage | Oui | Oui | | |
| CreateImage | Oui | Oui | | |
| CreateRestoreImageTask | Oui | Oui | | |
| DeregisterImage | | | Oui | |
| DisableImage | | | | Oui |
| EnableImage | Oui | | | |
| RegisterImage | Oui | Oui | | |
**Événements EC2 AMI State Change**
+ [Détails de l’événement](#ami-events)
+ [Événements available](#ami-event-available)
+ [Événements failed](#ami-event-failed)
+ [Événements deregistered](#ami-event-deregistered)
+ [Événements disabled](#ami-event-disabled)
## Détails de l’événement
Vous pouvez utiliser les champs suivants dans l’événement afin de créer des règles qui déclenchent une action :
`"source": "aws.ec2"`
Indique que l'événement provient d'Amazon EC2.
`"detail-type": "EC2 AMI State Change"`
Identifie le nom de l’événement.
`"detail": { "ImageId": "ami-0abcdef1234567890", "State": "available", }`
Fournit l’identifiant de l’AMI et l’état de l’AMI (`available`, `failed`, `deregistered`, ou `disabled`).
Pour plus d'informations, consultez les informations suivantes dans le *guide de EventBridge l'utilisateur Amazon* :
+ [ EventBridge Événements Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)
+ [Modèles d' EventBridge événements Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html)
+ [ EventBridge Règles d'Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)
*Pour un didacticiel sur la création d'une fonction Lambda et d'une EventBridge règle qui exécute la fonction Lambda, consultez [Tutoriel : enregistrez l'état d'une EC2 instance Amazon EventBridge à l'aide](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-log-ec2-instance-state.html) du manuel du développeur.AWS Lambda *
## Événements available
Voici un exemple d'événement EC2 généré par Amazon lorsque l'AMI entre dans l'`available`état suivant une `EnableImage` opération réussie `CreateImage` `CopyImage` `RegisterImage``CreateRestoreImageTask`,, ou.
`"State": "available"` indique que l’opération a réussi.
```
{
"version": "0",
"id": "example-9f07-51db-246b-d8b8441bcdf0",
"detail-type": "EC2 AMI State Change",
"source": "aws.ec2",
"account": "012345678901",
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "us-east-1",
"resources": ["arn:aws:ec2:us-east-1::image/ami-0abcdef1234567890"],
"detail": {
"RequestId": "example-9dcc-40a6-aa77-7ce457d5442b",
"ImageId": "ami-0abcdef1234567890",
"State": "available",
"ErrorMessage": ""
}
}
```
## Événements failed
Voici un exemple d'événement EC2 généré par Amazon lorsque l'AMI entre dans l'`failed`état suite à un échec `CreateImage` ou à une `CreateRestoreImageTask` opération. `CopyImage` `RegisterImage`
Les champs suivants fournissent des informations pertinentes :
+ `"State": "failed"` : indique que l’opération a échoué.
+ `"ErrorMessage": ""` : indique la raison de l’échec de l’opération.
```
{
"version": "0",
"id": "example-9f07-51db-246b-d8b8441bcdf0",
"detail-type": "EC2 AMI State Change",
"source": "aws.ec2",
"account": "012345678901",
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "us-east-1",
"resources": ["arn:aws:ec2:us-east-1::image/ami-0abcdef1234567890"],
"detail": {
"RequestId": "example-9dcc-40a6-aa77-7ce457d5442b",
"ImageId": "ami-0abcdef1234567890",
"State": "failed",
"ErrorMessage": "Description of failure"
}
}
```
## Événements deregistered
Voici un exemple d'événement EC2 généré par Amazon lorsque l'AMI entre dans l'`deregistered`état suivant une `DeregisterImage` opération réussie. Si l’opération échoue, aucun événement n’est généré. Tout échec est immédiatement connu, car `DeregisterImage` est une opération synchrone.
`"State": "deregistered"` indique que l’opération `DeregisterImage` a réussi.
```
{
"version": "0",
"id": "example-9f07-51db-246b-d8b8441bcdf0",
"detail-type": "EC2 AMI State Change",
"source": "aws.ec2",
"account": "012345678901",
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "us-east-1",
"resources": ["arn:aws:ec2:us-east-1::image/ami-0abcdef1234567890"],
"detail": {
"RequestId": "example-9dcc-40a6-aa77-7ce457d5442b",
"ImageId": "ami-0abcdef1234567890",
"State": "deregistered",
"ErrorMessage": ""
}
}
```
## Événements disabled
Voici un exemple d'événement EC2 généré par Amazon lorsque l'AMI entre dans l'`disabled`état suivant une `DisableImage` opération réussie. Si l’opération échoue, aucun événement n’est généré. Tout échec est immédiatement connu, car `DisableImage` est une opération synchrone.
`"State": "disabled"` indique que l’opération `DisableImage` a réussi.
```
{
"version": "0",
"id": "example-9f07-51db-246b-d8b8441bcdf0",
"detail-type": "EC2 AMI State Change",
"source": "aws.ec2",
"account": "012345678901",
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "us-east-1",
"resources": ["arn:aws:ec2:us-east-1::image/ami-0abcdef1234567890"],
"detail": {
"RequestId": "example-9dcc-40a6-aa77-7ce457d5442b",
"ImageId": "ami-0abcdef1234567890",
"State": "disabled",
"ErrorMessage": ""
}
}
```