Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Consultas de estado de conectividad de los dispositivos
AWS IoTLa indexación de flotas admite consultas de conectividad de dispositivos individuales, lo que le permite recuperar de manera eficiente el estado de la conectividad y los metadatos relacionados para dispositivos específicos. Esta característica complementa las capacidades de indexación y consulta existentes en toda la flota.
Funcionamiento
La compatibilidad con las consultas de conectividad de los dispositivos se puede utilizar para recuperar de forma optimizada el estado de la conectividad de un solo dispositivo. Esta API proporciona acceso de baja latencia y alto rendimiento a la información de conectividad específica del dispositivo más reciente. Una vez que habilite la indexación de conectividad, tendrá acceso a esta API de consultas, que se cobrará como consultas estándar. Para obtener más información, consulte Precios de AWS IoT Device Management
Características
Gracias a la compatibilidad con las consultas de conectividad de los dispositivos, puede:
-
Consultar el estado de conectividad actual (conectado o desconectado) de un dispositivo determinado mediante su
thingName. -
Recuperar metadatos de conectividad adicionales, como, por ejemplo:
-
Motivo de desconexión
-
Marcas de tiempo de los eventos de conexión o desconexión más recientes.
-
nota
La indexación de flotas indexa el estado de conectividad de un dispositivo cuya conexión clientId es la misma que la thingName de un dispositivo registrado en el Registro.
Ventajas
-
Baja latencia: refleja el estado de conectividad del dispositivo más reciente y ofrece una latencia baja para reflejar los cambios en el estado de la conexión con respecto a IoT Core. IoT Core determina que un dispositivo está desconectado en cuanto recibe una solicitud de desconexión del dispositivo o en caso de que un dispositivo se desconecte sin enviar una solicitud de desconexión. IoT Core esperará 1,5 veces el tiempo de keep-alive configurado antes de que se determine que el cliente está desconectado. La API de estado de conectividad reflejará estos cambios normalmente en menos de un segundo después de que IoT Core determine el cambio de estado de conexión de un dispositivo.
-
Alto rendimiento: admite 350 transacciones por segundo (TPS) de forma predeterminada y se puede ajustar en un nivel superior si se solicita.
-
Retención de datos: almacena los datos de los eventos de forma indefinida cuando el ConnectivityIndexing modo de indexación de flotas (FI) está activado y el elemento no se elimina. Si deshabilita la opción Indexación de conectividad, los registros no se conservarán.
nota
Si la indexación del estado de la conectividad estaba habilitada antes del lanzamiento de esta API, la opción Indexación de flotas comienza a realizar un seguimiento de los cambios en el estado de la conectividad después del lanzamiento de la API y refleja el estado actualizado en función de esos cambios.
Requisitos previos
Cómo utilizar el soporte de consultas sobre conectividad de dispositivos:
-
Incorpora y registra dispositivos AWS IoT Core en la región que prefieras
-
Habilitar Indexación de flotas con Indexación de conectividad
nota
No se requiere ninguna configuración adicional si ya tiene habilitada la indexación de conectividad.
Para obtener instrucciones detalladas de configuración, consulte la Guía para desarrolladores de AWS IoT.
Ejemplos
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: el nombre del dispositivo, tal y como se indica en la solicitud. También coincide con el clientId utilizado para conectarse a AWS IoT Core. -
disconnectReason: motivo de la desconexión. Será NONE para un dispositivo conectado. -
connected: el valor booleano true indica que este dispositivo está conectado actualmente. -
timestamp: la marca de tiempo que representa la última desconexión del dispositivo en milisegundos.
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: el nombre del dispositivo, tal y como se indica en la solicitud. También coincide con el clientId utilizado para conectarse a AWS IoT Core. -
disconnectReason: El motivo de la desconexión es CLIENT_INITIATED_DISCONNECT, que indica el cliente que quiere desconectarseAWS IoT Core. -
connected: el valor booleano false indica que este dispositivo está desconectado actualmente. -
timestamp: la marca de tiempo que representa la última desconexión del dispositivo en milisegundos.
aws iot get-thing-connectivity-data --thing-name neverConnectedThing
{ "connected": false, "disconnectReason": "UNKNOWN", "thingName": "neverConnectedThing" }
-
thingName: el nombre del dispositivo, tal y como se indica en la solicitud. También coincide con el clientId utilizado para conectarse a AWS IoT Core. -
disconnectReason: motivo de la desconexión. Será “UNKNOWN” para un dispositivo que nunca se haya conectado o para el que la opción Indexación de flotas no tenga almacenado el motivo de la última desconexión. -
connected: el valor booleano false indica que este dispositivo está desconectado actualmente. -
timestamp: la marca de tiempo no se devuelve para un dispositivo que nunca se haya conectado o para el que la opción Indexación de flotas no tenga almacenada la última marca de tiempo.
