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.

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:region:account:/$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 AWS Management Console 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.

• Para habilitar los mensajes de eventos, vaya a la pestaña Configuración 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 API de UpdateEventconfiguraciones 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 API de DescribeEventconfiguraciones 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