Créez une destination pour votre appareil Sidewalk

Vous pouvez ajouter une destination à votre compte pour AWS IoT Core pour Amazon Sidewalk soit à l’aide du hub Destinations, soit à l’aide de CreateDestination. Lors de la création de votre destination, spécifiez :

• Un nom unique pour la destination à utiliser pour votre terminal Sidewalk.

  Note

  Si vous avez déjà ajouté votre appareil en utilisant un nom de destination, vous devez utiliser ce nom lors de la création de votre destination. Pour en savoir plus, consultez Étape 2 : Ajouter votre appareil Sidewalk.

• Le nom de la règle AWS IoT qui traitera les données de l’appareil et le sujet dans lequel les messages sont publiés.

• Rôle IAM qui accorde aux données de l’appareil l’autorisation d’accéder à la règle.

Les sections suivantes décrivent comment créer la règle AWS IoT et le rôle IAM pour votre destination.

Créer une destination (console)

Pour créer une destination à l’aide de la console AWS IoT, accédez au centre Destinations et choisissez Ajouter une destination.

Pour traiter les données d’un appareil, spécifiez les champs suivants lors de la création d’une destination, puis choisissez Ajouter une destination.

• Détails de la destination

  Entrez un nom de destination et une description facultative pour votre destination.

• Nom de la règle

  La règle AWS IoT configurée pour évaluer les messages envoyés par votre appareil et traiter les données de celui-ci. Le nom de la règle sera mappé à votre destination. La destination a besoin de la règle pour traiter les messages qu’elle reçoit. Vous pouvez choisir de traiter les messages en invoquant une règle AWS IoT ou en les publiant sur l’agent de messages AWS IoT.

  • Si vous choisissez Entrez un nom de règle, entrez un nom, puis choisissez Copier pour copier le nom de règle que vous allez entrer lors de la création de la règle AWS IoT. Vous pouvez soit choisir Créer une règle pour créer la règle maintenant, soit accéder au centre de règles de la AWS IoT console et créer une règle portant ce nom.

    Vous pouvez également entrer une règle et utiliser le paramètre Avancé pour spécifier un nom de rubrique. Le nom du sujet est fourni lors de l’invocation de la règle et est accessible à l’aide de l’expression topic contenue dans la règle. Pour plus d’informations sur les règles AWS IoT, consultez AWS IoT Règles.

  • Si vous choisissez Publier sur AWS IoT l’agent de messages, entrez le nom du sujet. Vous pouvez ensuite copier le nom du sujet MQTT et plusieurs abonnés peuvent s’abonner à ce sujet pour recevoir les messages publiés sur ce sujet. Pour plus d’informations, consultez les rubriques MQTT.

  Pour plus d’informations sur les règles AWS IoT relatives aux destinations, voir Créer des règles pour traiter les messages des appareils LoRaWAN.

• Nom du rôle

  Le rôle IAM qui autorise les données de l’appareil à accéder à la règle nommée dans Nom de la règle. Dans la console, vous pouvez créer une nouvelle fonction du service ou sélectionner une fonction du service existant. Si vous créez un nouvelle fonction du service, vous pouvez soit entrer un nom de rôle (par exemple,SidewalkDestinationRole), soit le laisser vide AWS IoT Core for LoRaWAN pour générer un nouveau nom de rôle. AWS IoT Core for LoRaWAN créera ensuite automatiquement le rôle IAM avec les autorisations appropriées en votre nom.

Créer une destination (CLI)

Pour créer une destination, utilisez l’opération de l’API CreateDestination ou la commande CLI create-destination. Par exemple, la commande suivante crée une destination pour votre terminal Sidewalk :

aws iotwireless create-destination --name SidewalkDestination \
    --expression-type RuleName --expression SidewalkRule \
    --role-arn arn:aws:iam::123456789012:role/SidewalkRole

L’exécution de cette commande renvoie les détails de destination, notamment l’Amazon Resource Name (ARN) et le nom de destination.

{
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:Destination/SidewalkDestination",
    "Name": "SidewalkDestination"
}

Pour plus d’informations sur la création d’une destination, consultez Création de règles pour traiter les messages des appareils LoRaWAN.