Hinweis zum Ende des Supports: Am 7. Oktober 2026 AWS wird der Support für eingestellt. AWS IoT Greengrass Version 1 Nach dem 7. Oktober 2026 können Sie nicht mehr auf die Ressourcen zugreifen. AWS IoT Greengrass V1 Weitere Informationen finden Sie unter [Migrieren von AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).
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.
# Abrufen von Bereitstellungsbenachrichtigungen
Mit den EventBridge Amazon-Veranstaltungsregeln erhalten Sie Benachrichtigungen über Statusänderungen für Ihre Greengrass-Gruppenbereitstellungen. EventBridge liefert nahezu in Echtzeit einen Stream von Systemereignissen, der Änderungen an AWS Ressourcen beschreibt. AWS IoT Greengrass sendet diese EventBridge Ereignisse *mindestens einmal* an. Das bedeutet, dass AWS IoT Greengrass möglicherweise mehrere Kopien eines bestimmten Ereignisses gesendet werden, um die Zustellung sicherzustellen. Außerdem empfangen Ihre Ereignis-Listener die Ereignisse möglicherweise nicht in der Reihenfolge, in der die Ereignisse aufgetreten sind.
**Anmerkung**
Amazon EventBridge ist ein Event-Bus-Service, mit dem Sie Ihre Anwendungen mit Daten aus einer Vielzahl von Quellen verbinden können, wie z. B. [Greengrass-Core-Geräten](telemetry.md) und Bereitstellungsbenachrichtigungen. Weitere Informationen finden Sie unter [Was ist Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/what-is-amazon-eventbridge.html) im * EventBridge Amazon-Benutzerhandbuch*.
AWS IoT Greengrass gibt ein Ereignis aus, wenn sich der Status von Gruppenbereitstellungen ändert. Sie können eine EventBridge Regel erstellen, die für alle von Ihnen angegebenen Zustandsübergänge oder Zustandsübergänge gilt. Wenn eine Bereitstellung in einen Zustand übergeht, der eine Regel initiiert, EventBridge ruft sie die in der Regel definierten Zielaktionen auf. Auf diese Weise können Sie Benachrichtigungen senden, Ereignisinformationen erfassen, Korrekturmaßnahmen ergreifen oder andere Ereignisse als Reaktion auf eine Statusänderung initiieren. Sie können beispielsweise Regeln für die folgenden Anwendungsfälle erstellen:
+ Initiiert Operationen nach der Bereitstellung, z. B. das Herunterladen von Ressourcen und die Benachrichtigung des Personals.
+ Senden Sie Benachrichtigungen bei erfolgreicher oder fehlgeschlagener Bereitstellung.
+ Veröffentlichen Sie benutzerdefinierte Metriken zu Bereitstellungsereignissen.
AWS IoT Greengrass löst ein Ereignis aus, wenn eine Bereitstellung in die folgenden Zustände übergeht:`Building`,`InProgress`, `Success` und. `Failure`
**Anmerkung**
Die Überwachung des Status einer [Sammelbereitstellungsoperation](bulk-deploy-cli.md) wird derzeit nicht unterstützt. Gibt jedoch Zustandsänderungsereignisse für einzelne Gruppenbereitstellungen aus, die Teil einer AWS IoT Greengrass Massenbereitstellung sind.
## Änderungsereignis für den Gruppenbereitstellungsstatus
Das [Ereignis](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html) für eine Änderung des Bereitstellungsstatus verwendet das folgende Format:
```
{
"version":"0",
"id":" cd4d811e-ab12-322b-8255-EXAMPLEb1bc8",
"detail-type":"Greengrass Deployment Status Change",
"source":"aws.greengrass",
"account":"123456789012",
"time":"2018-03-22T00:38:11Z",
"region":"us-west-2",
"resources":[],
"detail":{
"group-id": "284dcd4e-24bc-4c8c-a770-EXAMPLEf03b8",
"deployment-id": "4f38f1a7-3dd0-42a1-af48-EXAMPLE09681",
"deployment-type": "NewDeployment|Redeployment|ResetDeployment|ForceResetDeployment",
"status": "Building|InProgress|Success|Failure"
}
}
```
Sie können Regeln erstellen, die für mindestens eine Gruppe gelten. Sie können Regeln nach mindestens einem der folgenden Bereitstellungstypen und Bereitstellungsstatus filtern:
**Bereitstellungstypen**
+ `NewDeployment`. Die erste Bereitstellung einer Gruppenversion.
+ `ReDeployment`. Eine erneute Bereitstellung einer Gruppenversion.
+ `ResetDeployment`. Löscht Bereitstellungsinformationen, die im AWS Cloud und auf dem AWS IoT Greengrass Core gespeichert sind. Weitere Informationen finden Sie unter [Zurücksetzen von Bereitstellungen](reset-deployments-scenario.md).
+ `ForceResetDeployment`. Löscht die in der gespeicherten Bereitstellungsinformationen AWS Cloud und meldet den Erfolg, ohne auf die Antwort des Kerns zu warten. Löscht außerdem Bereitstellungsinformationen, die auf dem Core gespeichert sind, wenn der Core verbunden ist oder wenn er das nächste Mal eine Verbindung herstellt.
**Bereitstellungsstatus**
+ `Building`. AWS IoT Greengrass validiert die Gruppenkonfiguration und erstellt Einrichtungsartefakte.
+ `InProgress`. Die Bereitstellung im AWS IoT Greengrass Kern ist im Gange.
+ `Success`. Die Bereitstellung war erfolgreich.
+ `Failure`. Die Bereitstellung ist fehlgeschlagen.
Es ist möglich, dass Ereignisse doppelt sind oder nicht in der richtigen Reihenfolge werden. Um die Reihenfolge der Ereignisse zu bestimmen, verwenden Sie die `time`-Eigenschaft.
**Anmerkung**
AWS IoT Greengrass verwendet die `resources` Eigenschaft nicht, daher ist sie immer leer.
## Voraussetzungen für die Erstellung von EventBridge Regeln
Bevor Sie eine EventBridge Regel für erstellen AWS IoT Greengrass, gehen Sie wie folgt vor:
+ Machen Sie sich mit Ereignissen, Regeln und Zielen in vertraut EventBridge.
+ Erstellen und konfigurieren Sie die Ziele, die durch Ihre EventBridge Regeln aufgerufen werden. Regeln können viele Arten von Zielen aufrufen, einschließlich:
+ Amazon-Simple-Notification-Service (Amazon-SNS)
+ AWS Lambda Funktionen
+ Amazon Kinesis Video Streams
+ Amazon-Simple-Queue-Service-(Amazon-SQS)-Warteschlangen
Weitere Informationen finden Sie unter [Was ist Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/what-is-amazon-eventbridge.html) und [Erste Schritte mit Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-getting-set-up.html) im * EventBridge Amazon-Benutzerhandbuch*.
## Konfigurieren von Bereitstellungsbenachrichtigungen (Konsole)
Gehen Sie wie folgt vor, um eine EventBridge Regel zu erstellen, die ein Amazon SNS SNS-Thema veröffentlicht, wenn sich der Bereitstellungsstatus für eine Gruppe ändert. Auf diese Weise können Webserver, E-Mail-Adressen und andere Themenabonnenten auf das Ereignis reagieren. Weitere Informationen finden Sie im * EventBridge Amazon-Benutzerhandbuch* unter [Erstellen einer EventBridge Regel, die bei einem Ereignis von einer AWS Ressource ausgelöst](https://docs.aws.amazon.com/eventbridge/latest/userguide/create-eventbridge-rule.html) wird.
1. Öffnen Sie die [ EventBridgeAmazon-Konsole](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.
Eine Regel darf nicht denselben Namen wie eine andere Regel in derselben Region und auf demselben Event Bus haben.
1. Wählen Sie als **Event bus** (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 **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.
1. Als **Event source** (Ereignisquelle) wählen Sie **AWS -Services** aus.
1. Wählen Sie für **Event-Pattern** die Option **AWS Services** aus.
1. Wählen Sie für den **AWS Service** Greengrass.
1. Wählen Sie für **Ereignistyp** die Option **Greengrass Deployment Status Change (Änderung des Status der Greengrass-Bereitstellung)**.
**Anmerkung**
Der **AWS API-Aufruf über** den CloudTrail Ereignistyp basiert auf der AWS IoT Greengrass Integration mit AWS CloudTrail. Sie können diese Option verwenden, um Regeln zu erstellen, die durch Lese- oder Schreibaufrufe an die AWS IoT Greengrass API initiiert werden. Weitere Informationen finden Sie unter [AWS IoT Greengrass API-Aufrufe protokollieren mit AWS CloudTrail](logging-using-cloudtrail.md).
1. Wählen Sie die Bereitstellungsstatus aus, die eine Benachrichtigung auslösen.
+ Um Benachrichtigungen für alle Statusänderungsereignisse zu erhalten, wählen Sie **Any state (Beliebiger Status)**.
+ Um Benachrichtigungen nur für bestimmte Statusänderungsereignisse zu erhalten, wählen Sie **Specific state(s) (Spezifische(r) Status)** und dann die Zielstatus aus.
1. Wählen Sie die Bereitstellungstypen aus, die eine Benachrichtigung auslösen.
+ Um Benachrichtigungen für alle Bereitstellungstypen zu erhalten, wählen Sie **Any state (Beliebiger Status)**.
+ Um Benachrichtigungen nur für bestimmte Bereitstellungstypen zu erhalten, wählen Sie **Specific state(s) (Spezifische(r) Status)** und dann die Zielbereitstellungstypen aus.
1. Wählen Sie **Weiter** aus.
1. Bei **Zieltypen** wählen Sie **AWS -Service** aus.
1. Für **Wählen Sie ein Ziel** aus konfigurieren Sie Ihr Ziel. In diesem Beispiel wird ein Amazon SNS SNS-Thema verwendet, Sie können jedoch auch andere Zieltypen für das Senden von Benachrichtigungen konfigurieren.
1. Wählen Sie in **Target (Ziel)** die Option **SNS topic (SNS-Thema)** aus.
1. Wählen Sie unter **Thema** das Zielthema aus.
1. Wählen Sie **Weiter** aus.
1. Definieren Sie unter **Tags** Tags für die Regel oder lassen Sie die Felder leer.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie die Details der Regel und wählen Sie dann **Regel erstellen** aus.
## Konfigurieren von Bereitstellungsbenachrichtigungen (CLI)
Gehen Sie wie folgt vor, um eine EventBridge Regel zu erstellen, die ein Amazon SNS SNS-Thema veröffentlicht, wenn sich der Bereitstellungsstatus für eine Gruppe ändert. Auf diese Weise können Webserver, E-Mail-Adressen und andere Themenabonnenten auf das Ereignis reagieren.
1. Erstellen Sie die Regel.
+ *group-id*Ersetzen Sie es durch die ID Ihrer AWS IoT Greengrass Gruppe.
```
aws events put-rule \
--name TestRule \
--event-pattern "{\"source\": [\"aws.greengrass\"], \"detail\": {\"group-id\": [\"group-id\"]}}"
```
Eigenschaften, die aus dem Muster weggelassen werden, werden ignoriert.
1. Fügen Sie das Thema als Regelziel hinzu.
+ *topic-arn*Ersetzen Sie es durch den ARN Ihres Amazon SNS SNS-Themas.
```
aws events put-targets \
--rule TestRule \
--targets "Id"="1","Arn"="topic-arn"
```
**Anmerkung**
Damit Amazon EventBridge Ihr Zielthema aufrufen kann, müssen Sie Ihrem Thema eine ressourcenbasierte Richtlinie hinzufügen. Weitere Informationen finden Sie unter [Amazon SNS SNS-Berechtigungen](https://docs.aws.amazon.com/eventbridge/latest/userguide/resource-based-policies-eventbridge.html#sns-permissions) im * EventBridge Amazon-Benutzerhandbuch*.
Weitere Informationen finden Sie unter [Ereignisse und Ereignismuster EventBridge im EventBridge ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-and-event-patterns.html) *Amazon-Benutzerhandbuch*.
## Konfigurieren von Bereitstellungsbenachrichtigungen (CloudFormation)
Verwenden Sie CloudFormation Vorlagen, um EventBridge Regeln zu erstellen, die Benachrichtigungen über Statusänderungen für Ihre Greengrass-Gruppenbereitstellungen senden. Weitere Informationen finden Sie in der [Referenz zum EventBridge Amazon-Ressourcentyp](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_Events.html) im *AWS CloudFormation Benutzerhandbuch*.
## Weitere Informationen finden Sie auch unter
+ [AWS IoT Greengrass Gruppen für einen AWS IoT Greengrass Kern bereitstellen](deployments.md)
+ [Was ist Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/what-is-amazon-eventbridge.html) im * EventBridge Amazon-Benutzerhandbuch*