Eventos de registro - AWS IoT Core

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 registro

O registro pode publicar mensagens de eventos quando objetos, tipos de objetos e grupos de objetos são criados, atualizados ou excluídos. No entanto, esses eventos não estão disponíveis por padrão. Para obter mais informações sobre como ativar esses eventos, consulte Habilitar eventos para AWS IoT.

O tipo de evento ocorreu com os seguintes tipos de evento:

Eventos de objetos

Coisa Created/Updated/Deleted

O registro publica as seguintes mensagens de eventos quando as objetos são criadas, atualizadas ou excluídas:

  • $aws/events/thing/thingName/created

  • $aws/events/thing/thingName/updated

  • $aws/events/thing/thingName/deleted

As mensagens contêm os seguintes exemplos de carga útil:

{ "eventType" : "THING_EVENT", "eventId" : "f5ae9b94-8b8e-4d8e-8c8f-b3266dd89853", "timestamp" : 1234567890123, "operation" : "CREATED|UPDATED|DELETED", "accountId" : "123456789012", "thingId" : "b604f69c-aa9a-4d4a-829e-c480e958a0b5", "thingName" : "MyThing", "versionNumber" : 1, "thingTypeName" : null, "attributes": { "attribute3": "value3", "attribute1": "value1", "attribute2": "value2" } }

As cargas úteis contêm os seguintes atributos:

eventType

Defina como "THING_EVENT”.

eventId

Um ID de evento exclusivo (sequência).

timestamp

A UNIX data e hora de quando o evento ocorreu.

operação

A operação que acionou o evento. Os valores válidos são:

  • CREATED

  • UPDATED

  • DELETED

accountId

Sua Conta da AWS identidade.

thingId

O ID do objeto que está sendo criada, atualizada ou excluída.

thingName

O nome do objeto que está sendo criada, atualizada ou excluída.

versionNumber

A versão do objeto que está sendo criada, atualizada ou excluída. Esse valor é definido como 1 quando um objeto é criada. Ele é incrementado em 1 toda vez que o objeto é atualizada.

thingTypeName

O tipo do objeto associado ao objeto, se existir. Caso contrário, null.

attributes

Uma coleção de pares nome-valor associados ao objeto.

Eventos de tipos de objeto

Tipo de coisa Created/Updated/Deprecated/Undeprecated/Deleted

O registro publica as seguintes mensagens de eventos quando tipos de itens são criados, atualizados, descontinuados, descontinuados ou excluídos:

  • $aws/events/thingType/thingTypeName/created

  • $aws/events/thingType/thingTypeName/updated

  • $aws/events/thingType/thingTypeName/deleted

A mensagem contém as seguintes cargas úteis de exemplo:

{ "eventType" : "THING_TYPE_EVENT", "eventId" : "8827376c-4b05-49a3-9b3b-733729df7ed5", "timestamp" : 1234567890123, "operation" : "CREATED|UPDATED|DELETED", "accountId" : "123456789012", "thingTypeId" : "c530ae83-32aa-4592-94d3-da29879d1aac", "thingTypeName" : "MyThingType", "isDeprecated" : false|true, "deprecationDate" : null, "searchableAttributes" : [ "attribute1", "attribute2", "attribute3" ], "propagatingAttributes": [ { "userPropertyKey": "key", "thingAttribute": "model" }, { "userPropertyKey": "key", "connectionAttribute": "iot:ClientId" } ], "description" : "My thing type" }

As cargas úteis contêm os seguintes atributos:

eventType

Defina como "THING_ TYPE _EVENT”.

eventId

Um ID de evento exclusivo (sequência).

timestamp

A UNIX data e hora de quando o evento ocorreu.

operação

A operação que acionou o evento. Os valores válidos são:

  • CREATED

  • UPDATED

  • DELETED

accountId

Sua Conta da AWS identidade.

thingTypeId

O ID do tipo de item que está sendo criado, atualizado, obsoleto ou excluído.

thingTypeName

O nome do tipo de item que está sendo criado, atualizado, obsoleto ou excluído.

isDeprecated

true se o tipo do objeto estiver preterido. Caso contrário, false.

deprecationDate

A UNIX data e hora de quando o tipo de coisa foi descontinuado.

searchableAttributes

Uma coleção de pares nome-valor associados ao tipo de objeto que pode ser usada para pesquisa.

propagatingAttributes

