Exemples d’utilisation de l’AWS CLI avec AWS IoT Wireless - AWS Command Line Interface

Exemples d’utilisation de l’AWS CLI avec AWS IoT Wireless

Les exemples de code suivants montrent comment réaliser des actions et mettre en œuvre des scénarios courants en utilisant l’AWS Command Line Interface avec AWS IoT Wireless.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

L’exemple de code suivant montre comment utiliser associate-aws-account-with-partner-account.

AWS CLI

Pour associer un compte partenaire à votre compte AWS

L’exemple associate-aws-account-with-partner-account suivant associe les informations d’identification suivantes du compte Sidewalk à votre compte AWS.

aws iotwireless associate-aws-account-with-partner-account \ --sidewalk AmazonId="12345678901234",AppServerPrivateKey="a123b45c6d78e9f012a34cd5e6a7890b12c3d45e6f78a1b234c56d7e890a1234"

Sortie :

{ "Sidewalk": { "AmazonId": "12345678901234", "AppServerPrivateKey": "a123b45c6d78e9f012a34cd5e6a7890b12c3d45e6f78a1b234c56d7e890a1234" } }

Pour plus d’informations, consultez Intégration d’Amazon Sidewalk pour AWS IoT Core dans le Manuel du développeur AWS IoT.

L’exemple de code suivant montre comment utiliser associate-wireless-device-with-thing.

AWS CLI

Pour associer un objet à un appareil sans fil

L’exemple associate-wireless-device-with-thing suivant associe à votre appareil sans fil un objet portant l’ID spécifié.

aws iotwireless associate-wireless-device-with-thing \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" \ --thing-arn "arn:aws:iot:us-east-1:123456789012:thing/MyIoTWirelessThing"

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Ajout de passerelles et d’appareils sans fil à AWS IoT Core for LoRaWAN dans le Manuel du développeur AWS IoT.

L’exemple de code suivant montre comment utiliser associate-wireless-gateway-with-certificate.

AWS CLI

Pour associer le certificat à la passerelle sans fil

L’exemple associate-wireless-gateway-with-certificate suivant associe une passerelle sans fil à un certificat.

aws iotwireless associate-wireless-gateway-with-certificate \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" \ --iot-certificate-id "a123b45c6d78e9f012a34cd5e6a7890b12c3d45e6f78a1b234c56d7e890a1234"

Sortie :

{ "IotCertificateId": "a123b45c6d78e9f012a34cd5e6a7890b12c3d45e6f78a1b234c56d7e890a1234" }

Pour plus d’informations, consultez Ajout de passerelles et d’appareils sans fil à AWS IoT Core for LoRaWAN dans le Manuel du développeur AWS IoT.

L’exemple de code suivant montre comment utiliser associate-wireless-gateway-with-thing.

AWS CLI

Pour associer un objet à une passerelle sans fil

L’exemple associate-wireless-gateway-with-thing suivant associe un objet à une passerelle sans fil.

aws iotwireless associate-wireless-gateway-with-thing \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" \ --thing-arn "arn:aws:iot:us-east-1:123456789012:thing/MyIoTWirelessThing"

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Ajout de passerelles et d’appareils sans fil à AWS IoT Core for LoRaWAN dans le Manuel du développeur AWS IoT.

L’exemple de code suivant montre comment utiliser create-destination.

AWS CLI

Pour créer une destination sans fil IoT

L’exemple create-destination suivant crée une destination pour mapper un message d’appareil à une règle AWS IoT. Avant d’exécuter cette commande, vous devez avoir créé un rôle IAM qui donne à AWS IoT Core pour LoRaWAN les autorisations nécessaires pour envoyer des données à la règle AWS IoT.

aws iotwireless create-destination \ --name IoTWirelessDestination \ --expression-type RuleName \ --expression IoTWirelessRule \ --role-arn arn:aws:iam::123456789012:role/IoTWirelessDestinationRole

Sortie :

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

Pour plus d’informations, consultez Ajout des destinations AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez CreateDestination dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-device-profile.

AWS CLI

Pour créer un nouveau profil d’appareil

L’exemple create-device-profile suivant crée un nouveau profil d’appareil IoT sans fil.

aws iotwireless create-device-profile

Sortie :

{ "Arn": "arn:aws:iotwireless:us-east-1:123456789012:DeviceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d", "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d" }

Pour plus d’informations, consultez Add profiles to AWS IoT Core for LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez CreateDeviceProfile dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-service-profile.

AWS CLI

Pour créer un nouveau profil de service

L’exemple create-service-profile suivant crée un nouveau profil de service IoT sans fil.

aws iotwireless create-service-profile

Sortie :

{ "Arn": "arn:aws:iotwireless:us-east-1:123456789012:ServiceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d", "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d" }

Pour plus d’informations, consultez Add profiles to AWS IoT Core for LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez CreateServiceProfile dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-wireless-device.

