Eventos de registro - AWS IoT Core
Eventos de objetoEventos de tipo de objetoEventos de grupo de objetos

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Eventos de registro

El registro puede publicar mensajes de eventos cuando se crean, actualizan o eliminan objetos, tipos de objetos y grupos de objetos. Estos eventos, sin embargo, no están disponibles de forma predeterminada. Para obtener información sobre cómo activar estos eventos, consulte Habilite los eventos para AWS IoT.

El registro puede proporcionar los siguientes tipos de eventos:

Eventos de objeto

Objeto creado, actualizado, eliminado

El registro publica los siguientes mensajes de eventos cuando se crean, actualizan o eliminan objetos:

  • $aws/events/thing/thingName/created

  • $aws/events/thing/thingName/updated

  • $aws/events/thing/thingName/deleted

Los mensajes contienen la siguiente carga de ejemplo:

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

Las cargas contienen los siguientes atributos:

eventType

Se establece en "THING_EVENT".

eventId

Un ID de evento exclusivo (cadena).

Marca de tiempo

La marca de tiempo UNIX de cuándo se produjo el evento.

operación

La operación en la que se activó el evento. Los valores válidos son:

  • CREATED

  • UPDATED

  • DELETED

accountId

Tu Cuenta de AWS ID.

thingId

El ID de la cosa que se crea, actualiza o elimina.

thingName

El nombre de la cosa que se crea, actualiza o elimina.

versionNumber

La versión de la cosa que se crea, actualiza o elimina. Este valor se establece en 1 cuando se crea un objeto. Aumenta en 1 cada vez que se actualiza el objeto.

cosa TypeName

El tipo de objeto asociado al objeto, si existiera. De lo contrario, null.

attributes

Un conjunto de pares nombre-valor asociados al objeto.

Eventos de tipo de objeto

Tipo de objeto creado, descartado, eliminado o al que se le ha quitado la marca de descartado

El registro publica los siguientes mensajes de eventos cuando se crean, se descartan, se eliminan o se quita la marca de descartado de los tipos de objetos:

  • $aws/events/thingType/thingTypeName/created

  • $aws/events/thingType/thingTypeName/updated

  • $aws/events/thingType/thingTypeName/deleted

El mensaje contiene la siguiente carga de ejemplo:

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

Las cargas contienen los siguientes atributos:

eventType

Se establece en "THING_TYPE_EVENT".

eventId

Un ID de evento exclusivo (cadena).

Marca de tiempo

La marca de tiempo UNIX de cuándo se produjo el evento.

operación

La operación en la que se activó el evento. Los valores válidos son:

  • CREATED

  • UPDATED

  • DELETED

accountId

Tu Cuenta de AWS carné de identidad.

cosa TypeId

El ID del tipo de objeto que se crea o elimina, o que está descartado.

cosa TypeName

El nombre del tipo de objeto que se crea o elimina, o que está descartado.

isDeprecated

true si el tipo de objeto está descartado. De lo contrario, false.

deprecationDate

La marca de tiempo UNIX para cuando el tipo de objeto está descartado.

searchableAttributes

Un conjunto de pares nombre-valor asociados con el tipo de objeto que puede utilizarse para realizar búsquedas.

description

Una descripción del tipo de objeto.

Tipo de objeto asociado o desasociado de un objeto

El registro publica los siguientes mensajes de eventos cuando se asocia o desasocia un tipo de objeto a un objeto.

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

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

A continuación, se muestra un ejemplo de carga de added. Las cargas de los mensajes removed son similares.

{
    "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,
}

Las cargas contienen los siguientes atributos:

eventId

Un ID de evento exclusivo (cadena).

eventType

Se establece en "THING_TYPE_ASSOCIATION_EVENT".

operación

La operación en la que se activó el evento. Los valores válidos son:

  • ADDED

  • REMOVED

thingId

El ID de la cosa cuya asociación de tipo ha cambiado.

thingName

El nombre de la cosa cuya asociación de tipo ha cambiado.

