Como as mensagens de eventos são geradas Habilitar eventos para AWS IoT

Mensagens de eventos

Esta seção contém informações sobre mensagens publicadas AWS IoT quando itens ou trabalhos são atualizados ou alterados. Para obter informações sobre o AWS IoT Events serviço que permite criar detectores para monitorar seus dispositivos em busca de falhas ou alterações na operação e para acionar ações quando elas ocorrerem, consulte AWS IoT Events.

Como as mensagens de eventos são geradas

AWS IoT publica mensagens de eventos quando determinados eventos ocorrem. Por exemplo, os eventos são gerados pelo registro quando as objetos são adicionadas, atualizadas ou excluídas. Cada evento faz com que uma única mensagem de evento seja enviada. As mensagens de eventos são publicadas por meio do MQTT com uma carga JSON. O conteúdo da carga depende do tipo do evento.

nota

Há garantia de que as mensagens de eventos sejam publicadas uma vez. É possível que elas sejam publicadas mais de uma vez. A ordenação das mensagens de eventos não é garantida.

Política para receber mensagens de eventos

Para receber mensagens de eventos, seu dispositivo deve usar uma política apropriada que permita que ele se conecte ao gateway do AWS IoT dispositivo e assine os tópicos de eventos do MQTT. Você também deve assinar os filtros apropriados dos tópicos.

Veja a seguir um exemplo da política necessária para o recebimento de eventos de ciclo de vida:


{
    "Version":"2012-10-17",
    "Statement":[{
        "Effect":"Allow",
        "Action":[
            "iot:Subscribe",
            "iot:Receive"
        ],
        "Resource":[
            "arn:aws:iot:region:account:/$aws/events/*"
        ]
    }]
}

Habilitar eventos para AWS IoT

Antes que os assinantes dos tópicos reservados possam receber mensagens, você deve habilitar as mensagens de eventos do AWS Management Console ou usando a API ou a CLI. Para obter informações sobre as mensagens de eventos que as diferentes opções gerenciam, consulte a Tabela de configurações de AWS IoT eventos.

Para habilitar mensagens de eventos, acesse a guia Configurações do AWS IoT console e, na seção Mensagens baseadas em eventos, escolha Gerenciar eventos. Você pode especificar os eventos que deseja gerenciar.
Para controlar quais tipos de eventos são publicados usando a API ou a CLI, chame a API de UpdateEventconfigurações ou use o comando da update-event-configurations CLI. Por exemplo: .
```
aws iot update-event-configurations --event-configurations "{\"THING\":{\"Enabled\": true}}"
```

nota

