Activer les événements pour les ressources sans fil

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.

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 et Types d’événements pour les ressources Sidewalk.

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

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.

Activez les notifications à l’aide de AWS Management Console.

Pour activer les messages d’événements depuis la console, accédez à l’onglet Paramètres 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.

2. 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.

2. 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.

   2. 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.

3. 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.

4. 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.

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 ou de la commande CLI update-event-configuration-by-resource-types. 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 ou en utilisant la commande CLI get-event-configuration-by-resource-types. 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 ou utilisez la commande CLI update-resource-event-configuration. 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 ou en utilisant la commande CLI get-resource-event-configuration. 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 ou utilisez la commande CLI list-event-configurations. Par exemple :

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