

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
<a name="iot-events"></a>

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
<a name="iot-events-how"></a>

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
<a name="iot-events-policy"></a>

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
<a name="iot-events-enable"></a>

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 (\\).

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
```<a name="iot-events-settings-table"></a>

**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`<br />`$aws/events/thingTypeAssociation/thing/{{thingName}}/thingType/{{thingTypeName}}/removed` | 