Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Événements du cycle de vie

AWS IoT peut publier les événements du cycle de vie sur les MQTT sujets. Ces événements sont disponibles par défaut et ne peuvent pas être désactivés.

Événements de connexion/déconnexion

AWS IoT publie un message dans les MQTT rubriques suivantes lorsqu'un client se connecte ou se déconnecte :

Vous trouverez ci-dessous une liste des JSON éléments contenus dans les messages de connexion/déconnexion publiés dans le sujet. $aws/events/presence/connected/clientId

Un message de connexion présente la structure suivante.

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

Un message de déconnexion présente la structure suivante.

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

Gestion des déconnexions du client

La meilleure pratique consiste à toujours implémenter un état d'attente pour les événements du cycle de vie, y compris les messages Last Will and Testament (LWT). À réception d'un message de déconnexion, votre code doit déclencher un délai d'attente et vérifier si un appareil est toujours hors ligne avant de prendre des mesures. Pour ce faire, vous pouvez utiliser SQS les files d'attente. Lorsqu'un client reçoit un événement LWT ou un événement du cycle de vie, vous pouvez mettre un message en file d'attente (par exemple, pendant 5 secondes). Lorsque ce message est disponible et traité (par Lambda ou un autre service), vous pouvez commencer par vérifier si l'appareil est toujours hors connexion avant de prendre d'autres mesures.

Événement d'échec de tentative de connexion

AWS IoT publie un message dans la MQTT rubrique suivante lorsqu'un client n'est pas autorisé à se connecter ou lorsqu'un dernier testament est configuré et que le client n'est pas autorisé à publier sur cette rubrique testamentaire.

$aws/events/presence/connect_failed/clientId

Vous trouverez ci-dessous une liste des JSON éléments contenus dans les messages d'autorisation de connexion publiés dans le $aws/events/presence/connect_failed/clientId sujet.

La structure d'un message d'échec de connexion est la suivante.

{
    "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"
}

Événements d'abonnement/désabonnement

AWS IoT publie un message dans la MQTT rubrique suivante lorsqu'un client s'abonne ou se désabonne à une rubrique : MQTT

$aws/events/subscriptions/subscribed/clientId

or

$aws/events/subscriptions/unsubscribed/clientId

Où se clientId trouve l'ID MQTT client qui se connecte au courtier de AWS IoT messages.

Le message publié sur cette rubrique a la structure suivante :

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

Vous trouverez ci-dessous une liste des JSON éléments contenus dans les messages abonnés et désabonnés publiés dans les $aws/events/subscriptions/unsubscribed/clientId rubriques $aws/events/subscriptions/subscribed/clientId et.