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](iot-events.md#iot-events-enable).
**Topics**
+ [Eventos de objeto](#registry-events-thing)
+ [Eventos de tipo de objeto](#registry-events-thingtype)
+ [Eventos de grupo de objetos](#registry-events-thinggroup)
## 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
Se establece en "THING\$1EVENT".
eventId
Un ID de evento exclusivo (cadena).
timestamp
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.
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
**Topics**
+ [Tipo de cosa Created/Updated/Deprecated/Undeprecated/Deleted](#registry-events-thingtype-crud)
+ [Tipo de objeto asociado o desasociado de un objeto](#registry-events-thingtype-assoc)
### Tipo de cosa Created/Updated/Deprecated/Undeprecated/Deleted
El registro publica los siguientes mensajes de eventos cuando los tipos de objetos se crean, se actualizan, se dan de baja o a los que se les quita la marca de obsoleto:
+ `$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
Se establece en "THING\$1TYPE\$1EVENT".
eventId
Un ID de evento exclusivo (cadena).
timestamp
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.
thingTypeId
El ID del tipo de objeto que se crea, se actualiza, se da de baja o se elimina.
thingTypeName
El nombre del tipo de objeto que se crea, se actualiza, se da de baja o se elimina.
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.
propagatingAttributes
Una lista de atributos de propagación. Un atributo de propagación puede incluir un atributo de objeto, un atributo de conexión y una clave de propiedad de usuario. Para obtener más información, consulte [Agregación de atributos de propagación para enriquecer los mensajes](https://docs.aws.amazon.com//iot/latest/developerguide/thing-types-propagating-attributes.html).
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\$1TYPE\$1ASSOCIATION\$1EVENT".
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.
timestamp
La marca de tiempo UNIX de cuándo se produjo el evento.
## Eventos de grupo de objetos
**Topics**
+ [Grupo de cosas Created/Updated/Deleted](#registry-events-thinggroup-crud)
+ [Objeto agregado o eliminado de un grupo de objetos](#registry-events-thinggroup-addremove)
+ [Grupo de objetos agregado o eliminado de un grupo de objetos](#registry-events-thinggroup-adddelete)
### 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
Se establece en "THING\$1GROUP\$1EVENT".
eventId
Un ID de evento exclusivo (cadena).
timestamp
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.
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
Se establece en "THING\$1GROUP\$1MEMBERSHIP\$1EVENT".
eventId
El ID del evento.
timestamp
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\$1GROUP\$1HIERARCHY\$1EVENT".
eventId
El ID del evento.
timestamp
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.
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.