

# Activer les événements pour les ressources sans fil
<a name="iot-wireless-control-events"></a>

Avant que les abonnés aux sujets réservés puissent recevoir des messages, vous devez activer les notifications d’événements. Pour ce faire, vous utilisez l’AWS Management Console ou l’API AWS IoT Wireless ou AWS CLI.

## Configurations d’événement.
<a name="iot-wireless-control-events-config"></a>

Vous pouvez configurer des événements pour envoyer des notifications à toutes les ressources appartenant à un type particulier ou à des ressources sans fil individuelles. Le type de ressource peut être une passerelle sans fil, un compte partenaire Sidewalk ou un appareil sans fil, qui peut être un appareil LoRaWAN ou Sidewalk. Pour plus d’informations sur le type d’événements que vous pouvez activer pour vos appareils sans fil, consultez [Types d’événements pour les ressources LoRaWAN](iot-lorawan-events.md#iot-lorawan-event-types) et [Types d’événements pour les ressources Sidewalk](iot-sidewalk-events.md#iot-sidewalk-event-types).

**Toutes les ressources**  
Vous pouvez activer des événements tels que toutes les ressources de votre Compte AWS appartenant à un type de ressource particulier reçoivent des notifications. Par exemple, vous pouvez activer un événement qui vous informe des modifications de l’état de connexion pour toutes les passerelles LoRaWAN que vous avez intégrées à AWS IoT Core for LoRaWAN. La surveillance de ces événements vous aidera à être averti dans des cas tels que lorsque certaines passerelles LoRaWAN de votre flotte de ressources sont déconnectées ou en cas de perte d’une balise pour un certain nombre d’appareils Sidewalk de votre Compte AWS.

**Ressources individuelles**  
Vous pouvez également ajouter des ressources LoRaWAN et Sidewalk individuelles à la configuration de votre événement et activer les notifications correspondantes. Cela vous aidera à surveiller les ressources individuelles d’un type particulier. Par exemple, vous pouvez ajouter certains appareils LoRaWAN et Sidewalk à votre configuration et recevoir des notifications en cas d’inscription ou d’enregistrement d’appareils pour ces ressources.

## Prérequis
<a name="iot-wireless-control-events-prereq"></a>

Votre ressource LoRaWAN ou Sidewalk doit disposer d’une politique appropriée lui permettant de recevoir des notifications d’événements. Pour en savoir plus, consultez [Politique de réception de notifications d’événements sans fil](iot-wireless-events.md#iot-wireless-events-policy).

## Activez les notifications à l’aide de AWS Management Console.
<a name="iot-wireless-control-events-console"></a>

Pour activer les messages d’événements depuis la console, accédez à l’onglet [Paramètres](console.aws.amazon.com/iot/home/settings/) de la AWS IoT console, puis à la section de **notification des événements LoRaWAN et Sidewalk**. 

Vous pouvez activer les notifications pour toutes les ressources de votre Compte AWS qui appartiennent à un type de ressource particulier et les surveiller.

**Pour activer les notifications pour toutes les ressources**

1. Dans la section **Notification des événements LoRaWAN et Sidewalk**, accédez à l’onglet **Toutes les ressources**, choisissez **Action**, puis sélectionnez **Gérer les événements**.

1. Activez les événements que vous souhaitez surveiller, puis choisissez **Mettre à jour les événements**. Si vous ne souhaitez plus surveiller certains événements, choisissez **Action**, puis **Gérer les événements**, puis désactivez ces événements.

Vous pouvez également activer les notifications pour les ressources individuelles de votre Compte AWS qui appartiennent à un type de ressource particulier et les surveiller.

**Pour activer les notifications pour des ressources individuelles**

1. Dans la section **Notification des événements LoRaWAN et Sidewalk**, choisissez **Action**, puis **Ajouter des ressources**.

1. Sélectionnez les ressources et les événements pour lesquels vous souhaitez recevoir des notifications :

   1. Choisissez si vous souhaitez surveiller les événements pour vos **ressources LoRaWAN** ou pour les **ressources Sidewalk**.

   1. En fonction du type de ressource, vous pouvez choisir les événements que vous souhaitez activer pour les ressources. Vous pouvez ensuite vous abonner à ces événements et recevoir des notifications. Si vous choisissez :
      + **Ressources LoRaWAN** : vous pouvez activer les événements de **participation** pour vos appareils LoRaWAN ou les événements **d’état de connexion** pour vos passerelles LoRaWAN. 
      + Ressources Sidewalk : vous pouvez activer l’**état d’enregistrement de l’appareil** et/ou les événements de **proximité** pour vos comptes partenaires Sidewalk et vos appareils Sidewalk.

1. En fonction du type de ressource et des événements que vous avez choisis, sélectionnez les appareils ou passerelles sans fil que vous souhaitez surveiller. Vous pouvez sélectionner jusqu’à 250 ressources pour toutes les ressources combinées. 

1. Choisissez **Soumettre** pour ajouter vos ressources.

Les ressources que vous ajoutez apparaîtront avec leurs rubriques MQTT dans l’onglet correspondant à votre type de ressource dans la section de **notification des événements LoRaWAN et Sidewalk** de la console.
+ Les événements de **participation au LoRaWAN** et les événements pour vos appareils Sidewalk apparaîtront dans la section **Appareils sans fil** de la console.
+ Les événements **relatifs à l’état de connexion** de vos passerelles LoRaWAN apparaîtront dans la section **Passerelles sans fil**.
+ **L’état d’enregistrement des appareils** et les événements de **proximité** pour vos comptes Sidewalk apparaîtront dans l’onglet **Comptes Sidewalk**.

**Abonnez-vous à des sujets à l’aide du client MQTT**  
Selon que vous avez activé les événements pour toutes les ressources ou pour des types de ressources individuels, les événements que vous avez activés apparaîtront dans la console avec leurs rubriques MQTT dans l’onglet **Toutes les ressources** ou dans l’onglet correspondant au type de ressource spécifié.
+ Si vous choisissez l’un des sujets MQTT, vous pouvez accéder au client MQTT pour vous abonner à ces sujets et recevoir des messages.
+ Si vous avez ajouté plusieurs événements, vous pouvez vous abonner à plusieurs sujets d’événements et recevoir des notifications à leur sujet. Pour vous abonner à plusieurs sujets, choisissez vos rubriques, cliquez sur **Action**, puis sur **S’abonner**.

## Activez les notifications à l’aide de AWS CLI.
<a name="iot-wireless-control-events-cli"></a>

Vous pouvez configurer des événements et ajouter des ressources à votre configuration à l’aide de l’API AWS IoT Wireless ou du AWS CLI.

**Activer les notifications pour toutes les ressources**  
Vous pouvez activer les notifications pour toutes les ressources de votre Compte AWS qui appartiennent à un type de ressource particulier et les surveiller à l’aide de l’API [UpdateEventConfigurationByResourceTypes](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateResourceEventConfiguration.html) ou de la commande CLI [cli/latest/reference/iotwireless/update-event-configuration-by-resource-types.html](cli/latest/reference/iotwireless/update-event-configuration-by-resource-types.html). Par exemple :

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

**Contenu de input.json**

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

**Note**  
L'échappement de tous les guillemets (") est effectué avec des barres obliques inverses (\\).

Vous pouvez obtenir la configuration actuelle de l’événement en appelant l’API [GetEventConfigurationByResourceTypes](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetResourceEventConfiguration.html) ou en utilisant la commande CLI [cli/latest/reference/iotwireless/get-event-configuration-by-resource-types.html](cli/latest/reference/iotwireless/get-event-configuration-by-resource-types.html). Par exemple :

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

**Activer les notifications pour des ressources individuelles**  
Pour ajouter des ressources individuelles à la configuration de vos événements et contrôler les événements publiés à l’aide de l’API ou de la CLI, appelez l’API [UpdateResourceEventConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateResourceEventConfiguration.html) ou utilisez la commande CLI [cli/latest/reference/iotwireless/update-resource-event-configuration.html](cli/latest/reference/iotwireless/update-resource-event-configuration.html). Par exemple :

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

**Contenu de input.json**

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

**Note**  
L'échappement de tous les guillemets (") est effectué avec des barres obliques inverses (\\).

Vous pouvez obtenir la configuration actuelle de l’événement en appelant l’API [GetResourceEventConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetResourceEventConfiguration.html) ou en utilisant la commande CLI [cli/latest/reference/iotwireless/get-resource-event-configuration.html](cli/latest/reference/iotwireless/get-resource-event-configuration.html). Par exemple :

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

**Liste des configurations d’événement**  
Vous pouvez également utiliser l’AWS IoT WirelessAPI ou le AWS CLI pour répertorier les configurations d’événements dans lesquelles au moins une rubrique d’événement a été activé. Pour répertorier les configurations, utilisez l’opération d’API [ListEventConfigurations](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListEventConfigurations.html) ou utilisez la commande CLI [cli/latest/reference/iotwireless/list-event-configurations.html](cli/latest/reference/iotwireless/list-event-configurations.html). Par exemple :

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