

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 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, créez 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 invoque une rubrique Amazon SNS pour vous envoyer une notification par e-mail.

Amazon EC2 génère un événement de `EC2 AMI State Change` 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)
+ [available events](#ami-event-available)
+ [failed events](#ami-event-failed)
+ [désenregistré events](#ami-event-deregistered)
+ [désactivées events](#ami-event-disabled)

## Détails de l’événement
<a name="ami-events"></a>

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"`  
Identifie que l’événement provient de 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 : Consigner l'état d'une instance Amazon EC2 EventBridge ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-log-ec2-instance-state.html) à l'aide du Guide du *AWS Lambda développeur. *

## available events
<a name="ami-event-available"></a>

Voici un exemple d’événement généré par Amazon EC2 lorsque l’AMI bascule dans l’état `available` après une opération `CreateImage`, `CopyImage`, `RegisterImage`, `CreateRestoreImageTask` ou `EnableImage` réussie.

`"State": "available"` indique que l’opération a réussi.

```JSON
{
    "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": ""
    }
}
```

## failed events
<a name="ami-event-failed"></a>

Voici un exemple d’événement généré par Amazon EC2 lorsque l’AMI bascule dans l’état `failed` après l’échec d’une opération `CreateImage`, `CopyImage`, `RegisterImage` ou `CreateRestoreImageTask`.

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.

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

## désenregistré events
<a name="ami-event-deregistered"></a>

Voici un exemple d’événement généré par Amazon EC2 lorsque l’AMI bascule dans l’état `deregistered` après une opération `DeregisterImage` 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.

```JSON
{
    "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": ""
    }
}
```

## désactivées events
<a name="ami-event-disabled"></a>

Voici un exemple d’événement généré par Amazon EC2 lorsque l’AMI bascule dans l’état `disabled` après une opération `DisableImage` 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.

```JSON
{
    "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": ""
    }
}
```