Demandes d'état de connectivité de l'appareil - AWS IoT Core
Comment ça marcheFonctionnalitésAvantagesPrérequisExemples

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.

Demandes d'état de connectivité de l'appareil

AWS IoT Fleet Indexing prend en charge les requêtes de connectivité individuelles des appareils, ce qui vous permet de récupérer efficacement l'état de connectivité et les métadonnées associées pour des appareils spécifiques. Cette fonctionnalité complète les fonctionnalités d'indexation et d'interrogation existantes à l'échelle du parc.

Comment ça marche

La prise en charge des requêtes de connectivité des appareils peut être utilisée pour une récupération optimisée de l'état de connectivité d'un seul appareil. Cette API fournit un accès à faible latence et à haut débit aux informations de connectivité spécifiques aux appareils les plus récentes. Une fois que vous aurez activé l'indexation de connectivité, vous aurez accès à cette API de requête qui sera facturée en tant que requêtes standard. Pour plus d'informations, consultez la section Tarification de la gestion des AWS IoT appareils

Fonctionnalités

Grâce à la prise en charge des requêtes relatives à la connectivité des appareils, vous pouvez :

  1. Recherchez l'état de connectivité actuel (connecté ou déconnecté) d'un appareil donné à l'aide de sonthingName.

  2. Récupérez des métadonnées de connectivité supplémentaires, notamment :

    1. Raison de la déconnexion

    2. Horodatage du dernier événement de connexion ou de déconnexion.

Note

L'indexation de flotte indexe l'état de connectivité d'un appareil dont la connexion clientId est identique à celle thingName d'un objet enregistré dans le registre .

Avantages

  1. Faible latence : reflète l'état de connectivité le plus récent de l'appareil et offre une faible latence pour refléter les changements d'état de connexion depuis IoT Core. IoT Core détermine qu'un appareil est déconnecté soit dès qu'il reçoit une demande de déconnexion de la part de l'appareil, soit dans le cas où un appareil se déconnecte sans envoyer de demande de déconnexion. Le cœur de l'IoT attendra 1,5 fois le temps de maintien en vie configuré avant qu'il ne soit déterminé que le client est déconnecté. L'API d'état de la connectivité reflétera ces changements généralement moins d'une seconde après que IoT Core ait déterminé le changement d'état de connexion d'un appareil.

  2. Haut débit : prend en charge 350 transactions par seconde (TPS) par défaut et peut être ajusté à un niveau supérieur sur demande.

  3. Conservation des données : stocke les données des événements indéfiniment lorsque le ConnectivityIndexing mode Fleet Indexing (FI) est activé et que l'objet n'est pas supprimé. Si vous désactivez l'indexation de connectivité, les enregistrements ne seront pas conservés.

Note

Si l'indexation de l'état de connectivité a été activée avant le lancement de cette API, Fleet Indexing commence à suivre les modifications de l'état de connectivité après le lancement de l'API et reflète le statut mis à jour en fonction de ces modifications.

Prérequis

Pour utiliser la prise en charge des requêtes de connectivité de l'appareil :

  1. Créez un AWS compte

  2. Intégrez et enregistrez les appareils AWS IoT Core dans votre région préférée

  3. Activez l'indexation de la flotte grâce à l'indexation de la connectivité

Note

Aucune configuration supplémentaire n'est requise si l'indexation de connectivité est déjà activée

Pour des instructions de configuration détaillées, reportez-vous au guide du AWS IoT développeur

Exemples

aws iot get-thing-connectivity-data --thing-name myThingName

{
   "connected": true,
   "disconnectReason": "NONE",
   "thingName": "myThingName",
   "timestamp": "2024-12-19T10:00:00.000000-08:00"
}

  • thingName: nom de l'appareil tel qu'indiqué dans la demande. Cela correspond également au ClientiD utilisé pour se connecter. AWS IoT Core

  • disconnectReason: Motif de la déconnexion. Ce sera AUCUN pour un appareil connecté.

  • connected: valeur booléenne vraie indiquant que cet appareil est actuellement connecté.

  • timestamp: horodatage représentant la dernière déconnexion de l'appareil en millisecondes.

aws iot get-thing-connectivity-data --thing-name myThingName

{
   "connected": false,
   "disconnectReason": "CLIENT_INITIATED_DISCONNECT",
   "thingName": "myThingName",
   "timestamp": "2024-12-19T10:30:00.000000-08:00"
}

  • thingName: nom de l'appareil tel qu'indiqué dans la demande. Cela correspond également au ClientiD utilisé pour se connecter. AWS IoT Core

  • disconnectReason: La raison de la déconnexion est CLIENT_INITIATED_DISCONNECT, qui indique que le client a indiqué qu'il allait se AWS IoT Core déconnecter.

  • connected: valeur booléenne fausse indiquant que cet appareil est actuellement déconnecté.

  • timestamp: horodatage représentant la dernière déconnexion de l'appareil en millisecondes.

aws iot get-thing-connectivity-data --thing-name neverConnectedThing

{
   "connected": false,
   "disconnectReason": "UNKNOWN",
   "thingName": "neverConnectedThing"
}

  • thingName: nom de l'appareil tel qu'indiqué dans la demande. Cela correspond également au ClientiD utilisé pour se connecter. AWS IoT Core

  • disconnectReason: Motif de la déconnexion. Sera « INCONNU » pour un appareil qui n'a jamais été connecté ou pour lequel Fleet Indexing n'a pas enregistré la dernière raison de déconnexion.

  • connected: valeur booléenne fausse indiquant que cet appareil est actuellement déconnecté.

  • timestamp: L'horodatage n'est pas renvoyé pour un appareil qui n'a jamais été connecté ou pour lequel le dernier horodatage n'est pas enregistré dans Fleet Indexing.