Überwachen Sie AMI-Ereignisse mit Amazon EventBridge

Wenn sich der Status eines Amazon Machine Image (AMI) ändert, generiert Amazon EC2 ein Ereignis, das an Amazon gesendet wird EventBridge (früher bekannt als Amazon CloudWatch Events). 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 Ereignis, wenn ein AMI einen der folgenden Status eingibt:

• available

• failed

• deregistered

• disabled

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

Ereignisse werden auf bestmögliche Weise ausgegeben.

AMI-Ereignisse

Es gibt vier EC2 AMI State Change-Ereignisse:

• available
• failed
• deregistered
• disabled

Die Ereignisse werden im JSON-Format an den EventBridge Standard-Event-Bus gesendet.

Die folgenden Felder des Ereignisses können verwendet werden, um Regeln zu erstellen, die eine Aktion auslösen:

"source": "aws.ec2"

Gibt an, dass das Ereignis aus Amazon EC2 stammt

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

Identifiziert den Ereignisnamen.

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

Stellt die folgenden Informationen bereit:

• Die AMI-ID – Wenn Sie ein bestimmtes AMI verfolgen möchten.

• Den Status des AMI (available, failed, deregistered oder disabled).

available

Im Folgenden finden Sie ein Ereignis, das Amazon EC2 generiert, wenn das AMI nach einem erfolgreichen CreateImage-, CopyImage-, RegisterImage-, CreateRestoreImageTask- oder EnableImage-Vorgang 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-0123456789example"],
    "detail": {
        "RequestId": "example-9dcc-40a6-aa77-7ce457d5442b",
        "ImageId": "ami-0123456789example",
        "State": "available",
        "ErrorMessage": ""
    }
}

failed

Im Folgenden finden Sie 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-0123456789example"],
    "detail": {
        "RequestId": "example-9dcc-40a6-aa77-7ce457d5442b",
        "ImageId": "ami-0123456789example",
        "State": "failed",
        "ErrorMessage": "Description of failure"
    }
}

deregistered

Im Folgenden finden Sie 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-0123456789example"],
    "detail": {
        "RequestId": "example-9dcc-40a6-aa77-7ce457d5442b",
        "ImageId": "ami-0123456789example",
        "State": "deregistered",
        "ErrorMessage": ""
    }
}

disabled

Im Folgenden finden Sie 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-0123456789example"],
    "detail": {
        "RequestId": "example-9dcc-40a6-aa77-7ce457d5442b",
        "ImageId": "ami-0123456789example",
        "State": "disabled",
        "ErrorMessage": ""
    }
}

EventBridge Amazon-Regeln erstellen

Sie können eine EventBridge Amazon-Regel erstellen, die eine Aktion festlegt, die ausgeführt werden soll, wenn ein Ereignis EventBridge empfangen wird, das dem Ereignismuster in der Regel entspricht. Wenn ein Ereignis übereinstimmt, wird das Ereignis an das angegebene Ziel EventBridge gesendet und die in der Regel definierte Aktion ausgelöst.

Ereignismuster haben dieselbe Struktur wie die Ereignisse, mit denen sie übereinstimmen. Ein Ereignismuster stimmt entweder mit einem Ereignis überein oder nicht.

Wenn Sie eine Regel für ein AMI-Statusänderungsereignis erstellen, können Sie die folgenden Felder in das Ereignismuster aufnehmen:

"source": "aws.ec2“

Gibt an, dass das Ereignis aus Amazon EC2 stammt

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

Identifiziert den Ereignisnamen.

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

Stellt die folgenden Informationen bereit:

• Die AMI-ID – Wenn Sie ein bestimmtes AMI verfolgen möchten.

• Den Status des AMI (available, failed, deregistered oder disabled).

Beispiel: Erstellen Sie eine EventBridge Regel zum Senden einer Benachrichtigung

Im folgenden Beispiel wird eine EventBridge Regel zum Senden einer E-Mail, Textnachricht oder mobilen Push-Benachrichtigung erstellt, wenn sich ein AMI nach erfolgreichem Abschluss des CreateImage Vorgangs im available Status befindet.

Bevor Sie die EventBridge Regel erstellen, müssen Sie das Amazon SNS SNS-Thema für die E-Mail, Textnachricht oder mobile Push-Benachrichtigung erstellen.

Um eine EventBridge Regel zu erstellen, um eine Benachrichtigung zu senden, wenn ein AMI erstellt wird und sich im available Status

1. Öffnen Sie die EventBridge Amazon-Konsole unter https://console.aws.amazon.com/events/.

2. Wählen Sie Regel erstellen aus.

