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.
Regeln erstellen, die auf Ereignisse in Amazon reagieren EventBridge
Um bei Amazon eingegangenen Ereignissen Maßnahmen zu ergreifen EventBridge, können Sie Regeln erstellen. Wenn ein Ereignis dem in Ihrer Regel definierten Ereignismuster entspricht, wird das Ereignis an das angegebene Ziel EventBridge gesendet und die in der Regel definierte Aktion ausgelöst.
Das folgende Video zeigt, wie verschiedene Arten von Regeln erstellt werden und wie man sie testet:
In den folgenden Schritten erfahren Sie, wie Sie eine Regel erstellen, EventBridge die Ereignisse abgleicht, wenn sie an den angegebenen Event-Bus gesendet werden.
Definieren der Regel
Geben Sie zunächst einen Namen und eine Beschreibung für die Regel ein, um sie zu identifizieren. Sie müssen auch den Event Bus definieren, in dem die Regel nach Ereignissen sucht, die einem Ereignismuster entsprechen.
So definieren Sie die Regeldetails
Öffnen Sie die EventBridge Amazon-Konsole unter https://console.aws.amazon.com/events/.
-
Wählen Sie im Navigationsbereich Rules aus.
-
Wählen Sie Regel erstellen aus.
-
Geben Sie für die Regel einen Namen und optional eine Beschreibung ein.
Eine Regel kann nicht denselben Namen haben wie eine andere Regel im selben AWS-Region und im selben Event-Bus.
-
Wählen Sie für Event Bus den Event Bus aus, der dieser Regel zugeordnet werden soll. Wenn Sie möchten, dass diese Regel mit Ereignissen aus Ihrem eigenen Konto übereinstimmt, wählen Sie AWS -Standard-Event-Bus aus. Wenn ein AWS-Service in Ihrem Konto ein Ereignis ausgibt, wird es immer an den Standard-Event-Bus Ihres Kontos weitergeleitet.
-
Bei Rule type (Regeltyp) wählen Sie Rule with an event pattern (Regel mit einem Ereignismuster) aus.
-
Wählen Sie Weiter aus.
Erstellen des Ereignismusters
Als Nächstes erstellen Sie das Ereignismuster. Geben Sie dazu die Ereignisquelle an, wählen Sie die Grundlage für das Ereignismuster aus und definieren Sie die Attribute und Werte, anhand derer abgeglichen werden soll. Sie können das Ereignismuster auch in einem Beispielereignis generieren JSON und es anhand eines Beispielereignisses testen.
So erstellen Sie das Ereignismuster
-
Wählen Sie als Ereignisquelle AWS Ereignisse oder EventBridge Partnerereignisse aus.
-
(Optional) Wählen Sie im Abschnitt Beispielereignisse einen Beispiel-Ereignistyp aus, anhand dessen Sie das Ereignismuster testen möchten.
Die folgenden Beispiel-Ereignistypen sind verfügbar:
-
AWS Ereignisse — Wählen Sie unter „Unterstützte Ereignisse“ aus AWS-Services.
-
EventBridge Partnerereignisse — Wählen Sie aus Ereignissen aus EventBridge, die von unterstützenden Drittanbieterdiensten wie Salesforce gesendet werden.
-
Mein eigenes Ereignis eingeben — Geben Sie Ihr eigenes Ereignis als JSON Text ein.
Sie können auch eine Veranstaltung AWS oder eine Partnerveranstaltung als Ausgangspunkt für die Erstellung Ihrer eigenen benutzerdefinierten Veranstaltung verwenden.
Wählen Sie AWS Veranstaltungen oder EventBridge Partnerveranstaltungen aus.
Verwenden Sie das Dropdown-Menü Beispielereignisse, um das Ereignis auszuwählen, das Sie als Ausgangspunkt für Ihr benutzerdefiniertes Ereignis verwenden möchten.
EventBridge zeigt das Beispielereignis an.
Wählen Sie Kopieren aus.
Wählen Sie Mein eigenes eingeben für Ereignistyp aus.
Löschen Sie die Beispiel-Eventstruktur im JSON Bearbeitungsbereich und fügen Sie das Event AWS oder das Partnerereignis an seiner Stelle ein.
Bearbeiten Sie das EreignisJSON, um Ihr eigenes Beispielereignis zu erstellen.
-
Wählen Sie eine Erstellungsmethode aus. Sie können ein Ereignismuster anhand eines EventBridge Schemas oder einer Vorlage erstellen, oder Sie können ein benutzerdefiniertes Ereignismuster erstellen.
- Existing schema
-
Gehen Sie wie folgt vor, um ein vorhandenes EventBridge Schema zum Erstellen des Ereignismusters zu verwenden:
-
Wählen Sie im Abschnitt Erstellungsmethode für Methode die Option Schema verwenden aus.
-
Wählen Sie im Abschnitt Ereignismuster für Schematyp die Option Schema aus der Schemaregistrierung auswählen aus.
-
Wählen Sie für Schemaregistrierung das Dropdown-Feld aus und geben Sie den Namen einer Schemaregistrierung ein, z. B. aws.events
. Sie können auch eine Option aus der angezeigten Dropdown-Liste auswählen.
-
Wählen Sie für Schema das Dropdown-Feld aus und geben Sie den Namen des zu verwendenden Schemas ein. z. B. aws.s3@ObjectDeleted
. Sie können auch eine Option aus der angezeigten Dropdown-Liste auswählen.
-
Klicken Sie im Bereich Modelle neben einem beliebigen Attribut auf die Schaltfläche Bearbeiten, um dessen Eigenschaften zu öffnen. Stellen Sie die Felder Beziehung und Wert nach Bedarf ein und wählen Sie dann Einrichten aus, um das Attribut zu speichern.
Informationen zur Definition eines Attributs erhalten Sie, wenn Sie das Infosymbol neben dem Namen des Attributs auswählen. Eine Referenz zum Einrichten von Attributeigenschaften in Ihrem Ereignis finden Sie im Abschnitt Notiz des Dialogfelds mit den Attributeigenschaften.
Zum Löschen der Eigenschaften eines Attributs klicken Sie auf die Schaltfläche Bearbeiten für dieses Attribut und anschließend auf Löschen.
-
Wählen Sie Ereignismuster generieren in JSON, um Ihr Ereignismuster als JSON Text zu generieren und zu validieren.
-
(Optional) Zum Testen des Beispielereignisses anhand Ihres Testmusters wählen Sie Testmuster aus.
EventBridge zeigt ein Meldungsfeld an, in dem angegeben wird, ob Ihr Beispielereignis mit dem Ereignismuster übereinstimmt.
Sie können auch eine der folgenden Optionen wählen:
-
Kopieren – Kopiert das Ereignismuster in die Zwischenablage Ihres Geräts.
-
Prettify — Macht den JSON Text durch Hinzufügen von Zeilenumbrüchen, Tabulatoren und Leerzeichen lesbarer.
- Custom schema
-
Gehen Sie wie folgt vor, um ein benutzerdefiniertes Schema zu erstellen und es in ein Ereignismuster zu konvertieren:
-
Wählen Sie im Abschnitt Erstellungsmethode für Methode die Option Schema verwenden aus.
-
Wählen Sie im Abschnitt Ereignismuster für Schematyp die Option Schema eingeben aus.
-
Geben Sie Ihr Schema in das Textfeld ein. Sie müssen das Schema als gültigen JSON Text formatieren.
-
Klicken Sie im Bereich Modelle neben einem beliebigen Attribut auf die Schaltfläche Bearbeiten, um dessen Eigenschaften zu öffnen. Stellen Sie die Felder Beziehung und Wert nach Bedarf ein und wählen Sie dann Einrichten aus, um das Attribut zu speichern.
Informationen zur Definition eines Attributs erhalten Sie, wenn Sie das Infosymbol neben dem Namen des Attributs auswählen. Eine Referenz zum Einrichten von Attributeigenschaften in Ihrem Ereignis finden Sie im Abschnitt Notiz des Dialogfelds mit den Attributeigenschaften.
Zum Löschen der Eigenschaften eines Attributs klicken Sie auf die Schaltfläche Bearbeiten für dieses Attribut und anschließend auf Löschen.
-
Wählen Sie unter Ereignismuster generieren ausJSON, um Ihr Ereignismuster als JSON Text zu generieren und zu validieren.
-
(Optional) Zum Testen des Beispielereignisses anhand Ihres Testmusters wählen Sie Testmuster aus.
EventBridge zeigt ein Meldungsfeld an, in dem angegeben wird, ob Ihr Beispielereignis mit dem Ereignismuster übereinstimmt.
Sie können auch eine der folgenden Optionen wählen:
-
Kopieren – Kopiert das Ereignismuster in die Zwischenablage Ihres Geräts.
-
Prettify — Macht den JSON Text durch Hinzufügen von Zeilenumbrüchen, Tabulatoren und Leerzeichen lesbarer.
- Event pattern
-
Gehen Sie wie folgt vor, um ein benutzerdefiniertes Ereignismuster im JSON Format zu schreiben:
-
Wählen Sie im Abschnitt Erstellungsmethode für Methode die Option Benutzerdefiniertes Muster (JSONEditor) aus.
-
Geben Sie unter Ereignismuster Ihr benutzerdefiniertes Ereignismuster in JSON -formatiertem Text ein.
-
(Optional) Zum Testen des Beispielereignisses anhand Ihres Testmusters wählen Sie Testmuster aus.
EventBridge zeigt ein Meldungsfeld an, in dem angegeben wird, ob Ihr Beispielereignis mit dem Ereignismuster übereinstimmt.
Sie können auch eine der folgenden Optionen wählen:
-
Kopieren – Kopiert das Ereignismuster in die Zwischenablage Ihres Geräts.
-
Prettify — Macht den JSON Text durch Hinzufügen von Zeilenumbrüchen, Tabulatoren und Leerzeichen lesbarer.
-
Ereignismusterformular – Öffnet das Ereignismuster in Pattern Builder. Wenn das Muster in Pattern Builder nicht unverändert gerendert werden kann, werden Sie EventBridge gewarnt, bevor Pattern Builder geöffnet wird.
-
Wählen Sie Weiter aus.
Auswählen von Zielen
Wählen Sie ein oder mehrere Ziele aus, um Ereignisse zu empfangen, die dem angegebenen Muster entsprechen. Zu den Zielen können ein EventBridge Eventbus, EventBridge API Ziele, einschließlich SaaS-Partner wie Salesforce, oder andere gehören AWS-Service.
So wählen Sie Ziele aus
-
Wählen Sie für Zieltyp einen der folgenden Zieltypen aus:
- Event bus
-
Um einen EventBridge Event-Bus auszuwählen, wählen Sie EventBridge Event-Bus aus und gehen dann wie folgt vor:
- API destination
-
Um ein EventBridge API Ziel zu verwenden, wählen Sie EventBridge APIZiel aus und führen Sie dann einen der folgenden Schritte aus:
-
Um ein vorhandenes API Ziel zu verwenden, wählen Sie Bestehendes API Ziel verwenden aus. Wählen Sie dann ein API Ziel aus der Drop-down-Liste aus.
-
Um ein neues API Ziel zu erstellen, wählen Sie Neues API Ziel erstellen aus. Geben Sie anschließend die folgenden Details für das Ziel an:
-
Name – Geben Sie einen Namen für das Ziel ein.
Namen müssen innerhalb Ihres AWS-Konto-Kontos eindeutig sein. Namen können bis zu 64 Zeichen lang sein. Gültige Zeichen sind A-Z, a-z, 0-9 und . _ - (Bindestrich).
-
(Optional) Beschreibung – Geben Sie eine Beschreibung für das Ziel ein.
Beschreibungen können bis zu 512 Zeichen lang sein.
-
APIZielendpunkt — Der URL Endpunkt für das Ziel.
Der Endpunkt URL muss mit beginnenhttps
. Sie können das *
als Pfadparameterplatzhalter angeben. Sie können Pfadparameter über das HttpParameters
-Attribut des Ziels festlegen.
-
HTTPMethode — Wählen Sie die HTTP Methode aus, die beim Aufrufen des Endpunkts verwendet wurde.
-
(Optional) Begrenzung der Aufrufrate pro Sekunde – Geben Sie die maximale Anzahl von Aufrufen ein, die pro Sekunde für dieses Ziel akzeptiert werden.
Dieser Wert muss größer als null sein. Standardmäßig ist dieser Wert auf 300 festgelegt.
-
Verbindung – Wählen Sie, ob Sie eine neue oder eine vorhandene Verbindung verwenden möchten:
Zum Verwenden einer vorhandenen Verbindung wählen Sie Vorhandene Verbindung verwenden und die Verbindung aus der Dropdown-Liste aus.
Zum Erstellen einer neuen Verbindung für dieses Ziel wählen Sie Neue Verbindung erstellen aus und definieren dann den Namen, den Zieltyp und den Autorisierungstyp der Verbindung. Sie können auch eine optionale Beschreibung für diese Verbindung hinzufügen.
Weitere Informationen finden Sie unter APIZiele als Ziele bei Amazon EventBridge.
- AWS-Service
-
Um eine zu verwenden AWS-ServiceAWS-Service, wählen Sie aus und gehen Sie dann wie folgt vor:
-
Wählen Sie für Ziel auswählen einen AWS-Service aus, der als Ziel verwendet werden soll. Geben Sie die angeforderten Informationen für den ausgewählten Service ein.
-
Für viele Zieltypen sind EventBridge Berechtigungen erforderlich, um Ereignisse an das Ziel zu senden. In diesen Fällen EventBridge kann die IAM Rolle erstellt werden, die für die Ausführung Ihrer Regel erforderlich ist.
Führen Sie für Ausführungsrolle einen der folgenden Schritte aus:
-
Gehen Sie wie folgt vor, um eine neue Ausführungsrolle für diese Regel zu erstellen:
Wählen Sie Eine neue Rolle für diese spezifische Ressource erstellen aus.
Geben Sie entweder einen Namen für diese Ausführungsrolle ein, oder verwenden Sie den Namen, der von generiert wurde EventBridge.
-
So verwenden Sie eine vorhandene Ausführungsrolle für diese Regel:
Wählen Sie Vorhandene Rolle verwenden aus.
Geben Sie den Namen der zu verwendenden Ausführungsrolle ein oder wählen Sie ihn aus der Dropdown-Liste aus.
-
(Optional) Geben Sie für Zusätzliche Einstellungen eine der optionalen Einstellungen an, die für Ihren Zieltyp verfügbar sind:
- Event bus
-
(Optional) Wählen Sie für die Warteschlange für unzustellbare Briefe aus, ob Sie eine standardmäßige SQS Amazon-Warteschlange als Warteschlange für unzustellbare Briefe verwenden möchten. EventBridge sendet Ereignisse, die dieser Regel entsprechen, an die Warteschlange für unzustellbare Briefe, wenn sie nicht erfolgreich an das Ziel zugestellt wurden. Führen Sie eine der folgenden Aktionen aus:
-
Klicken Sie auf Keine, um keine Warteschlange für unzustellbare Nachrichten zu verwenden.
-
Wählen Sie Wählen Sie eine SQS Amazon-Warteschlange im aktuellen AWS
Konto aus, die als Warteschlange für eingehende Briefe verwendet werden soll, und wählen Sie dann die zu verwendende Warteschlange aus der Drop-down-Liste aus.
-
Wählen Sie Wählen Sie eine SQS Amazon-Warteschlange in einem anderen AWS
Konto als Warteschlange für eingehende Briefe aus und geben Sie dann die ARN Warteschlange ein, die Sie verwenden möchten. Sie müssen der Warteschlange eine ressourcenbasierte Richtlinie hinzufügen, die das Senden von Nachrichten an die Warteschlange EventBridge gestattet.
Weitere Informationen finden Sie unter Erteilen von Berechtigungen für die Warteschlange für unzustellbare Nachrichten.
- API destination
-
-
(Optional) Wählen Sie für „Zieleingabe konfigurieren“ aus, wie Sie den an das Ziel gesendeten Text für passende Ereignisse anpassen möchten. Wählen Sie eine der folgenden Optionen aus:
-
Übereinstimmende Ereignisse — EventBridge sendet das gesamte ursprüngliche Quellereignis an das Ziel. Dies ist die Standardeinstellung.
-
Teil der übereinstimmenden Ereignisse — sendet EventBridge nur den angegebenen Teil des ursprünglichen Quellereignisses an das Ziel.
Geben Sie unter Geben Sie den Teil des übereinstimmenden Ereignisses an einen JSON Pfad an, der den Teil des Ereignisses definiert EventBridge , den Sie an das Ziel senden möchten.
-
Konstante (JSONText) — EventBridge sendet nur den angegebenen JSON Text an das Ziel. Es wird kein Teil des ursprünglichen Quellereignisses gesendet.
Geben Sie unter Konstante angeben in JSON den JSON Text an, den Sie an das Ziel statt an das Ereignis senden möchten EventBridge .
-
Eingangstransformator — Konfigurieren Sie einen Eingangstransformator, um den Text, den Sie an das Ziel EventBridge senden möchten, anzupassen. Weitere Informationen finden Sie unter Transformation Amazon EventBridge Amazon-Eingaben.
-
(Optional) Geben Sie unter Wiederholungsrichtlinie an, wie erneut versucht EventBridge werden soll, ein Ereignis an ein Ziel zu senden, nachdem ein Fehler aufgetreten ist.
-
Maximales Alter des Ereignisses — Geben Sie die maximale Dauer (in Stunden, Minuten und Sekunden) ein, für die unverarbeitete Ereignisse aufbewahrt werden EventBridge sollen. Die Standardeinstellung ist 24 Stunden.
-
Wiederholungsversuche — Geben Sie ein, wie oft nach dem Auftreten eines Fehlers maximal versucht werden EventBridge soll, ein Ereignis an das Ziel zu senden. Die Standardeinstellung ist 185 Mal.
-
(Optional) Wählen Sie für die Warteschlange für unzustellbare Briefe aus, ob Sie eine standardmäßige SQS Amazon-Warteschlange als Warteschlange für unzustellbare Briefe verwenden möchten. EventBridge sendet Ereignisse, die dieser Regel entsprechen, an die Warteschlange für unzustellbare Briefe, wenn sie nicht erfolgreich an das Ziel zugestellt wurden. Führen Sie eine der folgenden Aktionen aus:
-
Klicken Sie auf Keine, um keine Warteschlange für unzustellbare Nachrichten zu verwenden.
-
Wählen Sie Wählen Sie eine SQS Amazon-Warteschlange im aktuellen AWS Konto aus, die als Warteschlange für eingehende Briefe verwendet werden soll, und wählen Sie dann die zu verwendende Warteschlange aus der Drop-down-Liste aus.
-
Wählen Sie Wählen Sie eine SQS Amazon-Warteschlange in einem anderen AWS Konto als Warteschlange für eingehende Briefe aus und geben Sie dann die ARN Warteschlange ein, die Sie verwenden möchten. Sie müssen der Warteschlange eine ressourcenbasierte Richtlinie hinzufügen, die das Senden von Nachrichten an die Warteschlange EventBridge gestattet.
Weitere Informationen finden Sie unter Erteilen von Berechtigungen für die Warteschlange für unzustellbare Nachrichten.
- AWS service
-
Beachten Sie, dass EventBridge möglicherweise nicht alle der folgenden Felder für einen bestimmten AWS Dienst angezeigt werden.
-
(Optional) Wählen Sie für „Zieleingabe konfigurieren“ aus, wie Sie den an das Ziel gesendeten Text für passende Ereignisse anpassen möchten. Wählen Sie eine der folgenden Optionen aus:
-
Übereinstimmende Ereignisse — EventBridge sendet das gesamte ursprüngliche Quellereignis an das Ziel. Dies ist die Standardeinstellung.
-
Teil der übereinstimmenden Ereignisse — sendet EventBridge nur den angegebenen Teil des ursprünglichen Quellereignisses an das Ziel.
Geben Sie unter Geben Sie den Teil des übereinstimmenden Ereignisses an einen JSON Pfad an, der den Teil des Ereignisses definiert EventBridge , den Sie an das Ziel senden möchten.
-
Konstante (JSONText) — EventBridge sendet nur den angegebenen JSON Text an das Ziel. Es wird kein Teil des ursprünglichen Quellereignisses gesendet.
Geben Sie unter Konstante angeben in JSON den JSON Text an, den Sie an das Ziel statt an das Ereignis senden möchten EventBridge .
-
Eingangstransformator — Konfigurieren Sie einen Eingangstransformator, um den Text, den Sie an das Ziel EventBridge senden möchten, anzupassen. Weitere Informationen finden Sie unter Transformation Amazon EventBridge Amazon-Eingaben.
-
(Optional) Geben Sie unter Wiederholungsrichtlinie an, wie erneut versucht EventBridge werden soll, ein Ereignis an ein Ziel zu senden, nachdem ein Fehler aufgetreten ist.
-
Maximales Alter des Ereignisses — Geben Sie die maximale Dauer (in Stunden, Minuten und Sekunden) ein, für die unverarbeitete Ereignisse aufbewahrt werden EventBridge sollen. Die Standardeinstellung ist 24 Stunden.
-
Wiederholungsversuche — Geben Sie ein, wie oft nach dem Auftreten eines Fehlers maximal versucht werden EventBridge soll, ein Ereignis an das Ziel zu senden. Die Standardeinstellung ist 185 Mal.
-
(Optional) Wählen Sie für die Warteschlange für unzustellbare Briefe aus, ob Sie eine standardmäßige SQS Amazon-Warteschlange als Warteschlange für unzustellbare Briefe verwenden möchten. EventBridge sendet Ereignisse, die dieser Regel entsprechen, an die Warteschlange für unzustellbare Briefe, wenn sie nicht erfolgreich an das Ziel zugestellt wurden. Führen Sie eine der folgenden Aktionen aus:
-
Klicken Sie auf Keine, um keine Warteschlange für unzustellbare Nachrichten zu verwenden.
-
Wählen Sie Wählen Sie eine SQS Amazon-Warteschlange im aktuellen AWS Konto aus, die als Warteschlange für eingehende Briefe verwendet werden soll, und wählen Sie dann die zu verwendende Warteschlange aus der Drop-down-Liste aus.
-
Wählen Sie Wählen Sie eine SQS Amazon-Warteschlange in einem anderen AWS Konto als Warteschlange für eingehende Briefe aus und geben Sie dann die ARN Warteschlange ein, die Sie verwenden möchten. Sie müssen der Warteschlange eine ressourcenbasierte Richtlinie hinzufügen, die das Senden von Nachrichten an die Warteschlange EventBridge gestattet.
Weitere Informationen finden Sie unter Erteilen von Berechtigungen für die Warteschlange für unzustellbare Nachrichten.
-
(Optional) Wählen Sie Add another target (Weiteres Ziel hinzufügen) aus, um ein weiteres Ziel für diese Regel hinzuzufügen.
-
Wählen Sie Weiter aus.
Beachten Sie, dass EventBridge möglicherweise nicht alle der folgenden Felder für einen bestimmten AWS Dienst angezeigt werden.
Konfigurieren von Tags und Überprüfen von Regeln
Geben Sie abschließend alle gewünschten Tags für die Regel ein, überprüfen und erstellen Sie dann die Regel.
So konfigurieren Sie Tags und überprüfen und erstellen die Regel
-
(Optional) Geben Sie ein oder mehrere Tags für die Regel ein. Weitere Informationen finden Sie unter Ressourcen in Amazon taggen EventBridge.
-
Wählen Sie Weiter.
-
Überprüfen Sie die Details der neuen Regel. Um Änderungen an einem Abschnitt vorzunehmen, wählen Sie neben diesem Abschnitt die Schaltfläche Bearbeiten aus.
Wenn Sie mit den Regeldetails zufrieden sind, wählen Sie Regel erstellen aus.