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.

# CloudEvents Ereignisse an API-Ziele senden
<a name="eb-api-destinations-cloudevents"></a>

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, z. B. ein API-Ziel, gesendet werden.

**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 .](https://cloudevents.io/)

**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 mit dem Enhanced Builder erstellen](eb-create-rule-visual.md).

1. Wenn Sie in dem [Auswählen von Zielen](eb-create-rule-wizard.md#eb-create-rule-target) Schritt aufgefordert werden, ein API-Ziel als Zieltyp auszuwählen, gehen Sie wie folgt vor:

   1. Wählen Sie das **EventBridge API-Ziel** aus.

   1. 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 unter[Erstellen Sie ein API-Ziel in Amazon EventBridge](eb-api-destination-create.md).

   1. 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** an`Content-Type`. 

        Geben Sie als **Wert** an`application/cloudevents+json; charset=UTF-8`.

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

1. 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**.

   1. 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](https://github.com/cloudevents/spec/tree/main/cloudevents/extensions) in der [CloudEvents Spezifikationsdokumentation](https://github.com/cloudevents/spec/tree/main) von GitHub.

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

   1. 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>
      }
      ```

1. Schließen Sie die Erstellung der Regel gemäß den [Verfahrensschritten](eb-create-rule-visual.md) ab.