3. Zum Define rule detail (Festlegen der Regeldetails) gehen Sie folgendermaßen vor:

   1. Geben Sie für die Regel einen Name (Namen) und optional eine Beschreibung ein.

      Eine Regel darf nicht denselben Namen wie eine andere Regel in derselben Region und auf demselben Event Bus haben.

   2. Bei Event bus (Ereignisbus) wählen Sie default (Standard) aus. Wenn ein AWS -Service in Ihrem Konto ein Ereignis ausgibt, wird dieses stets an den standardmäßigen Event Bus Ihres Kontos weitergeleitet.

   3. Bei Rule type (Regeltyp) wählen Sie Rule with an event pattern (Regel mit einem Ereignismuster) aus.

   4. Wählen Sie Weiter aus.

4. Bei Build event pattern (Ereignis-Muster erstellen) gehen Sie wie folgt vor:

   1. Wählen Sie als Eventquelle AWS Events oder EventBridge Partnerevents aus.

   2. Bei Event pattern (Ereignismuster) in diesem Beispiel geben Sie das folgende Ereignismuster an, um mit jedem EC2 AMI State Change-Ereignis übereinzustimmen, das generiert wird, wenn ein AMI in den available-Status übergeht:

      {
       "source": ["aws.ec2"],
       "detail-type": ["EC2 AMI State Change"],
       "detail": {"State": ["available"]}
      }

      Um das Ereignismuster hinzuzufügen, können Sie entweder eine Vorlage verwenden, indem Sie Event pattern form (Ereignismusterformular) auswählen oder Sie spezifizieren Ihr eigenes Muster, indem Sie Custom pattern (JSON-Editor) (Benutzerdefiniertes Muster (JSON-Editor)) auswählen, siehe nachfolgend:

      1. Gehen Sie wie folgt vor, um eine Vorlage zum Erstellen des Ereignismusters zu erstellen:

         1. Wählen Sie Event pattern form (Ereignismusterformular) aus.

         2. Als Event source (Ereignisquelle) wählen Sie AWS -Services aus.

         3. Wählen Sie bei AWS -Service EC2 aus.

         4. Bei Event type (Ereignistyp), wählen Sie EC2 AMI State Change (EC2-AMI-Statusänderung) aus.

         5. Um die Vorlage anzupassen, wählen Sie Edit pattern (Muster bearbeiten) und nehmen Sie Ihre Änderungen vor, damit sie dem Beispiel-Ereignismuster entsprechen.

      2. Gehen Sie wie folgt vor, um ein benutzerdefiniertes Ereignismuster anzugeben:

         1. Wählen Sie Custom pattern (JSON editor) (Benutzerdefiniertes Muster (JSON-Editor)) aus.

         2. In dem Feld Event pattern (Ereignismuster) fügen Sie das Ereignismuster für dieses Beispiel hinzu.

   3. Wählen Sie Weiter aus.

5. Bei Select target(s) (Ziel(e) auswählen) gehen Sie wie folgt vor:

   1. Bei Target types (Zieltypen) wählen Sie AWS -Service aus.

   2. Bei Select a target (Ziel auswählen) wählen Sie SNS topic (SNS-Thema) aus, um eine E-Mail, eine SMS oder eine mobile Push-Benachrichtigung zu senden, wenn das Ereignis eintritt.

   3. Wählen Sie für Topic (Thema) ein vorhandenes Thema aus. Sie müssen zuerst mit der Amazon-SNS-Konsole ein Amazon-SNS-Thema erstellen. Weitere Informationen finden Sie unter Verwenden von Amazon SNS für application-to-person (A2P) -Messaging im Amazon Simple Notification Service Developer Guide.

   4. (Optional) Unter Additional settings (Zusätzliche Einstellungen) können Sie optional zusätzliche Einstellungen konfigurieren. Weitere Informationen finden Sie im EventBridge Amazon-Benutzerhandbuch unter EventBridge Amazon-Regeln erstellen, die auf Ereignisse reagieren (Schritt 16).

   5. Wählen Sie Weiter aus.

6. (Optional) Bei Tags können Sie Ihrer Regel optional einen Tag oder mehrere Tags hinzufügen und dann Next (Weiter) auswählen.

7. Bei Review and create (Überprüfen und erstellen) gehen Sie wie folgt vor:

   1. Überprüfen Sie die Details der Regel und ändern Sie sie nach Bedarf.

   2. Wählen Sie Regel erstellen aus.

Weitere Informationen finden Sie in den folgenden Themen im EventBridge Amazon-Benutzerhandbuch:

• EventBridge Amazon-Veranstaltungen

• EventBridge Amazon-Ereignismuster

• EventBridge Amazon-Regeln

Ein Tutorial zum Erstellen einer Lambda-Funktion und einer EventBridge Regel, die die Lambda-Funktion ausführt, finden Sie unter Tutorial: Den Status einer Amazon EC2 EC2-Instance mithilfe protokollieren EventBridge im AWS Lambda Developer Guide.