Uma lista de atributos de propagação. Um atributo de propagação pode conter um atributo de coisa, um atributo de conexão e uma chave de propriedade do usuário. Para obter mais informações, consulte Adicionar atributos de propagação para enriquecimento de mensagens.

description

Uma descrição do tipo de objeto.

Tipo de objeto associado ou desassociado de um objeto

O registro publica as seguintes mensagens de eventos quando um tipo de objeto é associado ou desassociado de um objeto.

  • $aws/events/thingTypeAssociation/thing/thingName/thingType/typeName/added

  • $aws/events/thingTypeAssociation/thing/thingName/thingType/typeName/removed

Veja a seguir um exemplo de carga added. As cargas das mensagens removed são semelhantes.

{ "eventId" : "87f8e095-531c-47b3-aab5-5171364d138d", "eventType" : "THING_TYPE_ASSOCIATION_EVENT", "operation" : "ADDED", "thingId" : "b604f69c-aa9a-4d4a-829e-c480e958a0b5", "thingName": "myThing", "thingTypeName" : "MyThingType", "timestamp" : 1234567890123, }

As cargas úteis contêm os seguintes atributos:

eventId

Um ID de evento exclusivo (sequência).

eventType

Defina como "THING_ TYPE _ ASSOCIATION _EVENT”.

operação

A operação que acionou o evento. Os valores válidos são:

  • ADDED

  • REMOVED

thingId

O ID do objeto cuja associação do tipo foi alterada.

thingName

O nome do objeto cuja associação do tipo foi alterada.

thingTypeName

O tipo de objeto associado ou não mais associado ao objeto.

timestamp

A UNIX data e hora de quando o evento ocorreu.

Eventos de grupos de objetos

Thing Group Created/Updated/Deleted

O registro publica as seguintes mensagens de eventos quando um grupo de objetos é criado, atualizado ou excluído.

  • $aws/events/thingGroup/groupName/created

  • $aws/events/thingGroup/groupName/updated

  • $aws/events/thingGroup/groupName/deleted

Veja a seguir um exemplo de carga updated. As cargas para mensagens created e deleted são semelhantes.

{ "eventType": "THING_GROUP_EVENT", "eventId": "8b9ea8626aeaa1e42100f3f32b975899", "timestamp": 1603995417409, "operation": "UPDATED", "accountId": "571EXAMPLE833", "thingGroupId": "8757eec8-bb37-4cca-a6fa-403b003d139f", "thingGroupName": "Tg_level5", "versionNumber": 3, "parentGroupName": "Tg_level4", "parentGroupId": "5fce366a-7875-4c0e-870b-79d8d1dce119", "description": "New description for Tg_level5", "rootToParentThingGroups": [ { "groupArn": "arn:aws:iot:us-west-2:571EXAMPLE833:thinggroup/TgTopLevel", "groupId": "36aa0482-f80d-4e13-9bff-1c0a75c055f6" }, { "groupArn": "arn:aws:iot:us-west-2:571EXAMPLE833:thinggroup/Tg_level1", "groupId": "bc1643e1-5a85-4eac-b45a-92509cbe2a77" }, { "groupArn": "arn:aws:iot:us-west-2:571EXAMPLE833:thinggroup/Tg_level2", "groupId": "0476f3d2-9beb-48bb-ae2c-ea8bd6458158" }, { "groupArn": "arn:aws:iot:us-west-2:571EXAMPLE833:thinggroup/Tg_level3", "groupId": "1d9d4ffe-a6b0-48d6-9de6-2e54d1eae78f" }, { "groupArn": "arn:aws:iot:us-west-2:571EXAMPLE833:thinggroup/Tg_level4", "groupId": "5fce366a-7875-4c0e-870b-79d8d1dce119" } ], "attributes": { "attribute1": "value1", "attribute3": "value3", "attribute2": "value2" }, "dynamicGroupMappingId": null }

As cargas úteis contêm os seguintes atributos:

eventType

Defina como "THING_ GROUP _EVENT”.

eventId

Um ID de evento exclusivo (sequência).

timestamp

A UNIX data e hora de quando o evento ocorreu.

operação

A operação que acionou o evento. Os valores válidos são:

  • CREATED

  • UPDATED

  • DELETED

accountId

Sua Conta da AWS identidade.

thingGroupId

O ID do grupo de objetos que está sendo criado, atualizado ou excluído.

thingGroupName

O nome do grupo de objetos que está sendo criado, atualizado ou excluído.

