Notificaciones de eventos para AWS IoT Wireless

AWS IoT Wireless puede publicar mensajes para notificarle los eventos de los dispositivos LoRaWAN y de Sidewalk que haya incorporado a AWS IoT Core. Por ejemplo, puede recibir notificaciones de eventos cuando se hayan aprovisionado o registrado los dispositivos de Sidewalk de la cuenta.

Cómo se pueden notificar los eventos a los recursos

Las notificaciones de eventos se publican cuando se producen determinados eventos. Por ejemplo, cuando se aprovisiona el dispositivo de Sidewalk se generan eventos. Cada evento provoca que se envíe una única notificación de evento. Las notificaciones de evento se publican a través de MQTT con una carga JSON. El contenido de la carga depende del tipo de evento.

nota

Las notificaciones de eventos se publican al menos una vez. Es posible que se publiquen más de una. No se garantiza el orden de las notificaciones de eventos.

Eventos y tipos de recursos

La siguiente tabla muestra los diferentes tipos de eventos de los que recibirá notificaciones. Los tipos de eventos dependen de si el tipo de recurso es un dispositivo inalámbrico, una puerta de enlace inalámbrica o una cuenta de Sidewalk. También puede habilitar los eventos para sus recursos a nivel de recursos, lo que se aplica a todos los recursos de un tipo concreto, o para recursos seleccionados, como se describe en la siguiente sección. Para obtener más información acerca de los diferentes tipos de evento, consulte Notificaciones de eventos para los recursos de LoRaWAN y Notificaciones de eventos para recursos de Sidewalk.

Tipos de eventos basados en recursos
Recurso	Tipo de recurso	Tipo de evento
Dispositivo inalámbrico	LoRaWAN	Join
	Sidewalk	Estado de registro del dispositivo Proximidad
Puerta de enlace inalámbrica	LoRaWAN	Estado de conexión
Cuenta de Sidewalk	Sidewalk	Estado de registro del dispositivo Proximidad

Política de recepción de notificaciones de eventos inalámbricos

Para recibir notificaciones de eventos, el dispositivo debe usar una política adecuada que le permita conectarse a la puerta de enlace de dispositivos de AWS IoT y suscribirse a los temas de eventos MQTT. También debe suscribirse a los filtros de temas adecuados.

El siguiente es un ejemplo de la política necesaria para recibir notificaciones de los distintos eventos inalámbricos.

{
    "Version":"2012-10-17",
    "Statement":[{
        "Effect":"Allow",
        "Action":[
            "iot:Subscribe",
            "iot:Receive"
        ],
        "Resource":[
            "arn:aws:iotwireless:region:account:/$aws/iotwireless/events/join/*",
            "arn:aws:iotwireless:region:account:/$aws/iotwireless/events/connection_status/*"
            "arn:aws:iotwireless:region:account:/$aws/iotwireless/events/device_registration_state/*", 
            "arn:aws:iotwireless:region:account:/$aws/iotwireless/events/proximity/*"
        ]
    }]
}

Formato de los temas MQTT para eventos inalámbricos

Para enviarle notificaciones de eventos para los recursos inalámbricos, AWS IoT utiliza temas reservados de MQTT que comienzan con un signo de dólar ($). Puede publicar y suscribirse a dichos temas reservados. Sin embargo, no se pueden crear nuevos temas que comiencen con un signo de dólar.

nota

Los temas MQTT son específicos para la Cuenta de AWS y utilizan el formato arn:aws:iotwireless:aws-region:AWS-account-ID:topic/Topic. Para obtener más información, consulte MQTT topics en la Guía del desarrollador de AWS IoT.

Los temas MQTT reservados para dispositivos inalámbricos utilizan el siguiente formato:

• Temas de nivel de recursos

  Estos temas se aplican a todos los recursos de un tipo concreto en la Cuenta de AWS que haya incorporado a AWS IoT Wireless.

  $aws/iotwireless/events/{eventName}/{eventType}/{resourceType}/resources

• Temas de nivel de identificador

  Estos temas se aplican a todos los recursos seleccionados de un tipo concreto en la Cuenta de AWS que haya incorporado a AWS IoT Wireless, especificados por el identificador de recursos.

  $aws/iotwireless/events/{eventName}/{eventType}/{resourceType}/{resourceIdentifierType}/{resourceID}/{id}

Para obtener más información sobre temas en los niveles de recursos e identificador, consulte Configuraciones de eventos.

En la siguiente tabla se muestran ejemplos de temas MQTT para los distintos eventos:

Eventos y temas MQTT
Evento	Tema MQTT	Notas
Estado de registro del dispositivo de Sidewalk	Tema de nivel de recursos $aws/iotwireless/events/device_registration_state/{eventType}/sidewalk/wireless_devices Tema de nivel de identificador $aws/iotwireless/events/device_registration_state/{eventType}/sidewalk/{resourceType}/{resourceID}/{id}	{eventType} puede ser registered o provisioned {resourceType} puede ser sidewalk_accounts o wireless_devices {resourceID} es el amazon_id para sidewalk_accounts y wireless_device_id para wireless_devices
Proximidad de Sidewalk	Tema de nivel de recursos $aws/iotwireless/events/proximity/{eventType}/sidewalk/wireless_devices Tema de nivel de identificador $aws/iotwireless/events/proximity/{eventType}/sidewalk/{resourceType}/{resourceID}/{id}	{eventType} puede ser beacon_discovered o beacon_lost {resourceType} puede ser sidewalk_accounts o wireless_devices {resourceID} es el amazon_id para sidewalk_accounts y wireless_device_id para wireless_devices
Conexión a LoRaWAN	Tema de nivel de recursos $aws/iotwireless/events/join/{eventType}/lorawan/wireless_devices Tema de nivel de identificador $aws/iotwireless/events/join/{eventType}/lorawan/wireless_devices/{resourceID}/{id}	{eventType} puede ser join_req_0_received, join_req_2_received o join_accepted {resourceID} puede ser wireless_device_id o dev_eui
Estado de conexión de la puerta de enlace de LoRaWAN	Tema de nivel de recursos $aws/iotwireless/events/join/{eventType}/lorawan/wireless_gateways Tema de nivel de identificador $aws/iotwireless/events/join/{eventType}/lorawan/wireless_gateways/{resourceID}/{id}	{eventType} puede ser connected o disconnected {resourceID} puede ser wireless_gateway_id o gateway_eui

Para obtener más información sobre los diferentes eventos, consulte Notificaciones de eventos para los recursos de LoRaWAN y Notificaciones de eventos para recursos de Sidewalk.

Si se ha suscrito a estos temas, recibirá una notificación cuando se publique un mensaje en uno de los temas de notificación de eventos. Para obtener más información, consulte MQTT reserved topics en la Guía del desarrollador de AWS IoT.

Precios de eventos inalámbricos

Para obtener información sobre los precios de la suscripción a eventos y la recepción de notificaciones, consulta Precios de AWS IoT Core.