Tutorial: Verwenden Sie Eingangstransformatoren, um Ereignisse zu transformieren in EventBridge - Amazon EventBridge

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.

Tutorial: Verwenden Sie Eingangstransformatoren, um Ereignisse zu transformieren in EventBridge

Sie können den Eingangstransformator verwenden EventBridge, um den Text eines Ereignisses anzupassen, bevor Sie ihn an das Ziel einer Regel senden.

Dazu definieren Sie JSON Pfade aus dem Ereignis und weisen ihre Ausgaben verschiedenen Variablen zu. Anschließend können Sie diese Variablen in der Eingabevorlage verwenden. Die Zeichen < und > können nicht durch Escape-Zeichen geschützt werden. Weitere Informationen finden Sie unter Transformation Amazon EventBridge Amazon-Eingaben.

Anmerkung

Wenn Sie eine Variable angeben, die einem JSON Pfad entspricht, der im Ereignis nicht existiert, wird diese Variable nicht erstellt und erscheint nicht in der Ausgabe.

In diesem Tutorial erstellen Sie eine Regel, die einem Ereignis mit detail-type: "customerCreated" entspricht. Der Eingangstransformator ordnet die type Variable dem JSON Pfad vom Typ $.detail aus dem Ereignis zu. EventBridge <type>Fügt dann die Variable in die Eingabevorlage „Dieses Ereignis war“ ein. Das Ergebnis ist die folgende SNS Amazon-Nachricht.

"This event was of customerCreated type."

Schritt 1: Erstellen Sie ein SNS Amazon-Thema

Erstellen Sie ein Thema, von dem Sie die Ereignisse erhalten möchten EventBridge.

Erstellen Sie ein Thema wie folgt
  1. Öffnen Sie die SNS Amazon-Konsole unter https://console.aws.amazon.com/sns/v3/home.

  2. Wählen Sie im Navigationsbereich Themen aus.

  3. Wählen Sie Thema erstellen aus.

  4. Wählen Sie unter Type (Typ) die Option Standard aus.

  5. Geben Sie eventbridge-IT-test als Namen des Themas ein.

  6. Wählen Sie Thema erstellen aus.

Schritt 2: Erstellen Sie ein SNS Amazon-Abonnement

Erstellen Sie ein Abonnement, um E-Mails mit den transformierten Informationen zu erhalten.

Erstellen eines Abonnements
  1. Öffnen Sie die SNS Amazon-Konsole unter https://console.aws.amazon.com/sns/v3/home.

  2. Wählen Sie im Navigationsbereich Subscriptions aus.

  3. Wählen Sie Create subscription.

  4. Wählen Sie unter Thema das Thema ausARN, das Sie in Schritt 1 erstellt haben. Wählen Sie für dieses Tutorial eventbridge-IT-test aus.

  5. Wählen Sie unter Protocol (Protokoll) die Option Email (E-Mail) aus.

  6. Geben Sie unter Endpunkt Ihre E-Mail-Adresse ein.

  7. Wählen Sie Create subscription (Abonnement erstellen) aus.

  8. Bestätigen Sie das Abonnement, indem Sie in der E-Mail, die Sie von AWS -Benachrichtigungen erhalten, die Option Abonnement bestätigen auswählen.

Schritt 3: Erstellen einer Regel

Erstellen Sie eine Regel, um mithilfe des Eingabe-Transformators die Informationen zum Instance-Status anzupassen, die an ein Ziel gesendet werden.

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

  2. Wählen Sie im Navigationsbereich Rules aus.

  3. Wählen Sie Regel erstellen aus.

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

  5. Wählen Sie für Event Bus den Event Bus aus, den Sie dieser Regel zuordnen möchten. Wenn Sie möchten, dass diese Regel mit Ereignissen aus Ihrem eigenen Konto übereinstimmt, 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 Weiter aus.

  8. Wählen Sie für Event source (Ereignisquelle) Other (Andere) aus.

  9. Geben Sie für Ereignismuster Folgendes ein:

    { "detail-type": [ "customerCreated" ] }
  10. Wählen Sie Weiter aus.

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

  12. Wählen Sie für Select a target SNS das Thema aus der Drop-down-Liste aus.

  13. Wählen Sie unter Thema das SNS Amazon-Thema aus, das Sie in Schritt 1 erstellt haben. Wählen Sie für dieses Tutorial eventbridge-IT-test aus.

  14. Gehen Sie für Weitere Einstellungen wie folgt vor:

    1. Wählen Sie für Zieleingabe konfigurieren die Option Eingabe-Transformator aus der Dropdown-Liste aus.

    2. Wählen Sie Eingabe-Transformator konfigurieren aus.

    3. Geben Sie für Beispielereignisse Folgendes ein:

      { "detail-type": "customerCreated" }
    4. Gehen Sie für Zieleingabe-Transformator wie folgt vor:

      1. Geben Sie für Eingabepfad Folgendes ein:

        {"detail-type":"$.detail-type"}
      2. Geben Sie für Eingabevorlage Folgendes ein:

        "This event was of <detail-type> type."
    5. Wählen Sie Bestätigen aus.

  15. Wählen Sie Weiter.

  16. Wählen Sie Weiter.

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

Schritt 4: Senden von Testereignissen

Nachdem Sie das SNS Thema und die Regel eingerichtet haben, senden wir Testereignisse, um sicherzustellen, dass die Regel ordnungsgemäß funktioniert.

So senden Sie Testereignisse (Konsole)
  1. Öffnen Sie die EventBridge Amazon-Konsole unter https://console.aws.amazon.com/events/.

  2. Wählen Sie im Navigationsbereich die Option Event Buses (Ereignisbusse) aus.

  3. Wählen Sie in der Kachel Standard-Event-Bus die Optionen Aktionen, Ereignisse senden aus.

  4. Geben Sie eine Ereignisquelle ein. z. B. TestEvent.

  5. Geben Sie für Detailtyp customerCreated ein.

  6. Geben Sie für Ereignisdetail {} ein.

  7. Wählen Sie Send (Senden) aus.

Schritt 5: Bestätigen des Erfolgs

Wenn Sie von AWS Benachrichtigungen eine E-Mail erhalten, die der erwarteten Ausgabe entspricht, haben Sie das Tutorial erfolgreich abgeschlossen.

Schritt 6: Bereinigen Ihrer Ressourcen

Sie können jetzt die Ressourcen, die Sie für dieses Tutorial erstellt haben, löschen, es sei denn, Sie möchten sie behalten. Indem Sie AWS Ressourcen löschen, die Sie nicht mehr verwenden, verhindern Sie, dass Ihr AWS Konto unnötig belastet wird.

Um das SNS Thema zu löschen
  1. Öffnen Sie die Themenseite der SNS Konsole.

  2. Wählen Sie das Thema aus, das Sie erstellt haben.

  3. Wählen Sie Löschen aus.

  4. Geben Sie delete me ein.

  5. Wählen Sie Löschen aus.

Um das SNS Abonnement zu löschen
  1. Öffnen Sie die Abonnementseite der SNS Konsole.

  2. Wählen Sie das von Ihnen erstellte Abonnement aus.

  3. Wählen Sie Delete (Löschen).

  4. Wählen Sie Delete (Löschen).

Um die EventBridge Regel (n) zu löschen
  1. Öffnen Sie die Regelseite der EventBridge Konsole.

  2. Wählen Sie die Regel(n) aus, die Sie erstellt haben.

  3. Wählen Sie Delete (Löschen).

  4. Wählen Sie Löschen.