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 Events). CloudWatch 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 rilevi quando il processo di creazione dell'AMI è stato completato e quindi richiami un argomento Amazon SNS per inviarti una notifica via email.
Amazon EC2 genera un evento `EC2 AMI State Change` 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)
+ [disponibile eventi](#ami-event-available)
+ [Non riuscito eventi](#ami-event-failed)
+ [annullata la registrazione eventi](#ami-event-deregistered)
+ [disabled eventi](#ami-event-disabled)
## Dettagli dell’evento
Puoi utilizzare i campi seguenti dell'evento per creare regole che attivano un'operazione:
`"source": "aws.ec2"`
Identifica 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: Registra lo stato di un'istanza Amazon EC2 utilizzando EventBridge ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-log-ec2-instance-state.html) nella Developer Guide. *AWS Lambda *
## disponibile eventi
Di seguito è illustrato un esempio di un evento generato da Amazon EC2 quando l'AMI assume lo stato `available` dopo un'operazione `CreateImage`, `CopyImage`, `RegisterImage`, `CreateRestoreImageTask` o `EnableImage` 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": ""
}
}
```
## Non riuscito eventi
Di seguito è illustrato un esempio di un evento generato da Amazon EC2 quando l'AMI assume lo stato `failed` dopo un'operazione `CreateImage`, `CopyImage`, `RegisterImage` o `CreateRestoreImageTask` 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"
}
}
```
## annullata la registrazione eventi
Di seguito è illustrato un esempio di un evento generato da Amazon EC2 quando l'AMI assume lo stato `deregistered` dopo un'operazione `DeregisterImage` 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": ""
}
}
```
## disabled eventi
Di seguito è illustrato un esempio di un evento generato da Amazon EC2 quando l'AMI assume lo stato `disabled` dopo un'operazione `DisableImage` 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": ""
}
}
```