As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Consultas do status de conectividade do dispositivo
AWS IoT A indexação de frota oferece suporte à consulta de conectividade de dispositivos individuais, permitindo que você recupere com eficiência o status da conectividade e os metadados relacionados para dispositivos específicos. Esse recurso complementa os recursos existentes de indexação e consulta em toda a frota.
## Como funciona
O suporte à consulta de conectividade de dispositivos pode ser usado para recuperação otimizada do status de conectividade de um único dispositivo. Essa API fornece acesso de baixa latência e alto throughput às informações mais recentes de conectividade específicas do dispositivo. Depois de habilitar a indexação de conectividade, você terá acesso a essa API de consulta, que será cobrada como consultas padrão. Para acessar mais informações, consulte [Preços do AWS IoT Device Management](https://aws.amazon.com/iot-device-management/pricing/#:~:text=Search%20queries%20(per%2010%2C000%20queries)).
## Recursos
Com o suporte à consulta de conectividade de dispositivos, você pode:
1. Consultar o estado atual de conectividade (conectado ou desconectado) de determinado dispositivo usando o respectivo `thingName`.
1. Recuperar metadados adicionais de conectividade, incluindo:
1. Motivo da desconexão
1. Carimbos de data/hora do evento de conexão ou desconexão mais recente.
**nota**
A indexação da frota indexa o status de conectividade de um dispositivo cuja conexão `clientId` é a mesma de `thingName` de um objeto registrada no [Registro](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html).
## Benefícios
1. **Baixa latência:** reflete o estado mais recente de conectividade do dispositivo e oferece baixa latência para refletir as alterações do estado de conexão do IoT Core. O IoT Core determina que um dispositivo está desconectado assim que recebe uma solicitação de desconexão dele ou no caso de um dispositivo se desconectar sem enviar uma solicitação de desconexão. O IoT Core aguardará 1,5x do tempo de keep-alive configurado antes de decidir desconectar o cliente. A API de status da conectividade exibirá essas alterações normalmente em menos de um segundo após o IoT Core determinar a mudança de estado conectado de um dispositivo.
1. **Alto throughput:** aceita 350 transações por segundo (TPS) por padrão e pode ser ajustável para um valor maior mediante solicitação.
1. **Retenção de dados:** armazena dados de eventos indefinidamente quando o ConnectivityIndexing modo Fleet Indexing (FI) está ativado e o item não é excluído. Se você desabilitar a indexação de conectividade, os registros não serão retidos.
**nota**
Se a indexação do status de conectividade tiver sido habilitada antes do lançamento dessa API, o Fleet Indexing começará a rastrear as alterações do status de conectividade após o lançamento da API e exibirá o status atualizado com base nessas alterações.
## Pré-requisitos
Para usar o suporte à consulta de conectividade do dispositivo:
1. [Configurar uma AWS conta](https://docs.aws.amazon.com/iot/latest/developerguide/setting-up.html)
1. Integre e registre dispositivos AWS IoT Core na sua região preferida
1. [Habilite o Fleet Indexing](https://docs.aws.amazon.com/iot/latest/developerguide/managing-index.html) com indexação de conectividade.
**nota**
Nenhuma configuração adicional será necessária se você já tiver a indexação de conectividade habilitada.
Para receber instruções detalhadas de configuração, consulte o [Guia do desenvolvedor da AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/setting-up.html).
## Exemplos
```
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`: o nome do dispositivo conforme indicado na solicitação. Isso também corresponde ao clientId usado para se conectar ao AWS IoT Core.
+ `disconnectReason`: motivo da desconexão. Será NONE para um dispositivo conectado.
+ `connected`: o valor booliano verdadeiro indicando que esse dispositivo está conectado no momento.
+ `timestamp`: o carimbo de data/hora que representa a desconexão mais recente do dispositivo em milissegundos.
```
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`: o nome do dispositivo conforme indicado na solicitação. Isso também corresponde ao clientId usado para se conectar ao AWS IoT Core.
+ `disconnectReason`: O motivo da desconexão é CLIENT\$1INITIATED\$1DISCONNECT indicando que o cliente indicou que ele se desconectaria. AWS IoT Core
+ `connected`: o valor booliano falso indicando que esse dispositivo está desconectado no momento.
+ `timestamp`: o carimbo de data/hora que representa a desconexão mais recente do dispositivo em milissegundos.
```
aws iot get-thing-connectivity-data --thing-name neverConnectedThing
```
```
{
"connected": false,
"disconnectReason": "UNKNOWN",
"thingName": "neverConnectedThing"
}
```
+ `thingName`: o nome do dispositivo conforme indicado na solicitação. Isso também corresponde ao clientId usado para se conectar ao AWS IoT Core.
+ `disconnectReason`: motivo da desconexão. Será “UNKNOWN” para um dispositivo que nunca foi conectado ou para o qual o Fleet Indexing não tenha o último motivo de desconexão armazenado.
+ `connected`: o valor booliano falso indicando que esse dispositivo está desconectado no momento.
+ `timestamp`: o carimbo de data/hora não é exibido para um dispositivo que nunca foi conectado ou para o qual o Fleet Indexing não tem o último carimbo de data/hora armazenado.