versionNumber

A versão do grupo de objetos. Esse valor é definido como 1 quando um grupo de objetos é criado. Ele é incrementado em 1 toda vez que o grupo de objetos é atualizado.

parentGroupName

O nome do grupo de objetos pai, se houver.

parentGroupId

O ID do grupo de objetos pai, se houver.

description

Uma descrição do grupo de objetos.

rootToParentThingGroups

Um conjunto de informações sobre o grupo de objetos pai. Há um elemento para cada grupo de objetos principal, começando pelo grupo de objetos raiz e continuando até o grupo de objetos principal. Cada entrada contém o groupArn e groupId. do grupo de objetos.

attributes

Uma coleção de pares nome-valor associados ao grupo de objetos.

Objeto adicionado ou removido de um grupo de objetos

O registro publica as seguintes mensagens de eventos quando um objeto é adicionada ou removida de um grupo de objetos.

  • $aws/events/thingGroupMembership/thingGroup/thingGroupName/thing/thingName/added

  • $aws/events/thingGroupMembership/thingGroup/thingGroupName/thing/thingName/removed

As mensagens contêm os seguintes exemplos de carga útil:

{ "eventType" : "THING_GROUP_MEMBERSHIP_EVENT", "eventId" : "d684bd5f-6f6e-48e1-950c-766ac7f02fd1", "timestamp" : 1234567890123, "operation" : "ADDED|REMOVED", "accountId" : "123456789012", "groupArn" : "arn:aws:iot:ap-northeast-2:123456789012:thinggroup/MyChildThingGroup", "groupId" : "06838589-373f-4312-b1f2-53f2192291c4", "thingArn" : "arn:aws:iot:ap-northeast-2:123456789012:thing/MyThing", "thingId" : "b604f69c-aa9a-4d4a-829e-c480e958a0b5", "membershipId" : "8505ebf8-4d32-4286-80e9-c23a4a16bbd8" }

As cargas úteis contêm os seguintes atributos:

eventType

Defina como "THING_ GROUP _ MEMBERSHIP _EVENT”.

eventId

O ID do evento.

timestamp

A UNIX data e hora de quando o evento ocorreu.

operação

ADDED quando um objeto é adicionada a um grupo de objetos. REMOVED quando um objeto é removida de um grupo de objetos.

accountId

Sua Conta da AWS identidade.

groupArn

O grupo ARN of the thing.

groupId

O ID do group.

thingArn

A ARN coisa que foi adicionada ou removida do grupo de coisas.

thingId

O ID do objeto que foi adicionada ou removida do grupo de objetos.

membershipId

Um ID que representa a relação entre o objeto e o grupo de objetos. Esse valor é gerado quando você adiciona um objeto a um grupo de objetos.

Grupo de objetos adicionado ou removido de um grupo de objetos

O registro publica as seguintes mensagens de eventos quando um grupo de objetos é adicionado ou removido de um outro grupo de objetos.

  • $aws/events/thingGroupHierarchy/thingGroup/parentThingGroupName/childThingGroup/childThingGroupName/added

  • $aws/events/thingGroupHierarchy/thingGroup/parentThingGroupName/childThingGroup/childThingGroupName/removed

A mensagem contém as seguintes cargas úteis de exemplo:

{ "eventType" : "THING_GROUP_HIERARCHY_EVENT", "eventId" : "264192c7-b573-46ef-ab7b-489fcd47da41", "timestamp" : 1234567890123, "operation" : "ADDED|REMOVED", "accountId" : "123456789012", "thingGroupId" : "8f82a106-6b1d-4331-8984-a84db5f6f8cb", "thingGroupName" : "MyRootThingGroup", "childGroupId" : "06838589-373f-4312-b1f2-53f2192291c4", "childGroupName" : "MyChildThingGroup" }

As cargas úteis contêm os seguintes atributos:

eventType

Defina como "THING_ GROUP _ HIERARCHY _EVENT”.

eventId

O ID do evento.

timestamp

A UNIX data e hora de quando o evento ocorreu.

operação

ADDED quando um objeto é adicionada a um grupo de objetos. REMOVED quando um objeto é removida de um grupo de objetos.

accountId

Sua Conta da AWS identidade.

thingGroupId

O ID do grupo de objetos pai.

thingGroupName

O nome do grupo de objetos pai.

childGroupId

O ID do grupo de objetos filho.

childGroupName

O nome do grupo de objetos filho.