cosa TypeName

El tipo de objeto asociado o desasociado de la cosa.

Marca de tiempo

La marca de tiempo UNIX de cuándo se produjo el evento.

Eventos de grupo de objetos

Grupo de objetos creado, actualizado o eliminado

El registro publica los siguientes mensajes de eventos cuando se crea, actualiza o elimina un grupo de objetos.

  • $aws/events/thingGroup/groupName/created

  • $aws/events/thingGroup/groupName/updated

  • $aws/events/thingGroup/groupName/deleted

A continuación, se muestra un ejemplo de carga de updated. Las cargas de los mensajes created y deleted son similares.

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

Las cargas contienen los siguientes atributos:

eventType

Se establece en "THING_GROUP_EVENT".

eventId

Un ID de evento exclusivo (cadena).

Marca de tiempo

La marca de tiempo UNIX de cuándo se produjo el evento.

operación

La operación en la que se activó el evento. Los valores válidos son:

  • CREATED

  • UPDATED

  • DELETED

accountId

Tu Cuenta de AWS carné de identidad.

cosa GroupId

El ID del grupo de objetos que se crea, actualiza o elimina.

cosa GroupName

El nombre del grupo de objetos que se crea, actualiza o elimina.

versionNumber

La versión del grupo de objetos. Este valor se establece en 1 cuando se crea un grupo de objetos. Aumenta en 1 cada vez que se actualiza el grupo de objetos.

padre GroupName

El nombre del grupo principal de objetos, si existe.

padre GroupId

El ID del grupo principal de objetos, si existe.

description

Una descripción del grupo de objetos.

raíz ToParent ThingGroups

Una matriz de información acerca del grupo principal de objetos. Hay un elemento por cada grupo principal de objetos, empezando por el grupo de objetos raíz y continuando hasta el grupo principal. Cada entrada contiene los groupArn y groupId del grupo de objetos.

attributes

Un conjunto de pares nombre-valor asociados al grupo de objetos.

Objeto agregado o eliminado de un grupo de objetos

El registro publica los siguientes mensajes de eventos cuando se agrega un objeto a un grupo de objetos o se elimina de este.

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

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

Los mensajes contienen la siguiente carga de ejemplo:

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

Las cargas contienen los siguientes atributos:

eventType

Se establece en "THING_GROUP_MEMBERSHIP_EVENT".

eventId

El ID del evento.

Marca de tiempo

La marca de tiempo UNIX de cuándo se produjo el evento.

operación

ADDED cuando se agrega un objeto a un grupo de objetos. REMOVED cuando se elimina un objeto de un grupo de objetos.

accountId

Tu Cuenta de AWS carné de identidad.

groupArn

El ARN del grupo de objetos.

groupId

El ID del grupo.

thingArn

El ARN de la cosa que se agregó o quitó del grupo de objetos.

thingId

El ID de la cosa que se agregó o quitó del grupo de objetos.

membershipId

Un ID que representa la relación entre objeto y el grupo de objetos. Este valor se genera cuando agrega un objeto a un grupo de objetos.

Grupo de objetos agregado o eliminado de un grupo de objetos

El registro publica los siguientes mensajes de eventos cuando se agrega un grupo de objetos a otro grupo de objetos o se elimina de este.

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

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

El mensaje contiene la siguiente carga de ejemplo:

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

Las cargas contienen los siguientes atributos:

eventType

Se establece en "THING_GROUP_HIERARCHY_EVENT".

eventId

El ID del evento.

Marca de tiempo

La marca de tiempo UNIX de cuándo se produjo el evento.

operación

ADDED cuando se agrega un objeto a un grupo de objetos. REMOVED cuando se elimina un objeto de un grupo de objetos.

accountId

Tu Cuenta de AWS carné de identidad.

cosa GroupId

El ID del grupo principal de objetos.

cosa GroupName

El nombre del grupo principal de objetos.

niño GroupId

El ID del grupo secundario de objetos.

niño GroupName

El nombre del grupo secundario de objetos.