Eventos de registro - AWS IoT Core
Eventos de objetosEventos de tipos de objetoEventos de grupos de objetos

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

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

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 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:

{
    "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.