Wireless AWS IoT esempi utilizzando AWS CLI - AWS Command Line Interface

Questa documentazione è valida AWS CLI solo per la versione 1. Per la documentazione relativa alla versione 2 di AWS CLI, consulta la Guida per l'utente della versione 2.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Wireless AWS IoT esempi utilizzando AWS CLI

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface with Wireless AWS IoT.

Le operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Mentre le azioni mostrano come richiamare le singole funzioni di servizio, è possibile visualizzare le azioni nel loro contesto negli scenari correlati.

Ogni esempio include un collegamento al codice sorgente completo, in cui è possibile trovare istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Il seguente esempio di codice mostra come utilizzareassociate-aws-account-with-partner-account.

AWS CLI

Per associare un account partner al tuo AWS account

L'associate-aws-account-with-partner-accountesempio seguente associa le seguenti credenziali dell'account Sidewalk al tuo account. AWS

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

Output:

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

Per ulteriori informazioni, consulta Amazon Sidewalk Integration for AWS IoT Core nella IoT Developers Guide.AWS

Il seguente esempio di codice mostra come utilizzareassociate-wireless-device-with-thing.

AWS CLI

Associare un oggetto a un dispositivo wireless

L'associate-wireless-device-with-thingesempio seguente associa un oggetto al dispositivo wireless con l'ID specificato.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Aggiungere i gateway e i dispositivi wireless a AWS IoT Core LoRa WAN nella Guida per sviluppatori AWS IoT.

Il seguente esempio di codice mostra come utilizzareassociate-wireless-gateway-with-certificate.

AWS CLI

Per associare il certificato al gateway wireless

Quanto segue associate-wireless-gateway-with-certificate associa un gateway wireless a un certificato.

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

Output:

{ "IotCertificateId": "a123b45c6d78e9f012a34cd5e6a7890b12c3d45e6f78a1b234c56d7e890a1234" }

Per ulteriori informazioni, consulta Aggiungere i gateway e i dispositivi wireless a AWS IoT Core LoRa WAN nella Guida per sviluppatori AWS IoT.

Il seguente esempio di codice mostra come utilizzareassociate-wireless-gateway-with-thing.

AWS CLI

Associare un oggetto a un gateway wireless

L'associate-wireless-gateway-with-thingesempio seguente associa un oggetto a un gateway wireless.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Aggiungere i gateway e i dispositivi wireless a AWS IoT Core LoRa WAN nella Guida per sviluppatori AWS IoT.

Il seguente esempio di codice mostra come utilizzarecreate-destination.

AWS CLI

Per creare una destinazione wireless IoT

L'create-destinationesempio seguente crea una destinazione per mappare un messaggio del dispositivo a una regola AWS IoT. Prima di eseguire questo comando, è necessario aver creato un IAM ruolo che fornisca a AWS IoT Core LoRa WAN le autorizzazioni necessarie per inviare dati alla regola AWS IoT.

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

Output:

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

Per ulteriori informazioni, consulta Aggiungere destinazioni a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzarecreate-device-profile.

AWS CLI

Per creare un nuovo profilo del dispositivo

L'create-device-profileesempio seguente crea un nuovo profilo di dispositivo wireless IoT.

aws iotwireless create-device-profile

Output:

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

Per ulteriori informazioni, consulta Aggiungere profili a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzarecreate-service-profile.

AWS CLI

Per creare un nuovo profilo di servizio

L'create-service-profileesempio seguente crea un nuovo profilo di servizio wireless IoT.

aws iotwireless create-service-profile

Output:

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

Per ulteriori informazioni, consulta Aggiungere profili a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzarecreate-wireless-device.

AWS CLI

Per creare un dispositivo wireless IoT

L'create-wireless-deviceesempio seguente crea una risorsa di dispositivo wireless del tipo LoRaWAN.

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

Contenuto di 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 }

Output:

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

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzarecreate-wireless-gateway-task-definition.

AWS CLI

Per creare una definizione di attività per un gateway wireless

Quanto segue crea create-wireless-gateway-task-definition automaticamente le attività utilizzando questa definizione di attività per tutti i gateway con la versione corrente specificata.

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

Contenuto di 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" } } } }

Output:

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

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzarecreate-wireless-gateway-task.

