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: Ereignisse mithilfe EventBridge von Schemas an Amazon Kinesis senden
Sie können AWS [API-Aufrufereignisse](eb-events.md) EventBridge an einen [Amazon Kinesis Kinesis-Stream](https://docs.aws.amazon.com/streams/latest/dev/introduction.html) senden, Kinesis Data Streams Streams-Anwendungen erstellen und große Datenmengen verarbeiten. In diesem Tutorial erstellen Sie einen Kinesis-Stream und anschließend eine [Regel](eb-rules.md) in der EventBridge Konsole, die Ereignisse an diesen Stream sendet, wenn eine [ EC2Amazon-Instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/concepts.html) stoppt.
**Topics**
+ [Voraussetzungen](#eb-stream-prerequisite)
+ [Schritt 1: Erstellen eines Amazon-Kinesis-Streams](#eb-stream-create-stream)
+ [Schritt 2: Erstellen einer Regel](#eb-stream-create-rule)
+ [Schritt 3: Testen der Regel](#eb-stream-test-rule)
+ [Schritt 4: Überprüfen, ob das Ereignis gesendet wurde](#eb-stream-verify-event)
+ [Schritt 5: Bereinigen Ihrer Ressourcen](#cleanup)
## Voraussetzungen
In diesem Tutorial verwenden Sie Folgendes:
+ Verwenden Sie den AWS CLI , um mit Kinesis-Streams zu arbeiten.
Informationen zur AWS CLI Installation von finden Sie unter [Installation, Aktualisierung und Deinstallation der AWS CLI Version 2.](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html)
**Anmerkung**
In diesem Tutorial werden AWS Ereignisse und die integrierte `aws.events` Schemaregistrierung verwendet. Sie können auch eine EventBridge Regel erstellen, die auf dem Schema Ihrer benutzerdefinierten Ereignisse basiert, indem Sie sie manuell zu einer benutzerdefinierten Schemaregistrierung hinzufügen oder die Schemaerkennung verwenden.
Weitere Informationen zu Schemata finden Sie unter [EventBridge Amazon-Schemas](eb-schema.md). Weitere Informationen zum Erstellen einer Regel mithilfe anderer Ereignismusteroptionen finden Sie unter [Regeln in Amazon erstellen EventBridge](eb-create-rule-visual.md).
## Schritt 1: Erstellen eines Amazon-Kinesis-Streams
Verwenden Sie an einer Befehlszeile den Befehl, um einen Stream zu `create-stream` AWS CLI erstellen.
```
aws kinesis create-stream --stream-name test --shard-count 1
```
Wenn der Stream-Status `ACTIVE` ist, ist der Stream bereit. Verwenden Sie den Befehl `describe-stream`, um den Status eines Streams zu überprüfen.
```
aws kinesis describe-stream --stream-name test
```
## Schritt 2: Erstellen einer Regel
Erstellen Sie eine Regel, um Ereignisse an Ihren Stream zu senden, wenn Sie eine EC2 Amazon-Instance beenden.
**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 `TestRule`.
1. Wählen Sie für **Event Bus** die Option **Standard** aus.
1. Bei **Regeltyp** wählen Sie **Regel mit einem Ereignismuster** aus.
1. Wählen Sie **Weiter** aus.
1. Wählen Sie als **Quelle der Veranstaltung AWS ** **Veranstaltungen oder EventBridge Partnerveranstaltungen** aus.
1. Wählen Sie für **Erstellungsmethode** die Option **Schema verwenden** aus.
1. Gehen Sie bei **Event pattern** (Ereignismuster) wie folgt vor:
1. Wählen Sie für **Schematyp** die Option **Schema aus der Schemaregistrierung auswählen** aus.
1. Wählen Sie für **Schemaregistrierung** die Option **aws.events** aus der Dropdown-Liste aus.
1. Wählen Sie für **Schema** die Option **aws.ec2@ EC2 InstanceStateChangeNotification aus der Dropdownliste** aus.
EventBridge **zeigt das Ereignisschema unter Modelle an.**
EventBridge zeigt neben allen Eigenschaften, die für das Ereignis und nicht *für das Ereignismuster* erforderlich sind, ein rotes Sternchen an.
1. Legen Sie für **Modelle** die folgenden Eigenschaften für den Ereignisfilter fest:
1. Wählen Sie **\$1 Bearbeiten** neben der **Statuseigenschaft** aus.
Lassen Sie das Feld **Beziehung** leer. Geben Sie für **Wert** `running` ein. Wählen Sie **Festlegen** aus.
1. Wählen Sie **\$1 Bearbeiten** neben der **Quelleigenschaft** aus.
Lassen Sie das Feld **Beziehung** leer. Geben Sie für **Wert** `aws.ec2` ein. Wählen Sie **Festlegen** aus.
1. Wählen Sie **\$1 Bearbeiten** neben der **Detailtypeigenschaft** aus.
Lassen Sie das Feld **Beziehung** leer. Geben Sie für **Wert** `EC2 Instance State-change Notification` ein. Wählen Sie **Festlegen** aus.
1. Wählen Sie **Ereignismuster in JSON generieren** aus, um das von Ihnen erstellte Ereignismuster anzuzeigen.
EventBridge zeigt das Ereignismuster in JSON an:
```
{
"detail": {
"state": ["running"]
},
"detail-type": ["EC2 Instance State-change Notification"],
"source": ["aws.ec2"]
}
```
1. Wählen Sie **Weiter** aus.
1. Bei **Zieltypen** wählen Sie **AWS -Service** aus.
1. Wählen Sie für **Ziel auswählen** die Option **Kinesis-Stream** aus der Dropdown-Liste aus.
1. Wählen Sie für **Stream** den Kinesis-Stream aus, den Sie im Abschnitt **Schritt 1: Erstellen eines Amazon-Kinesis-Streams** erstellt haben. Wählen Sie in diesem Beispiel `test` aus.
1. Wählen Sie für **Ausführungsrolle** die Option **Eine neue Rolle für diese spezifische Ressource erstellen** aus.
1. Wählen Sie **Weiter** aus.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie die Details der Regel und wählen Sie dann **Regel erstellen** aus.
## Schritt 3: Testen der Regel
Um Ihre Regel zu testen, beenden Sie eine EC2 Amazon-Instance. Warten Sie einige Minuten, bis die Instance beendet ist, und überprüfen Sie dann Ihre CloudWatch Metriken, um sicherzustellen, dass Ihre Funktion ausgeführt wurde.
**Testen der Regel durch Anhalten einer Instance**
1. Öffnen Sie die EC2 Amazon-Konsole unter [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Starten Sie eine Instance. Weitere Informationen finden Sie unter [Launch Your Instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/LaunchingAndUsingInstances.html) im * EC2 Amazon-Benutzerhandbuch*.
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 den Namen der von Ihnen erstellten Regel und **Metrics for the rule (Metriken für die Regel)** aus.
1. (Optional) Beenden Sie die Instance, wenn Sie fertig sind. Weitere Informationen finden Sie unter [Terminate Your Instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/terminating-instances.html) im * EC2 Amazon-Benutzerhandbuch*.
## Schritt 4: Überprüfen, ob das Ereignis gesendet wurde
Sie können das verwenden AWS CLI , um den Datensatz aus dem Stream abzurufen, um zu überprüfen, ob das Ereignis gesendet wurde.
**So rufen Sie den Datensatz ab**
1. Verwenden Sie an einer Eingabeaufforderung den Befehl `get-shard-iterator`, um mit dem Lesen aus dem Kinesis-Stream zu beginnen.
```
aws kinesis get-shard-iterator --shard-id shardId-000000000000 --shard-iterator-type TRIM_HORIZON --stream-name test
```
Es folgt eine Beispielausgabe.
```
{
"ShardIterator": "AAAAAAAAAAHSywljv0zEgPX4NyKdZ5wryMzP9yALs8NeKbUjp1IxtZs1Sp+KEd9I6AJ9ZG4lNR1EMi+9Md/nHvtLyxpfhEzYvkTZ4D9DQVz/mBYWRO6OTZRKnW9gd+efGN2aHFdkH1rJl4BL9Wyrk+ghYG22D2T1Da2EyNSH1+LAbK33gQweTJADBdyMwlo5r6PqcP2dzhg="
}
```
1. Um den Datensatz abzurufen, verwenden Sie den folgenden `get-records`-Befehl. Verwenden Sie den Shard-Iterator aus der Ausgabe im vorherigen Schritt.
```
aws kinesis get-records --shard-iterator AAAAAAAAAAHSywljv0zEgPX4NyKdZ5wryMzP9yALs8NeKbUjp1IxtZs1Sp+KEd9I6AJ9ZG4lNR1EMi+9Md/nHvtLyxpfhEzYvkTZ4D9DQVz/mBYWRO6OTZRKnW9gd+efGN2aHFdkH1rJl4BL9Wyrk+ghYG22D2T1Da2EyNSH1+LAbK33gQweTJADBdyMwlo5r6PqcP2dzhg=
```
Wenn der Befehl erfolgreich war, werden Datensätze aus dem Stream für eine bestimmte Shard abgefragt. Sie können null oder mehr Datensätze erhalten. Die zurückgegebenen Datensätze stellen möglicherweise nicht alle Datensätze in Ihrem Stream dar. Wenn Sie nicht die erwarteten Daten erhalten, rufen Sie `get-records` weiter auf.
1. Datensätze in Kinesis sind in Base64 codiert. Verwenden Sie einen Base64-Decoder, um die Daten zu decodieren, sodass Sie überprüfen können, ob es sich um das Ereignis handelt, das im JSON-Format an den Stream gesendet wurde.
## Schritt 5: Bereinigen Ihrer Ressourcen
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.
**Um die EventBridge Regel (n) zu löschen**
1. Öffnen Sie die [Regelseite](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 **Löschen** aus.
1. Wählen Sie **Löschen** aus.
**So löschen Sie den/die Kinesis-Stream(s)**
1. Öffnen Sie die [Datenstromseite](https://console.aws.amazon.com/kinesis/home#/streams/list) der Kinesis-Konsole.
1. Wählen Sie den/die Stream(s) aus, den/die Sie erstellt haben.
1. Wählen Sie **Aktionen**, **Löschen** aus.
1. Geben Sie **delete** in das Feld ein und wählen Sie **Löschen** aus.