Seleccione sus preferencias de cookies

Usamos cookies esenciales y herramientas similares que son necesarias para proporcionar nuestro sitio y nuestros servicios. Usamos cookies de rendimiento para recopilar estadísticas anónimas para que podamos entender cómo los clientes usan nuestro sitio y hacer mejoras. Las cookies esenciales no se pueden desactivar, pero puede hacer clic en “Personalizar” o “Rechazar” para rechazar las cookies de rendimiento.

Si está de acuerdo, AWS y los terceros aprobados también utilizarán cookies para proporcionar características útiles del sitio, recordar sus preferencias y mostrar contenido relevante, incluida publicidad relevante. Para aceptar o rechazar todas las cookies no esenciales, haga clic en “Aceptar” o “Rechazar”. Para elegir opciones más detalladas, haga clic en “Personalizar”.

Eventos de registro

Modo de enfoque
Eventos de registro - AWS IoT Core

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.

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.

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 Habilita los eventos para AWS IoT.

El registro puede proporcionar los siguientes tipos de eventos:

Eventos de objeto

¿Cosa Created/Updated/Deleted

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

Establézcalo en "THING_EVENT».

eventId

Un ID de evento exclusivo (cadena).

marca de tiempo

La UNIX marca de tiempo del momento en que ocurrió el evento.

operación

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

  • CREATED

  • UPDATED

  • DELETED

accountId

Tu ID. Cuenta de AWS

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.

thingTypeName

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 cosa Created/Updated/Deprecated/Undeprecated/Deleted

El registro publica los siguientes mensajes de eventos cuando se crean, actualizan, dejan de estar en desuso, dejan de estar en desuso o se eliminan tipos de cosas:

  • $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" ], "propagatingAttributes": [ { "userPropertyKey": "key", "thingAttribute": "model" }, { "userPropertyKey": "key", "connectionAttribute": "iot:ClientId" } ], "description" : "My thing type" }

Las cargas contienen los siguientes atributos:

eventType

Establézcalo en "THING_ _TYPE». EVENT

eventId

Un ID de evento exclusivo (cadena).

marca de tiempo

La UNIX marca de tiempo del momento en que ocurrió el evento.

operación

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

  • CREATED

  • UPDATED

  • DELETED

accountId

Tu ID. Cuenta de AWS

thingTypeId

El ID del tipo de cosa que se va a crear, actualizar, dejar de utilizar o eliminar.

thingTypeName

El nombre del tipo de cosa que se va a crear, actualizar, dejar de utilizar o eliminar.

isDeprecated

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

deprecationDate

La UNIX marca de tiempo en la que el tipo de cosa quedó obsoleto.

searchableAttributes

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

propagatingAttributes

Una lista de atributos de propagación. Un atributo de propagación puede contener un atributo de cosa, un atributo de conexión y una clave de propiedad de usuario. Para obtener más información, consulte Añadir atributos de propagación para enriquecer los mensajes.

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

Configúrelo 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.

thingTypeName

El tipo de objeto asociado o desasociado de la cosa.

marca de tiempo

La UNIX marca de tiempo del momento en que ocurrió el evento.

Eventos de grupo de objetos

Grupo de cosas Created/Updated/Deleted

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

Establézcalo en "THINGGROUP_ _EVENT».

eventId

Un ID de evento exclusivo (cadena).

marca de tiempo

La UNIX marca de tiempo del momento en que ocurrió el evento.

operación

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

  • CREATED

  • UPDATED

  • DELETED

accountId

Tu ID. Cuenta de AWS

thingGroupId

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

thingGroupName

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.

parentGroupName

El nombre del grupo principal de objetos, si existe.

parentGroupId

El ID del grupo principal de objetos, si existe.

description

Una descripción del grupo de objetos.

rootToParentThingGroups

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

Configúrelo en "THINGGROUP_ MEMBERSHIP _ _EVENT».

eventId

El ID del evento.

marca de tiempo

La UNIX marca de tiempo en la que 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 ID. Cuenta de AWS

groupArn

El ARN del grupo de cosas.

groupId

El ID del grupo.

thingArn

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

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

Establézcalo en "THINGGROUP_ HIERARCHY _ _EVENT».

eventId

El ID del evento.

marca de tiempo

La UNIX marca de tiempo en la que 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 ID. Cuenta de AWS

thingGroupId

El ID del grupo principal de objetos.

thingGroupName

El nombre del grupo principal de objetos.

childGroupId

El ID del grupo secundario de objetos.

childGroupName

El nombre del grupo secundario de objetos.

PrivacidadTérminos del sitioPreferencias de cookies
© 2025, Amazon Web Services, Inc o sus afiliados. Todos los derechos reservados.