

# Habilitación de eventos para recursos inalámbricos
<a name="iot-wireless-control-events"></a>

Para que los suscriptores de los temas reservados puedan recibir mensajes, debe habilitar las notificaciones de eventos. Para ello, puede utilizar la Consola de administración de AWS, la API de AWS IoT Wireless o la AWS CLI.

## Configuraciones de eventos
<a name="iot-wireless-control-events-config"></a>

Puede configurar eventos para enviar notificaciones a todos los recursos que pertenecen a un tipo concreto o a recursos inalámbricos individuales. El tipo de recurso puede ser una puerta de enlace inalámbrica, una cuenta de socio de Sidewalk o un dispositivo inalámbrico, que puede ser un dispositivo LoRaWAN o de Sidewalk. Para obtener información sobre el tipo de eventos que puede habilitar para los dispositivos inalámbricos, consulte [Tipos de eventos para los recursos de LoRaWAN](iot-lorawan-events.md#iot-lorawan-event-types) y [Tipos de eventos para los recursos de Sidewalk](iot-sidewalk-events.md#iot-sidewalk-event-types).

**Todos los recursos**  
Puede habilitar los eventos de forma que todos los recursos en la Cuenta de AWS que pertenezcan a un tipo de recurso concreto reciban notificaciones. Por ejemplo, puede habilitar un evento que le notifique los cambios en el estado de conexión en todas las puertas de enlace de LoRaWAN que haya incorporado con AWS IoT Core para LoRaWAN. Monitorizar estos eventos le ayudará a recibir notificaciones en casos como cuando algunas puertas de enlace de LoRaWAN de la flota de recursos se desconecten o si se pierde una baliza en una serie de dispositivos de Sidewalk en la Cuenta de AWS.

**Recursos individuales**  
También puede añadir recursos individuales de LoRaWAN y Sidewalk a la configuración del evento y habilitar las notificaciones para ellos. Esto le ayudará a monitorear los recursos individuales de un tipo en particular. Por ejemplo, puede añadir determinados dispositivos LoRaWAN y de Sidewalk a su configuración y recibir notificaciones sobre los eventos relacionados con el estado de registro de dispositivos o de incorporación para estos recursos.

## Requisitos previos
<a name="iot-wireless-control-events-prereq"></a>

Su recurso de LoRaWAN o Sidewalk debe tener una política adecuada que le permita recibir notificaciones de eventos. Para obtener más información, consulte [Política de recepción de notificaciones de eventos inalámbricos](iot-wireless-events.md#iot-wireless-events-policy).

## Habilitación de notificaciones mediante la Consola de administración de AWS
<a name="iot-wireless-control-events-console"></a>

Para habilitar los mensajes de eventos desde la consola, vaya a la pestaña [Configuración](console.aws.amazon.com/iot/home/settings/) de la consola de AWS IoT y, a continuación, vaya a la sección **Notificaciones de eventos de LoRaWAN y Sidewalk**. 

Puede habilitar las notificaciones para todos los recursos en la Cuenta de AWS que pertenezcan a un tipo de recurso concreto y monitorizarlos.

**Para habilitar las notificaciones para todos los recursos**

1. En la sección **Notificaciones de eventos de LoRaWAN y Sidewalk**, vaya a la pestaña **Todos los recursos**, seleccione **Acción** y, a continuación, seleccione **Administrar eventos**.

1. Habilite los eventos que desea monitorizar y, a continuación, seleccione **Actualizar eventos**. Si ya no quiere monitorizar determinados eventos, seleccione **Acción** y **Administrar eventos** y, a continuación, deshabilítelos.

También puede habilitar las notificaciones para los recursos individuales en la Cuenta de AWS que pertenezcan a un tipo de recurso concreto y monitorizarlos.

**Para habilitar las notificaciones para los recursos individuales**

1. En la sección **Notificaciones de eventos de LoRaWAN y Sidewalk**, seleccione **Acción** y, a continuación, elija **Agregar recursos**.

1. Elija los recursos y eventos de los que desea recibir notificaciones:

   1. Elija si desea monitorizar los eventos de los **recursos de LoRaWAN** o **de Sidewalk**.

   1. Según el tipo de recurso, puede elegir los eventos que desea habilitar para los recursos. A continuación, puede suscribirse a estos eventos y recibir notificaciones. Si selecciona:
      + **Recursos de LoRaWAN**: puede habilitar los eventos de **conexión** para los dispositivos LoRaWAN o los eventos de **estado de conexión** para las puertas de enlace de LoRaWAN. 
      + Recursos de Sidewalk: puede habilitar los eventos de **estado de registro de dispositivos** o de **proximidad** (o ambos) para las cuentas de socio de Sidewalk y los dispositivos Sidewalk.

1. Según el tipo de recurso y los eventos que elija, seleccione los dispositivos inalámbricos o las puertas de enlace que desee monitorizar. Puede seleccionar hasta 250 recursos para todos los recursos combinados. 

1. Seleccione **Enviar** para añadir los recursos.

Los recursos que añada aparecerán con sus temas MQTT en la pestaña correspondiente a su tipo de recurso en la sección **Notificaciones de eventos de LoRaWAN y Sidewalk** de la consola.
+ Los eventos de **conexión a LoRaWAN** y los eventos de los dispositivos de Sidewalk aparecerán en la sección **Dispositivos inalámbricos** de la consola.
+ Los eventos sobre el **estado de conexión** de las puertas de enlace de LoRaWAN aparecerán en la sección **Puertas de enlace inalámbricas**.
+ Los eventos de **estado de registro del dispositivo** y de **proximidad** de las cuentas de Sidewalk aparecerán en la pestaña **Cuentas de Sidewalk**.

**Suscripción a temas con el cliente de MQTT**  
En función de si ha habilitado los eventos para todos los recursos o para tipos de recursos individuales, los eventos que haya habilitado aparecerán en la consola con sus temas MQTT en la pestaña **Todos los recursos** o en la pestaña del tipo de recurso especificado.
+ Si elige uno de los temas MQTT, puede ir al cliente de MQTT para suscribirse a estos temas y recibir mensajes.
+ Si ha agregado varios eventos, puede suscribirse a varios temas de eventos y recibir notificaciones sobre ellos. Para suscribirse a varios temas, elija los temas, seleccione **Acción** y, a continuación, elija **Suscribirse**.

## Habilitación de notificaciones mediante la AWS CLI
<a name="iot-wireless-control-events-cli"></a>

Puede configurar eventos y añadir recursos a la configuración mediante la API de AWS IoT Wireless o la AWS CLI.

**Habilitación de las notificaciones para todos los recursos**  
Puede habilitar las notificaciones para todos sus recursos de la Cuenta de AWS que pertenezcan a un tipo de recurso concreto y monitorizarlos mediante la operación [UpdateEventConfigurationByResourceTypes](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateResourceEventConfiguration.html) de la API o el comando [cli/latest/reference/iotwireless/update-event-configuration-by-resource-types.html](cli/latest/reference/iotwireless/update-event-configuration-by-resource-types.html) de la CLI. Por ejemplo:

```
aws iotwireless update-event-configuration-by-resource-types \ 
   --cli-input-json input.json
```

**Contenido de input.json**

```
{   
   "DeviceRegistrationState": { 
      "Sidewalk": { 
         "AmazonIdEventTopic": "Enabled"
      }
   },
   "ConnectionStatus": { 
      "LoRaWAN": { 
         "WirelessGatewayEventTopic": "Enabled"
      }
   }
}
```

**nota**  
Todas las comillas (") van precedidas de barras diagonales invertidas (\\).

Puede obtener la configuración de eventos actual llamando a la API [GetEventConfigurationByResourceTypes](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetResourceEventConfiguration.html) o mediante el comando [cli/latest/reference/iotwireless/get-event-configuration-by-resource-types.html](cli/latest/reference/iotwireless/get-event-configuration-by-resource-types.html) de la CLI. Por ejemplo:

```
aws iotwireless get-event-configuration-by-resource-types
```

**Habilitación de las notificaciones para recursos individuales**  
Para agregar recursos individuales a la configuración de eventos y controlar cuáles se publican mediante la API o la CLI, llame a la API [UpdateResourceEventConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateResourceEventConfiguration.html) o utilice el comando [cli/latest/reference/iotwireless/update-resource-event-configuration.html](cli/latest/reference/iotwireless/update-resource-event-configuration.html) de la CLI. Por ejemplo:

```
aws iotwireless update-resource-event-configuration \ 
   --identifer 1ffd32c8-8130-4194-96df-622f072a315f \ 
   --identifier-type WirelessDeviceId \ 
   --cli-input-json input.json
```

**Contenido de input.json**

```
{  
   "Join": { 
      "LoRaWAN": { 
         "DevEuiEventTopic": "Disabled"
      },
      "WirelessDeviceIdEventTopic": "Enabled"
   }
}
```

**nota**  
Todas las comillas (") van precedidas de barras diagonales invertidas (\\).

Puede obtener la configuración de eventos actual llamando a la API [GetResourceEventConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetResourceEventConfiguration.html) o mediante el comando [cli/latest/reference/iotwireless/get-resource-event-configuration.html](cli/latest/reference/iotwireless/get-resource-event-configuration.html) de la CLI. Por ejemplo:

```
aws iotwireless get-resource-event-configuration \ 
    --identifier-type WirelessDeviceId \ 
    --identifier 1ffd32c8-8130-4194-96df-622f072a315f
```

**Enumeración de las configuraciones de eventos**  
También puede usar la API de AWS IoT Wireless o la AWS CLI para enumerar las configuraciones de eventos en las que se haya habilitado al menos un tema de evento. Para enumerar las configuraciones, utilice la operación [ListEventConfigurations](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListEventConfigurations.html) de la API o el comando [cli/latest/reference/iotwireless/list-event-configurations.html](cli/latest/reference/iotwireless/list-event-configurations.html) de la CLI. Por ejemplo:

```
aws iotwireless list-event-configurations --resource-type WirelessDevice
```