AWS CLI

Pour créer un appareil sans fil IoT

L’exemple create-wireless-device suivant crée une ressource d’appareil sans fil du type LoRaWAN.

aws iotwireless create-wireless-device \ --cli-input-json file://input.json

Contenu de input.json :

{ "Description": "My LoRaWAN wireless device" "DestinationName": "IoTWirelessDestination" "LoRaWAN": { "DeviceProfileId": "ab0c23d3-b001-45ef-6a01-2bc3de4f5333", "ServiceProfileId": "fe98dc76-cd12-001e-2d34-5550432da100", "OtaaV1_1": { "AppKey": "3f4ca100e2fc675ea123f4eb12c4a012", "JoinEui": "b4c231a359bc2e3d", "NwkKey": "01c3f004a2d6efffe32c4eda14bcd2b4" }, "DevEui": "ac12efc654d23fc2" }, "Name": "SampleIoTWirelessThing" "Type": LoRaWAN }

Sortie :

{ "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessDevice/1ffd32c8-8130-4194-96df-622f072a315f", "Id": "1ffd32c8-8130-4194-96df-622f072a315f" }

Pour plus d’informations, consultez Connexion d’appareils et de passerelles à AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez CreateWirelessDevice dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-wireless-gateway-task-definition.

AWS CLI

Pour créer une définition de tâche de passerelle sans fil

L’exemple create-wireless-gateway-task-definition suivant crée automatiquement des tâches à l’aide de cette définition de tâche pour toutes les passerelles avec la version actuelle spécifiée.

aws iotwireless create-wireless-gateway-task-definition \ --cli-input-json file://input.json

Contenu de input.json :

{ "AutoCreateTasks": true, "Name": "TestAutoUpdate", "Update":{ "UpdateDataSource" : "s3://cupsalphagafirmwarebin/station", "UpdateDataRole" : "arn:aws:iam::001234567890:role/SDK_Test_Role", "LoRaWAN" :{ "CurrentVersion" :{ "PackageVersion" : "1.0.0", "Station" : "2.0.5", "Model" : "linux" }, "UpdateVersion" :{ "PackageVersion" : "1.0.1", "Station" : "2.0.5", "Model" : "minihub" } } } }

Sortie :

{ "Id": "b7d3baad-25c7-35e7-a4e1-1683a0d61da9" }

Pour plus d’informations, consultez Connexion d’appareils et de passerelles à AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

L’exemple de code suivant montre comment utiliser create-wireless-gateway-task.

AWS CLI

Pour créer la tâche pour une passerelle sans fil

L’exemple create-wireless-gateway-task suivant crée une tâche pour une passerelle sans fil.

aws iotwireless create-wireless-gateway-task \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" \ --wireless-gateway-task-definition-id "aa000102-0304-b0cd-ef56-a1b23cde456a"

Sortie :

{ "WirelessGatewayTaskDefinitionId": "aa204003-0604-30fb-ac82-a4f95aaf450a", "Status": "Success" }

Pour plus d’informations, consultez Connexion d’appareils et de passerelles à AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

L’exemple de code suivant montre comment utiliser create-wireless-gateway.

AWS CLI

Pour créer une passerelle sans fil

L’exemple create-wireless-gateway suivant crée une passerelle d’appareil sans fil LoRaWAN.

aws iotwireless create-wireless-gateway \ --lorawan GatewayEui="a1b2c3d4567890ab",RfRegion="US915" \ --name "myFirstLoRaWANGateway" \ --description "Using my first LoRaWAN gateway"

Sortie :

{ "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessGateway/12345678-a1b2-3c45-67d8-e90fa1b2c34d", "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d" }

Pour plus d’informations, consultez Connexion d’appareils et de passerelles à AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez CreateWirelessGateway dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-destination.

AWS CLI

Pour supprimer une destination sans fil IoT

L’exemple delete-destination suivant supprime la ressource de destination sans fil portant le nom IoTWirelessDestination que vous avez créée.

aws iotwireless delete-destination \ --name "IoTWirelessDestination"

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Ajout des destinations AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez DeleteDestination dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-device-profile.

AWS CLI

Pour supprimer un profil d’appareil

L’exemple delete-device-profile suivant supprime un profil d’appareil avec l’ID spécifié que vous avez créé.

aws iotwireless delete-device-profile \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d"

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Add profiles to AWS IoT Core for LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez DeleteDeviceProfile dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-service-profile.

AWS CLI

Pour supprimer un profil de service

L’exemple delete-service-profile suivant supprime un profil de service avec l’ID spécifié que vous avez créé.

aws iotwireless delete-service-profile \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d"

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Add profiles to AWS IoT Core for LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez DeleteServiceProfile dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-wireless-device.

AWS CLI

