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 :

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.

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 :

Pour plus d'informations, consultez les informations suivantes dans le guide de EventBridge l'utilisateur Amazon  :

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 à l'aide du Guide du AWS Lambda développeur.

available events

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.

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

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 :

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

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.

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

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.

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