Konfigurieren eines Eingabe-Transformators als Teil der Erstellung einer Regel - 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.

Konfigurieren eines Eingabe-Transformators als Teil der Erstellung einer Regel

Im Rahmen der Erstellung einer Regel können Sie einen Eingangstransformator angeben, der verwendet werden EventBridge soll, um übereinstimmende Ereignisse zu verarbeiten, bevor diese Ereignisse an das angegebene Ziel gesendet werden. Sie können Eingangstransformatoren für Ziele konfigurieren, bei denen es sich um AWS Dienste oder API-Ziele handelt.

So erstellen Sie einen Zieleingabe-Transformator als Teil einer Regel

  1. Befolgen Sie die Schritte zum Erstellen einer Regel, wie unter Erstellen von Amazon-EventBridge-Regeln, die auf Ereignisse reagieren beschrieben.

  2. Erweitern Sie in Schritt 3 – Ziel(e) auswählen die Option Zusätzliche Einstellungen.

  3. Wählen Sie für Zieleingabe konfigurieren die Option Eingabe-Transformator im Dropdown-Menü aus.

    Klicken Sie auf Eingabe-Transformator konfigurieren.

    EventBridge zeigt das Dialogfeld Eingangstransformator konfigurieren an.

  4. Wählen Sie im Abschnitt Beispielereignis einen Beispiel-Ereignistyp aus, anhand dessen Sie das Ereignismuster testen möchten. Sie können ein AWS Ereignis oder ein Partnerereignis auswählen oder ein eigenes benutzerdefiniertes Ereignis eingeben.

    AWS events

    Wählen Sie aus Ereignissen aus, die von unterstützten AWS-Services ausgegeben wurden.

    1. Wählen Sie AWS -Ereignisse aus.

    2. Wählen Sie unter Beispielereignisse die gewünschte AWS Veranstaltung aus. Die Veranstaltungen werden nach AWS Service organisiert.

      Wenn Sie ein Ereignis auswählen, wird das Beispielereignis EventBridge aufgefüllt.

      Wenn Sie beispielsweise S3 Object Created wählen, EventBridge wird ein Beispielereignis vom Typ S3 Object Created angezeigt.

    3. (Optional) Sie können auch Kopieren auswählen, um das Beispielereignis in die Zwischenablage Ihres Geräts zu kopieren.

    Partner events

    Wählen Sie Ereignisse aus, die von EventBridge unterstützenden Drittanbieterdiensten wie Salesforce ausgelöst werden.

    1. Wählen Sie EventBridge Partnerereignisse aus.

    2. Wählen Sie unter Beispielereignisse das gewünschte Partnerereignis aus. Die Ereignisse sind nach Partner organisiert.

      Wenn Sie ein Ereignis auswählen, wird das Beispielereignis EventBridge aufgefüllt.

    3. (Optional) Sie können auch Kopieren auswählen, um das Beispielereignis in die Zwischenablage Ihres Geräts zu kopieren.

    Enter your own

    Geben Sie Ihr eigenes Ereignis als JSON-Text ein.

    1. Wählen Mein eigenes eingeben aus.

    2. EventBridge füllt das Beispielereignis mit einer Vorlage mit den erforderlichen Ereignisattributen auf.

    3. Bearbeiten Sie das Beispielereignis nach Bedarf und fügen Sie es hinzu. Das Beispielereignis muss gültiges JSON sein.

    4. (Optional) Sie können auch eine der folgenden Optionen wählen:

      • Kopieren – Kopiert das Beispielereignis in die Zwischenablage Ihres Geräts.

      • Verschönern – Erleichtert das Lesen des JSON-Texts durch Hinzufügen von Zeilenumbrüchen, Tabulatoren und Leerzeichen.

  5. (Optional) Erweitern Sie den Abschnitt Beispiel für Eingabepfade, Vorlagen und Ausgaben, um Beispiele für Folgendes zu sehen:

    • So werden JSON-Pfade verwendet, um Variablen zu definieren, die Ereignisdaten darstellen

    • So können diese Variablen in einer Eingabe-Transformator-Vorlage verwendet werden

    • Die resultierende Ausgabe, die EventBridge an das Ziel gesendet wird

    Ausführlichere Beispiele für Eingabetransformationen finden Sie unter Beispiele für die Eingabetransformation.

  6. Definieren Sie im Abschnitt Zieleingabe-Transformator alle Variablen, die Sie in der Eingabevorlage verwenden möchten.

    Variablen verwenden einen JSON-Pfad, um auf Werte in der ursprünglichen Ereignisquelle zu verweisen. Sie können dann in der Eingabevorlage auf diese Variablen verweisen, um Daten aus dem ursprünglichen Quellereignis in das transformierte Ereignis einzubeziehen, das EventBridge an das Ziel weitergegeben wird. Sie können bis zu 100 Variablen definieren. Der Eingabe-Transformator muss gültiges JSON sein.

    Nehmen wir beispielsweise an, Sie hätten das AWS Ereignis S3 Object Created als Beispielereignis für diesen Eingangstransformator ausgewählt. Sie könnten dann die folgenden Variablen zur Verwendung in Ihrer Vorlage definieren:

    {
  "requester": "$.detail.requester",
  "key": "$.detail.object.key",
  "bucket": "$.detail.bucket.name"
}

    (Optional) Sie können auch Kopieren auswählen, um den Eingabe-Transformator in die Zwischenablage Ihres Geräts zu kopieren.

  7. Verfassen Sie im Abschnitt Vorlage die Vorlage, anhand derer Sie bestimmen möchten, was EventBridge an das Ziel übergeben wird.

    Sie können JSON, Zeichenfolgen, statische Informationen, von Ihnen definierte Variablen sowie reservierte Variablen verwenden. Ausführlichere Beispiele für Eingabetransformationen finden Sie unter Beispiele für die Eingabetransformation.

    Angenommen, Sie haben die Variablen im vorherigen Beispiel definiert. Sie könnten dann die folgende Vorlage erstellen, die auf diese Variablen sowie auf reservierte Variablen und statische Informationen verweist.

    {
    "message": "<requester> has created the object \"<key>\" in the bucket \"<bucket>\"",
    "RuleName": <aws.events.rule-name>,
    "ruleArn" : <aws.events.rule-arn>,
    "Transformed": "Yes"
}

    (Optional) Sie können auch Kopieren auswählen, um die Vorlage in die Zwischenablage Ihres Geräts zu kopieren.

  8. Wenn Sie Ihre Vorlage testen möchten, wählen Sie Ausgabe erzeugen aus.

    EventBridge verarbeitet das Beispielereignis auf der Grundlage der Eingabevorlage und zeigt die transformierte Ausgabe an, die unter Ausgabe generiert wurde. Dies sind die Informationen, EventBridge die anstelle des ursprünglichen Quellereignisses an das Ziel weitergegeben werden.

    Die erzeugte Ausgabe für die oben beschriebene Beispiel-Eingabevorlage wäre die folgende:

    {
    "message": "123456789012 has created the object "example-key" in the bucket "example-bucket"",
    "RuleName": rule-name,
    "ruleArn" : arn:aws:events:us-east-1:123456789012:rule/rule-name,
    "Transformed": "Yes"
}

    (Optional) Sie können auch Kopieren auswählen, um die erzeugte Ausgabe in die Zwischenablage Ihres Geräts zu kopieren.

  9. Wählen Sie Bestätigen aus.

  10. Befolgen Sie die restlichen Schritte zum Erstellen einer Regel, wie unter Erstellen von Amazon-EventBridge-Regeln, die auf Ereignisse reagieren beschrieben.