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 und Ereignisbenachrichtigungen für Sidewalk-Ressourcen.

Ereignistypen auf Basis der Ressourcen
Ressource	Ressourcentyp	Ereignistyp
Drahtloses Gerät	LoRaWAN	Join
	Sidewalk	Geräteregistrierungsstatus Nähe
Drahtloses Gateway	LoRaWAN	Verbindungsstatus
Sidewalk-Konto	Sidewalk	Geräteregistrierungsstatus Nähe

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 ($) 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 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.

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	Thema auf Ressourcenebene $aws/iotwireless/events/device_registration_state/{eventType}/sidewalk/wireless_devices Thema auf Kennungsebene $aws/iotwireless/events/device_registration_state/{eventType}/sidewalk/{resourceType}/{resourceID}/{id}	{eventType} kann registered oder provisioned sein. {resourceType} kann sidewalk_accounts oder wireless_devices sein. {resourceID} ist die amazon_id für sidewalk_accounts und wireless_device_id für wireless_devices
Nähe zu Sidewalk	Thema auf Ressourcenebene $aws/iotwireless/events/proximity/{eventType}/sidewalk/wireless_devices Thema auf Kennungsebene $aws/iotwireless/events/proximity/{eventType}/sidewalk/{resourceType}/{resourceID}/{id}	{eventType} kann beacon_discovered oder beacon_lost sein. {resourceType} kann sidewalk_accounts oder wireless_devices sein. {resourceID} ist das amazon_id für sidewalk_accounts und wireless_device_id für wireless_devices
LoRaWAN-Join	Thema auf Ressourcenebene $aws/iotwireless/events/join/{eventType}/lorawan/wireless_devices Thema auf Kennungsebene $aws/iotwireless/events/join/{eventType}/lorawan/wireless_devices/{resourceID}/{id}	{eventType} kann join_req_0_received oder join_req_2_received oder join_accepted sein {resourceID} kann wireless_device_id oder dev_eui sein.
Verbindungsstatus des LoRaWAN-Gateway	Thema auf Ressourcenebene $aws/iotwireless/events/join/{eventType}/lorawan/wireless_gateways Thema auf Kennungsebene $aws/iotwireless/events/join/{eventType}/lorawan/wireless_gateways/{resourceID}/{id}	{eventType} kann connected oder disconnected sein. {resourceID} kann wireless_gateway_id oder gateway_eui sein.

Weitere Informationen zu den verschiedenen Ereignissen finden Sie unter Ereignisbenachrichtigungen für LoRaWAN-Ressourcen und Ereignisbenachrichtigungen für Sidewalk-Ressourcen.

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 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.