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 bei Amazon EventBridge
Sie geben an, EventBridge was mit den Ereignissen geschehen soll, die an die einzelnen Event-Busse übertragen werden. Dazu erstellen Sie *Regeln*. Eine Regel gibt an, welche Ereignisse zur Verarbeitung an welche [Ziele](eb-targets.md) gesendet werden sollen. Eine einzelne Regel kann ein Ereignis an mehrere Ziele senden, die dann parallel ausgeführt werden.
Sie können zwei Arten von Regeln erstellen: Regeln, die bei der Übermittlung von Ereignissen anhand von Ereignisdaten übereinstimmen, und Regeln, die nach einem definierten Zeitplan ausgeführt werden. Darüber hinaus können bestimmte AWS Dienste auch Regeln in Ihrem Konto erstellen und verwalten.
## Regeln, die mit den Eventdaten übereinstimmen
Sie können Regeln erstellen, die auf der Grundlage von Kriterien für Ereignisdaten (ein *sogenanntes Ereignismuster*) mit eingehenden Ereignissen übereinstimmen. Ein Ereignismuster definiert die Ereignisstruktur und die Felder, denen eine Regel entspricht. Wenn ein Ereignis den im Ereignismuster definierten Kriterien entspricht, wird es EventBridge an die von Ihnen angegebenen Ziele gesendet.
Weitere Informationen finden Sie unter [Regeln in Amazon erstellen EventBridge](eb-create-rule-visual.md).
## Regeln, die nach einem Zeitplan ausgeführt werden
**Anmerkung**
Geplante Regeln sind ein veraltetes Feature von EventBridge.
EventBridgebietet eine flexiblere und leistungsfähigere Möglichkeit, geplante Aufgaben zentral und skalierbar zu erstellen, auszuführen und zu verwalten: EventBridge Scheduler. Mit EventBridge Scheduler können Sie Zeitpläne mithilfe von Cron- und Rate-Ausdrücken für wiederkehrende Muster erstellen oder einmalige Aufrufe konfigurieren. Sie können flexible Zeitfenster für die Zustellung einrichten, Wiederholungslimits definieren und die maximale Aufbewahrungszeit für fehlgeschlagene API-Aufrufe festlegen.
Scheduler ist hochgradig anpassbar und bietet eine verbesserte Skalierbarkeit im Vergleich zu geplanten Regeln sowie ein breiteres Spektrum an API-Zieloperationen und -diensten. AWS Wir empfehlen, dass Sie Scheduler verwenden, um Ziele nach einem Zeitplan aufzurufen.
Weitere Informationen finden Sie unter [Erstellen eines Zeitplans](using-eventbridge-scheduler.md#using-eventbridge-scheduler-create) oder im *[EventBridge Scheduler-Benutzerhandbuch](https://docs.aws.amazon.com/scheduler/latest/UserGuide/what-is-scheduler.html)*.
Sie können auch Regeln erstellen, die Ereignisse in bestimmten Intervallen an die angegebenen Ziele senden. Um beispielsweise eine Lambda Funktion regelmäßig auszuführen, können Sie eine Regel erstellen, die nach einem Zeitplan ausgeführt wird.
Weitere Informationen finden Sie unter [Eine geplante Regel (Legacy) in Amazon erstellen EventBridge](eb-create-rule-schedule.md).
## Von AWS Diensten verwaltete Regeln
Zusätzlich zu den Regeln, die Sie erstellen, können AWS Dienste EventBridge Regeln in Ihrem AWS Konto erstellen und verwalten, die für bestimmte Funktionen in diesen Diensten erforderlich sind. Diese werden als *verwaltete Regeln* bezeichnet.
Wenn ein Dienst eine verwaltete Regel erstellt, kann er auch eine [IAM Richtlinie](eb-iam.md) erstellen, die diesem Dienst die Erlaubnis erteilt, die Regel zu erstellen. Auf diese Weise erstellte IAM-Richtlinien sind eng mit Berechtigungen auf Ressourcenebene verbunden, um die Erstellung nur der notwendigen Regeln zu ermöglichen.
Sie können verwaltete Regeln mit der Option **Löschen erzwingen** löschen. Sie sollten sie jedoch nur löschen, wenn Sie sicher sind, dass der andere Service die Regel nicht mehr benötigt. Andernfalls führt das Löschen einer verwalteten Regel dazu, dass die Funktionen, die von ihr abhängen, nicht mehr funktionieren.
# Regeln in Amazon erstellen EventBridge
## Voraussetzungen
Stellen Sie vor Beginn sicher, dass Sie über Folgendes verfügen:
+ Zugriff auf die EventBridge Amazon-Konsole
+ Entsprechende IAM-Berechtigungen zum Erstellen von Regeln EventBridge
+ Grundlegendes Verständnis ereignisgesteuerter Architekturen
## -Übersicht
Um bei 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.
In diesem Thema erfahren Sie, wie Sie eine Regel erstellen, EventBridge mit der Ereignisse abgeglichen werden, wenn sie an den angegebenen Ereignisbus gesendet werden.
Das Erstellen von EventBridge Regeln umfasst vier Hauptschritte:
1. Wählen Sie die Ereignisse aus, die Sie verarbeiten möchten
1. Konfigurieren Sie das Filtern und Testen von Ereignissen
1. Wählen Sie Ziele aus und konfigurieren Sie sie
1. Konfigurieren Sie die Regeleinstellungen
## Wählen Sie die Ereignisse aus
Wählen Sie zunächst die Ereignisse aus, die Sie an das Ziel senden möchten.
**Um ein Ereignis auszuwählen**
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** und anschließend **Regel erstellen** aus.
1. Suchen Sie auf der Registerkarte **Ereignisse** nach den Ereignissen, die Sie an das Ziel senden möchten:
1. Wählen Sie **AWS Serviceereignisse** oder **Benutzerdefinierte Ereignisse** aus.
1. Verwenden Sie das Suchfeld oder durchsuchen Sie die Ereignisliste, um die Ereignisse zu finden, die Sie an das Ziel senden möchten.
1. Ziehen Sie ein oder mehrere Ereignisse in die **Build-Arbeitsfläche** und legen Sie sie auf **Triggering Events** ab.
EventBridge zeigt den Abschnitt **Auslösende Ereignisse** an. Dieser Abschnitt enthält:
+ **Ereignisse**: Hier wird das von Ihnen gewählte Ereignis aufgeführt.
+ **Schema**, das das Schema des ausgewählten Ereignisses anzeigt, falls verfügbar.
**Das Schema** enthält drei Registerkarten:
+ **Baum**: Eine Strukturansicht des Ereignisschemas.
+ **Code**: Das Ereignisschema im Open API-Spezifikations- oder JSON-Format.
+ **Info**: Übersichtsinformationen über das Schema.
+ **Beispielereignis**, das ein Beispiel für ein ausgewähltes Ereignis anzeigt, falls verfügbar.
+ **Ereignismuster (Filter)**, das ein Ereignismuster enthält, das alle von Ihnen ausgewählten Ereignisse auswählt.
## Filtern Sie Ereignisse, um nur das zu senden, was Sie möchten
Wahrscheinlich möchten Sie nicht *alle* Ereignisse eines bestimmten Typs an ein Ziel senden. Sie können Ihr Ereignismuster spezifischer gestalten, sodass es nur Ereignisse auswählt, die die Attribute und Werte enthalten, an denen Sie interessiert sind.
### Bearbeiten Sie das Ereignismuster (optional)
Im Bereich **Auslösende Ereignisse** können Sie das Ereignismuster auf zwei Arten erstellen:
+ Visuell mithilfe der **Schema-Strukturansicht**
+ Durch direktes Bearbeiten der JSON-Datei im Bereich „**Ereignismuster**“
**Um das Ereignismuster mithilfe der Schema-Strukturansicht zu bearbeiten**
1. Wählen Sie im **Schemabereich** die Registerkarte **Baum**.
1. Fügen Sie Filter hinzu und bearbeiten Sie sie, um das Ereignismuster zu erstellen.
1. Wählen Sie das Filtersymbol neben dem Attribut aus, das Sie dem Ereignismuster als Filter hinzufügen möchten.
1. Wählen Sie einen Vergleichsoperator aus der Dropdownliste aus.
Weitere Informationen zu Vergleichsoperatoren finden Sie unter [Ereignismuster erstellen](eb-create-pattern-operators.md).
1. Geben Sie den Wert ein, den Sie abgleichen möchten.
1. Klicken Sie auf das Häkchen, um den Vorgang abzuschließen.
EventBridge fügt den von Ihnen erstellten Filter dem JSON im Bereich **Event-Pattern** hinzu.
1. Fügen Sie weitere Filter hinzu, bis Sie ein Ereignismuster erstellt haben, das mit allen gewünschten Ereignisattributen übereinstimmt.
### Testen Sie das Ereignismuster
Nachdem Sie ein Ereignismuster erstellt haben, das allen gewünschten Ereignisattributen entspricht, testen Sie, ob das Ereignismuster erwartungsgemäß funktioniert.
#### Testen Sie das Ereignismuster (optional)
1. Wählen Sie ein Beispielereignis zum Testen aus, oder verwenden Sie Ihr eigenes.
+ **Verwenden Sie die bereitgestellten Beispielereignisse**
1. Wählen Sie **Bereitgestellte Beispielereignisse verwenden** aus.
1. Wählen Sie unter **Auslösendes Beispielereignis** aus der Dropdownliste das Ereignis aus, das zum Testen verwendet werden soll.
+ **Verwenden Sie Ihr eigenes Ereignis**
1. Wählen Sie **Eigenes Ereignis verwenden** aus.
EventBridge zeigt ein generisches Ereignis mit einem leeren `details` Element an.
1. Bearbeiten Sie die Event-JSON, um das Ereignis zu erstellen, anhand dessen Sie Ihr Ereignismuster testen möchten.
**Tipp**
Sie können die bereitgestellten Beispielereignisse als Ausgangspunkt für die Erstellung Ihrer eigenen benutzerdefinierten Ereignisse verwenden, die Sie in Ihren Tests verwenden können:
Wählen Sie **Angegebene Beispielereignisse benutzen** aus, wählen Sie ein Ereignis aus dem **Beispiel eines auslösenden Ereignisses** und dann **Kopieren** aus.
Wählen Sie **Eigenes Ereignis verwenden** aus.
Wählen Sie das gesamte Ereignis im Fenster aus und kopieren Sie das Beispielereignis darüber.
Bearbeiten Sie das Ereignis nach Belieben.
1. Wählen Sie **Test ausführen**.
EventBridge zeigt eine Meldung an, die angibt, ob das Testereignis dem Ereignismuster entspricht.
## Ziele auswählen
Ziehen Sie ein (und bis zu fünf) Ziele in die **Build-Arbeitsfläche** und legen Sie es auf **Targets ab**, um Ereignisse zu empfangen, die dem angegebenen Ereignismuster entsprechen. Zu den Zielen können gehören:
+ Andere EventBridge Eventbusse, im gleichen oder in einem anderen AWS-Konto
+ EventBridge API-Ziele, einschließlich SaaS-Partner wie Salesforce
+ Eine Reihe von AWS Serviceressourcen, wie Amazon SQS SQS-Warteschlangen oder Amazon SNS SNS-Themen
**So wählen Sie Ziele aus**
1. Wählen Sie den Zieltyp im Bereich „**Ziele**“ aus und legen Sie ihn auf der Build-Arbeitsfläche in der Form „**Ziele**“ ab.
EventBridge zeigt den Abschnitt „**Ziel**“ im Build mit den entsprechenden Konfigurationsoptionen an, die auf dem ausgewählten Zieltyp basieren.
**Tipp**
Wenn Sie mehr als ein Ziel angegeben haben, wird bei Auswahl der Zielform der Konfigurationsabschnitt für dieses Ziel angezeigt.
1. Konfigurieren Sie das Ziel auf der Grundlage Ihres Zieltyps. Detaillierte Konfigurationsschritte finden Sie unter [EventBridge Ziele](eb-targets.md).
### Passen Sie die an das Ziel gesendeten Ereignisdaten an
Wenn Sie ein anderes Ziel als ein EventBridge Eventbus- oder EventBridge API-Ziel auswählen, haben Sie die Möglichkeit, anzupassen, welche Daten tatsächlich an das Ziel übermittelt werden.
#### Transformieren oder ersetzen Sie die gesendeten Ereignisdaten (optional)
1. Wählen Sie auf der Design-Arbeitsfläche Build das Symbol für die **Eingabetransformation** in der Form **Ziele** aus.
EventBridge zeigt den Abschnitt **Eingabetransformation** an.
1. Wählen Sie unter **Konfiguration der Eingabetransformation** die Option **Aktivieren** aus.
1. Wählen Sie die Transformationsmethode aus, um auszuwählen, wie Sie den an das Ziel gesendeten Text für passende Ereignisse anpassen möchten:
+ **Teil der übereinstimmenden Ereignisse** — sendet EventBridge nur den angegebenen Teil des ursprünglichen Quellereignisses an das Ziel.
+ **Konstante (JSON-Text)** — EventBridge sendet nur den angegebenen JSON-Text an das Ziel. Es wird kein Teil des ursprünglichen Quellereignisses gesendet.
+ **Eingangstransformator** — Konfigurieren Sie einen Eingangstransformator, um den Text EventBridge , den Sie an das Ziel senden möchten, anzupassen. Weitere Informationen finden Sie unter [Transformieren der Zieleingabe](eb-transform-target-input.md).
## Konfigurieren Sie die Regel
Abschließend konfigurieren und erstellen Sie die Regel.
**Um die Regel zu konfigurieren (Konsole)**
1. Wählen Sie **Konfigurieren** aus.
1. 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.
1. 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 sendet, wird es immer an den Standard-Event-Bus Ihres Kontos weitergeleitet.
1. Um die Regel zu aktivieren, sobald sie erstellt wurde, aktivieren Sie unter **Aktivierung** die Option **Aktiv**.
1. (Optional) Geben Sie ein oder mehrere Tags für die Regel ein. Weitere Informationen finden Sie unter [Ressourcen in Amazon taggen EventBridge](eb-tagging.md).
1. Wählen Sie **Erstellen** aus.
## Nächste Schritte
Nachdem Sie Ihre Regel erstellt haben, können Sie:
+ [Überwachen Sie die Regelleistung mithilfe von Metriken](eb-monitoring.md)
+ [Testen Sie Ihre Regel anhand von Beispielereignissen](eb-event-pattern-sandbox.md)
+ [Ändern Sie die Ereignismuster nach Bedarf](eb-event-patterns.md)
+ [Fügen Sie zusätzliche Ziele zu bestehenden Regeln hinzu](eb-targets.md)
## Weitere Ressourcen
Weitere Informationen zu EventBridge Regeln finden Sie unter:
+ [EventBridge Regeln im Überblick](eb-rules.md)
+ [Ereignismuster erstellen](eb-event-patterns.md)
+ [EventBridge Ziele](eb-targets.md)
+ [ EventBridge Regeln zur Fehlerbehebung](eb-troubleshooting.md)
# Regeln erstellen, die auf Ereignisse in Amazon reagieren EventBridge
Um bei Amazon eingegangenen Ereignissen Maßnahmen zu ergreifen EventBridge, können Sie [Regeln](eb-rules.md) erstellen. Wenn ein Ereignis dem in Ihrer Regel definierten [Ereignismuster](eb-event-patterns.md) entspricht, wird das Ereignis an das angegebene [Ziel EventBridge ](eb-targets.md) gesendet und die in der Regel definierte Aktion ausgelöst.
In den folgenden Schritten erfahren Sie, wie Sie eine Regel erstellen, EventBridge die Ereignisse abgleicht, wenn sie an den angegebenen Event-Bus gesendet werden.
**Topics**
+ [Definieren der Regel](#eb-create-rule-define)
+ [Erstellen des Ereignismusters](#eb-create-rule-event-pattern)
+ [Auswählen von Zielen](#eb-create-rule-target)
+ [Konfigurieren von Tags und Überprüfen von Regeln](#eb-create-rule-review)
## 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**
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 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.
1. 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.
1. Bei **Regeltyp** wählen Sie **Regel mit einem Ereignismuster** aus.
1. 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 JSON generieren und es anhand eines Beispielereignisses testen.
**So erstellen Sie das Ereignismuster**
1. Wählen Sie als **Eventquelle AWS ** **Events oder EventBridge Partnerevents** aus.
1. (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 eingeben** – Geben Sie Ihr eigenes Ereignis als JSON-Text ein.
Sie können auch ein Ereignis AWS oder ein Partnerereignis als Ausgangspunkt für die Erstellung Ihres eigenen benutzerdefinierten Ereignisses verwenden.
1. Wählen Sie **AWS Veranstaltungen** oder **EventBridge Partnerveranstaltungen** aus.
1. 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.
1. Wählen Sie **Kopieren** aus.
1. Wählen Sie **Mein eigenes eingeben** für **Ereignistyp** aus.
1. Löschen Sie die Beispiel-Eventstruktur im JSON-Bearbeitungsbereich und fügen Sie das Ereignis AWS oder das Partnerereignis an seiner Stelle ein.
1. Bearbeiten Sie das Ereignis-JSON, um Ihr eigenes Beispielereignis zu erstellen.
1. 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:
1. Wählen Sie im Abschnitt **Erstellungsmethode** für **Methode** die Option **Schema verwenden** aus.
1. Wählen Sie im Abschnitt **Ereignismuster** für **Schematyp** die Option **Schema aus der Schemaregistrierung auswählen** aus.
1. 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.
1. Wählen Sie für **Schema** das Dropdown-Feld aus und geben Sie den Namen des zu verwendenden Schemas ein. Beispiel, `aws.s3@ObjectDeleted`. Sie können auch eine Option aus der angezeigten Dropdown-Liste auswählen.
1. 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.
**Anmerkung**
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**.
1. Wählen Sie **Ereignismuster in JSON generieren** aus, um Ihr Ereignismuster als JSON-Text zu generieren und zu validieren.
1. (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.
+ **Verschönern** – Erleichtert das Lesen des JSON-Texts durch Hinzufügen von Zeilenumbrüchen, Tabulatoren und Leerzeichen.
------
#### [ Custom schema ]
Gehen Sie wie folgt vor, um ein benutzerdefiniertes Schema zu erstellen und es in ein Ereignismuster zu konvertieren:
1. Wählen Sie im Abschnitt **Erstellungsmethode** für **Methode** die Option **Schema verwenden** aus.
1. Wählen Sie im Abschnitt **Ereignismuster** für **Schematyp** die Option **Schema eingeben** aus.
1. Geben Sie Ihr Schema in das Textfeld ein. Sie müssen das Schema als gültigen JSON-Text formatieren.
1. 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.
**Anmerkung**
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**.
1. Wählen Sie **Ereignismuster in JSON generieren** aus, um Ihr Ereignismuster als JSON-Text zu generieren und zu validieren.
1. (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 dem Ereignismuster entspricht.
Sie können auch eine der folgenden Optionen wählen:
+ **Kopieren** – Kopiert das Ereignismuster in die Zwischenablage Ihres Geräts.
+ **Verschönern** – Erleichtert das Lesen des JSON-Texts durch Hinzufügen von Zeilenumbrüchen, Tabulatoren und Leerzeichen.
------
#### [ Event pattern ]
Gehen Sie wie folgt vor, um ein benutzerdefiniertes Ereignismuster im JSON-Format zu schreiben:
1. Wählen Sie im Abschnitt **Erstellungsmethode** für **Methode** die Option **Benutzerdefiniertes Muster (JSON-Editor)** aus.
1. Geben Sie für **Ereignismuster** Ihr benutzerdefiniertes Ereignismuster in JSON-formatiertem Text ein.
1. (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 dem Ereignismuster entspricht.
Sie können auch eine der folgenden Optionen wählen:
+ **Kopieren** – Kopiert das Ereignismuster in die Zwischenablage Ihres Geräts.
+ **Verschönern** – Erleichtert das Lesen des JSON-Texts durch Hinzufügen von Zeilenumbrüchen, Tabulatoren und Leerzeichen.
+ **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.
------
1. 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 Event-Bus, EventBridge API-Ziele, einschließlich SaaS-Partner wie Salesforce, oder andere gehören AWS-Service.
**So wählen Sie Ziele aus**
1. Wählen Sie für **Zieltyp** einen der folgenden Zieltypen aus:
------
#### [ Event bus ]
1. Wählen Sie den **EventBridge Event-Bus** aus.
1. Wählen Sie den Event-Bus aus, der als Ziel verwendet werden soll.
+ Um einen Event-Bus wie in dieser AWS-Region Regel zu verwenden:
1. Wählen Sie **Event Bus in demselben Konto und derselben Region** aus.
1. Wählen Sie für **Event Bus für das Ziel** das Dropdown-Feld aus und geben Sie den Namen des Event Bus ein. Sie können den Event Bus auch aus der Dropdown-Liste auswählen.
Weitere Informationen finden Sie unter [Senden von Ereignissen zwischen Eventbussen desselben Kontos und derselben Region in Amazon EventBridge](eb-bus-to-bus.md).
+ Um einen Event-Bus in einem anderen AWS-Region OP-Konto wie in dieser Regel zu verwenden:
1. Wählen Sie **Event Bus in einem anderen Konto oder einer anderen Region** aus.
1. Geben Sie für **Event Bus als Ziel** den ARN des Event Bus ein, den Sie verwenden möchten.
Weitere Informationen finden Sie unter:
+ [Senden und Empfangen von Ereignissen zwischen AWS Konten bei Amazon EventBridge](eb-cross-account.md)
+ [Senden und Empfangen von Ereignissen zwischen AWS Regionen in Amazon EventBridge](eb-cross-region.md)
1. Für viele Zieltypen benötigt EventBridge Berechtigungen zum Senden von Ereignissen an das Ziel. 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:
1. Wählen Sie **Eine neue Rolle für diese spezifische Ressource erstellen** aus.
1. Geben Sie entweder einen Namen für diese Ausführungsrolle ein, oder verwenden Sie den Namen, der von EventBridge generiert wurde.
+ So verwenden Sie eine vorhandene Ausführungsrolle für diese Regel:
1. Wählen Sie **Vorhandene Rolle verwenden** aus.
1. Geben Sie den Namen der zu verwendenden Ausführungsrolle ein oder wählen Sie ihn aus der Dropdown-Liste aus.
1. (Optional) Geben Sie für **Zusätzliche Einstellungen** eine der optionalen Einstellungen an, die für Ihren Zieltyp verfügbar sind:
(Optional) Wählen Sie für die **Warteschlange für unzustellbare Briefe** aus, ob Sie eine standardmäßige Amazon SQS SQS-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.
+ Klicken Sie auf **Wählen Sie eine Amazon SQS Warteschlange im aktuellen AWS -Konto als Warteschlange für unzustellbare Nachrichten** und wählen Sie dann die Warteschlange aus der Dropdown-Liste aus.
+ Klicken Sie auf **Wählen Sie eine Amazon SQS Warteschlange in einem anderen AWS -Konto als Warteschlange für unzustellbare Nachrichten** und geben Sie dann den ARN der Warteschlange ein, die verwendet werden soll. Sie müssen der Warteschlange eine ressourcenbasierte Richtlinie hinzufügen, die die EventBridge Berechtigung zum Senden von Nachrichten an die Warteschlange erteilt.
Weitere Informationen finden Sie unter [Erteilen von Berechtigungen für die Warteschlange für unzustellbare Nachrichten](eb-rule-dlq.md#eb-dlq-perms).
------
#### [ API destination ]
1. Wählen Sie das **EventBridge API-Ziel** aus.
1. Wählen Sie ein neues oder vorhandenes API-Ziel:
+ Zum Verwenden eines vorhandenen API-Ziels wählen Sie **Vorhandenes API-Ziel verwenden** aus. Wählen Sie dann ein API-Ziel aus der Dropdown-Liste aus.
+ Zum Erstellen eines neuen API-Ziels 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 **.** **\$1** **-** (Bindestrich).
+ (Optional) **Beschreibung** – Geben Sie eine Beschreibung für das Ziel ein.
Beschreibungen können bis zu 512 Zeichen lang sein.
+ **API-Zielendpunkt** – Der URL-Endpunkt für das Ziel.
Die Endpunkt-URL muss mit **https** beginnen. Sie können das **\$1** als Pfadparameterplatzhalter angeben. Sie können Pfadparameter über das `HttpParameters`-Attribut des Ziels festlegen.
+ **HTTP-Methode** – Wählen Sie die HTTP-Methode aus, die beim Aufrufen des Endpunkts verwendet wird.
+ (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.
1. Für viele Zieltypen benötigt EventBridge Berechtigungen zum Senden von Ereignissen an das Ziel. 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:
1. Wählen Sie **Eine neue Rolle für diese spezifische Ressource erstellen** aus.
1. Geben Sie entweder einen Namen für diese Ausführungsrolle ein, oder verwenden Sie den Namen, der von EventBridge generiert wurde.
+ So verwenden Sie eine vorhandene Ausführungsrolle für diese Regel:
1. Wählen Sie **Vorhandene Rolle verwenden** aus.
1. Geben Sie den Namen der zu verwendenden Ausführungsrolle ein oder wählen Sie ihn aus der Dropdown-Liste aus.
1. (Optional) Geben Sie für **Zusätzliche Einstellungen** eine der optionalen Einstellungen an, die für Ihren Zieltyp verfügbar sind:
Beachten Sie, dass EventBridge möglicherweise nicht alle der folgenden Felder für einen bestimmten AWS Dienst angezeigt werden.
1. (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:
+ **Ü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 (JSON-Text)** — EventBridge sendet nur den angegebenen JSON-Text an das Ziel. Es wird kein Teil des ursprünglichen Quellereignisses gesendet.
**Geben Sie unter Konstante in JSON** angeben 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](eb-transform-target-input.md).
1. Wählen Sie **Eingabe-Transformator konfigurieren** aus.
1. Konfigurieren Sie den Eingabe-Transformator wie unter [Konfiguration eines Eingangstransformators beim Erstellen einer Regel in EventBridge](eb-transform-input-rule.md) beschrieben.
1. (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.
1. (Optional) Wählen Sie für die **Warteschlange für unzustellbare Briefe** aus, ob Sie eine standardmäßige Amazon SQS SQS-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 Amazon SQS SQS-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.
+ Klicken Sie auf **Wählen Sie eine Amazon SQS Warteschlange in einem anderen AWS -Konto als Warteschlange für unzustellbare Nachrichten** und geben Sie dann den ARN der Warteschlange ein, die verwendet werden soll. Sie müssen der Warteschlange eine ressourcenbasierte Richtlinie hinzufügen, die das Senden von Nachrichten an die EventBridge Warteschlange ermöglicht.
Weitere Informationen finden Sie unter [Erteilen von Berechtigungen für die Warteschlange für unzustellbare Nachrichten](eb-rule-dlq.md#eb-dlq-perms).
Weitere Informationen finden Sie unter [API-Ziele als Ziele in Amazon EventBridge](eb-api-destinations.md).
------
#### [ AWS-Service ]
1. Wählen Sie **AWS-Service**.
1. Wählen Sie für **Ziel auswählen** einen AWS-Service aus, der als Ziel verwendet werden soll.
1. Wenn Sie einen AWS Dienst wählen, der kontoübergreifende Ziele unterstützt, können Sie ein Ziel auswählen, das sich in demselben Konto wie der Event Bus befindet, oder in einem anderen Konto.
+ Wählen Sie für ein Ziel in demselben Konto als **Zieltyp** die Option **Ziel in diesem Konto** aus.
1. Geben Sie die angeforderten Informationen für den ausgewählten Service ein.
**Anmerkung**
Die angezeigten Felder variieren je nach ausgewähltem Service. Weitere Informationen zu verfügbaren Zielen finden Sie unter [Event-Bus-Ziele sind in der EventBridge Konsole verfügbar](eb-targets.md#eb-console-targets).
1. Für viele Zieltypen benötigt EventBridge Berechtigungen zum Senden von Ereignissen an das Ziel. 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:
1. Wählen Sie **Eine neue Rolle für diese spezifische Ressource erstellen** aus.
1. Geben Sie entweder einen Namen für diese Ausführungsrolle ein, oder verwenden Sie den Namen, der von EventBridge generiert wurde.
+ So verwenden Sie eine vorhandene Ausführungsrolle für diese Regel:
1. Wählen Sie **Vorhandene Rolle verwenden** aus.
1. Geben Sie den Namen der zu verwendenden Ausführungsrolle ein oder wählen Sie ihn aus der Dropdown-Liste aus.
+ Wählen Sie für ein Ziel in einem anderen Konto als **Zieltyp** die Option **Ziel in einem anderen AWS Konto** aus.
1. Geben Sie den ARN der Zielressource ein, an die Sie Ereignisse senden möchten.
1. Geben Sie alle zusätzlichen Informationen ein, die für den von Ihnen ausgewählten Dienst angefordert wurden.
1. Wählen Sie den Namen der zu verwendenden Ausführungsrolle aus der Dropdownliste aus.
1. (Optional) Geben Sie für **Zusätzliche Einstellungen** eine der optionalen Einstellungen an, die für Ihren Zieltyp verfügbar sind:
1. (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:
+ **Ü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 (JSON-Text)** — EventBridge sendet nur den angegebenen JSON-Text an das Ziel. Es wird kein Teil des ursprünglichen Quellereignisses gesendet.
**Geben Sie unter Konstante in JSON** angeben 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](eb-transform-target-input.md).
1. Wählen Sie **Eingabe-Transformator konfigurieren** aus.
1. Konfigurieren Sie den Eingabe-Transformator wie unter [Konfiguration eines Eingangstransformators beim Erstellen einer Regel in EventBridge](eb-transform-input-rule.md) beschrieben.
1. (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.
1. (Optional) Wählen Sie für die **Warteschlange für unzustellbare Briefe** aus, ob Sie eine standardmäßige Amazon SQS SQS-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 Amazon SQS SQS-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.
+ Klicken Sie auf **Wählen Sie eine Amazon SQS Warteschlange in einem anderen AWS -Konto als Warteschlange für unzustellbare Nachrichten** und geben Sie dann den ARN der Warteschlange ein, die verwendet werden soll. Sie müssen der Warteschlange eine ressourcenbasierte Richtlinie hinzufügen, die das Senden von Nachrichten an die EventBridge Warteschlange ermöglicht.
Weitere Informationen finden Sie unter [Erteilen von Berechtigungen für die Warteschlange für unzustellbare Nachrichten](eb-rule-dlq.md#eb-dlq-perms).
------
1. (Optional) Wählen Sie **Add another target** (Weiteres Ziel hinzufügen) aus, um ein weiteres Ziel für diese Regel hinzuzufügen.
1. Wählen Sie **Weiter** aus.
## 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**
1. (Optional) Geben Sie ein oder mehrere Tags für die Regel ein. Weitere Informationen finden Sie unter [Ressourcen in Amazon taggen EventBridge](eb-tagging.md).
1. Wählen Sie **Weiter** aus.
1. Ü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.
# Eine Regel in Amazon deaktivieren oder löschen EventBridge
Um zu verhindern, dass eine [Regel](eb-rules.md) [Ereignisse](eb-events.md) verarbeitet oder nach einem Zeitplan ausgeführt wird, können Sie die Regel löschen oder deaktivieren. In den folgenden Schritten erfahren Sie, wie Sie eine EventBridge Regel löschen oder deaktivieren.
**So löschen oder deaktivieren 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.
Wählen Sie in **Event bus (Ereignisbus)** den Ereignisbus aus, der der Regel zugeordnet ist.
1. Führen Sie eine der folgenden Aktionen aus:
1. Wählen Sie zum Löschen einer Regel die Schaltfläche neben der Regel und dann **Actions**, **Delete** und **Delete** aus.
Wenn es sich bei der Regel um eine verwaltete Regel handelt, geben Sie den Namen der Regel ein, um zu bestätigen, dass es sich um eine verwaltete Regel handelt und dass das Löschen dieser Regel die Funktionalität des Service, der die Regel erstellt hat, beeinträchtigen kann. Um fortzufahren, geben Sie den Namen der Regel ein und wählen **Force delete (Löschen erzwingen)** aus.
1. Wenn Sie eine Regel vorübergehend deaktivieren möchten, wählen Sie die Schaltfläche neben der Regel und dann **Actions (Aktionen)** und **Disable (Deaktivieren)** aus.
Sie können eine verwaltete Regel nicht deaktivieren.
# Bewährte Methoden bei der Definition von Regeln in Amazon EventBridge
Im Folgenden finden Sie einige bewährte Methoden, die Sie bei der Erstellung von Regeln für Ihre Event Buses berücksichtigen sollten.
## Festlegen eines einzelnen Ziels für jede Regel
Sie können zwar bis zu fünf Ziele für eine bestimmte Regel angeben, die Verwaltung von Regeln ist jedoch einfacher, wenn Sie für jede Regel ein einzelnes Ziel angeben. Wenn mehrere Ziele dieselbe Gruppe von Ereignissen empfangen müssen, empfehlen wir, die Regel zu duplizieren, um dieselben Ereignisse an verschiedene Ziele zu übermitteln. Diese Kapselung vereinfacht die Verwaltung von Regeln: Wenn die Anforderungen der Ereignisziele im Laufe der Zeit voneinander abweichen, können Sie jede Regel und ihr Ereignismuster unabhängig von den anderen aktualisieren.
## Festlegen von Regelberechtigungen
Sie können ereignisverbrauchenden Anwendungskomponenten oder -services ermöglichen, die Verwaltung ihrer eigenen Regeln selbst zu steuern. Ein gängiger architektonischer Ansatz, den Kunden verfolgen, besteht darin, diese Anwendungskomponenten oder Dienste mithilfe separater AWS Konten zu isolieren. Um den Ablauf von Ereignissen von einem Konto zum anderen zu ermöglichen, müssen Sie für einen Event Bus eine Regel erstellen, die Ereignisse an einen Event Bus in einem anderen Konto weiterleitet. Sie können ereignisverbrauchenden Teams oder Services die Kontrolle über die Verwaltung ihrer eigenen Regeln geben. Dazu geben Sie mithilfe von Ressourcenrichtlinien die entsprechenden Berechtigungen für ihre Konten an. Dies funktioniert konto- und regionsübergreifend.
Weitere Informationen finden Sie unter [Genehmigungen für Eventbusse bei Amazon EventBridge](eb-event-bus-perms.md).
Beispiele für Ressourcenrichtlinien finden Sie unter [Entwurfsmuster für mehrere Konten bei aktiviertem EventBridge Amazon](https://github.com/aws-samples/amazon-eventbridge-resource-policy-samples/tree/main/patterns) GitHub.
## Überwachen der Regelleistung
Überwachen Sie Ihre Regeln, um sicherzustellen, dass sie erwartungsgemäß funktionieren:
+ Wenn Sie die Metrik `TriggeredRules` auf fehlende Datenpunkte oder Anomalien überwachen, können Sie Unstimmigkeiten bei einem Publisher erkennen, der eine grundlegende Änderung vorgenommen hat. Weitere Informationen finden Sie unter [Überwachung von Amazon EventBridge](eb-monitoring.md).
+ Ein Alarm bei Anomalien oder der maximal erwarteten Anzahl kann auch dabei helfen, zu erkennen, ob eine Regel mit neuen Ereignissen übereinstimmt. Dies kann passieren, wenn Ereignis-Publisher, einschließlich AWS -Services und SaaS-Partner, neue Ereignisse beim Aktivieren neuer Anwendungsfälle und Features einführen. Wenn diese neuen Ereignisse unerwartet auftreten und dazu führen, dass das Volumen die Verarbeitungsrate des nachgelagerten Ziels übersteigt, können sie zu einem Ereignis-Backlog führen.
Eine solche Verarbeitung unerwarteter Ereignisse kann auch zu unerwünschten Abrechnungsgebühren führen.
Es kann auch zu einer Drosselung der Regeln führen, wenn das Konto seine gesamte Servicequote für Aufrufe pro Sekunde überschreitet. EventBridge versucht immer noch, Ereignisse zuzustellen, für die gedrosselte Regeln gelten, und versucht es bis zu 24 Stunden oder wie in der benutzerdefinierten Wiederholungsrichtlinie des Ziels beschrieben erneut. Mithilfe der Metrik `ThrottledRules` können Sie gedrosselte Regeln erkennen und bei diesen einen Alarm auslösen.
+ In Anwendungsfällen mit niedriger Latenz können Sie die Latenz auch mithilfe von `IngestionToInvocationStartLatency` überwachen, was einen Hinweis auf den Zustand Ihres Event Bus gibt. Längere Zeiträume mit hoher Latenz von mehr als 30 Sekunden können auf eine Serviceunterbrechung oder Regeldrosselung hinweisen.
# Verwenden von AWS Serverless Application Model Vorlagen zur Bereitstellung von EventBridge Amazon-Ressourcen
Sie können [Regeln](eb-rules.md) manuell in der EventBridge Konsole erstellen und testen, was den Entwicklungsprozess bei der Verfeinerung von [Ereignismustern](eb-event-patterns.md) unterstützen kann. Sobald Sie jedoch bereit sind, Ihre Anwendung bereitzustellen, ist es einfacher, ein Framework wie [AWS SAM](https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/what-is-sam.html) zu verwenden, um beispielsweise all Ihre Serverless-Ressourcen konsistent zu starten.
Wir werden diese [Beispielanwendung](https://github.com/aws-samples/amazon-eventbridge-producer-consumer-example) verwenden, um zu untersuchen, wie Sie AWS SAM Vorlagen zum Erstellen von EventBridge Ressourcen verwenden können. Die Datei template.yaml in diesem Beispiel ist eine AWS SAM Vorlage, die vier [AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html)Funktionen definiert und zwei verschiedene Möglichkeiten zur Integration der Lambda-Funktionen zeigt. EventBridge
Eine exemplarische Vorgehensweise für diese Beispielanwendung finden Sie unter [Tutorial: Erstellen Sie eine EventBridge Amazon-Beispielanwendung](eb-tutorial-get-started.md).
Es gibt zwei Ansätze für die Verwendung von Vorlagen. EventBridge AWS SAM Für einfache Integrationen, bei denen eine Lambda-Funktion durch eine Regel aufgerufen wird, ist der Ansatz **Kombinierte Vorlage** empfohlen. Wenn Sie über eine komplexe Routing-Logik verfügen oder eine Verbindung zu Ressourcen außerhalb Ihrer AWS SAM Vorlage herstellen, ist der Ansatz mit **getrennten Vorlagen** die bessere Wahl.
**Topics**
+ [Kombinierte Vorlage](#eb-combined-template)
+ [Getrennte Vorlage](#eb-separated-template)
## Kombinierte Vorlage
Beim ersten Ansatz wird die `Events` Eigenschaft verwendet, um die EventBridge Regel zu konfigurieren. Der folgende Beispielcode definiert ein [Ereignis](eb-events.md), das Ihre Lambda-Funktion aufruft.
**Anmerkung**
In diesem Beispiel wird die Regel automatisch auf dem [Standardereignisbus](eb-event-bus.md) erstellt, der in jedem AWS Konto vorhanden ist. Um die Regel einem benutzerdefinierten Event Bus zuzuordnen, können Sie den `EventBusName` zur Vorlage hinzufügen.
```
atmConsumerCase3Fn:
Type: AWS::Serverless::Function
Properties:
CodeUri: atmConsumer/
Handler: handler.case3Handler
Runtime: nodejs12.x
Events:
Trigger:
Type: CloudWatchEvent
Properties:
Pattern:
source:
- custom.myATMapp
detail-type:
- transaction
detail:
result:
- "anything-but": "approved"
```
Dieser YAML-Code entspricht einem Ereignismuster in der EventBridge Konsole. In YAML müssen Sie nur das Ereignismuster definieren und AWS SAM automatisch eine IAM-Rolle mit den erforderlichen Berechtigungen erstellen.
## Getrennte Vorlage
Beim zweiten Ansatz zur Definition einer EventBridge Konfiguration in AWS SAM werden die Ressourcen in der Vorlage klarer voneinander getrennt.
1. Zuerst definieren Sie die Lambda-Funktion:
```
atmConsumerCase1Fn:
Type: AWS::Serverless::Function
Properties:
CodeUri: atmConsumer/
Handler: handler.case1Handler
Runtime: nodejs12.x
```
1. Als Nächstes definieren Sie die Regel mithilfe einer `AWS::Events::Rule`-Ressource. Die Eigenschaften definieren das Ereignismuster und können auch [Ziele](eb-targets.md) angeben. Sie können mehrere Ziele explizit definieren.
```
EventRuleCase1:
Type: AWS::Events::Rule
Properties:
Description: "Approved transactions"
EventPattern:
source:
- "custom.myATMapp"
detail-type:
- transaction
detail:
result:
- "approved"
State: "ENABLED"
Targets:
-
Arn:
Fn::GetAtt:
- "atmConsumerCase1Fn"
- "Arn"
Id: "atmConsumerTarget1"
```
1. Definieren Sie abschließend eine `AWS::Lambda::Permission` Ressource, die die Berechtigung EventBridge zum Aufrufen des Ziels erteilt.
```
PermissionForEventsToInvokeLambda:
Type: AWS::Lambda::Permission
Properties:
FunctionName:
Ref: "atmConsumerCase1Fn"
Action: "lambda:InvokeFunction"
Principal: "events.amazonaws.com"
SourceArn:
Fn::GetAtt:
- "EventRuleCase1"
- "Arn"
```
# Generieren einer AWS CloudFormation Vorlage aus einer vorhandenen Regel EventBridge
AWS CloudFormation ermöglicht es Ihnen, Ihre AWS Ressourcen konto- und regionsübergreifend zentral und wiederholbar zu konfigurieren und zu verwalten, indem Infrastruktur als Code behandelt wird. CloudFormation ermöglicht dies, indem Sie *Vorlagen* erstellen können, die die Ressourcen definieren, die Sie bereitstellen und verwalten möchten.
EventBridge ermöglicht es Ihnen, Vorlagen anhand der vorhandenen Regeln in Ihrem Konto zu generieren, um Ihnen den Einstieg in die Entwicklung von CloudFormation Vorlagen zu erleichtern. Sie können eine einzelne Regel oder mehrere Regeln auswählen, die in die Vorlage aufgenommen werden sollen. Sie können diese Vorlagen dann als Grundlage für die [Erstellung von Stapel verwalteter](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html) Ressourcen verwenden. CloudFormation
Weitere Informationen CloudFormation finden Sie [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).
**Anmerkung**
EventBridge enthält keine [verwalteten Regeln](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html) in der generierten Vorlage.
Sie können auch [eine Vorlage aus einem vorhandenen Event Bus generieren](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-generate-event-bus-template.html), einschließlich der Regeln, die der Event Bus enthält.
**Um eine CloudFormation Vorlage aus einer oder mehreren Regeln zu generieren**
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 unter **Event Bus auswählen** den Event Bus aus, der die Regeln enthält, die Sie in die Vorlage aufnehmen möchten.
1. Wählen Sie unter **Regeln** die Regeln aus, die Sie in die generierte CloudFormation Vorlage aufnehmen möchten.
Bei einer einzelnen Regel können Sie auch den Namen der Regel auswählen, um die Seite mit den Details zu der Regel anzuzeigen.
1. Wählen Sie **CloudFormation Vorlage** und wählen Sie dann aus, in welchem Format Sie die Vorlage generieren EventBridge möchten: **JSON** oder **YAML**.
EventBridge zeigt die Vorlage an, die im ausgewählten Format generiert wurde.
1. EventBridge bietet Ihnen die Möglichkeit, die Vorlagendatei herunterzuladen oder die Vorlage in die Zwischenablage zu kopieren.
+ Wählen Sie zum Herunterladen der Vorlagendatei **Herunterladen** aus.
+ Wählen Sie zum Kopieren der Vorlage in die Zwischenablage **Kopieren** aus.
1. Wählen Sie zum Beenden der Vorlage **Abbrechen** aus.
Sobald Sie Ihre CloudFormation Vorlage an Ihren Anwendungsfall angepasst haben, können Sie sie verwenden, um darin [Stapel zu erstellen](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html). CloudFormation
## Überlegungen zur Verwendung von CloudFormation Vorlagen, die von Amazon generiert wurden EventBridge
Berücksichtigen Sie die folgenden Faktoren, wenn Sie eine CloudFormation Vorlage verwenden, anhand derer Sie generiert haben EventBridge:
+ EventBridge enthält keine Passwörter in der generierten Vorlage.
Sie können die Vorlage so bearbeiten, dass sie [Vorlagenparameter](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html) enthält, mit denen Benutzer Passwörter oder andere vertrauliche Informationen angeben können, wenn sie die Vorlage zum Erstellen oder Aktualisieren eines CloudFormation-Stacks verwenden.
Darüber hinaus können Benutzer Secrets Manager verwenden, um ein Secret in der gewünschten Region zu erstellen und dann die generierte Vorlage so zu bearbeiten, dass [dynamische Parameter](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/dynamic-references.html#dynamic-references-secretsmanager) eingesetzt werden.
+ Die Ziele in der generierten Vorlage bleiben genau so, wie sie im ursprünglichen Event Bus angegeben wurden. Dies kann zu regionsübergreifenden Problemen führen, wenn Sie die Vorlage nicht entsprechend bearbeiten, bevor Sie sie zum Erstellen von Stacks in anderen Regionen verwenden.
Darüber hinaus erstellt die generierte Vorlage die nachgelagerten Ziele nicht automatisch.