Übergabe von Daten an Automation mithilfe von Eingangstransformatoren

Dieses AWS Systems Manager-Automation-Tutorial zeigt, wie Sie die Funktion des Eingabetransformators von Amazon EventBridge verwenden, um die instance-id einer Amazon Elastic Compute Cloud (Amazon EC2)-Instance aus einem Instance-Statusänderungsereignis zu extrahieren. Automation ist eine Funktion von AWS Systems Manager. Wir verwenden den Eingangstransformator, um diese Daten als InstanceId-Eingabeparameter an das AWS-CreateImage-Runbook zu übergeben. Die Regel wird ausgelöst, wenn eine beliebige Instance in den Status „stopped“ übergeht.

Weitere Informationen zum Arbeiten mit Eingabetransformatoren finden Sie unter Anleitung: Verwenden des Eingangstransformators zur Anpassung der an das Ereignisziel übergebenen Daten im Amazon EventBridge Benutzerhandbuch.

Bevor Sie beginnen

Stellen Sie sicher, dass Sie der Systems Manager-Automatisierungs-Servicerolle die erforderlichen Berechtigungen und Vertrauensrichtlinien für EventBridge hinzugefügt haben. Weitere Informationen finden Sie unter Übersicht über die Verwaltung von Zugriffsberechtigungen für Ihre EventBridge-Ressourcen im Amazon EventBridge-Benutzerhandbuch.

So verwenden Sie Eingangstransformatoren mit Automatisierung

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

2. Wählen Sie im Navigationsbereich Rules aus.

3. Wählen Sie Create rule (Regel erstellen).

4. Geben Sie einen Namen und eine Beschreibung für die Regel ein.

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

5. Wählen Sie als Event bus (Event Bus) den Event Bus aus, den Sie dieser Regel zuordnen möchten. Wenn Sie möchten, dass diese Regel auf übereinstimmende Ereignisse reagiert, die von Ihrem eigenen AWS-Konto stammen, wählen Sie Standard aus. Wenn ein AWS-Service in Ihrem Konto ein Ereignis ausgibt, wird es stets an den Standard-Event-Bus Ihres Kontos weitergeleitet.

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

7. Wählen Sie Next (Weiter).

8. Wählen Sie für Event source (Ereignisquelle) AWS events or EventBridge partner events (-Ereignisse oder EventBridge-Partnerereignisse).

9. Wählen Sie im Abschnitt Ereignismuster die Option Ereignismusterformular aus.

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

11. Wählen Sie für AWS-Service EC2 aus.

12. Wählen Sie in Event Type (Ereignistyp) EC2 Instance State-change Notification (Benachrichtigung über die Statusänderung der EC2-Instance) aus

13. Für Specific state(s) (Spezifische(r) Zustand(e)), wählen Sie stopped (gestoppt).

14. Wählen Sie Next (Weiter).

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

16. Für Select target (Ziel auswählen), wählen Sie Systems Manager Automation.

17. Wählen Sie unter Document (Dokument) die Option AWS-CreateImage aus.

18. Wählen Sie im Abschnitt Configure automation parameter(s) (Automatisierungsparameter konfigurieren) Input Transformer (Eingangstransformator) aus.

19. Geben Sie für Input path (Eingabepfad) den Wert {"instance":"$.detail.instance-id"} ein.

20. Geben Sie für Template (Vorlage) den Wert {"InstanceId":[<instance>]} ein.

21. Wählen Sie für Execution role (Ausführungsrolle) die Option Use existing role (Vorhandene Rolle) verwenden und wählen Sie Ihre Automation-Servicerolle.

22. Wählen Sie Next (Weiter).

23. (Optional) Geben Sie ein oder mehrere Tags für die Regel ein. Weitere Informationen finden Sie unter Tagging Your Amazon EventBridge Resources (Taggen Ihrer Amazon EventBridge Resources) im Amazon EventBridge-Benutzerhandbuch.

24. Wählen Sie Next (Weiter).

25. Überprüfen Sie die Details der Regel und wählen Sie dann Create rule (Regel erstellen) aus.