Todas as aspas (") são recuadas com uma barra invertida (\).

Você pode obter a configuração atual do evento chamando a API de DescribeEventconfigurações ou usando o comando describe-event-configurations CLI. Por exemplo: .


aws iot describe-event-configurations

Tabela de configurações de eventos de AWS IoT

Categoria de evento (AWS IoT Console: Configurações: mensagens baseadas em eventos)	Valor da chave `eventConfigurations` (AWS CLI/API)	Tópico de mensagens de evento
(Só pode ser configurado usando a AWS CLI/API)	`CA_CERTIFICATE`	`$aws/events/certificates/registered/caCertificateId`
(Só pode ser configurado usando a AWS CLI/API)	`CERTIFICATE`	`$aws/events/presence/connected/clientId`
(Só pode ser configurado usando a AWS CLI/API)	`CERTIFICATE`	`$aws/events/presence/disconnected/clientId`
(Só pode ser configurado usando a AWS CLI/API)	`CERTIFICATE`	`$aws/events/subscriptions/subscribed/clientId`
(Só pode ser configurado usando a AWS CLI/API)	`CERTIFICATE`	`$aws/events/subscriptions/unsubscribed/clientId`
Trabalho concluído, cancelado	`JOB`	`$aws/events/job/jobID/canceled`
Trabalho concluído, cancelado	`JOB`	`$aws/events/job/jobID/cancellation_in_progress`
Trabalho concluído, cancelado	`JOB`	`$aws/events/job/jobID/completed`
Trabalho concluído, cancelado	`JOB`	`$aws/events/job/jobID/deleted`
Trabalho concluído, cancelado	`JOB`	`$aws/events/job/jobID/deletion_in_progress`
Execução do trabalho: sucesso, falha, rejeitado, cancelado, removido	`JOB_EXECUTION`	`$aws/events/jobExecution/jobID/canceled`
Execução do trabalho: sucesso, falha, rejeitado, cancelado, removido	`JOB_EXECUTION`	`$aws/events/jobExecution/jobID/deleted`
Execução do trabalho: sucesso, falha, rejeitado, cancelado, removido	`JOB_EXECUTION`	`$aws/events/jobExecution/jobID/failed`
Execução do trabalho: sucesso, falha, rejeitado, cancelado, removido	`JOB_EXECUTION`	`$aws/events/jobExecution/jobID/rejected`
Execução do trabalho: sucesso, falha, rejeitado, cancelado, removido	`JOB_EXECUTION`	`$aws/events/jobExecution/jobID/removed`
Execução do trabalho: sucesso, falha, rejeitado, cancelado, removido	`JOB_EXECUTION`	`$aws/events/jobExecution/jobID/succeeded`
Execução do trabalho: sucesso, falha, rejeitado, cancelado, removido	`JOB_EXECUTION`	`$aws/events/jobExecution/jobID/timed_out`
Objeto: criado, atualizado, excluído	`THING`	`$aws/events/thing/thingName/created`
Objeto: criado, atualizado, excluído	`THING`	`$aws/events/thing/thingName/updated`
Objeto: criado, atualizado, excluído	`THING`	`$aws/events/thing/thingName/deleted`
Grupo de objetos: adicionado, removido	`THING_GROUP`	`$aws/events/thingGroup/thingGroupName/created`
Grupo de objetos: adicionado, removido	`THING_GROUP`	`$aws/events/thingGroup/thingGroupName/updated`
Grupo de objetos: adicionado, removido	`THING_GROUP`	`$aws/events/thingGroup/thingGroupName/deleted`
Hierarquia de grupos de objetos: adicionada, removida	`THING_GROUP_HIERARCHY`	`$aws/events/thingGroupHierarchy/thingGroup/parentThingGroupName/childThingGroup/childThingGroupName/added`
Hierarquia de grupos de objetos: adicionada, removida	`THING_GROUP_HIERARCHY`	`$aws/events/thingGroupHierarchy/thingGroup/parentThingGroupName/childThingGroup/childThingGroupName/removed`
Associação ao grupo de objetos: adicionada, removida	`THING_GROUP_MEMBERSHIP`	`$aws/events/thingGroupMembership/thingGroup/thingGroupName/thing/thingName/added`
Associação ao grupo de objetos: adicionada, removida	`THING_GROUP_MEMBERSHIP`	`$aws/events/thingGroupMembership/thingGroup/thingGroupName/thing/thingName/removed`
Tipo de objeto: criada, atualizada, excluída	`THING_TYPE`	`$aws/events/thingType/thingTypeName/created`
Tipo de objeto: criada, atualizada, excluída	`THING_TYPE`	`$aws/events/thingType/thingTypeName/updated`
Tipo de objeto: criada, atualizada, excluída	`THING_TYPE`	`$aws/events/thingType/thingTypeName/deleted`
Associação do tipo de objeto: adicionada, removida	`THING_TYPE_ASSOCIATION`	`$aws/events/thingTypeAssociation/thing/thingName/thingType/thingTypeName/added` `$aws/events/thingTypeAssociation/thing/thingName/thingType/thingTypeName/removed`

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Solucionadores de localização e carga do dispositivo

Eventos de registro