Pour supprimer un appareil sans fil

L’exemple delete-wireless-device suivant supprime un appareil sans fil avec l’ID spécifié.

aws iotwireless delete-wireless-device \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d"

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Connexion d’appareils et de passerelles à AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez DeleteWirelessDevice dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-wireless-gateway-task-definition.

AWS CLI

Pour supprimer une définition de tâche de passerelle sans fil

L’exemple delete-wireless-gateway-task-definition suivant supprime la définition de tâche de passerelle sans fil que vous avez créée avec l’ID suivant.

aws iotwireless delete-wireless-gateway-task-definition \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d"

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Connexion d’appareils et de passerelles à AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

L’exemple de code suivant montre comment utiliser delete-wireless-gateway-task.

AWS CLI

Pour supprimer une tâche de passerelle sans fil

L’exemple delete-wireless-gateway-task suivant supprime la tâche de passerelle sans fil avec l’ID spécifié.

aws iotwireless delete-wireless-gateway-task \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d"

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Connexion d’appareils et de passerelles à AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

L’exemple de code suivant montre comment utiliser delete-wireless-gateway.

AWS CLI

Pour supprimer une passerelle sans fil

L’exemple delete-wireless-gateway suivant supprime une passerelle sans fil avec l’ID spécifié.

aws iotwireless delete-wireless-gateway \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d"

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Connexion d’appareils et de passerelles à AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez DeleteWirelessGateway dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser disassociate-aws-account-from-partner-account.

AWS CLI

Pour dissocier le compte partenaire du compte AWS

L’exemple disassociate-aws-account-from-partner-account suivant dissocie un compte partenaire de votre compte AWS actuellement associé.

aws iotwireless disassociate-aws-account-from-partner-account \ --partner-account-id "12345678901234" \ --partner-type "Sidewalk"

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Ajout de passerelles et d’appareils sans fil à AWS IoT Core for LoRaWAN dans le Manuel du développeur AWS IoT.

L’exemple de code suivant montre comment utiliser disassociate-wireless-device-from-thing.

AWS CLI

Pour dissocier l’objet de l’appareil sans fil

L’exemple disassociate-wireless-device-from-thing suivant dissocie un appareil sans fil de l’objet qui y est actuellement associé.

aws iotwireless disassociate-wireless-device-from-thing \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d"

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Ajout de passerelles et d’appareils sans fil à AWS IoT Core for LoRaWAN dans le Manuel du développeur AWS IoT.

L’exemple de code suivant montre comment utiliser disassociate-wireless-gateway-from-certificate.

AWS CLI

Pour dissocier le certificat de la passerelle sans fil

L’exemple disassociate-wireless-gateway-from-certificate suivant dissocie une passerelle sans fil du certificat qui y est actuellement associé.

aws iotwireless disassociate-wireless-gateway-from-certificate \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d"

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Ajout de passerelles et d’appareils sans fil à AWS IoT Core for LoRaWAN dans le Manuel du développeur AWS IoT.

L’exemple de code suivant montre comment utiliser disassociate-wireless-gateway-from-thing.

AWS CLI

Pour dissocier l’objet de la passerelle sans fil

L’exemple disassociate-wireless-gateway-from-thing suivant dissocie une passerelle sans fil de l’objet qui y est actuellement associé.

aws iotwireless disassociate-wireless-gateway-from-thing \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d"

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Ajout de passerelles et d’appareils sans fil à AWS IoT Core for LoRaWAN dans le Manuel du développeur AWS IoT.

L’exemple de code suivant montre comment utiliser get-destination.

AWS CLI

Pour obtenir les informations sur une destination sans fil IoT

L’exemple get-destination suivant obtient les informations sur la ressource de destination portant le nom IoTWirelessDestination que vous avez créée.

aws iotwireless get-destination \ --name "IoTWirelessDestination"

Sortie :

{ "Arn": "arn:aws:iotwireless:us-east-1:123456789012:Destination/IoTWirelessDestination", "Name": "IoTWirelessDestination", "Expression": "IoTWirelessRule", "ExpressionType": "RuleName", "RoleArn": "arn:aws:iam::123456789012:role/IoTWirelessDestinationRole" }

Pour plus d’informations, consultez Ajout des destinations AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez GetDestination dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-device-profile.

AWS CLI

Pour obtenir les informations sur un profil d’appareil

L’exemple get-device-profile suivant obtient les informations sur le profil d’appareil avec l’ID spécifié que vous avez créé.

aws iotwireless get-device-profile \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d"

Sortie :

{ "Arn": "arn:aws:iotwireless:us-east-1:123456789012:DeviceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d", "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d", "LoRaWAN": { "MacVersion": "1.0.3", "MaxDutyCycle": 10, "Supports32BitFCnt": false, "RegParamsRevision": "RP002-1.0.1", "SupportsJoin": true, "RfRegion": "US915", "MaxEirp": 13, "SupportsClassB": false, "SupportsClassC": false } }