AWS CLI

Per creare l'attività per un gateway wireless

L'create-wireless-gateway-taskesempio seguente crea un'attività per un gateway wireless.

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

Output:

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

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzarecreate-wireless-gateway.

AWS CLI

Per creare un gateway wireless

L'create-wireless-gatewayesempio seguente crea un gateway per LoRa WAN dispositivi wireless.

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

Output:

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

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzaredelete-destination.

AWS CLI

Per eliminare una destinazione wireless IoT

L'delete-destinationesempio seguente elimina la risorsa di destinazione wireless con il nome IoTWirelessDestination che hai creato.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Aggiungere destinazioni a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzaredelete-device-profile.

AWS CLI

Per eliminare il profilo di un dispositivo

L'delete-device-profileesempio seguente elimina un profilo di dispositivo con l'ID specificato che avete creato.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Aggiungere profili a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzaredelete-service-profile.

AWS CLI

Per eliminare un profilo di servizio

L'delete-service-profileesempio seguente elimina un profilo di servizio con l'ID specificato che avete creato.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Aggiungere profili a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzaredelete-wireless-device.

AWS CLI

Per eliminare un dispositivo wireless

L'delete-wireless-deviceesempio seguente elimina un dispositivo wireless con l'ID specificato.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzaredelete-wireless-gateway-task-definition.

AWS CLI

Per eliminare una definizione di attività su un gateway wireless

L'delete-wireless-gateway-task-definitionesempio seguente elimina la definizione di attività del gateway wireless creata con il seguente ID.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzaredelete-wireless-gateway-task.

AWS CLI

Per eliminare un'operazione relativa al gateway wireless

L'delete-wireless-gateway-taskesempio seguente elimina l'attività del gateway wireless con l'ID specificato.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzaredelete-wireless-gateway.

AWS CLI

Per eliminare un gateway wireless

L'delete-wireless-gatewayesempio seguente elimina un gateway wireless con l'ID specificato.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzaredisassociate-aws-account-from-partner-account.

AWS CLI

Per dissociare l'account partner dall' AWS account

L'disassociate-aws-account-from-partner-accountesempio seguente dissocia un account partner dall'account attualmente associato. AWS

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Aggiungere i gateway e i dispositivi wireless a AWS IoT Core LoRa WAN nella Guida per sviluppatori AWS IoT.

Il seguente esempio di codice mostra come utilizzaredisassociate-wireless-device-from-thing.

AWS CLI

Per dissociare l'oggetto dal dispositivo wireless

L'disassociate-wireless-device-from-thingesempio seguente dissocia un dispositivo wireless dall'oggetto attualmente associato.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Aggiungere i gateway e i dispositivi wireless a AWS IoT Core LoRa WAN nella Guida per sviluppatori AWS IoT.

Il seguente esempio di codice mostra come utilizzaredisassociate-wireless-gateway-from-certificate.

AWS CLI

Per dissociare il certificato dal gateway wireless

Quanto segue disassociate-wireless-gateway-from-certificate dissocia un gateway wireless dal certificato attualmente associato.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Aggiungere i gateway e i dispositivi wireless a AWS IoT Core LoRa WAN nella Guida per sviluppatori AWS IoT.

Il seguente esempio di codice mostra come utilizzaredisassociate-wireless-gateway-from-thing.

AWS CLI

Per dissociare l'oggetto dal gateway wireless

L'disassociate-wireless-gateway-from-thingesempio seguente dissocia un gateway wireless dall'elemento attualmente associato.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Aggiungere i gateway e i dispositivi wireless a AWS IoT Core LoRa WAN nella Guida per sviluppatori AWS IoT.

Il seguente esempio di codice mostra come utilizzareget-destination.

AWS CLI

Per ottenere informazioni su una destinazione wireless IoT

L'get-destinationesempio seguente ottiene informazioni sulla risorsa di destinazione con il nome IoTWirelessDestination che hai creato.

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

Output:

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

Per ulteriori informazioni, consulta Aggiungere destinazioni a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzareget-device-profile.

AWS CLI

Per ottenere informazioni sul profilo di un dispositivo

L'get-device-profileesempio seguente ottiene informazioni sul profilo del dispositivo con l'ID specificato che hai creato.

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

