Surveillez les AMI événements à l'aide d'Amazon EventBridge - Amazon Elastic Compute Cloud

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 AMI événements à 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 JSON format. 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 AMI création, puis qui invoque un SNS sujet Amazon pour vous envoyer une notification par e-mail.

Amazon EC2 génère un EC2 AMI State Change événement lorsqu'un utilisateur 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 AMI opérations et les états qu'un homme AMI peut entrer. Dans le tableau, Oui indique les états qu'ils AMI peuvent entrer lors de l'exécution de l'opération correspondante.

AMIopérations available failed deregistered disabled

CopyImage

Oui

Oui

CreateImage

Oui

Oui

CreateRestoreImageTask

Oui

Oui

DeregisterImage

Oui

DisableImage

Oui

EnableImage

Oui

RegisterImage

Oui

Oui

Détails de l'événement

Vous pouvez utiliser les champs suivants lors de l'événement pour créer des règles qui déclenchent une action :

"source": "aws.ec2"

Indique que l'événement provient d'AmazonEC2.

"detail-type": "EC2 AMI State Change"

Identifie le nom de l’événement.

"detail": { "ImageId": "ami-0123456789example", "State": "available", }

Fournit l'AMIID et l'état du AMI (availablefailed,deregistered, oudisabled).

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 : enregistrez l'état d'une EC2 instance Amazon EventBridge à l'aide du manuel du développeur.AWS Lambda

Événements available

Voici un exemple d'événement EC2 généré par Amazon lorsqu'il AMI entre dans l'availableétat suite à une EnableImage opération CreateImageCopyImage,RegisterImage,CreateRestoreImageTask, ou 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-0123456789example"], "detail": { "RequestId": "example-9dcc-40a6-aa77-7ce457d5442b", "ImageId": "ami-0123456789example", "State": "available", "ErrorMessage": "" } }

Événements failed

Voici un exemple d'événement EC2 généré par Amazon lorsqu'il 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-0123456789example"], "detail": { "RequestId": "example-9dcc-40a6-aa77-7ce457d5442b", "ImageId": "ami-0123456789example", "State": "failed", "ErrorMessage": "Description of failure" } }

Événements deregistered

Voici un exemple d'événement EC2 généré par Amazon lorsqu'il AMI entre dans l'deregisteredétat après 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-0123456789example"], "detail": { "RequestId": "example-9dcc-40a6-aa77-7ce457d5442b", "ImageId": "ami-0123456789example", "State": "deregistered", "ErrorMessage": "" } }

Événements disabled

Voici un exemple d'événement EC2 généré par Amazon lorsqu'il AMI entre dans l'disabledétat après 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-0123456789example"], "detail": { "RequestId": "example-9dcc-40a6-aa77-7ce457d5442b", "ImageId": "ami-0123456789example", "State": "disabled", "ErrorMessage": "" } }