CloudEvents Ereignisse an API Ziele senden

CloudEvents ist eine herstellerneutrale Spezifikation für die Formatierung von Ereignissen mit dem Ziel, Interoperabilität zwischen Diensten, Plattformen und Systemen zu gewährleisten. Sie können sie verwenden EventBridge , um AWS Dienstereignisse so umzuwandeln CloudEvents , dass sie an ein Ziel, wie z. B. ein Ziel, gesendet werden. API

Anmerkung

Das folgende Verfahren erklärt, wie Quellereignisse in den strukturierten CloudEvents Modus umgewandelt werden. In der CloudEvents Spezifikation ist eine Nachricht im strukturierten Modus eine Nachricht, bei der das gesamte Ereignis (Attribute und Daten) in der Nutzlast des Ereignisses kodiert ist.

Weitere Informationen zur Spezifikation finden Sie unter cloudevents.io CloudEvents .

Um AWS Ereignisse mithilfe der Konsole in das CloudEvents Format umzuwandeln

Um Ereignisse in das CloudEvents Format vor der Übermittlung an ein Ziel umzuwandeln, erstellen Sie zunächst eine Event-Bus-Regel. Im Rahmen der Definition der Regel verwenden Sie einen Eingangstransformator für Transformationsereignisse, bevor sie an das von Ihnen angegebene Ziel gesendet werden. EventBridge

1. Befolgen Sie die Schritte im Verfahren Regeln erstellen, die auf Ereignisse in Amazon reagieren EventBridge.

2. Wenn Sie in Auswählen von Zielen diesem Schritt aufgefordert werden, ein API Ziel als Zieltyp auszuwählen, gehen Sie wie folgt vor:

   1. Wählen Sie EventBridge APIein Ziel aus.

   2. Führen Sie eine der folgenden Aktionen aus:

      • Wählen Sie „Bestehendes API Ziel verwenden“ und wählen Sie ein vorhandenes API Ziel aus

      • Wählen Sie Neues API Ziel erstellen und geben Sie die erforderlichen Einstellungen an, um Ihr neues API Ziel zu definieren.

        Weitere Informationen zur Angabe der erforderlichen Einstellungen finden Sie unterEin API Ziel in Amazon erstellen EventBridge.

   3. Geben Sie die erforderlichen Content-Type-Header-Parameter für die Ereignisse an CloudEvents :

      • Wählen Sie unter Header-Parameter die Option Header-Parameter hinzufügen aus.

      • Geben Sie als Schlüssel anContent-Type.

        Geben Sie als Wert anapplication/cloudevents+json; charset=UTF-8.

3. Geben Sie eine Ausführungsrolle für Ihr Ziel an.

4. Definieren Sie einen Eingangstransformator, um die Quellereignisdaten in das folgende CloudEvents Format umzuwandeln:

   1. Wählen Sie unter Zusätzliche Einstellungen für Zieleingabe konfigurieren die Option Eingangstransformator aus.

      Wählen Sie dann Eingangstransformator konfigurieren.

   2. Geben Sie unter Zieleingangstransformator den Eingabepfad an.

      Im Eingabepfad unten ist das Regionsattribut ein benutzerdefiniertes Erweiterungsattribut des CloudEvents Formats. Daher ist es für die Einhaltung der CloudEvents Spezifikation nicht erforderlich.

      CloudEvents ermöglicht es Ihnen, Erweiterungsattribute zu verwenden und zu erstellen, die nicht in der Kernspezifikation definiert sind. Weitere Informationen, einschließlich einer Liste bekannter Erweiterungsattribute, finden Sie unter CloudEvents Erweiterungsattribute in der CloudEvents Spezifikationsdokumentation von GitHub.

      {
        "detail": "$.detail",
        "detail-type": "$.detail-type",
        "id": "$.id",
        "region": "$.region",
        "source": "$.source",
        "time": "$.time"
      }

   3. Geben Sie unter Vorlage die Vorlage ein, um die Quellereignisdaten in das CloudEvents Format umzuwandeln.

      In der Vorlage unten region ist dies nicht unbedingt erforderlich, da das region Attribut im Eingabepfad ein Erweiterungsattribut der CloudEvents Spezifikation ist.

      {
        "specversion":"1.0",
        "id":<id>,
        "source":<source>,
        "type":<detail-type>,
        "time":<time>,
        "region":<region>,
        "data":<detail>
      }

5. Schließen Sie die Erstellung der Regel gemäß den Verfahrensschritten ab.