Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Überwachen Sie AMI-Ereignisse mit Amazon EventBridge
Wenn sich der Status eines Amazon Machine Image (AMI) ändert, EC2 generiert Amazon ein Ereignis, das an Amazon gesendet wird EventBridge (früher bekannt als Amazon CloudWatch Events). Die Ereignisse werden im JSON-Format an den EventBridge Standard-Event-Bus gesendet. Sie können Amazon verwenden EventBridge , um diese Ereignisse zu erkennen und darauf zu reagieren. Sie tun dies, indem Sie Regeln erstellen EventBridge , die als Reaktion auf ein Ereignis eine Aktion auslösen. Sie können beispielsweise eine EventBridge Regel erstellen, die erkennt, wann der AMI-Erstellungsprozess abgeschlossen ist, und dann ein Amazon SNS SNS-Thema aufruft, um Ihnen eine E-Mail-Benachrichtigung zu senden.
Amazon EC2 generiert ein `EC2 AMI State Change` Ereignis, wenn ein AMI in einen der folgenden Zustände eintritt:
+ `available`
+ `failed`
+ `deregistered`
+ `disabled`
Ereignisse werden auf bestmögliche Weise ausgegeben.
In der folgenden Tabelle sind die AMI-Vorgänge und die Zustände aufgeführt, in die ein AMI übergehen kann. In der Tabelle gibt **Ja** die Zustände an, in die das AMI übergehen kann, wenn der entsprechende Vorgang ausgeführt wird.
| AMI-Vorgänge | available | failed | deregistered | disabled |
| --- | --- | --- | --- | --- |
| CopyImage | Ja | Ja | | |
| CreateImage | Ja | Ja | | |
| CreateRestoreImageTask | Ja | Ja | | |
| DeregisterImage | | | Ja | |
| DisableImage | | | | Ja |
| EnableImage | Ja | | | |
| RegisterImage | Ja | Ja | | |
**EC2 AMI State Change-Ereignisse**
+ [Ereignisdetails](#ami-events)
+ [available-Ereignisse](#ami-event-available)
+ [failed-Ereignisse](#ami-event-failed)
+ [deregistered-Ereignisse](#ami-event-deregistered)
+ [disabled-Ereignisse](#ami-event-disabled)
## Ereignisdetails
Die folgenden Felder des Ereignisses können verwendet werden, um Regeln zu erstellen, die eine Aktion auslösen:
`"source": "aws.ec2"`
Identifiziert, dass das Ereignis von Amazon stammt EC2.
`"detail-type": "EC2 AMI State Change"`
Identifiziert den Ereignisnamen.
`"detail": { "ImageId": "ami-0abcdef1234567890", "State": "available", }`
Stellt die AMI-ID und den Status des AMI (`available`, `failed`, `deregistered` oder `disabled`) bereit.
Weitere Informationen finden Sie im * EventBridge Amazon-Benutzerhandbuch*:
+ [ EventBridge Amazon-Veranstaltungen](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)
+ [ EventBridge Amazon-Ereignismuster](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html)
+ [ EventBridge Amazon-Regeln](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)
Ein Tutorial zum Erstellen einer Lambda-Funktion und einer EventBridge Regel, die die Lambda-Funktion ausführt, finden Sie unter [Tutorial: Den Status einer EC2 Amazon-Instance mithilfe protokollieren EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-log-ec2-instance-state.html) im *AWS Lambda Developer* Guide.
## available-Ereignisse
Das Folgende ist ein Beispiel für ein Ereignis, das Amazon EC2 generiert, wenn das AMI nach einem erfolgreichen `EnableImage` Vorgang`CreateImage`,, `CopyImage` `RegisterImage``CreateRestoreImageTask`, oder in den `available` Status wechselt.
`"State": "available"` zeigt an, dass der Vorgang erfolgreich war.
```
{
"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-Ereignisse
Das Folgende ist ein Beispiel für ein Ereignis, das Amazon EC2 generiert, wenn das AMI nach einem fehlgeschlagenen`CreateImage`, `CopyImage``RegisterImage`, oder `CreateRestoreImageTask` Vorgang in den `failed` Status wechselt.
Die folgenden Felder enthalten relevante Informationen:
+ `"State": "failed"` – Gibt an, dass ein Vorgang fehlgeschlagen ist.
+ `"ErrorMessage": ""` – Gibt den Grund für den fehlgeschlagenen Vorgang an.
```
{
"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"
}
}
```
## deregistered-Ereignisse
Das Folgende ist ein Beispiel für ein Ereignis, das Amazon EC2 generiert, wenn das AMI nach einem erfolgreichen `DeregisterImage` Vorgang in den `deregistered` Status wechselt. Wenn der Vorgang fehlschlägt, wird kein Ereignis generiert. Jeder Fehler ist sofort bekannt, da `DeregisterImage` ein synchroner Vorgang ist.
`"State": "deregistered"` zeigt an, dass der `DeregisterImage`-Vorgang erfolgreich war.
```
{
"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-Ereignisse
Das Folgende ist ein Beispiel für ein Ereignis, das Amazon EC2 generiert, wenn das AMI nach einem erfolgreichen `DisableImage` Vorgang in den `disabled` Status wechselt. Wenn der Vorgang fehlschlägt, wird kein Ereignis generiert. Jeder Fehler ist sofort bekannt, da `DisableImage` ein synchroner Vorgang ist.
`"State": "disabled"` zeigt an, dass der `DisableImage`-Vorgang erfolgreich war.
```
{
"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": ""
}
}
```