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
Objeto criado/atualizado/excluído
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:
{ "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 contêm os seguintes atributos:
- eventType
-
Defina como "THING_EVENT".
- 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.
- coisa TypeName
-
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
Eventos relacionados ao tipo de objeto:
Tipo de objeto criado/preterido/priorizado/cancelado/excluído
O registro publica as seguintes mensagens de eventos quando os tipos de objetos são criados, preterido, priorizados 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 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" ], "description" : "My thing type" }
As cargas contêm os seguintes atributos:
- eventType
-
Defina como "THING_TYPE_EVENT".
- 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.
- coisa TypeId
-
O ID do tipo de objeto que está sendo criado, preterido ou excluído.
- coisa TypeName
-
O nome do tipo de objeto que está sendo criado, preterido ou excluído.
- 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.
- 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 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:
-
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.
- coisa TypeName
-
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
Eventos relacionados ao grupo de objetos:
Grupo de objetos criado/atualizado/excluído
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 contêm os seguintes atributos:
- eventType
-
Defina como "THING_GROUP_EVENT".
- 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.
- coisa GroupId
-
O ID do grupo de objetos que está sendo criado, atualizado ou excluído.
- coisa GroupName
-
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.
- pai GroupName
-
O nome do grupo de objetos pai, se houver.
- pai GroupId
-
O ID do grupo de objetos pai, se houver.
- description
-
Uma descrição do grupo de objetos.
- raiz ToParent ThingGroups
-
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
egroupId
. 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:
{ "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 contêm os seguintes atributos:
- eventType
-
Defina como "THING_GROUP_MEMBERSHIP_EVENT".
- 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 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 contêm os seguintes atributos:
- eventType
-
Defina como "THING_GROUP_HIERARCHY_EVENT".
- 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.
- coisa GroupId
-
O ID do grupo de objetos pai.
- coisa GroupName
-
O nome do grupo de objetos pai.
- criança GroupId
-
O ID do grupo de objetos filho.
- criança GroupName
-
O nome do grupo de objetos filho.