Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Monitora gli eventi AMI utilizzando Amazon EventBridge
Quando lo stato di un'Amazon Machine Image (AMI) cambia, Amazon EC2 genera un evento che viene inviato ad Amazon EventBridge (precedentemente noto come Amazon CloudWatch Events). Gli eventi vengono inviati al bus di EventBridge eventi predefinito in formato JSON. Puoi usare Amazon EventBridge per rilevare e reagire a questi eventi. Puoi farlo creando regole EventBridge che attivano un'azione in risposta a un evento. Ad esempio, puoi creare una EventBridge regola che rileva quando il processo di creazione dell'AMI è completato e quindi richiama un argomento Amazon SNS per inviarti una notifica e-mail.
Amazon EC2 genera un `EC2 AMI State Change` evento quando un'AMI entra in uno dei seguenti stati:
+ `available`
+ `failed`
+ `deregistered`
+ `disabled`
Gli eventi vengono generati in base al miglior tentativo.
La tabella seguente elenca le operazioni AMI e gli stati che un'AMI può assumere. Nella tabella, **Sì** indica gli stati che l'AMI può assumere quando viene eseguita l'operazione corrispondente.
| Operazioni AMI | available | failed | deregistered | disabled |
| --- | --- | --- | --- | --- |
| CopyImage | Sì | Sì | | |
| CreateImage | Sì | Sì | | |
| CreateRestoreImageTask | Sì | Sì | | |
| DeregisterImage | | | Sì | |
| DisableImage | | | | Sì |
| EnableImage | Sì | | | |
| RegisterImage | Sì | Sì | | |
**Eventi EC2 AMI State Change**
+ [Dettagli dell’evento](#ami-events)
+ [Eventi available](#ami-event-available)
+ [Eventi failed](#ami-event-failed)
+ [Eventi deregistered](#ami-event-deregistered)
+ [Eventi disabled](#ami-event-disabled)
## Dettagli dell’evento
Puoi utilizzare i campi seguenti dell'evento per creare regole che attivano un'operazione:
`"source": "aws.ec2"`
Indica che l'evento proviene da Amazon EC2.
`"detail-type": "EC2 AMI State Change"`
Identifica il nome dell'evento.
`"detail": { "ImageId": "ami-0abcdef1234567890", "State": "available", }`
Fornisce l'ID dell'AMI e lo stato dell'AMI (`available`, `failed`, `deregistered`, o `disabled`).
Per ulteriori informazioni, consulta quanto segue nella *Amazon EventBridge User Guide*:
+ [ EventBridge Eventi Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)
+ [Modelli di EventBridge eventi Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html)
+ [ EventBridge Regole di Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)
*Per un tutorial su come creare una funzione Lambda e una EventBridge regola che esegua la funzione Lambda, consulta [Tutorial: Log the state of an Amazon EC2 instance using EventBridge in the](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-log-ec2-instance-state.html) Developer Guide.AWS Lambda *
## Eventi available
Di seguito è riportato un esempio di evento che Amazon EC2 genera quando l'AMI entra nello `available` stato a seguito di un'`EnableImage`operazione `CreateImage` `CopyImage``RegisterImage`,`CreateRestoreImageTask`, o riuscita.
`"State": "available"` indica che l'operazione è riuscita.
```
{
"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": ""
}
}
```
## Eventi failed
Di seguito è riportato un esempio di evento che Amazon EC2 genera quando l'AMI entra nello `failed` stato a seguito di un'`CreateRestoreImageTask`operazione `CreateImage` `CopyImage``RegisterImage`, o non riuscita.
I campi seguenti forniscono informazioni pertinenti:
+ `"State": "failed"`: indica che l'operazione non è riuscita.
+ `"ErrorMessage": ""`: fornisce il motivo dell'operazione non riuscita.
```
{
"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"
}
}
```
## Eventi deregistered
Di seguito è riportato un esempio di evento che Amazon EC2 genera quando l'AMI entra nello `deregistered` stato dopo un'`DeregisterImage`operazione riuscita. Se l'operazione ha esito negativo, non viene generato alcun evento. Qualsiasi errore viene comunicato immediatamente perché `DeregisterImage` è un'operazione sincrona.
`"State": "deregistered"` indica che l'operazione `DeregisterImage` è riuscita.
```
{
"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": ""
}
}
```
## Eventi disabled
Di seguito è riportato un esempio di evento che Amazon EC2 genera quando l'AMI entra nello `disabled` stato dopo un'`DisableImage`operazione riuscita. Se l'operazione ha esito negativo, non viene generato alcun evento. Qualsiasi errore viene comunicato immediatamente perché `DisableImage` è un'operazione sincrona.
`"State": "disabled"` indica che l'operazione `DisableImage` è riuscita.
```
{
"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": ""
}
}
```