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.

Ereignisse im Lebenszyklus

AWS IoT kann Lebenszyklusereignisse zu den MQTT-Themen veröffentlichen. Diese Ereignisse stehen standardmäßig zur Verfügung und können nicht deaktiviert werden.

„Verbinden/Verbindung trennen“-Ereignisse

AWS IoT veröffentlicht eine Nachricht zu den folgenden MQTT-Themen, wenn ein Client eine Verbindung herstellt oder trennt:

Im Folgenden finden Sie eine Liste der JSON-Elemente, die in den zum Thema veröffentlichten connection/disconnection Nachrichten enthalten sind. $aws/events/presence/connected/clientId

Eine Verbindungsnachricht hat die folgende Struktur.

{
    "clientId": "186b5",
    "thingName": "exampleThing",
    "timestamp": 1573002230757,
    "eventType": "connected",
    "sessionIdentifier": "00000000-0000-0000-0000-000000000000",
    "principalIdentifier": "12345678901234567890123456789012",
    "ipAddress": "192.0.2.0",
    "versionNumber": 0
}

Eine Trennungsnachricht hat die folgende Struktur.

{
    "clientId": "186b5",
    "thingName": "exampleThing",
    "timestamp": 1573002340451,
    "eventType": "disconnected",
    "sessionIdentifier": "00000000-0000-0000-0000-000000000000",
    "principalIdentifier": "12345678901234567890123456789012",
    "clientInitiatedDisconnect": true,
    "disconnectReason": "CLIENT_INITIATED_DISCONNECT",
    "versionNumber": 0
}

Umgang mit Client-Verbindungstrennungen

Es ist eine bewährte Methode, für Lebenszyklusereignisse (einschließlich Last Will and Testament (LWT)-Nachrichten) stets einen implementierten Wartestatus zu verwenden. Wenn eine getrennte Verbindung signalisiert wird, sollte Ihr Code eine gewisse Zeit warten und überprüfen, ob ein Gerät noch offline ist, bevor Maßnahmen ergriffen werden. Eine Möglichkeit dazu ist das Verwenden von SQS-Verzögerungswarteschlangen. Wenn ein Client ein LWT- oder Lebenszyklusereignis erhält, können Sie eine Nachricht für (beispielsweise) ca. 5 Sekunden in eine Warteschlange stellen. Wenn die Nachricht verfügbar ist und verarbeitet wird (durch Lambda oder einen anderen Service), können Sie zunächst überprüfen, ob das Gerät immer noch offline ist, bevor Sie zu weiteren Maßnahmen greifen.

Ereignis mit fehlgeschlagenem Verbindungsversuch

AWS IoT veröffentlicht eine Nachricht zum folgenden MQTT-Thema, wenn ein Client nicht autorisiert ist, eine Verbindung herzustellen, oder wenn ein Testament konfiguriert ist und der Client nicht berechtigt ist, zu diesem letzten Testament-Thema zu veröffentlichen.

$aws/events/presence/connect_failed/clientId

Im Folgenden finden Sie eine Liste der JSON-Elemente, die in den $aws/events/presence/connect_failed/clientId zum Thema veröffentlichten Verbindungsautorisierungsnachrichten enthalten sind.

Eine Meldung über einen Verbindungsfehler hat die folgende Struktur.

{
    "clientId": "186b5",
    "thingName": "exampleThing",
    "timestamp": 1460065214626,
    "eventType": "connect_failed",
    "connectFailureReason": "AUTHORIZATION_FAILED",
    "principalIdentifier": "12345678901234567890123456789012",
    "sessionIdentifier": "00000000-0000-0000-0000-000000000000",
    "ipAddress" : "192.0.2.0"
}

„Abonnieren/Abonnement beenden“-Ereignisse

AWS IoT veröffentlicht eine Nachricht zum folgenden MQTT-Thema, wenn ein Client ein MQTT-Thema abonniert oder abbestellt:

$aws/events/subscriptions/subscribed/clientId

or

$aws/events/subscriptions/unsubscribed/clientId

Hierbei ist clientId die MQTT-Client-ID, über die eine Verbindung zum AWS IoT Message Broker hergestellt wird.

Die im Topic veröffentlichte Nachricht weist die folgende Struktur auf:

{
    "clientId": "186b5",
    "thingName": "exampleThing",
    "timestamp": 1460065214626,
    "eventType": "subscribed" | "unsubscribed",
    "sessionIdentifier": "00000000-0000-0000-0000-000000000000",
    "principalIdentifier": "12345678901234567890123456789012",
    "topics" : ["foo/bar","device/data","dog/cat"]
}

Die nachfolgende Liste enthält JSON-Elemente, die in „Abonnieren/Abonnement abbestellen“-Nachrichten enthalten sind, die an die Topics $aws/events/subscriptions/subscribed/clientId und $aws/events/subscriptions/unsubscribed/clientId gesendet werden.