

# Abilitazione degli eventi per le risorse wireless
<a name="iot-wireless-control-events"></a>

Prima che i sottoscrittori agli argomenti riservati possano ricevere messaggi, è necessario abilitare le notifiche degli eventi. Per fare ciò, è possibile utilizzare la Console di gestione AWS, l'API Wireless AWS IoT o AWS CLI.

## Configurazioni degli eventi
<a name="iot-wireless-control-events-config"></a>

Puoi configurare gli eventi per inviare notifiche a tutte le risorse appartenenti a un determinato tipo o per singole risorse wireless. Il tipo di risorsa può essere un gateway wireless, un account partner Sidewalk o un dispositivo wireless, che può essere un dispositivo LoRaWAN o Sidewalk. Per informazioni sul tipo di eventi che è possibile abilitare per i dispositivi wireless, consulta [Tipi di evento per le risorse LoRaWAN](iot-lorawan-events.md#iot-lorawan-event-types) e [Tipi di evento per le risorse Sidewalk](iot-sidewalk-events.md#iot-sidewalk-event-types).

**Tutte le risorse**  
Puoi abilitare gli eventi in modo che tutte le risorse presenti nel tuo Account AWS che appartengono a un determinato tipo di risorse ricevano le notifiche. Ad esempio, è possibile abilitare un evento che notifichi le modifiche dello stato della connessione per tutti i gateway LoRaWAN che hai sottoposto all'onboarding con AWS IoT Core per LoRaWAN. Il monitoraggio di questi eventi ti aiuterà a ricevere le notifiche nei casi in cui i gateway LoRaWAN del tuo parco istanze di risorse vengano disconnessi o un beacon venga perso per un certo numero di dispositivi Sidewalk nel tuo Account AWS.

**Risorse individuali**  
È anche possibile aggiungere singole risorse LoRaWAN e Sidewalk alla configurazione dell'evento e abilitare le notifiche per queste risorse. In tal modo puoi monitorare le singole risorse di un determinato tipo. Ad esempio, puoi aggiungere determinati dispositivi LoRaWAN e Sidewalk alla configurazione e ricevere le notifiche per gli eventi di join o stato di registrazione del dispositivo per queste risorse.

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

La risorsa LoRaWAN o Sidewalk deve disporre di una policy appropriata che consenta di ricevere le notifiche degli eventi. Per ulteriori informazioni, consultare [Policy per la ricezione delle notifiche degli eventi wireless](iot-wireless-events.md#iot-wireless-events-policy).

## Abilitazione delle notifiche tramite Console di gestione AWS
<a name="iot-wireless-control-events-console"></a>

Per abilitare i messaggi di evento dalla console, accedi alla scheda [Settings](console.aws.amazon.com/iot/home/settings/) (Impostazioni) della console AWS IoT e vai nella sezione **LoRaWAN and Sidewalk event notification** (Notifica evento LoRaWAN e Sidewalk). 

Puoi abilitare le notifiche per tutte le risorse del tuo Account AWS che appartengono a un determinato tipo di risorsa e monitorarle.

**Per abilitare le notifiche per tutte le risorse**

1. Nella sezione **LoRaWAN and Sidewalk event notification** (Notifica eventi LoRaWAN e Sidewalk), vai nella scheda **All resources** (Tutte le risorse), seleziona **Action** (Operazione) e quindi scegli **Manage events** (Gestione eventi).

1. Abilita gli eventi da monitorare e scegli **Update events** (Aggiorna eventi). Se non vuoi più monitorare determinati eventi, scegli **Action** (Operazione), seleziona **Manage events** (Gestione eventi) e quindi disabilita gli eventi.

Puoi anche abilitare le notifiche per le singole risorse nel tuo Account AWS che appartengono a un determinato tipo di risorsa e monitorarle.

**Per abilitare le notifiche per singole risorse**

1. Nella sezione **LoRaWAN and Sidewalk event notification** (Notifica eventi LoRaWAN e Sidewalk), scegli **Action** (Operazione) e quindi seleziona **Add resources** (Aggiungi risorse).

1. Seleziona le risorse e gli eventi per i quali desideri ricevere le notifiche:

   1. Scegli se desideri monitorare gli eventi per le **LoRaWAN resources** (risorse LoRaWAN) o per le **Sidewalk resources** (risorse Sidewalk).

   1. Puoi scegliere gli eventi da abilitare per le risorse a seconda del tipo di risorsa. Puoi quindi iscriverti a questi eventi e ricevere le notifiche. Se scegli:
      + Le **risorse LoRaWAN**: puoi abilitare gli eventi di **join** per i tuoi dispositivi LoRaWAN o gli eventi di **stato della connessione** per i tuoi gateway LoRaWAN. 
      + Le risorse Sidewalk: puoi abilitare gli eventi di **stato di registrazione del dispositivo** o di **prossimità** o entrambi per gli account partner Sidewalk e i dispositivi Sidewalk.

1. A seconda del tipo di risorsa e degli eventi scelti, seleziona i dispositivi wireless o i gateway da monitorare. Puoi selezionare fino a 250 risorse per tutte le risorse combinate. 

1. Scegli **Submit** (Invia) per aggiungere le risorse.

Le risorse aggiunte verranno visualizzate con i relativi argomenti MQTT nella scheda per il tipo di risorsa nella sezione **LoRaWAN and Sidewalk event notification** (Notifica eventi LoRaWAN e Sidewalk) della console.
+ Gli eventi di **join LoRaWAN** e gli eventi per i tuoi dispositivi Sidewalk vengono visualizzati nella sezione **Wireless devices** (Dispositivi wireless) della console.
+ Gli eventi di **stato della connessione** per i gateway LoRaWAN vengono visualizzati nella sezione **Wireless gateways** (Gateway wireless).
+ Gli eventi di **stato di registrazione del dispositivo** e di **prossimità** per gli account Sidewalk vengono visualizzati nella scheda **Sidewalk accounts** (Account Sidewalk).

**Sottoscrizione agli argomenti tramite il client MQTT**  
A seconda che siano stati abilitati per tutte le risorse o per singoli tipi di risorse, gli eventi vengono visualizzati nella console con i relativi argomenti MQTT nella scheda **All resources** (Tutte le risorse) o nella scheda per il tipo di risorsa specificato.
+ Se scegli un argomento MQTT, puoi accedere al client MQTT per sottoscrivere l'argomento e ricevere messaggi.
+ Se hai aggiunto più eventi, puoi sottoscrivere più argomenti dell'evento e ricevere le relative notifiche. Per sottoscrivere più argomenti, scegli gli argomenti e seleziona **Action** (Operazione) e quindi **Subscribe** (Sottoscrivi).

## Abilitazione delle notifiche tramite AWS CLI
<a name="iot-wireless-control-events-cli"></a>

Puoi configurare gli eventi e aggiungere le risorse alla configurazione utilizzando l'API Wireless AWS IoT o AWS CLI.

**Abilitazione delle notifiche per tutte le risorse**  
Puoi abilitare le notifiche per tutte le risorse del tuo Account AWS che appartengono a un determinato tipo di risorsa e monitorarle utilizzando l'API [UpdateEventConfigurationByResourceTypes](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateResourceEventConfiguration.html) o il comando [cli/latest/reference/iotwireless/update-event-configuration-by-resource-types.html](cli/latest/reference/iotwireless/update-event-configuration-by-resource-types.html) dell'interfaccia a riga di comando. Ad esempio:

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

**Contenuto di input.json**

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

**Nota**  
Tutte le virgolette doppie (") sono precedute dal carattere di escape barra rovesciata (\$1).

Puoi ottenere la configurazione degli eventi corrente chiamando l'API [GetEventConfigurationByResourceTypes](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetResourceEventConfiguration.html) o utilizzando il comando [cli/latest/reference/iotwireless/get-event-configuration-by-resource-types.html](cli/latest/reference/iotwireless/get-event-configuration-by-resource-types.html) dell'interfaccia a riga di comando. Ad esempio:

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

**Abilitazione delle notifiche per singole risorse**  
Per aggiungere singole risorse alla configurazione dell'evento e controllare quali eventi vengono pubblicati utilizzando l'API o l'interfaccia a riga di comando, chiama l'API [UpdateResourceEventConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateResourceEventConfiguration.html) o usa il comando [cli/latest/reference/iotwireless/update-resource-event-configuration.html](cli/latest/reference/iotwireless/update-resource-event-configuration.html) dell'interfaccia a riga di comando. Ad esempio:

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

**Contenuto di input.json**

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

**Nota**  
Tutte le virgolette doppie (") sono precedute dal carattere di escape barra rovesciata (\$1).

Puoi ottenere la configurazione degli eventi corrente chiamando l'API [GetResourceEventConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetResourceEventConfiguration.html) o utilizzando il comando CLI [cli/latest/reference/iotwireless/get-resource-event-configuration.html](cli/latest/reference/iotwireless/get-resource-event-configuration.html). Ad esempio:

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

**Elenco delle configurazioni di eventi**  
Puoi utilizzare l'API Wireless AWS IoT o AWS CLI per elencare le configurazioni degli eventi in cui è stato abilitato almeno un argomento. Per elencare le configurazioni, utilizza l'operazione API [ListEventConfigurations](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListEventConfigurations.html) o il comando [cli/latest/reference/iotwireless/list-event-configurations.html](cli/latest/reference/iotwireless/list-event-configurations.html) dell'interfaccia a riga di comando. Ad esempio:

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