Pour plus d’informations, consultez Add profiles to AWS IoT Core for LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez GetDeviceProfile dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-partner-account.

AWS CLI

Pour obtenir les informations du compte partenaire

L’exemple get-partner-account suivant obtient les informations sur votre compte Sidewalk avec l’ID suivant.

aws iotwireless get-partner-account \ --partner-account-id "12345678901234" \ --partner-type "Sidewalk"

Sortie :

{ "Sidewalk": { "AmazonId": "12345678901234", "Fingerprint": "a123b45c6d78e9f012a34cd5e6a7890b12c3d45e6f78a1b234c56d7e890a1234" }, "AccountLinked": false }

Pour plus d’informations, consultez Intégration d’Amazon Sidewalk pour AWS IoT Core dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez GetPartnerAccount dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-service-endpoint.

AWS CLI

Pour définir le point de terminaison de service

L’exemple get-service-endpoint suivant obtient le point de terminaison spécifique au compte pour le protocole CUPS.

aws iotwireless get-service-endpoint

Sortie :

{ "ServiceType": "CUPS", "ServiceEndpoint": "https://A1RMKZ37ACAGOT.cups.lorawan.us-east-1.amazonaws.com:443", "ServerTrust": "-----BEGIN CERTIFICATE-----\n MIIESTCCAzGgAwIBAgITBn+UV4WH6Kx33rJTMlu8mYtWDTANBgkqhkiG9w0BAQsF\n ADA5MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6\n b24gUm9vdCBDQSAxMB4XDTE1MTAyMjAwMDAwMFoXDTI1MTAxOTAwMDAwMFowRjEL\n MAkGA1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEVMBMGA1UECxMMU2VydmVyIENB\n IDFCMQ8wDQYDVQQDEwZBbWF6b24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEK\n AoIBAQDCThZn3c68asg3Wuw6MLAd5tES6BIoSMzoKcG5blPVo+sDORrMd4f2AbnZ\n cMzPa43j4wNxhplty6aUKk4T1qe9BOwKFjwK6zmxxLVYo7bHViXsPlJ6qOMpFge5\n blDP+18x+B26A0piiQOuPkfyDyeR4xQghfj66Yo19V+emU3nazfvpFA+ROz6WoVm\n B5x+F2pV8xeKNR7u6azDdU5YVX1TawprmxRC1+WsAYmz6qP+z8ArDITC2FMVy2fw\n 0IjKOtEXc/VfmtTFch5+AfGYMGMqqvJ6LcXiAhqG5TI+Dr0RtM88k+8XUBCeQ8IG\n KuANaL7TiItKZYxK1MMuTJtV9IblAgMBAAGjggE7MIIBNzASBgNVHRMBAf8ECDAG\n AQH/AgEAMA4GA1UdDwEB/wQEAwIBhjAdBgNVHQ4EFgQUWaRmBlKge5WSPKOUByeW\n dFv5PdAwHwYDVR0jBBgwFoAUhBjMhTTsvAyUlC4IWZzHshBOCggwewYIKwYBBQUH\n AQEEbzBtMC8GCCsGAQUFBzABhiNodHRwOi8vb2NzcC5yb290Y2ExLmFtYXpvbnRy\n dXN0LmNvbTA6BggrBgEFBQcwAoYuaHR0cDovL2NydC5yb290Y2ExLmFtYXpvbnRy\n dXN0LmNvbS9yb290Y2ExLmNlcjA/BgNVHR8EODA2MDSgMqAwhi5odHRwOi8vY3Js\n LnJvb3RjYTEuYW1hem9udHJ1c3QuY29tL3Jvb3RjYTEuY3JsMBMGA1UdIAQMMAow\n CAYGZ4EMAQIBMA0GCSqGSIb3DQEBCwUAA4IBAQCFkr41u3nPo4FCHOTjY3NTOVI1\n 59Gt/a6ZiqyJEi+752+a1U5y6iAwYfmXss2lJwJFqMp2PphKg5625kXg8kP2CN5t\n 6G7bMQcT8C8xDZNtYTd7WPD8UZiRKAJPBXa30/AbwuZe0GaFEQ8ugcYQgSn+IGBI\n 8/LwhBNTZTUVEWuCUUBVV18YtbAiPq3yXqMB48Oz+ctBWuZSkbvkNodPLamkB2g1\n upRyzQ7qDn1X8nn8N8V7YJ6y68AtkHcNSRAnpTitxBKjtKPISLMVCx7i4hncxHZS\n yLyKQXhw2W2Xs0qLeC1etA+jTGDK4UfLeC0SF7FSi8o5LL21L8IzApar2pR/\n -----END CERTIFICATE-----\n" }

