

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
<a name="eb-input-transformer-tutorial"></a>

Sie können den [Eingangstransformator](eb-transform-target-input.md) verwenden EventBridge, um den Text eines [Ereignisses](eb-events.md) anzupassen, bevor Sie ihn an das Ziel einer [Regel](eb-rules.md) senden. 

Dazu definieren Sie JSON-Pfade aus dem Ereignis und weisen ihre Ausgaben unterschiedlichen 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](eb-transform-target-input.md)

**Anmerkung**  
Wenn Sie eine Variable angeben, die einem JSON-Pfad entspricht, der im Ereignis nicht vorhanden ist, wird diese Variable nicht erstellt und nicht in der Ausgabe angezeigt.

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

```
"This event was of customerCreated type."
```

**Topics**
+ [Schritt 1: Erstellen eines Amazon-SNS-Themas](#eb-input-transformer-tutorial-create-topic)
+ [Schritt 2: Erstellen eines Amazon-SNS-Abonnements](#eb-input-transformer-tutorial-create-sns)
+ [Schritt 3: Erstellen einer Regel](#eb-input-transformer-create-rule)
+ [Schritt 4: Senden von Testereignissen](#eb-input-transformer-send-test-events)
+ [Schritt 5: Bestätigen des Erfolgs](#success)
+ [Schritt 6: Bereinigen Ihrer Ressourcen](#cleanup)

## Schritt 1: Erstellen eines Amazon-SNS-Themas
<a name="eb-input-transformer-tutorial-create-topic"></a>

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

**Erstellen Sie ein Thema wie folgt**

1. Öffnen Sie die Amazon SNS SNS-Konsole unter [https://console.aws.amazon.com/sns/v3/home](https://console.aws.amazon.com/sns/v3/home).

1. Wählen Sie im Navigationsbereich **Themen** aus.

1. Wählen Sie **Thema erstellen** aus.

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

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

1. Wählen Sie **Thema erstellen** aus.

## Schritt 2: Erstellen eines Amazon-SNS-Abonnements
<a name="eb-input-transformer-tutorial-create-sns"></a>

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

**Erstellen eines Abonnements**

1. Öffnen Sie die Amazon SNS SNS-Konsole unter [https://console.aws.amazon.com/sns/v3/home](https://console.aws.amazon.com/sns/v3/home).

1. Wählen Sie im Navigationsbereich **Subscriptions** aus.

1. Wählen Sie **Create subscription**.

1. Wählen Sie für **Thema-ARN** das in Schritt 1 erstellte Thema aus. Wählen Sie für dieses Tutorial **eventbridge-IT-test** aus.

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

1. Geben Sie unter **Endpunkt** Ihre E-Mail-Adresse ein.

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

1. 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
<a name="eb-input-transformer-create-rule"></a>

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/](https://console.aws.amazon.com/events/).

1. Wählen Sie im Navigationsbereich **Regeln** aus.

1. Wählen Sie **Regel erstellen** aus.

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

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

1. Bei **Regeltyp** wählen Sie **Regel mit einem Ereignismuster** aus.

1. Wählen Sie **Weiter**.

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

1. Geben Sie für **Ereignismuster** Folgendes ein:

   ```
   {
     "detail-type": [
       "customerCreated"
     ]
   }
   ```

1. Wählen Sie **Weiter**.

1. Bei **Zieltypen** wählen Sie **AWS -Service** aus.

1. Wählen Sie für **Ziel auswählen** die Option **SNS-Thema** aus der Dropdown-Liste aus.

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

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

   1. Wählen Sie **Eingabe-Transformator konfigurieren** aus.

   1. Geben Sie für **Beispielereignisse** Folgendes ein:

      ```
      {
        "detail-type": "customerCreated"
      }
      ```

   1. Gehen Sie für **Zieleingabe-Transformator** wie folgt vor:

      1. Geben Sie für **Eingabepfad** Folgendes ein:

         ```
         {"detail-type":"$.detail-type"}
         ```

      1. Geben Sie für **Eingabevorlage** Folgendes ein:

         ```
         "This event was of <detail-type> type."
         ```

   1. Wählen Sie **Bestätigen** aus.

1. Wählen Sie **Weiter**.

1. Wählen Sie **Weiter**.

1. Überprüfen Sie die Details der Regel und wählen Sie dann **Regel erstellen** aus.

## Schritt 4: Senden von Testereignissen
<a name="eb-input-transformer-send-test-events"></a>

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/](https://console.aws.amazon.com/events/).

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

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

1. Geben Sie eine Ereignisquelle ein. Beispiel, `TestEvent`.

1. Geben Sie für **Detailtyp** `customerCreated` ein.

1. Geben Sie für **Ereignisdetail** `{}` ein.

1. Wählen Sie **Send (Senden)** aus.

## Schritt 5: Bestätigen des Erfolgs
<a name="success"></a>

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
<a name="cleanup"></a>

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.

**So löschen Sie das SNS-Thema**

1. Öffnen Sie die Seite [Themen](https://console.aws.amazon.com/sns/v3/home#/topics) der SNS-Konsole.

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

1. Wählen Sie **Löschen**.

1. Geben Sie **delete me** ein.

1. Wählen Sie **Löschen**.

**So löschen Sie das SNS-Abonnement**

1. Öffnen Sie die Seite [Abonnements](https://console.aws.amazon.com/sns/v3/home#/subscriptions) der SNS-Konsole.

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

1. Wählen Sie **Delete (Löschen)**.

1. Wählen Sie **Delete (Löschen)**.

**Um die EventBridge Regel (n) zu löschen**

1. Öffnen Sie die [Seite Regeln](https://console.aws.amazon.com/events/home#/rules) der EventBridge Konsole.

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

1. Wählen Sie **Delete (Löschen)**.

1. Wählen Sie **Löschen**.