# Ereignis-Benachrichtigungen für AWS IoT Wireless AWS IoT Wireless kann Nachrichten veröffentlichen, um Sie über Ereignisse für LoRaWAN- und Sidewalk-Geräte zu benachrichtigen, die Sie in AWS IoT Core hinzufügen. Sie können beispielsweise über Ereignisse informiert werden, z. B. wenn die Sidewalk-Geräte in Ihrem Konto bereitgestellt oder registriert wurden. ## Wie können Ihre Ressourcen über Ereignisse informiert werden Ereignisbenachrichtigungen werden veröffentlicht, wenn bestimmte Ereignisse eintreten. Ereignisse werden beispielsweise generiert, wenn Ihr Sidewalk-Gerät bereitgestellt wird. Jedes Ereignis führt dazu, dass eine einzelne Ereignisbenachrichtigung gesendet wird. Ereignisbenachrichtigungen werden über MQTT mit einer JSON-Nutzlast veröffentlicht. Der Inhalt der Nutzlast hängt von der Art des Ereignisses ab. **Anmerkung** Ereignisbenachrichtigungen werden mindestens einmal veröffentlicht. Es ist möglich, dass sie mehr als einmal veröffentlicht werden. Die Reihenfolge von Ereignisbenachrichtigungen ist nicht garantiert. ### Ereignisse und Ressourcentypen Die folgende Tabelle zeigt die verschiedenen Arten von Ereignissen, über die Sie Benachrichtigungen erhalten. Die Ereignistypen hängen davon ab, ob der Ressourcentyp ein drahtloses Gerät, ein drahtloses Gateway oder ein Sidewalk-Konto ist. Sie können Ereignisse auch für Ihre Ressourcen auf Ressourcenebene aktivieren, was für alle Ressourcen eines bestimmten Typs gilt, oder für ausgewählte Ressourcen, wie im folgenden Abschnitt beschrieben. Weitere Informationen zu den verschiedenen Ereignistypen finden Sie unter [Ereignisbenachrichtigungen für LoRaWAN-Ressourcen](iot-lorawan-events.md) und [Ereignisbenachrichtigungen für Sidewalk-Ressourcen](iot-sidewalk-events.md). **Ereignistypen auf Basis der Ressourcen** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/iot-wireless/latest/developerguide/iot-wireless-events.html) ### Richtlinie für den Empfang drahtloser Ereignisbenachrichtigungen Um Ereignisbenachrichtigungen zu empfangen, muss Ihr Gerät eine geeignete Richtlinie verwenden, mit der es eine Verbindung zum AWS IoT-Geräte-Gateway herstellen und MQTT-Ereignisthemen abonnieren kann. Sie müssen auch die entsprechenden Themenfilter abonnieren. Im Folgenden finden Sie ein Beispiel für die Richtlinie, die für den Empfang von Benachrichtigungen für die verschiedenen drahtlosen Ereignisse erforderlich ist. ``` { "Version":"2012-10-17", "Statement":[{ "Effect":"Allow", "Action":[ "iot:Subscribe", "iot:Receive" ], "Resource":[ "arn:aws:iotwireless:region:account:/$aws/iotwireless/events/join/*", "arn:aws:iotwireless:region:account:/$aws/iotwireless/events/connection_status/*" "arn:aws:iotwireless:region:account:/$aws/iotwireless/events/device_registration_state/*", "arn:aws:iotwireless:region:account:/$aws/iotwireless/events/proximity/*" ] }] } ``` ### Format der MQTT-Themen für Mobilfunkereignisse Um Ihnen Benachrichtigungen über Ereignisse für Ihre Mobilfunkressourcen zu senden, AWS IoT verwendet MQTT-reservierte Themen, die mit einem Dollarzeichen (\$1) beginnen. Sie können diese reservierten Themen veröffentlichen und abonnieren. Allerdings können Sie keine neuen Themen erstellen, die mit einem Dollarzeichen beginnen. **Anmerkung** MQTT-Themen sind spezifisch für Ihr AWS-Konto und verwenden das Format `arn:aws:iotwireless:aws-region:AWS-account-ID:topic/Topic`. Weitere Informationen finden Sie unter [MQTT-Themen](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) im *AWS IoT-Entwicklerhandbuch*. Für Drahtlos-Geräte reservierte MQTT-Themen wird das folgende Format verwendet: + **Themen auf Ressourcenebene** Diese Themen gelten für alle Ressourcen eines bestimmten Typs in Ihrer AWS-Konto, die Sie in die AWS IoT Wireless eingebunden haben. `$aws/iotwireless/events/{eventName}/{eventType}/{resourceType}/resources` + **Themen auf Kennungsebene** Diese Themen beziehen sich auf ausgewählte Ressourcen eines bestimmten Typs in Ihrem AWS-Konto, die Sie in AWS IoT Wireless eingebunden haben, angegeben durch die Ressourcenkennung. `$aws/iotwireless/events/{eventName}/{eventType}/{resourceType}/{resourceIdentifierType}/{resourceID}/{id}` Weitere Informationen zu Themen auf Ressourcen- und Kennungsebene finden Sie unter [Ereigniskonfigurationen](iot-wireless-control-events.md#iot-wireless-control-events-config). Die folgende Tabelle zeigt Beispiele für MQTT-Themen für die verschiedenen Ereignisse: **Ereignisse und MQTT-Themen** | Ereignis | MQTT-Thema | Hinweise | | --- | --- | --- | | Status der Registrierung von Sidewalk-Geräten | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/iot-wireless/latest/developerguide/iot-wireless-events.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/iot-wireless/latest/developerguide/iot-wireless-events.html) | | Nähe zu Sidewalk | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/iot-wireless/latest/developerguide/iot-wireless-events.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/iot-wireless/latest/developerguide/iot-wireless-events.html) | | LoRaWAN-Join | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/iot-wireless/latest/developerguide/iot-wireless-events.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/iot-wireless/latest/developerguide/iot-wireless-events.html) | | Verbindungsstatus des LoRaWAN-Gateway | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/iot-wireless/latest/developerguide/iot-wireless-events.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/iot-wireless/latest/developerguide/iot-wireless-events.html) | Weitere Informationen zu den verschiedenen Ereignissen finden Sie unter [Ereignisbenachrichtigungen für LoRaWAN-Ressourcen](iot-lorawan-events.md) und [Ereignisbenachrichtigungen für Sidewalk-Ressourcen](iot-sidewalk-events.md). Wenn Sie diese Themen abonniert haben, werden Sie benachrichtigt, wenn eine Nachricht zu einem der Themen für Benachrichtigungen zu Ereignissen veröffentlicht wird. Weitere Informationen finden Sie unter [Reservierte MQTT-Themen](https://docs.aws.amazon.com/iot/latest/developerguide/reserved-topics.html) im *AWS IoT-Entwicklerhandbuch*. ## Preise für Drahtlos-Ereignisse Informationen zu den Preisen für das Abonnieren von Ereignissen und für den Empfang von Benachrichtigungen finden Sie unter [AWS IoT CorePreise](https://aws.amazon.com/iot-core/pricing/). # Ereignisse für Drahtlos-Ressourcen aktivieren Bevor Subscribers der reservierten Themen Nachrichten empfangen können, müssen Sie die Ereignisbenachrichtigungen aktivieren. Sie können dazu die AWS-Managementkonsole oder die AWS IoT Wireless-API oder AWS CLI verwenden. ## Ereigniskonfigurationen Sie können Ereignisse so konfigurieren, dass Benachrichtigungen entweder an alle Ressourcen gesendet werden, die zu einem bestimmten Typ gehören, oder an einzelne Drahtlos-Ressourcen. Der Ressourcentyp kann ein drahtloses Gateway, ein Sidewalk-Partnerkonto oder ein drahtloses Gerät sein, bei dem es sich um ein LoRaWAN- oder Sidewalk-Gerät handeln kann. Informationen zu den Ereignistypen, die Sie für Ihre drahtlosen Geräte aktivieren können, finden Sie unter [Ereignistypen für LoRaWAN-Ressourcen](iot-lorawan-events.md#iot-lorawan-event-types) und [Ereignistypen für Sidewalk-Ressourcen](iot-sidewalk-events.md#iot-sidewalk-event-types). **Alle Ressourcen** Sie können Ereignisse so aktivieren, dass alle Ressourcen in Ihrem AWS-Konto, die zu einem bestimmten Ressourcentyp gehören, Benachrichtigungen erhalten. Sie können beispielsweise ein Ereignis aktivieren, das Sie über Änderungen des Verbindungsstatus für alle LoRaWAN-Gateways informiert, die Sie mit AWS IoT Core für LoRaWAN hinzugefügt haben. Durch die Überwachung dieser Ereignisse können Sie Benachrichtigungen erhalten, z. B. wenn bestimmte LoRaWAN-Gateways in Ihrer Ressourcenflotte unterbrochen werden oder wenn ein Beacon für eine Reihe von Sidewalk-Geräten in Ihrem AWS-Konto verloren geht. **Einzelne Ressourcen** Sie können Ihrer Ereigniskonfiguration auch einzelne LoRaWAN- und Sidewalk-Ressourcen hinzufügen und Benachrichtigungen für diese aktivieren. Auf diese Weise können Sie einzelne Ressourcen eines bestimmten Typs überwachen. Sie können beispielsweise ausgewählte LoRaWAN- und Sidewalk-Geräte zu Ihrer Konfiguration hinzufügen und Benachrichtigungen über Join- oder Geräteregistrierungsstatus für diese Ressourcen erhalten. ## Voraussetzungen Ihre LoRaWAN- oder Sidewalk-Ressource muss über eine entsprechende Richtlinie verfügen, die es ihr ermöglicht, Ereignisbenachrichtigungen zu empfangen. Weitere Informationen finden Sie unter [Richtlinie für den Empfang drahtloser Ereignisbenachrichtigungen](iot-wireless-events.md#iot-wireless-events-policy). ## Aktivieren von Benachrichtigungen mit AWS-Managementkonsole Um Ereignisnachrichten von der Konsole aus zu aktivieren, gehen Sie zur Registerkarte [Einstellungen](console.aws.amazon.com/iot/home/settings/) der AWS IoT-Konsole und dann zum Abschnitt **LoRaWAN- und Sidewalk-Ereignisbenachrichtigungen**. Sie können Benachrichtigungen für alle Ressourcen in Ihrem AWS-Konto aktivieren, die zu einem bestimmten Ressourcentyp gehören, und diese überwachen. **Um Benachrichtigungen für alle Ressourcen zu aktivieren** 1. Gehen Sie im Abschnitt **LoRaWAN- und Sidewalk-Ereignisbenachrichtigungen** zur Registerkarte **Alle Ressourcen**, wählen Sie **Aktion** und dann **Ereignisse verwalten**. 1. Aktivieren Sie die Ereignisse, die Sie überwachen möchten, und wählen Sie dann **Ereignisse aktualisieren**. Wenn Sie bestimmte Ereignisse nicht mehr überwachen möchten, wählen Sie **Aktion** und dann **Ereignisse verwalten** und deaktivieren Sie dann diese Ereignisse. Sie können auch Benachrichtigungen für einzelne Ressourcen in Ihrem AWS-Konto aktivieren, die zu einem bestimmten Ressourcentyp gehören, und diese überwachen. **Um Benachrichtigungen für individuelle Ressourcen zu aktivieren** 1. Wählen Sie im Abschnitt **LoRaWAN- und Sidewalk-Ereignisbenachrichtigungen** die Option **Aktion** und dann **Ressourcen hinzufügen**. 1. Wählen Sie die Ressourcen und Ereignisse aus, für die Sie Benachrichtigungen erhalten möchten: 1. Wählen Sie aus, ob Sie Ereignisse für Ihre **LoRaWAN-Ressourcen** oder **Sidewalk-Ressourcen** überwachen möchten. 1. Je nach Ressourcentyp können Sie die Ereignisse auswählen, die Sie für die Ressourcen aktivieren möchten. Sie können diese Ereignisse dann abonnieren und Benachrichtigungen erhalten. Wenn Sie auswählen: + **LoRaWAN-Ressourcen**: Sie können **Join**-Ereignisse für Ihre LoRaWAN-Geräte oder **Verbindungsstatus**-Ereignisse für Ihre LoRaWAN-Gateways aktivieren. + Sidewalk-Ressourcen: Sie können **Geräteregistrierungsstatus**- oder **Nähe**-Ereignisse oder beides für Ihre Sidewalk-Partnerkonten und Sidewalk-Geräte aktivieren. 1. Wählen Sie je nach Ressourcentyp und Ereignissen, die Sie ausgewählt haben, die drahtlosen Geräte oder Gateways aus, die Sie überwachen möchten. Sie können bis zu 250 Ressourcen für alle Ressourcen zusammen auswählen. 1. Wählen Sie **Senden**, um Ihre Ressourcen hinzuzufügen. Die Ressourcen, die Sie hinzufügen, werden mit ihren MQTT-Themen auf der Registerkarte für Ihren Ressourcentyp im Bereich **LoRaWAN- und Sidewalk-Ereignisbenachrichtigungen** der Konsole angezeigt. + **LoRaWAN-Join**-Ereignisse und Ereignisse für Ihre Sidewalk-Geräte werden im Bereich **Drahtlose Geräte** der Konsole angezeigt. + Ereignisse zum **Verbindungsstatus** Ihrer LoRaWAN-Gateways werden im Abschnitt **Drahtlose Gateways** angezeigt. + **Geräteregistrierungsstatus**- und **Nähe**-Ereignisse für Ihre Sidewalk-Konten werden auf der Registerkarte **Sidewalk-Konten** angezeigt. **Abonnieren Sie Themen mit dem MQTT-Client** Je nachdem, ob Sie Ereignisse für alle Ressourcen oder für einzelne Ressourcentypen aktiviert haben, werden die Ereignisse, die Sie aktiviert haben, in der Konsole mit ihren MQTT-Themen auf der Registerkarte **Alle Ressourcen** oder auf der Registerkarte für den angegebenen Ressourcentyp angezeigt. + Wenn Sie eines der MQTT-Themen wählen, können Sie zum MQTT-Client gehen, um diese Themen zu abonnieren und Nachrichten zu empfangen. + Wenn Sie mehrere Ereignisse hinzugefügt haben, können Sie mehrere Ereignisthemen abonnieren und Benachrichtigungen für sie erhalten. Um mehrere Themen zu abonnieren, wählen Sie Ihre Themen aus und wählen Sie **Aktion** und dann **Abonnieren**. ## Aktivieren von Benachrichtigungen mit AWS CLI Sie können Ereignisse konfigurieren und Ressourcen zu Ihrer Konfiguration hinzufügen, indem Sie die AWS IoT Wireless-API oder die AWS CLI verwenden. **Aktivieren Sie Benachrichtigungen für alle Ressourcen** Sie können Benachrichtigungen für alle Ressourcen in Ihrem AWS-Konto aktivieren, die zu einem bestimmten Ressourcentyp gehören, und diese mithilfe der [UpdateEventConfigurationByResourceTypes](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateResourceEventConfiguration.html)-API oder des [cli/latest/reference/iotwireless/update-event-configuration-by-resource-types.html](cli/latest/reference/iotwireless/update-event-configuration-by-resource-types.html) CLI-Befehls überwachen. Beispielsweise: ``` aws iotwireless update-event-configuration-by-resource-types \ --cli-input-json input.json ``` **Inhalt von input.json** ``` { "DeviceRegistrationState": { "Sidewalk": { "AmazonIdEventTopic": "Enabled" } }, "ConnectionStatus": { "LoRaWAN": { "WirelessGatewayEventTopic": "Enabled" } } } ``` **Anmerkung** Alle Anführungszeichen („“) werden durch Backslashes (\$1) umgangen. Sie können die aktuelle Ereigniskonfiguration abrufen, indem Sie die [GetEventConfigurationByResourceTypes](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetResourceEventConfiguration.html)-API aufrufen oder den [cli/latest/reference/iotwireless/get-event-configuration-by-resource-types.html](cli/latest/reference/iotwireless/get-event-configuration-by-resource-types.html) CLI-Befehl verwenden. Beispielsweise: ``` aws iotwireless get-event-configuration-by-resource-types ``` **Aktivieren Sie Benachrichtigungen für einzelne Ressourcen** Um Ihrer Ereigniskonfiguration einzelne Ressourcen hinzuzufügen und zu steuern, welche Ereignisse mithilfe der API oder CLI veröffentlicht werden, rufen Sie die [UpdateResourceEventConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateResourceEventConfiguration.html)-API auf oder verwenden Sie den [cli/latest/reference/iotwireless/update-resource-event-configuration.html](cli/latest/reference/iotwireless/update-resource-event-configuration.html) CLI-Befehl. Beispielsweise: ``` aws iotwireless update-resource-event-configuration \ --identifer 1ffd32c8-8130-4194-96df-622f072a315f \ --identifier-type WirelessDeviceId \ --cli-input-json input.json ``` **Inhalt von input.json** ``` { "Join": { "LoRaWAN": { "DevEuiEventTopic": "Disabled" }, "WirelessDeviceIdEventTopic": "Enabled" } } ``` **Anmerkung** Alle Anführungszeichen („“) werden durch Backslashes (\$1) umgangen. Sie können die aktuelle Ereigniskonfiguration abrufen, indem Sie die [GetResourceEventConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetResourceEventConfiguration.html)-API aufrufen oder den [cli/latest/reference/iotwireless/get-resource-event-configuration.html](cli/latest/reference/iotwireless/get-resource-event-configuration.html) CLI-Befehl verwenden. Beispielsweise: ``` aws iotwireless get-resource-event-configuration \ --identifier-type WirelessDeviceId \ --identifier 1ffd32c8-8130-4194-96df-622f072a315f ``` **Ereigniskonfigurationen auflisten** Sie können auch die AWS IoT Wireless-API oder die AWS CLI verwenden, um Ereigniskonfigurationen aufzulisten, für die mindestens ein Ereignisthema aktiviert wurde. Verwenden Sie den API-Vorgang [ListEventConfigurations](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListEventConfigurations.html) oder den [cli/latest/reference/iotwireless/list-event-configurations.html](cli/latest/reference/iotwireless/list-event-configurations.html) CLI-Befehl, um Konfigurationen aufzulisten. Beispielsweise: ``` aws iotwireless list-event-configurations --resource-type WirelessDevice ``` # Ereignisbenachrichtigungen für LoRaWAN-Ressourcen Sie können die API-Operationen AWS-Managementkonsole oder AWS IoT Wireless verwenden, um Sie über Ereignisse für Ihre LoRaWAN-Geräte und -Gateways zu informieren. Informationen zu Ereignisbenachrichtigungen und deren Aktivierung finden Sie unter [Ereignis-Benachrichtigungen für AWS IoT Wireless](iot-wireless-events.md) und [Ereignisse für Drahtlos-Ressourcen aktivieren](iot-wireless-control-events.md). ## Ereignistypen für LoRaWAN-Ressourcen Zu den Ereignissen, die Sie für Ihre LoRaWAN-Ressourcen aktivieren können, gehören: + Nehmen Sie an Ereignissen teil, die Sie über Join-Ereignisse für Ihr LoRaWAN-Gerät informieren. Sie erhalten Benachrichtigungen, wenn ein Gerät mit AWS IoT Core für LoRaWAN beitritt oder wenn eine Anfrage zum erneuten Beitritt vom Typ 0 oder Typ 2 eingeht. + Ereignisse zum Verbindungsstatus, die Sie benachrichtigen, wenn sich der Verbindungsstatus Ihres LoRaWAN-Gateways auf verbunden oder getrennt ändert. Die folgenden Abschnitte enthalten weitere Informationen zu den Ereignissen für Ihre LoRaWAN-Ressourcen: **Topics** + [ ## Ereignistypen für LoRaWAN-Ressourcen ](#iot-lorawan-event-types) + [ # LoRaWAN-Join-Ereignisse ](iot-lorawan-join-events.md) + [ # Ereignisse des Verbindungsstatus ](iot-lorawan-gateway-events.md) # LoRaWAN-Join-Ereignisse AWS IoT Core für LoRaWAN kann Nachrichten veröffentlichen, um Sie über Join-Ereignisse für LoRaWAN-Geräte zu informieren, die Sie zu AWS IoT hinzufügen. Join-Ereignisse benachrichtigen Sie, wenn eine Anfrage zum Beitritt oder Wiederbeitritt vom Typ 0 oder Typ 2 eingeht und das Gerät mit AWS IoT Core für LoRaWAN beigetreten ist. ## Funktionsweise von Join-Ereignissen Wenn Sie Ihre LoRaWAN-Geräte mit AWS IoT Core für LoRaWAN einbinden, führt AWS IoT Core für LoRaWAN mit AWS IoT Core für LoRaWAN ein *Join*-Verfahren für Ihr Gerät durch. Ihr Gerät wird dann für die Nutzung aktiviert und kann eine Uplink-Nachricht senden, um anzuzeigen, dass es verfügbar ist. Nachdem das Gerät beigetreten ist, können Uplink- und Downlink-Nachrichten zwischen Ihrem Gerät und AWS IoT Core für LoRaWAN ausgetauscht werden. Weitere Informationen zum Onboarding von Geräten finden Sie unter [Einbinden Ihrer Geräte in AWS IoT Core für LoRaWAN](lorawan-onboard-end-devices.md). Sie können Ereignisse aktivieren, um Sie zu benachrichtigen, wenn Ihr Gerät mit AWS IoT Core für LoRaWAN beigetreten ist. Sie werden auch benachrichtigt, wenn das Join-Ereignis fehlschlägt und wenn eine Wiederbeitrittsanfrage vom Typ 0 oder Typ 2 eingeht und wenn sie akzeptiert wird. ## LoRaWAN-Join-Ereignisse aktivieren Bevor Subscriber der reservierten LoRaWAN-Join-Themen Nachrichten empfangen können, müssen Sie für sie Ereignisbenachrichtigungen über die AWS-Managementkonsole oder mithilfe der API oder CLI aktivieren. Sie können diese Ereignisse für alle LoRaWAN-Ressourcen in Ihren AWS-Konto oder für ausgewählte Ressourcen aktivieren. Weitere Informationen darüber, wie Sie diese Ereignisse einrichten finden Sie unter [Ereignisse für Drahtlos-Ressourcen aktivieren](iot-wireless-control-events.md). ## Format der MQTT-Themen für LoRaWAN-Ereignisse Für LoRaWAN-Geräte reservierte MQTT-Themen wird das folgende Format verwendet: Wenn Sie diese Themen abonniert haben, können alle LoRaWAN-Geräte, die bei Ihrem AWS-Konto registriert sind, die Benachrichtigung erhalten: + **Themen auf Ressourcenebene** `$aws/iotwireless/events/{eventName}/{eventType}/lorawan/wireless_devices` + **Kennungsthemen** `$aws/iotwireless/events/{eventName}/{eventType}/lorawan/wireless_devices/{resourceID}/{id}` Wobei gilt: **\$1eventName\$1** \$1eventName\$1 muss `join` sein. **\$1eventType\$1** \$1eventType\$1 kann sein. + `join_req_received` + `rejoin_req_0_received` + `rejoin_req_2_received` + `join_accepted` **\$1resourceID\$1** \$1resourceID\$1 kann `dev_eui` oder `wireless_device_id` sein. Sie können beispielsweise die folgenden Themen abonnieren, um eine Ereignisbenachrichtigung zu erhalten, wenn Sie AWS IoT Core für LoRaWAN eine Join-Anfrage von Ihren Geräten akzeptiert haben. `$aws/iotwireless/events/join/join_accepted/lorawan/wireless_devices/wireless_device_id/{id}` Sie können auch das Platzhalterzeichen `+` verwenden, um mehrere Themen gleichzeitig zu abonnieren. Das Platzhalterzeichen `+` entspricht einer beliebigen Zeichenfolge in der Ebene, die das Zeichen enthält, z. B. im folgenden Thema: `$aws/iotwireless/events/join/join_req_received/lorawan/wireless_devices/wireless_device_id/+` **Anmerkung** Sie können das Platzhalterzeichen `#` nicht verwenden, um die reservierten Themen zu abonnieren. Weitere Informationen zur Verwendung des Platzhalters `+` beim Abonnieren von Themen finden Sie unter [MQTT-Themenfilter](https://docs.aws.amazon.com/iot/latest/developerguide/topicfilters.html) im *AWS IoT-Entwicklerhandbuch*. ## Nachrichten-Payload für das LoRaWAN-Join-Ereignis Im Folgenden wird die Nachrichtennutzlast für das LoRaWAN-Join-Ereignis angezeigt. ``` { // General fields "eventId": "string", "eventType": "join_req_received|rejoin_req_0_received|rejoin_req_2_received|join_accepted", "WirelessDeviceId": "string", "timestamp": "timestamp", // Event-specific fields "LoRaWAN": { "DevEui": "string", // The fields below are optional indicating that it can be a null value. "DevAddr": "string", "JoinEui": "string", "AppEui": "string", } } ``` Die Nutzlast enthält die folgenden Attribute: **eventId** Eine eindeutige Ereignis-ID, die von AWS IoT Core für LoRaWAN (Zeichenfolge) generiert wird. **eventType** Die Art des Ereignisses, das eingetreten ist. Dabei kann es sich um einen der folgenden Werte handeln: + `join_req_received`: In diesem Feld werden die EUI-Parameter `JoinEui` oder `AppEui` angezeigt + `rejoin_req_0_received` + `rejoin_req_2_received` + `join_accepted`: In diesem Feld wird das `NetId` und `DevAddr` angezeigt. **wirelessDeviceId** Die ID des LoRaWAN-Geräts. **timestamp** Der Unix-Zeitstempel für den Zeitpunkt, an dem das Ereignis aufgetreten ist. **DevEui** Die eindeutige Kennung des Geräts, die auf dem Geräteetikett oder der Gerätedokumentation zu finden ist. **DevAddr und EUIs (optional)** Diese Felder sind die optionale Geräteadresse und die EUI-Parameter `JoinEUI` oder `AppEUI`. # Ereignisse des Verbindungsstatus AWS IoT Core für LoRaWAN kann Nachrichten veröffentlichen, um Sie über Verbindungsstatusereignisse für LoRaWAN-Gateways zu informieren, die Sie zu AWS IoT hinzufügen. Verbindungsstatus-Ereignisse benachrichtigen Sie, wenn sich der Verbindungsstatus eines LoRaWAN-Gateways auf verbunden oder getrennt ändert. ## Wie Verbindungsstatus-Ereignisse funktionieren Nachdem Sie Ihr Gateway in AWS IoT Core für LoRaWAN integriert haben, können Sie Ihr Gateway mit AWS IoT Core für LoRaWAN verbinden und dessen Verbindungsstatus überprüfen. Dieses Ereignis benachrichtigt Sie, wenn sich der Verbindungsstatus Ihres Gateways auf verbunden oder getrennt ändert. Weitere Informationen zum Onboarding und zur Verbindung Ihres Gateways mit diesem finden Sie AWS IoT Core für LoRaWAN unter [Einbinden Ihrer Gateways in AWS IoT Core für LoRaWAN](lorawan-onboard-gateways.md) und [Verbinden Ihres LoRaWAN-Gateways und Überprüfung des Verbindungsstatus](lorawan-gateway-connection-status.md). ## Format der MQTT-Themen für LoRaWAN-Gateways Reservierte MQTT-Themen für LoRaWAN-Gateways verwenden das folgende Format. Wenn Sie diese Themen abonniert haben, können alle LoRaWAN-Gateways, die bei Ihrem AWS-Konto registriert sind, die Benachrichtigung erhalten: + Für Themen auf Ressourcenebene: `$aws/iotwireless/events/{eventName}/{eventType}/lorawan/wireless_gateways` + Für Kennungsthemen: `$aws/iotwireless/events/{eventName}/{eventType}/lorawan/wireless_gateways/{resourceID}/{id}` Wobei gilt: **\$1eventName\$1** \$1eventName\$1 muss `connection_status` sein. **\$1eventType\$1** \$1eventType\$1 kann `connected` oder `disconnected` sein. **\$1resourceID\$1** \$1resourceID\$1 kann `gateway_eui` oder `wireless_gateway_id` sein. Sie können beispielsweise die folgenden Themen abonnieren, um eine Ereignisbenachrichtigung zu erhalten, wenn alle Ihre Gateways eine Verbindung zu AWS IoT Core für LoRaWAN hergestellt haben: `$aws/iotwireless/events/connection_status/connected/lorawan/wireless_gateways/wireless_gateway_id/{id}` Sie können auch das Platzhalterzeichen `+` verwenden, um mehrere Themen gleichzeitig zu abonnieren. Das Platzhalterzeichen `+` entspricht einer beliebigen Zeichenfolge in der Ebene, die das Zeichen enthält, z. B. im folgenden Thema: `$aws/iotwireless/events/connection_status/connected/lorawan/wireless_gateways/wireless_gateway_id/+` **Anmerkung** Sie können das Platzhalterzeichen `#` nicht verwenden, um die reservierten Themen zu abonnieren. Weitere Informationen zur Verwendung des Platzhalters `+` beim Abonnieren von Themen finden Sie unter [MQTT-Themenfilter](https://docs.aws.amazon.com/iot/latest/developerguide/topicfilters.html) im *AWS IoT-Entwicklerhandbuch*. ## Nachrichten-Payload für Verbindungsstatusereignisse Im Folgenden wird die Nachrichtennutzlast für das Verbindungsstatusereignis dargestellt. ``` { // General fields "eventId": "string", "eventType": "connected|disconnected", "WirelessGatewayId": "string", "timestamp": "timestamp", // Event-specific fields "LoRaWAN": { "GatewayEui": "string" } } ``` Die Nutzlast enthält die folgenden Attribute: **eventId** Eine eindeutige Ereignis-ID, die von AWS IoT Core für LoRaWAN (Zeichenfolge) generiert wird. **eventType** Die Art des Ereignisses, das eingetreten ist. Kann `connected` oder `disconnected` sein. **wirelessGatewayId** Die ID des LoRaWAN-Gateways. **timestamp** Der Unix-Zeitstempel für den Zeitpunkt, an dem das Ereignis aufgetreten ist. **GatewayEui** Die eindeutige Kennung des Gateways, die auf dem Gateway-Label oder der Gateway-Dokumentation zu finden ist. # Ereignisbenachrichtigungen für Sidewalk-Ressourcen Sie können die API-Operationen AWS-Managementkonsole oder AWS IoT Wireless verwenden, um Sie über Ereignisse für Ihre Sidewalk-Geräte und Partnerkonten zu informieren. Informationen zu Ereignisbenachrichtigungen und deren Aktivierung finden Sie unter [Ereignis-Benachrichtigungen für AWS IoT Wireless](iot-wireless-events.md) und [Ereignisse für Drahtlos-Ressourcen aktivieren](iot-wireless-control-events.md). ## Ereignistypen für Sidewalk-Ressourcen Zu den Ereignissen, die Sie für Ihre Sidewalk-Ressourcen aktivieren können, gehören: + Geräteereignisse, die Sie über Statusänderungen Ihres Sidewalk-Geräts informieren, z. B. wenn das Gerät registriert wurde und betriebsbereit ist. + Nähe-Ereignisse, die Sie benachrichtigen, wenn AWS IoT Wireless eine Benachrichtigung von Amazon Sidewalk erhalten, dass ein Beacon entdeckt wurde oder verloren gegangen ist. Die folgenden Abschnitte enthalten weitere Informationen zu den Ereignissen für Ihre Sidewalk-Ressourcen: **Topics** + [ ## Ereignistypen für Sidewalk-Ressourcen ](#iot-sidewalk-event-types) + [ # Ereignisse im Status der Geräteregistrierung ](iot-sidewalk-device-events.md) + [ # Proxy-Ereignisse ](iot-sidewalk-proximity-events.md) # Ereignisse im Status der Geräteregistrierung Ereignisse mit dem Status der Geräteregistrierung veröffentlichen Ereignisbenachrichtigungen, wenn sich der Status der Geräteregistrierung ändert, z. B. wenn ein Sidewalk-Gerät bereitgestellt oder registriert wurde. Die Ereignisse liefern Ihnen Informationen über die verschiedenen Status, die das Gerät von der Bereitstellung bis zur Registrierung durchläuft. ## So funktionieren Ereignisse mit dem Status der Geräteregistrierung Wenn Sie Ihr Sidewalk-Gerät bei Amazon Sidewalk und AWS IoT Wireless einbinden, führt AWS IoT Wireless einen `create`-Vorgang aus und fügt Ihr Sidewalk-Gerät zu Ihrem AWS-Konto hinzu. Ihr Gerät wechselt dann in den Status „Bereitgestellt“ und `eventType` wird `provisioned`. Weitere Informationen zum Onboarding von Geräten finden Sie unter [Erste Schritte mit AWS IoT Core für Amazon Sidewalk](sidewalk-getting-started.md). Nachdem das Gerät `provisioned` wurde, führt Amazon Sidewalk einen `register`-Vorgang durch, bei dem Ihr Sidewalk-Gerät mit AWS IoT Wireless registriert wird. Der Registrierungsprozess beginnt, wo die Verschlüsselung und die Sitzungsschlüssel mit AWS IoT eingerichtet werden. Wenn das Gerät registriert ist, wird `eventType` das `registered` und Ihr Gerät ist einsatzbereit. Nachdem das Gerät `registered` wurde, kann Sidewalk eine `deregister`-Anfrage Ihr Gerät senden. AWS IoT Wireless erfüllt dann die Anfrage und ändert den Gerätestatus wieder auf `provisioned`. Weitere Informationen über die Gerätezustände finden Sie unter [DeviceState](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_SidewalkDeviceMetadata.html#iotwireless-Type-SidewalkDeviceMetadata-DeviceState). ## Aktiviert Benachrichtigungen für Ereignisse mit dem Status der Geräteregistrierung Bevor Subscriber der reservierten Geräteregistrierungs-Themen Nachrichten empfangen können, müssen Sie für sie Ereignisbenachrichtigungen über die AWS-Managementkonsole oder mithilfe der API oder CLI aktivieren. Sie können diese Ereignisse für alle Sidewalk-Ressourcen in Ihren AWS-Konto oder für ausgewählte Ressourcen aktivieren. Weitere Informationen darüber, wie Sie diese Ereignisse einrichten finden Sie unter [Ereignisse für Drahtlos-Ressourcen aktivieren](iot-wireless-control-events.md). ## Format der MQTT-Themen für Ereignisse mit dem Status der Geräteregistrierung Um Sie über Ereignisse mit dem Status der Geräteregistrierung zu informieren, können Sie für MQTT reservierte Themen abonnieren, die mit einem Dollarzeichen (\$1) beginnen. Weitere Informationen finden Sie unter [MQTT-Themen](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) im *AWS IoT-Entwicklerhandbuch*. Reservierte MQTT-Themen für Ereignisse mit dem Status der Sidewalk-Geräteregistrierung verwenden das folgende Format: + Für Themen auf Ressourcenebene: `$aws/iotwireless/events/{eventName}/{eventType}/sidewalk/wireless_devices` + Für Kennungsthemen: `$aws/iotwireless/events/{eventName}/{eventType}/sidewalk/{resourceType}/{resourceID}/{id}` Wobei gilt: **\$1eventName\$1** \$1eventName\$1 muss `device_registation_state` sein. **\$1eventType\$1** \$1eventType\$1 kann `provisioned` oder `registered` sein. **\$1resourceType\$1** \$1resourceType\$1 kann `sidewalk_accounts` oder `wireless_devices` sein. **\$1resourceID\$1** \$1resourceID\$1 ist `amazon_id` für \$1resourceType\$1 von `sidewalk_accounts` und `wireless_device_id` für \$1resourceType\$1 von `wireless_devices`. Sie können auch das Platzhalterzeichen `+` verwenden, um mehrere Themen gleichzeitig zu abonnieren. Das Platzhalterzeichen `+` entspricht einer beliebigen Zeichenfolge in der Ebene, die das Zeichen enthält. Wenn Sie beispielsweise über alle möglichen Ereignistypen (`provisioned` und `registered`) und für alle Geräte, die mit einer bestimmten Amazon-ID registriert sind, informiert werden möchten, können Sie den folgenden Themenfilter verwenden: `$aws/iotwireless/events/device_registration_state/+/sidewalk/sidewalk_accounts/amazon_id/+` **Anmerkung** Sie können das Platzhalterzeichen `#` nicht verwenden, um die reservierten Themen zu abonnieren. Weitere Informationen zu Themenfiltern finden Sie unter [MQTT-Themenfilter](https://docs.aws.amazon.com/iot/latest/developerguide/topicfilters.html) im *AWS IoT-Entwicklerhandbuch*. ## Nachrichten-Payload für Ereignisse im Zusammenhang mit dem Status der Geräteregistrierung Nachdem Sie Benachrichtigungen für Ereignisse mit dem Status der Geräteregistrierung aktiviert haben, werden Ereignisbenachrichtigungen über MQTT mit einer JSON-Nutzlast veröffentlicht. Diese Ereignisse enthalten die folgende Beispielnutzlast: ``` { "eventId": "string", "eventType": "provisioned|registered", "WirelessDeviceId": "string", "timestamp": "timestamp", // Event-specific fields "operation": "create|deregister|register", "Sidewalk": { "AmazonId": "string", "SidewalkManufacturingSn": "string" } } ``` Die Nutzlast enthält die folgenden Attribute: **eventId** Eine eindeutige Ereignis-ID (Zeichenfolge). **eventType** Die Art des Ereignisses, das eingetreten ist. Kann `provisioned` oder `registered` sein. **wirelessDeviceId** Die Kennung des drahtlosen Geräts. **timestamp** Der Unix-Zeitstempel für den Zeitpunkt, an dem das Ereignis aufgetreten ist. **Operation beschleunigen** Die Operation, die das Ereignis ausgelöst hat. Gültige Werte sind `create`, `register` und `deregister`. **sidewalk** Die Sidewalk-Amazon-ID oder `SidewalkManufacturingSn` für die Sie Ereignisbenachrichtigungen erhalten möchten. # Proxy-Ereignisse Proxy-Ereignisse veröffentlichen Ereignisbenachrichtigungen, wenn AWS IoT ein Signal vom Sidewalk-Gerät empfängt. Wenn sich Ihr Sidewalk-Gerät Amazon Sidewalk nähert, werden Beacons, die von Ihrem Gerät gesendet werden, in regelmäßigen Abständen von Amazon Sidewalk gefiltert und AWS IoT Wireless von empfangen. AWS IoT Wireless benachrichtigt Sie dann über diese Ereignisse, wenn ein Beacon empfangen wird. ## Wie Nähe-Ereignisse funktionieren Nähe-Ereignisse benachrichtigen Sie, wenn AWS IoT ein Beacon empfängt. Ihre Sidewalk-Geräte können jederzeit Beacons ausgeben. Wenn sich Ihr Gerät in der Nähe von Amazon Sidewalk befindet, empfängt Sidewalk die Beacons und leitet sie in regelmäßigen Zeitabständen an AWS IoT Wirelessweiter. Amazon Sidewalk hat dieses Zeitintervall auf 10 Minuten konfiguriert. Wenn AWS IoT Wireless das Signal von Sidewalk empfängt, werden Sie über das Ereignis informiert. Nähe-Ereignisse benachrichtigen Sie, wenn ein Beacon erkannt wird oder verloren geht. Sie können die Intervalle konfigurieren, in denen Sie über das Nähe-Ereignis benachrichtigt werden. ## Aktivieren Sie Benachrichtigungen für Nähe-Ereignisse Bevor Subscriber der reservierten Sidewalk-Nähe-Themen Nachrichten empfangen können, müssen Sie für sie Ereignisbenachrichtigungen über die AWS-Managementkonsole oder mithilfe der API oder CLI aktivieren. Sie können diese Ereignisse für alle Sidewalk-Ressourcen in Ihren AWS-Konto oder für ausgewählte Ressourcen aktivieren. Weitere Informationen darüber, wie Sie diese Ereignisse einrichten finden Sie unter [Ereignisse für Drahtlos-Ressourcen aktivieren](iot-wireless-control-events.md). ## Format der MQTT-Themen für Nähe-Ereignisse Um Sie über Nähe-Ereignisse zu informieren, können Sie reservierte MQTT-Themen abonnieren, die mit einem Dollarzeichen (\$1) beginnen. Weitere Informationen finden Sie unter [MQTT-Themen](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) im *AWS IoT-Entwicklerhandbuch*. Reservierte MQTT-Themen für Sidewalk-Nähe-Ereignisse verwenden das folgende Format: + Für Themen auf Ressourcenebene: `$aws/iotwireless/events/{eventName}/{eventType}/sidewalk/wireless_devices` + Für Kennungsthemen: `$aws/iotwireless/events/{eventName}/{eventType}/sidewalk/{resourceType}/{resourceID}/{id}` Wobei gilt: **\$1eventName\$1** \$1eventName\$1 muss `proximity` sein. **\$1eventType\$1** \$1eventType\$1 kann `beacon_discovered` oder `beacon_lost` sein. **\$1resourceType\$1** \$1resourceType\$1 kann `sidewalk_accounts` oder `wireless_devices` sein. **\$1resourceID\$1** \$1resourceID\$1 ist `amazon_id` für \$1resourceType\$1 von `sidewalk_accounts` und `wireless_device_id` für \$1resourceType\$1 von `wireless_devices`. Sie können auch das Platzhalterzeichen `+` verwenden, um mehrere Themen gleichzeitig zu abonnieren. Das Platzhalterzeichen `+` entspricht einer beliebigen Zeichenfolge in der Ebene, die das Zeichen enthält. Wenn Sie beispielsweise über alle möglichen Ereignistypen (`beacon_discovered` und `beacon_lost`) und für alle Geräte, die mit einer bestimmten Amazon-ID registriert sind, informiert werden möchten, können Sie den folgenden Themenfilter verwenden: `$aws/iotwireless/events/proximity/+/sidewalk/sidewalk_accounts/amazon_id/+` **Anmerkung** Sie können das Platzhalterzeichen `#` nicht verwenden, um die reservierten Themen zu abonnieren. Weitere Informationen zu Themenfiltern finden Sie unter [MQTT-Themenfilter](https://docs.aws.amazon.com/iot/latest/developerguide/topicfilters.html) im *AWS IoT-Entwicklerhandbuch*. ## Nachrichten-Payload für Nähe-Ereignisse Nachdem Sie Benachrichtigungen für Nähe-Ereignisse aktiviert haben, werden Ereignisnachrichten über MQTT mit einer JSON-Nutzlast veröffentlicht. Diese Ereignisse enthalten die folgende Beispielnutzlast: ``` { "eventId": "string", "eventType": "beacon_discovered|beacon_lost", "WirelessDeviceId": "string", "timestamp": "1234567890123", // Event-specific fields "Sidewalk": { "AmazonId": "string", "SidewalkManufacturingSn": "string" } } ``` Die Nutzlast enthält die folgenden Attribute: **eventId** Eine eindeutige Ereignis-ID, bei der es sich um eine Zeichenfolge handelt. **eventType** Die Art des Ereignisses, das eingetreten ist. Kann `beacon_discovered` oder `beacon_lost` sein. **WirelessDeviceId** Die Kennung des drahtlosen Geräts. **timestamp** Der Unix-Zeitstempel für den Zeitpunkt, an dem das Ereignis aufgetreten ist. **sidewalk** Die Sidewalk-Amazon-ID oder `SidewalkManufacturingSn` für die Sie Ereignisbenachrichtigungen erhalten möchten.