Pour plus d’informations, consultez Connexion d’appareils et de passerelles à AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez GetServiceEndpoint dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-service-profile.

AWS CLI

Pour obtenir les informations sur un profil de service

L’exemple get-service-profile suivant obtient les informations sur le profil de service avec l’ID spécifié que vous avez créé.

aws iotwireless get-service-profile \ --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d"

Sortie :

{ "Arn": "arn:aws:iotwireless:us-east-1:651419225604:ServiceProfile/538185bb-d7e7-4b95-96a0-c51aa4a5b9a0", "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d", "LoRaWAN": { "HrAllowed": false, "NwkGeoLoc": false, "DrMax": 15, "UlBucketSize": 4096, "PrAllowed": false, "ReportDevStatusBattery": false, "DrMin": 0, "DlRate": 60, "AddGwMetadata": false, "ReportDevStatusMargin": false, "MinGwDiversity": 1, "RaAllowed": false, "DlBucketSize": 4096, "DevStatusReqFreq": 24, "TargetPer": 5, "UlRate": 60 } }

Pour plus d’informations, consultez Add profiles to AWS IoT Core for LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez GetServiceProfile dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-wireless-device-statistics.

AWS CLI

Pour obtenir les informations de fonctionnement sur un appareil sans fil

L’exemple get-wireless-device-statistics suivant obtient les informations de fonctionnement sur un appareil sans fil.

aws iotwireless get-wireless-device-statistics \ --wireless-device-id "1ffd32c8-8130-4194-96df-622f072a315f"

Sortie :

{ "WirelessDeviceId": "1ffd32c8-8130-4194-96df-622f072a315f" }

Pour plus d’informations, consultez Connexion d’appareils et de passerelles à AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

L’exemple de code suivant montre comment utiliser get-wireless-device.

AWS CLI

Pour obtenir les informations sur l’appareil sans fil

L’exemple get-wireless-device suivant répertorie les widgets disponibles dans votre compte AWS.

aws iotwireless get-wireless-device \ --identifier "1ffd32c8-8130-4194-96df-622f072a315f" \ --identifier-type WirelessDeviceID

Sortie :

{ "Name": "myLoRaWANDevice", "ThingArn": "arn:aws:iot:us-east-1:123456789012:thing/44b87eb4-9bce-423d-b5fc-973f5ecc358b", "DestinationName": "IoTWirelessDestination", "Id": "1ffd32c8-8130-4194-96df-622f072a315f", "ThingName": "44b87eb4-9bce-423d-b5fc-973f5ecc358b", "Type": "LoRaWAN", "LoRaWAN": { "DeviceProfileId": "ab0c23d3-b001-45ef-6a01-2bc3de4f5333", "ServiceProfileId": "fe98dc76-cd12-001e-2d34-5550432da100", "OtaaV1_1": { "AppKey": "3f4ca100e2fc675ea123f4eb12c4a012", "JoinEui": "b4c231a359bc2e3d", "NwkKey": "01c3f004a2d6efffe32c4eda14bcd2b4" }, "DevEui": "ac12efc654d23fc2" }, "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessDevice/1ffd32c8-8130-4194-96df-622f072a315f", "Description": "My LoRaWAN wireless device" }

Pour plus d’informations, consultez Connexion d’appareils et de passerelles à AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez GetWirelessDevice dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-wireless-gateway-certificate.

AWS CLI

Pour obtenir l’ID d’un certificat associé à une passerelle sans fil

L’exemple get-wireless-gateway-certificate suivant obtient l’ID du certificat associé à une passerelle sans fil avec l’ID spécifié.

aws iotwireless get-wireless-gateway-certificate \ --id "6c44ab31-8b4d-407a-bed3-19b6c7cda551"

Sortie :

{ "IotCertificateId": "8ea4aeae3db34c78cce75d9abd830356869ead6972997e0603e5fd032c804b6f" }

Pour plus d’informations, consultez Connexion d’appareils et de passerelles à AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

L’exemple de code suivant montre comment utiliser get-wireless-gateway-firmware-information.

AWS CLI

Pour obtenir les informations sur le microprogramme d’une passerelle sans fil

L’exemple get-wireless-gateway-firmware-information suivant obtient la version du microprogramme et d’autres informations sur une passerelle sans fil.

aws iotwireless get-wireless-gateway-firmware-information \ --id "3039b406-5cc9-4307-925b-9948c63da25b"

Sortie :

{ "LoRaWAN" :{ "CurrentVersion" :{ "PackageVersion" : "1.0.0", "Station" : "2.0.5", "Model" : "linux" } } }

Pour plus d’informations, consultez Connexion d’appareils et de passerelles à AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

L’exemple de code suivant montre comment utiliser get-wireless-gateway-statistics.

AWS CLI

Pour obtenir les informations de fonctionnement sur une passerelle sans fil