Output:

{ "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 } }

Per ulteriori informazioni, consulta Aggiungere profili a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzareget-partner-account.

AWS CLI

Per ottenere le informazioni sull'account partner

L'get-partner-accountesempio seguente ottiene informazioni sul tuo account Sidewalk con il seguente ID.

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

Output:

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

Per ulteriori informazioni, consulta Amazon Sidewalk Integration for AWS IoT Core nella IoT Developers Guide.AWS

Il seguente esempio di codice mostra come utilizzareget-service-endpoint.

AWS CLI

Per ottenere l'endpoint del servizio

L'get-service-endpointesempio seguente ottiene l'endpoint specifico dell'account per il protocollo. CUPS

aws iotwireless get-service-endpoint

Output:

{ "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" }

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzareget-service-profile.

AWS CLI

Per ottenere informazioni su un profilo di servizio

L'get-service-profileesempio seguente ottiene informazioni sul profilo di servizio con l'ID specificato che hai creato.

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

Output:

{ "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 } }

Per ulteriori informazioni, consulta Aggiungere profili a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzareget-wireless-device-statistics.

AWS CLI

Per ottenere informazioni operative su un dispositivo wireless

L'get-wireless-device-statisticsesempio seguente ottiene informazioni operative su un dispositivo wireless.

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

Output:

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

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzareget-wireless-device.

AWS CLI

Per ottenere informazioni sul dispositivo wireless

L'get-wireless-deviceesempio seguente elenca i widget disponibili nel tuo AWS account.

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

Output:

{ "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" }

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzareget-wireless-gateway-certificate.

AWS CLI

Per ottenere l'ID di un certificato associato a un gateway wireless

L'get-wireless-gateway-certificateesempio seguente ottiene l'ID del certificato associato a un gateway wireless con l'ID specificato.

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

Output:

{ "IotCertificateId": "8ea4aeae3db34c78cce75d9abd830356869ead6972997e0603e5fd032c804b6f" }

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzareget-wireless-gateway-firmware-information.

AWS CLI

Per ottenere informazioni sul firmware relative a un gateway wireless

L'get-wireless-gateway-firmware-informationesempio seguente ottiene la versione del firmware e altre informazioni su un gateway wireless.

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

Output:

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

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzareget-wireless-gateway-statistics.

AWS CLI

Per ottenere informazioni operative su un gateway wireless

L'get-wireless-gateway-statisticsesempio seguente ottiene informazioni operative su un gateway wireless.

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

Output:

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

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzareget-wireless-gateway-task-definition.

AWS CLI

Per ottenere informazioni su un gateway wireless, definizione delle attività

L'get-wireless-gateway-task-definitionesempio seguente ottiene informazioni sulla definizione dell'attività wireless con l'ID specificato.

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

Output:

{ "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" } } } }

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzareget-wireless-gateway-task.

AWS CLI

Per ottenere informazioni sull'operazione relativa al gateway wireless

L'get-wireless-gateway-taskesempio seguente ottiene informazioni sull'attività del gateway wireless con l'ID specificato.

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

Output:

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

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzareget-wireless-gateway.

AWS CLI

Per ottenere informazioni su un gateway wireless

L'get-wireless-gatewayesempio seguente ottiene informazioni sul gateway wirelessmyFirstLoRaWANGateway.

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

Output:

{ "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" }

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzarelist-destinations.

AWS CLI

Per elencare le destinazioni wireless

L'list-destinationsesempio seguente elenca le destinazioni disponibili registrate nel tuo AWS account.

aws iotwireless list-destinations

Output:

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

Per ulteriori informazioni, consulta Aggiungere destinazioni a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzarelist-device-profiles.

AWS CLI

Per elencare i profili dei dispositivi

L'list-device-profilesesempio seguente elenca i profili di dispositivo disponibili registrati nell' AWS account.

aws iotwireless list-device-profiles

Output:

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

Per ulteriori informazioni, consulta Aggiungere profili a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzarelist-partner-accounts.

AWS CLI

Per elencare gli account dei partner

L'list-partner-accountsesempio seguente elenca gli account partner disponibili associati al tuo AWS account.

aws iotwireless list-partner-accounts

Output:

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

