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](iot-events.md#iot-events-enable). **Topics** + [Eventos de objetos](#registry-events-thing) + [Eventos de tipos de objeto](#registry-events-thingtype) + [Eventos de grupos de objetos](#registry-events-thinggroup) ## 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\$1EVENT". eventId Um ID de evento exclusivo (sequência). timestamp A data e hora do UNIX de quando o evento ocorreu. operação A operação que acionou o evento. Os valores válidos são: + CREATED + UPDATED + EXCLUÍDO 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 **Topics** + [Tipo de coisa Created/Updated/Deprecated/Undeprecated/Deleted](#registry-events-thingtype-crud) + [Tipo de objeto associado ou desassociado de um objeto](#registry-events-thingtype-assoc) ### Tipo de coisa Created/Updated/Deprecated/Undeprecated/Deleted O registro publica as seguintes mensagens de evento quando os tipos de coisa são criados, atualizados, suspensos, recuperados 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\$1TYPE\$1EVENT". eventId Um ID de evento exclusivo (sequência). timestamp A data e hora do UNIX de quando o evento ocorreu. operação A operação que acionou o evento. Os valores válidos são: + CREATED + UPDATED + EXCLUÍDO accountId Sua Conta da AWS identidade. thingTypeId O ID do tipo de coisa que está sendo criada, atualizada, suspensa ou excluída. thingTypeName O nome do tipo de coisa que está sendo criada, atualizada, suspensa ou excluída. isDeprecated `true` se o tipo do objeto estiver preterido. Caso contrário, `false`. deprecationDate A data e hora do UNIX em que o tipo de objeto foi preterido. searchableAttributes Uma coleção de pares nome-valor associados ao tipo de objeto que pode ser usada para pesquisa. propagatingAttributes 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 acessar mais informações, consulte [Adicionar atributos de propagação para enriquecimento de mensagens](https://docs.aws.amazon.com//iot/latest/developerguide/thing-types-propagating-attributes.html). descrição 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\$1TYPE\$1ASSOCIATION\$1EVENT". operação A operação que acionou o evento. Os valores válidos são: + ADICIONADO + REMOVIDO 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 data e hora do UNIX de quando o evento ocorreu. ## Eventos de grupos de objetos **Topics** + [Thing Group Created/Updated/Deleted](#registry-events-thinggroup-crud) + [Objeto adicionado ou removido de um grupo de objetos](#registry-events-thinggroup-addremove) + [Grupo de objetos adicionado ou removido de um grupo de objetos](#registry-events-thinggroup-adddelete) ### 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\$1GROUP\$1EVENT". eventId Um ID de evento exclusivo (sequência). timestamp A data e hora do UNIX de quando o evento ocorreu. operação A operação que acionou o evento. Os valores válidos são: + CREATED + UPDATED + EXCLUÍDO 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. descrição 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\$1GROUP\$1MEMBERSHIP\$1EVENT". eventId O ID do evento. timestamp A data e hora do UNIX 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 ARN do grupo de objetos. groupId O ID do group. thingArn O ARN do objeto que foi adicionada ou removida do grupo de objetos. 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\$1GROUP\$1HIERARCHY\$1EVENT". eventId O ID do evento. timestamp A data e hora do UNIX 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.