L’exemple get-wireless-gateway-statistics suivant obtient les informations de fonctionnement sur une passerelle sans fil.

aws iotwireless get-wireless-gateway-statistics \ --wireless-gateway-id "3039b406-5cc9-4307-925b-9948c63da25b"

Sortie :

{ "WirelessGatewayId": "3039b406-5cc9-4307-925b-9948c63da25b" }

Pour plus d’informations, consultez Connexion d’appareils et de passerelles à AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

L’exemple de code suivant montre comment utiliser get-wireless-gateway-task-definition.

AWS CLI

Pour obtenir les informations sur la définition de tâche d’une passerelle sans fil

L’exemple get-wireless-gateway-task-definition suivant obtient les informations sur la définition de la tâche sans fil avec l’ID spécifié.

aws iotwireless get-wireless-gateway-task-definition \ --id "b7d3baad-25c7-35e7-a4e1-1683a0d61da9"

Sortie :

{ "AutoCreateTasks": true, "Name": "TestAutoUpdate", "Update":{ "UpdateDataSource" : "s3://cupsalphagafirmwarebin/station", "UpdateDataRole" : "arn:aws:iam::001234567890:role/SDK_Test_Role", "LoRaWAN" :{ "CurrentVersion" :{ "PackageVersion" : "1.0.0", "Station" : "2.0.5", "Model" : "linux" }, "UpdateVersion" :{ "PackageVersion" : "1.0.1", "Station" : "2.0.5", "Model" : "minihub" } } } }

Pour plus d’informations, consultez Connexion d’appareils et de passerelles à AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

L’exemple de code suivant montre comment utiliser get-wireless-gateway-task.

AWS CLI

Pour obtenir les informations sur la tâche de passerelle sans fil

L’exemple get-wireless-gateway-task suivant obtient les informations sur la tâche de passerelle sans fil avec l’ID spécifié.

aws iotwireless get-wireless-gateway-task \ --id "11693a46-6866-47c3-a031-c9a616e7644b"

Sortie :

{ "WirelessGatewayId": "6c44ab31-8b4d-407a-bed3-19b6c7cda551", "WirelessGatewayTaskDefinitionId": "b7d3baad-25c7-35e7-a4e1-1683a0d61da9", "Status": "Success" }

Pour plus d’informations, consultez Connexion d’appareils et de passerelles à AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez GetWirelessGatewayTask dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-wireless-gateway.

AWS CLI

Pour obtenir les informations sur une passerelle sans fil

L’exemple get-wireless-gateway suivant obtient les informations sur la passerelle sans fil myFirstLoRaWANGateway.

aws iotwireless get-wireless-gateway \ --identifier "12345678-a1b2-3c45-67d8-e90fa1b2c34d" \ --identifier-type WirelessGatewayId

Sortie :

{ "Description": "My first LoRaWAN gateway", "ThingArn": "arn:aws:iot:us-east-1:123456789012:thing/a1b2c3d4-5678-90ab-cdef-12ab345c67de", "LoRaWAN": { "RfRegion": "US915", "GatewayEui": "a1b2c3d4567890ab" }, "ThingName": "a1b2c3d4-5678-90ab-cdef-12ab345c67de", "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d", "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessGateway/6c44ab31-8b4d-407a-bed3-19b6c7cda551", "Name": "myFirstLoRaWANGateway" }

Pour plus d’informations, consultez Connexion d’appareils et de passerelles à AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez GetWirelessGateway dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-destinations.

AWS CLI

Pour répertorier les destinations sans fil

L’exemple list-destinations suivant répertorie les destinations disponibles enregistrées sur votre compte AWS.

aws iotwireless list-destinations

Sortie :

{ "DestinationList": [ { "Arn": "arn:aws:iotwireless:us-east-1:123456789012:Destination/IoTWirelessDestination", "Name": "IoTWirelessDestination", "Expression": "IoTWirelessRule", "Description": "Destination for messages processed using IoTWirelessRule", "RoleArn": "arn:aws:iam::123456789012:role/IoTWirelessDestinationRole" }, { "Arn": "arn:aws:iotwireless:us-east-1:123456789012:Destination/IoTWirelessDestination2", "Name": "IoTWirelessDestination2", "Expression": "IoTWirelessRule2", "RoleArn": "arn:aws:iam::123456789012:role/IoTWirelessDestinationRole" } ] }

Pour plus d’informations, consultez Ajout des destinations AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez ListDestinations dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-device-profiles.

AWS CLI

Pour répertorier les profils d’appareil

L’exemple list-device-profiles suivant répertorie les profils d’appareil disponibles enregistrées sur votre compte AWS.

aws iotwireless list-device-profiles

Sortie :

