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.
# Mensajes de los eventos
Esta sección contiene información sobre los mensajes que se publican AWS IoT cuando se actualizan o cambian cosas o trabajos. Para obtener información sobre el AWS IoT Events servicio que le permite crear detectores para monitorear sus dispositivos en busca de fallas o cambios en el funcionamiento y activar acciones cuando se produzcan, consulte [AWS IoT Events](https://aws.amazon.com/iot-events).
## Cómo se generan los mensajes de eventos
AWS IoT publica mensajes de eventos cuando se producen determinados eventos. Por ejemplo, el registro genera eventos cuando se agregan, actualizan o eliminan objetos. Cada evento provoca que se envíe un único mensaje de evento. Los mensajes de evento se publican a través de MQTT con una carga JSON. El contenido de la carga depende del tipo de evento.
**nota**
Se garantiza que los mensajes de eventos se publican una vez. Es posible que se publiquen más de una. No se garantiza el orden de los mensajes de eventos.
### Política de recepción de mensajes de eventos
Para recibir mensajes de eventos, su dispositivo debe utilizar una política adecuada que le permita conectarse a la puerta de enlace del AWS IoT dispositivo y suscribirse a los temas de los eventos de MQTT. También debe suscribirse a los filtros de temas adecuados.
A continuación, mostramos un ejemplo de política necesaria para recibir eventos del ciclo de vida:
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"iot:Subscribe",
"iot:Receive"
],
"Resource": [
"arn:aws:iot:us-east-1:123456789012:/$aws/events/*"
]
}
]
}
```
## Habilite los eventos para AWS IoT
Para que los suscriptores de los temas reservados puedan recibir mensajes, debes habilitar los mensajes de eventos desde Consola de administración de AWS o mediante la API o la CLI. Para obtener información sobre los mensajes de eventos que administran las distintas opciones, consulte la [tabla de opciones de configuración de AWS IoT eventos](#iot-events-settings-table).
+ Para habilitar los mensajes de eventos, vaya a la pestaña [Configuración](https://console.aws.amazon.com//iot/home#/settings) de la AWS IoT consola y, a continuación, en la sección **Mensajes basados en eventos**, elija **Administrar eventos**. Puede especificar los eventos que desea administrar.
+ Para controlar qué tipos de eventos se publican mediante la API o la CLI, llame a la [UpdateEventConfigurations](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateEventConfigurations.html)API o utilice el comando **update-event-configurations** CLI. Por ejemplo:
```
aws iot update-event-configurations --event-configurations "{\"THING\":{\"Enabled\": true}}"
```
**nota**
Todas las comillas (") van precedidas de barras diagonales invertidas (\$1).
Puede obtener la configuración de eventos actual llamando a la [DescribeEventConfigurations](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeEventConfigurations.html)API o mediante el comando **describe-event-configurations** CLI. Por ejemplo:
```
aws iot describe-event-configurations
```
**Tabla de opciones de configuración de eventos de AWS IoT **
| Categoría de evento (AWS IoT Consola: configuración: mensajes basados en eventos) | Valor de la clave `eventConfigurations` (AWS CLI/API) | Tema del mensaje del evento |
| --- | --- | --- |
| *(Solo se puede configurar mediante la AWS CLI/API)* | `CA_CERTIFICATE` | `$aws/events/certificates/registered/caCertificateId` |
| *(Solo se puede configurar mediante la AWS CLI/API)* | `CERTIFICATE` | `$aws/events/presence/connected/clientId` |
| *(Solo se puede configurar mediante la AWS CLI/API)* | `CERTIFICATE` | `$aws/events/presence/disconnected/clientId` |
| *(Solo se puede configurar mediante la AWS CLI/API)* | `CERTIFICATE` | `$aws/events/subscriptions/subscribed/clientId` |
| *(Solo se puede configurar mediante la AWS CLI/API)* | `CERTIFICATE` | `$aws/events/subscriptions/unsubscribed/clientId` |
| Trabajo completado, cancelado | `JOB` | `$aws/events/job/jobID/canceled` |
| Trabajo completado, cancelado | `JOB` | `$aws/events/job/jobID/cancellation_in_progress` |
| Trabajo completado, cancelado | `JOB` | `$aws/events/job/jobID/completed` |
| Trabajo completado, cancelado | `JOB` | `$aws/events/job/jobID/deleted` |
| Trabajo completado, cancelado | `JOB` | `$aws/events/job/jobID/deletion_in_progress` |
| Ejecución del trabajo: correcta, fallida, rechazada, cancelad, eliminada | `JOB_EXECUTION` | `$aws/events/jobExecution/jobID/canceled` |
| Ejecución del trabajo: correcta, fallida, rechazada, cancelad, eliminada | `JOB_EXECUTION` | `$aws/events/jobExecution/jobID/deleted` |
| Ejecución del trabajo: correcta, fallida, rechazada, cancelad, eliminada | `JOB_EXECUTION` | `$aws/events/jobExecution/jobID/failed` |
| Ejecución del trabajo: correcta, fallida, rechazada, cancelad, eliminada | `JOB_EXECUTION` | `$aws/events/jobExecution/jobID/rejected` |
| Ejecución del trabajo: correcta, fallida, rechazada, cancelad, eliminada | `JOB_EXECUTION` | `$aws/events/jobExecution/jobID/removed` |
| Ejecución del trabajo: correcta, fallida, rechazada, cancelad, eliminada | `JOB_EXECUTION` | `$aws/events/jobExecution/jobID/succeeded` |
| Ejecución del trabajo: correcta, fallida, rechazada, cancelad, eliminada | `JOB_EXECUTION` | `$aws/events/jobExecution/jobID/timed_out` |
| Objeto: creado, actualizado, eliminado | `THING` | `$aws/events/thing/thingName/created` |
| Objeto: creado, actualizado, eliminado | `THING` | `$aws/events/thing/thingName/updated` |
| Objeto: creado, actualizado, eliminado | `THING` | `$aws/events/thing/thingName/deleted` |
| Grupo de objetos: agregado, eliminado | `THING_GROUP` | `$aws/events/thingGroup/thingGroupName/created` |
| Grupo de objetos: agregado, eliminado | `THING_GROUP` | `$aws/events/thingGroup/thingGroupName/updated` |
| Grupo de objetos: agregado, eliminado | `THING_GROUP` | `$aws/events/thingGroup/thingGroupName/deleted` |
| Jerarquía de grupos de objetos: agregada, eliminada | `THING_GROUP_HIERARCHY` | `$aws/events/thingGroupHierarchy/thingGroup/parentThingGroupName/childThingGroup/childThingGroupName/added` |
| Jerarquía de grupos de objetos: agregada, eliminada | `THING_GROUP_HIERARCHY` | `$aws/events/thingGroupHierarchy/thingGroup/parentThingGroupName/childThingGroup/childThingGroupName/removed` |
| Pertenencia a un grupo de objetos: agregada, eliminada | `THING_GROUP_MEMBERSHIP` | `$aws/events/thingGroupMembership/thingGroup/thingGroupName/thing/thingName/added` |
| Pertenencia a un grupo de objetos: agregada, eliminada | `THING_GROUP_MEMBERSHIP` | `$aws/events/thingGroupMembership/thingGroup/thingGroupName/thing/thingName/removed` |
| Tipo de objeto: creado, actualizado, eliminado | `THING_TYPE` | `$aws/events/thingType/thingTypeName/created` |
| Tipo de objeto: creado, actualizado, eliminado | `THING_TYPE` | `$aws/events/thingType/thingTypeName/updated` |
| Tipo de objeto: creado, actualizado, eliminado | `THING_TYPE` | `$aws/events/thingType/thingTypeName/deleted` |
| Asociación de tipo de objeto: agregada, eliminada | `THING_TYPE_ASSOCIATION` | `$aws/events/thingTypeAssociation/thing/thingName/thingType/thingTypeName/added` `$aws/events/thingTypeAssociation/thing/thingName/thingType/thingTypeName/removed` |