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á.

Eventos de ciclo de vida

AWS IoT pode publicar eventos do ciclo de vida sobre os MQTT tópicos. Esses eventos estão disponíveis por padrão e não podem ser desativados.

Eventos de conexão/desconexão

AWS IoT publica uma mensagem nos seguintes MQTT tópicos quando um cliente se conecta ou desconecta:

A seguir está uma lista dos JSON elementos contidos nas mensagens de conexão/desconexão publicadas no tópico. $aws/events/presence/connected/clientId

Uma mensagem de conexão tem a seguinte estrutura.

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

Uma mensagem de desconexão tem a seguinte estrutura.

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

Gerenciamento de desconexões de clientes

A melhor prática é sempre ter um estado de espera implementado para eventos do ciclo de vida, incluindo mensagens de Last Will e Testament (LWT). Quando uma mensagem de desconexão é recebida, seu código deve aguardar um período e verificar se um dispositivo ainda está offline antes de realizar uma ação. Uma maneira de fazer isso é usando SQSDelay Queues. Quando um cliente recebe um evento de ciclo de vida LWT ou um evento de ciclo de vida, você pode enfileirar uma mensagem (por exemplo, por 5 segundos). Quando essa mensagem se torna disponível e é processada (pelo Lambda ou outro serviço), você pode primeiro verificar se o dispositivo ainda está off-line antes de realizar outras ações.

Evento de falha na tentativa de conexão

AWS IoT publica uma mensagem no MQTT tópico a seguir quando um cliente não está autorizado a se conectar ou quando um último testamento e testamento são configurados e o cliente não está autorizado a publicar nesse tópico do último testamento.

$aws/events/presence/connect_failed/clientId

A seguir está uma lista dos JSON elementos contidos nas mensagens de autorização de conexão publicadas no $aws/events/presence/connect_failed/clientId tópico.

Uma mensagem de falha de conexão tem a seguinte estrutura.

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

Eventos de assinatura/cancelamento de assinatura

AWS IoT publica uma mensagem no MQTT tópico a seguir quando um cliente assina ou cancela a assinatura de um tópico: MQTT

$aws/events/subscriptions/subscribed/clientId

or

$aws/events/subscriptions/unsubscribed/clientId

Onde clientId está o ID MQTT do cliente que se conecta ao agente de AWS IoT mensagens.

A mensagem publicada para este tópico tem a seguinte estrutura:

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

A seguir está uma lista dos JSON elementos contidos nas mensagens assinadas e não assinadas publicadas nos tópicos e. $aws/events/subscriptions/subscribed/clientId $aws/events/subscriptions/unsubscribed/clientId