Notifications d’événements pour AWS IoT Wireless - AWS IoT Wireless
Comment vos ressources peuvent être informées des événementsTarification des événements sans fil

Notifications d’événements pour AWS IoT Wireless

AWS IoT Wireless peut publier des messages pour vous informer des événements relatifs aux appareils LoRaWAN et Sidewalk auxquels vous êtes connecté à AWS IoT Core. Par exemple, vous pouvez être informé d’événements tels que le fait que les appareils Sidewalk de votre compte ont été mis en service ou enregistrés.

Comment vos ressources peuvent être informées des événements

Les notifications d’événements sont publiées lorsque certains événements se produisent. Par exemple, des événements sont générés lorsque votre appareil Sidewalk est mise en service. Chaque événement entraîne l’envoi d’une notification d’événement unique. Les notifications d’événements sont publiées via MQTT avec une charge utile JSON. Le contenu de la charge utile dépend du type d'événement.

Note

Les notifications d’événements sont publiées au moins une fois. Ils peuvent être publiés plusieurs fois. L’ordre des notifications d’événement n’est pas garanti.

Événements et types de ressources

Le tableau suivant indique les différents types d’événements pour lesquels vous recevrez des notifications. Les types d’événements varient selon que le type de ressource est un appareil sans fil, une passerelle sans fil ou un compte Sidewalk. Vous pouvez également activer des événements pour vos ressources au niveau des ressources, ce qui s’applique à toutes les ressources d’un type particulier, ou pour certaines ressources, comme décrit dans la section suivante. Pour plus d’informations sur les différents types d’événements, veuillez consulter Notifications d’événements pour les ressources LoRaWAN et Notifications d’événements pour les ressources Sidewalk.

Types d’événements basés sur les ressources
Ressource Type de ressource Type d’événement
Appareil sans fil LoRaWAN Joindre
Sidewalk

  • Statut d’enregistrement de l’appareil

  • Proximité
Passerelle sans fil LoRaWAN Statut de la connexion.
Compte Sidewalk Sidewalk

  • Statut d’enregistrement de l’appareil

  • Proximité

Politique de réception de notifications d’événements sans fil

Afin de recevoir des notifications d’événements, votre appareil doit utiliser une stratégie appropriée qui lui permet de se connecter à la passerelle de l’appareil AWS IoT et de s’abonner aux rubriques d’événements MQTT. Vous devez aussi vous abonner aux filtres de rubriques appropriés.

Voici un exemple de la politique requise pour recevoir des notifications relatives aux différents événements sans fil.

{
    "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/*"
        ]
    }]
}

Format des sujets MQTT pour les événements sans fil

Pour vous envoyer des notifications d’événements concernant vos ressources sans fil, AWS IoT utilise des sujets réservés au MQTT commençant par le signe dollar ($). Vous pouvez publier ces sujets réservés et vous y abonner. Cependant, vous ne pouvez pas créer de nouveaux rubriques commençant par le signe du dollar.

Note

Les sujets MQTT sont spécifiques à votre Compte AWS et utilisent le format arn:aws:iotwireless:aws-region:AWS-account-ID:topic/Topic. Pour plus d’informations, consultez Rubriques MQTT dans le Guide du développeur AWS IoT.

Les rubriques MQTT réservées aux appareils sans fil utilisent le format suivant :

  • Rubriques au niveau des ressources

    Ces rubriques s’appliquent à toutes les ressources d’un type particulier dans votre Compte AWS que vous avez intégrées à AWS IoT Wireless.

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

  • Sujets au niveau de l’identifiant

    Ces rubriques s’appliquent à une sélection de ressources d’un type particulier dans le site Compte AWS que vous avez intégré à AWS IoT Wireless, spécifiées par l’identifiant de la ressource.

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

Pour plus d’informations sur les sujets au niveau des ressources et des identifiants, consultez Configurations d’événement..

Le tableau suivant présente des exemples de rubriques MQTT pour les différents événements :

Événements et sujets du MQTT
Événement Rubrique MQTT Remarques
État d’enregistrement des appareils Sidewalk
  • Rubriques au niveau des ressources

    $aws/iotwireless/events/device_registration_state/{eventType}/sidewalk/wireless_devices

  • Rubrique au niveau de l’identifiant

    $aws/iotwireless/events/device_registration_state/{eventType}/sidewalk/{resourceType}/{resourceID}/{id}

  • {eventType} peut avoir la valeur registered ou provisioned.

  • {resourceType} peut avoir la valeur sidewalk_accounts ou wireless_devices.

  • {resourceID} est le amazon_id pour sidewalk_accounts et wireless_device_id pour wireless_devices
Proximité Sidewalk
  • Rubriques au niveau des ressources

    $aws/iotwireless/events/proximity/{eventType}/sidewalk/wireless_devices

  • Rubrique au niveau de l’identifiant

    $aws/iotwireless/events/proximity/{eventType}/sidewalk/{resourceType}/{resourceID}/{id}

  • {eventType} peut avoir la valeur beacon_discovered ou beacon_lost.

  • {resourceType} peut avoir la valeur sidewalk_accounts ou wireless_devices.

  • {resourceID} est le amazon_id pour sidewalk_accounts et wireless_device_id pour wireless_devices
Joindre LoRaWAN
  • Rubriques au niveau des ressources

    $aws/iotwireless/events/join/{eventType}/lorawan/wireless_devices

  • Rubrique au niveau de l’identifiant

    $aws/iotwireless/events/join/{eventType}/lorawan/wireless_devices/{resourceID}/{id}

  • {eventType} peut être join_req_0_received ou join_req_2_received ou join_accepted

  • {resourceID} peut avoir la valeur wireless_device_id ou dev_eui.
Statut de la connexion de passerelle LoRaWAN
  • Rubriques au niveau des ressources

    $aws/iotwireless/events/join/{eventType}/lorawan/wireless_gateways

  • Rubrique au niveau de l’identifiant

    $aws/iotwireless/events/join/{eventType}/lorawan/wireless_gateways/{resourceID}/{id}

  • {eventType} peut avoir la valeur connected ou disconnected.

  • {resourceID} peut avoir la valeur wireless_gateway_id ou gateway_eui.

Pour plus d’informations sur les différents événements, consultez Notifications d’événements pour les ressources LoRaWAN et Notifications d’événements pour les ressources Sidewalk.

Si vous êtes abonné à ces sujets, vous serez averti lorsqu’un message sera publié dans l’un des sujets de notification d’événements. Pour plus d’informations, consultez Rubriques réservées MQTT dans le Guide du développeur AWS IoT.

Tarification des événements sans fil

Pour plus d’informations sur les tarifs relatifs à l’abonnement aux événements et à la réception de notifications, consultez la section AWS IoT Coretarification.