{ "DeviceProfileList": [ { "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d", "Arn": "arn:aws:iotwireless:us-east-1:123456789012:DeviceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d" }, { "Id": "a1b2c3d4-5678-90ab-cdef-12ab345c67de", "Arn": "arn:aws:iotwireless:us-east-1:123456789012:DeviceProfile/a1b2c3d4-5678-90ab-cdef-12ab345c67de" } ] }

Pour plus d’informations, consultez Add profiles to AWS IoT Core for LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez ListDeviceProfiles dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-partner-accounts.

AWS CLI

Pour répertorier les comptes partenaires

L’exemple list-partner-accounts suivant répertorie les comptes partenaires disponibles associés à votre compte AWS.

aws iotwireless list-partner-accounts

Sortie :

{ "Sidewalk": [ { "AmazonId": "78965678771228", "Fingerprint": "bd96d8ef66dbfd2160eb60e156849e82ad7018b8b73c1ba0b4fc65c32498ee35" }, { "AmazonId": "89656787651228", "Fingerprint": "bc5e99e151c07be14be7e6603e4489c53f858b271213a36ebe3370777ba06e9b" } ] }

Pour plus d’informations, consultez Intégration d’Amazon Sidewalk pour AWS IoT Core dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez ListPartnerAccounts dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-service-profiles.

AWS CLI

Pour répertorier les profils de service

L’exemple list-service-profiles suivant répertorie les profils de service disponibles enregistrés sur votre compte AWS.

aws iotwireless list-service-profiles

Sortie :

{ "ServiceProfileList": [ { "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d", "Arn": "arn:aws:iotwireless:us-east-1:123456789012:ServiceProfile/538185bb-d7e7-4b95-96a0-c51aa4a5b9a0" }, { "Id": "a1b2c3d4-5678-90ab-cdef-12ab345c67de", "Arn": "arn:aws:iotwireless:us-east-1:123456789012:ServiceProfile/ea8bc823-5d13-472e-8d26-9550737d8100" } ] }

Pour plus d’informations, consultez Add profiles to AWS IoT Core for LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez ListServiceProfiles dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-tags-for-resource.

AWS CLI

Pour répertorier les balises attribuées à la ressource

L’exemple list-tags-for-resource suivant répertorie les balises attribuées à une ressource de destination sans fil.

aws iotwireless list-tags-for-resource \ --resource-arn "arn:aws:iotwireless:us-east-1:123456789012:Destination/IoTWirelessDestination"

Sortie :

{ "Tags": [ { "Value": "MyValue", "Key": "MyTag" } ] }

Pour plus d’informations, consultez Description de vos ressources AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez ListTagsForResource dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-wireless-devices.

AWS CLI

Pour répertorier les appareils sans fil disponibles

L’exemple list-wireless-devices suivant répertorie les appareils sans fil disponibles enregistrées sur votre compte AWS.

aws iotwireless list-wireless-devices

Sortie :

{ "WirelessDeviceList": [ { "Name": "myLoRaWANDevice", "DestinationName": "IoTWirelessDestination", "Id": "1ffd32c8-8130-4194-96df-622f072a315f", "Type": "LoRaWAN", "LoRaWAN": { "DevEui": "ac12efc654d23fc2" }, "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessDevice/1ffd32c8-8130-4194-96df-622f072a315f" } ] }

Pour plus d’informations, consultez Connexion d’appareils et de passerelles à AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez ListWirelessDevices dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-wireless-gateway-task-definitions.

AWS CLI

Pour répertorier les définitions de tâches de passerelle sans fil

L’exemple list-wireless-gateway-task-definitions suivant répertorie les définitions de tâches de passerelle sans fil disponibles enregistrées sur votre compte AWS.

aws iotwireless list-wireless-gateway-task-definitions

Sortie :

{ "TaskDefinitions": [ { "Id": "b7d3baad-25c7-35e7-a4e1-1683a0d61da9", "LoRaWAN" : { "CurrentVersion" :{ "PackageVersion" : "1.0.0", "Station" : "2.0.5", "Model" : "linux" }, "UpdateVersion" :{ "PackageVersion" : "1.0.1", "Station" : "2.0.5", "Model" : "minihub" } } } ] }

Pour plus d’informations, consultez Connexion d’appareils et de passerelles à AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

L’exemple de code suivant montre comment utiliser list-wireless-gateways.

AWS CLI

Pour répertorier les passerelles sans fil

L’exemple list-wireless-gateways suivant répertorie les passerelles sans fil disponibles dans votre compte AWS.

aws iotwireless list-wireless-gateways

Sortie :

