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
Eventos relacionados ao tipo 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
Eventos relacionados ao grupo 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
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 ú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.