Per ulteriori informazioni, consulta Amazon Sidewalk Integration for AWS IoT Core nella IoT Developers Guide.AWS

Il seguente esempio di codice mostra come utilizzarelist-service-profiles.

AWS CLI

Per elencare i profili di servizio

L'list-service-profilesesempio seguente elenca i profili di servizio disponibili registrati nell' AWS account dell'utente.

aws iotwireless list-service-profiles

Output:

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

Per ulteriori informazioni, consulta Aggiungere profili a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzarelist-tags-for-resource.

AWS CLI

Per elencare i tag assegnati alla risorsa

L'list-tags-for-resourceesempio seguente elenca i tag assegnati a una risorsa di destinazione wireless.

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

Output:

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

Per ulteriori informazioni, consulta Descrivi il tuo AWS IoT Core per LoRa WAN le risorse nella Guida per sviluppatori AWS IoT.

Il seguente esempio di codice mostra come utilizzarelist-wireless-devices.

AWS CLI

Per elencare i dispositivi wireless disponibili

L'list-wireless-devicesesempio seguente elenca i dispositivi wireless disponibili registrati nell' AWS account.

aws iotwireless list-wireless-devices

Output:

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

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzarelist-wireless-gateway-task-definitions.

AWS CLI

Per elencare le definizioni delle attività del gateway wireless

L'list-wireless-gateway-task-definitionsesempio seguente elenca le definizioni delle attività del gateway wireless disponibili registrate nell' AWS account.

aws iotwireless list-wireless-gateway-task-definitions

Output:

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

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzarelist-wireless-gateways.

AWS CLI

Per elencare i gateway wireless

L'list-wireless-gatewaysesempio seguente elenca i gateway wireless disponibili nell'account AWS .

aws iotwireless list-wireless-gateways

Output:

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

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzaresend-data-to-wireless-device.

AWS CLI

Per inviare dati al dispositivo wireless

L'send-data-to-wireless-deviceesempio seguente invia un frame di dati dell'applicazione decrittografato al dispositivo wireless.

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

Output:

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

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzaretag-resource.

AWS CLI

Per specificare una chiave e un valore di tag per una risorsa

L'tag-resourceesempio seguente contrassegna la destinazione wireless IoTWirelessDestination con la chiave MyTag e il valoreMyValue.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Descrivi il tuo AWS IoT Core per LoRa WAN le risorse nella Guida per sviluppatori AWS IoT.

Il seguente esempio di codice mostra come utilizzaretest-wireless-device.

AWS CLI

Per testare il dispositivo wireless

L'test-wireless-deviceesempio seguente invia i dati di uplink Hello a un dispositivo con un ID specificato.

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

Output:

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

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzareuntag-resource.

AWS CLI

Per rimuovere uno o più tag da una risorsa

L'untag-resourceesempio seguente rimuove il tag MyTag e il relativo valore dalla destinazione wirelessIoTWirelessDestination.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Descrivi il tuo AWS IoT Core per LoRa WAN le risorse nella Guida per sviluppatori AWS IoT.

Il seguente esempio di codice mostra come utilizzareupdate-destination.

AWS CLI

Per aggiornare le proprietà di una destinazione

L'update-destinationesempio seguente aggiorna la proprietà di descrizione di una destinazione wireless.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Aggiungere destinazioni a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzareupdate-partner-account.

AWS CLI

Per aggiornare le proprietà di un account partner

Quanto segue update-partner-account aggiorna il AppServerPrivateKey per l'account con l'ID specificato.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Amazon Sidewalk Integration for AWS IoT Core nella IoT Developers Guide.AWS

Il seguente esempio di codice mostra come utilizzareupdate-wireless-device.

AWS CLI

Per aggiornare le proprietà di un dispositivo wireless

L'update-wireless-deviceesempio seguente aggiorna le proprietà di un dispositivo wireless registrato nell' AWS account dell'utente.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.

Il seguente esempio di codice mostra come utilizzareupdate-wireless-gateway.

AWS CLI

Per aggiornare il gateway wireless

L'update-wireless-gatewayesempio seguente aggiorna la descrizione del gateway wireless.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Connessione di dispositivi e gateway a AWS IoT Core LoRa WAN nella AWS IoT Developers Guide.