{ "WirelessGatewayList": [ { "Description": "My first LoRaWAN gateway", "LoRaWAN": { "RfRegion": "US915", "GatewayEui": "dac632ebc01d23e4" }, "Id": "3039b406-5cc9-4307-925b-9948c63da25b", "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessGateway/3039b406-5cc9-4307-925b-9948c63da25b", "Name": "myFirstLoRaWANGateway" }, { "Description": "My second LoRaWAN gateway", "LoRaWAN": { "RfRegion": "US915", "GatewayEui": "cda123fffe92ecd2" }, "Id": "3285bdc7-5a12-4991-84ed-dadca65e342e", "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessGateway/3285bdc7-5a12-4991-84ed-dadca65e342e", "Name": "mySecondLoRaWANGateway" } ] }

Pour plus d’informations, consultez Connexion d’appareils et de passerelles à AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez ListWirelessGateways dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser send-data-to-wireless-device.

AWS CLI

Pour envoyer des données à l’appareil sans fil

L’exemple send-data-to-wireless-device suivant envoie une trame de données d’application déchiffrées à l’appareil sans fil.

aws iotwireless send-data-to-wireless-device \ --id "11aa5eae-2f56-4b8e-a023-b28d98494e49" \ --transmit-mode "1" \ --payload-data "SGVsbG8gVG8gRGV2c2lt" \ --wireless-metadata LoRaWAN={FPort=1}

Sortie :

{ MessageId: "6011dd36-0043d6eb-0072-0008" }

Pour plus d’informations, consultez Connexion d’appareils et de passerelles à AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez SendDataToWirelessDevice dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser tag-resource.

AWS CLI

Pour spécifier une clé de balise et une valeur pour une ressource

L’exemple tag-resource suivant balise la destination sans fil IoTWirelessDestination avec la clé MyTag et la valeur MyValue.

aws iotwireless tag-resource \ --resource-arn "arn:aws:iotwireless:us-east-1:651419225604:Destination/IoTWirelessDestination" \ --tags Key="MyTag",Value="MyValue"

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Description de vos ressources AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez TagResource dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser test-wireless-device.

AWS CLI

Pour tester l’appareil sans fil

L’exemple test-wireless-device suivant envoie des données de liaison montante Hello vers un appareil avec l’ID spécifié.

aws iotwireless test-wireless-device \ --id "11aa5eae-2f56-4b8e-a023-b28d98494e49"

Sortie :

{ Result: "Test succeeded. one message is sent with payload: hello" }

Pour plus d’informations, consultez Connexion d’appareils et de passerelles à AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez TestWirelessDevice dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser untag-resource.

AWS CLI

Pour supprimer une ou plusieurs balises d’une ressource

L’exemple untag-resource suivant supprime la balise MyTag et sa valeur de la destination sans fil IoTWirelessDestination.

aws iotwireless untag-resource \ --resource-arn "arn:aws:iotwireless:us-east-1:123456789012:Destination/IoTWirelessDestination" \ --tag-keys "MyTag"

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Description de vos ressources AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez UntagResource dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-destination.

AWS CLI

Pour mettre à jour les propriétés d’une destination

L’exemple update-destination suivant met à jour les propriétés de description d’une destination sans fil.

aws iotwireless update-destination \ --name "IoTWirelessDestination" \ --description "Destination for messages processed using IoTWirelessRule"

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Ajout des destinations AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez UpdateDestination dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-partner-account.

AWS CLI

Pour mettre à jour les propriétés d’un compte partenaire

L’exemple update-partner-account suivant met à jour la AppServerPrivateKey pour le compte avec l’ID spécifié.

aws iotwireless update-partner-account \ --partner-account-id "78965678771228" \ --partner-type "Sidewalk" \ --sidewalk AppServerPrivateKey="f798ab4899346a88599180fee9e14fa1ada7b6df989425b7c6d2146dd6c815bb"

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Intégration d’Amazon Sidewalk pour AWS IoT Core dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez UpdatePartnerAccount dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-wireless-device.

AWS CLI

Pour mettre à jour les propriétés d’un appareil sans fil

L’exemple update-wireless-device suivant met à jour les propriétés d’un appareil sans fil enregistré sur votre compte AWS.

aws iotwireless update-wireless-device \ --id "1ffd32c8-8130-4194-96df-622f072a315f" \ --destination-name IoTWirelessDestination2 \ --description "Using my first LoRaWAN device"

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Connexion d’appareils et de passerelles à AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez UpdateWirelessDevice dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-wireless-gateway.

AWS CLI

Pour mettre à jour la passerelle sans fil

L’exemple update-wireless-gateway suivant met à jour la description de votre passerelle sans fil.

aws iotwireless update-wireless-gateway \ --id "3285bdc7-5a12-4991-84ed-dadca65e342e" \ --description "Using my LoRaWAN gateway"

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Connexion d’appareils et de passerelles à AWS IoT Core pour LoRaWAN dans le Manuel du développeur AWS IoT.

  • Pour plus de détails sur l’API, consultez UpdateWirelessGateway dans la Référence des commandes de l’AWS CLI.