View a markdown version of this page

Wireless AWS IoT esempi di utilizzo AWS CLI - AWS Esempi di codice SDK
Azioni

Sono disponibili altri esempi di AWS SDK nel repository AWS Doc SDK Examples. GitHub

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 di utilizzo 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 azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

L’esempio di codice seguente mostra come utilizzare associate-aws-account-with-partner-account.

AWS CLI

Per associare un account partner al tuo account AWS

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

L’esempio di codice seguente mostra come utilizzare associate-wireless-device-with-thing.

AWS CLI

Come associare un oggetto a un dispositivo wireless

L’esempio associate-wireless-device-with-thing 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 IoT Core for WAN nella IoT Developers Guide. AWS LoRa AWS

L’esempio di codice seguente mostra come utilizzare associate-wireless-gateway-with-certificate.

AWS CLI

Come associare il certificato al gateway wireless

L’esempio associate-wireless-gateway-with-certificate seguente 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 IoT Core for WAN nella IoT Developers Guide. AWS LoRa AWS

L’esempio di codice seguente mostra come utilizzare associate-wireless-gateway-with-thing.

AWS CLI

Come associare un oggetto a un gateway wireless

L’esempio associate-wireless-gateway-with-thing 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 IoT Core for WAN nella IoT Developers Guide. AWS LoRa AWS

L’esempio di codice seguente mostra come utilizzare create-destination.

AWS CLI

Come creare una destinazione wireless IoT

L'create-destinationesempio seguente crea una destinazione per mappare un messaggio del dispositivo a una AWS regola IoT. Prima di eseguire questo comando, è necessario aver creato un ruolo IAM che conceda a AWS IoT Core for 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 for LoRa WAN nella AWS IoT Developers Guide.

L’esempio di codice seguente mostra come utilizzare create-device-profile.

AWS CLI

Come creare un nuovo profilo del dispositivo

L’esempio create-device-profile seguente crea un nuovo profilo del 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 for LoRa WAN nella IoT Developers Guide. AWS

L’esempio di codice seguente mostra come utilizzare create-service-profile.

AWS CLI

Come creare un nuovo profilo del servizio

L’esempio create-service-profile seguente crea un nuovo profilo del 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 for LoRa WAN nella IoT Developers Guide. AWS

L’esempio di codice seguente mostra come utilizzare create-wireless-device.

AWS CLI

Come creare un dispositivo wireless IoT

L'create-wireless-deviceesempio seguente crea una risorsa di dispositivo wireless di tipo WAN. LoRa

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 Connecting devices and gateway to AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

L’esempio di codice seguente mostra come utilizzare create-wireless-gateway-task-definition.

AWS CLI

Come creare una definizione di attività del gateway wireless

L’esempio create-wireless-gateway-task-definition seguente crea automaticamente 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 Connecting devices and gateway to IoT Core for WAN nella IoT Developers Guide. AWS LoRa AWS

L’esempio di codice seguente mostra come utilizzare create-wireless-gateway-task.

AWS CLI

Come creare l’attività per un gateway wireless

L’esempio create-wireless-gateway-task 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 Connecting devices and gateway to IoT Core for WAN nella IoT Developers Guide AWS . LoRa AWS

L’esempio di codice seguente mostra come utilizzare create-wireless-gateway.

AWS CLI

Come creare un gateway wireless

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

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 Connecting devices and gateway to AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

L’esempio di codice seguente mostra come utilizzare delete-destination.

AWS CLI

Come eliminare una destinazione wireless IoT

L’esempio delete-destination seguente elimina la risorsa di destinazione wireless creata con il nome IoTWirelessDestination.

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

Questo comando non produce alcun output.

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

L’esempio di codice seguente mostra come utilizzare delete-device-profile.

AWS CLI

Come eliminare un profilo del dispositivo

L’esempio delete-device-profile seguente elimina un profilo del dispositivo creato con l’ID specificato.

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 for LoRa WAN nella IoT Developers Guide. AWS

L’esempio di codice seguente mostra come utilizzare delete-service-profile.

AWS CLI

Come eliminare un profilo del servizio

L’esempio delete-service-profile seguente elimina un profilo del servizio creato con l’ID specificato.

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 for LoRa WAN nella IoT Developers Guide. AWS

L’esempio di codice seguente mostra come utilizzare delete-wireless-device.

AWS CLI

Come eliminare un dispositivo wireless

L’esempio delete-wireless-device 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 Connecting devices and gateway to AWS IoT Core for WAN nella IoT Developers Guide. LoRa AWS

L’esempio di codice seguente mostra come utilizzare delete-wireless-gateway-task-definition.

AWS CLI

Come eliminare una definizione di attività del gateway wireless

L’esempio delete-wireless-gateway-task-definition seguente elimina la definizione dell’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 Connecting devices and gateway to IoT Core for WAN nella IoT Developers Guide. AWS LoRa AWS

L’esempio di codice seguente mostra come utilizzare delete-wireless-gateway-task.

AWS CLI

Come eliminare un’attività del gateway wireless

L’esempio delete-wireless-gateway-task 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 Connecting devices and gateway to IoT Core for WAN nella IoT Developers Guide. AWS LoRa AWS

L’esempio di codice seguente mostra come utilizzare delete-wireless-gateway.

AWS CLI

Come eliminare un gateway wireless

L’esempio delete-wireless-gateway 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 Connecting devices and gateway to AWS IoT Core for WAN nella IoT Developers Guide. LoRa AWS

L’esempio di codice seguente mostra come utilizzare disassociate-aws-account-from-partner-account.

AWS CLI

Per dissociare l'account partner dall'account AWS

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 for LoRa WAN nella IoT Developers AWS Guide.

L’esempio di codice seguente mostra come utilizzare disassociate-wireless-device-from-thing.

AWS CLI

Come annullare l’associazione dell’oggetto al dispositivo wireless

L’esempio disassociate-wireless-device-from-thing seguente annulla l’associazione di un dispositivo wireless all’oggetto a cui è 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 IoT Core for WAN nella IoT Developers Guide. AWS LoRa AWS

L’esempio di codice seguente mostra come utilizzare disassociate-wireless-gateway-from-certificate.

AWS CLI

Come annullare l’associazione del certificato al gateway wireless

L’esempio disassociate-wireless-gateway-from-certificate seguente annulla l’associazione di un gateway wireless al certificato a cui è 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 IoT Core for WAN nella IoT Developers Guide. AWS LoRa AWS

L’esempio di codice seguente mostra come utilizzare disassociate-wireless-gateway-from-thing.

AWS CLI

Come annullare l’associazione dell’oggetto al gateway wireless

L’esempio disassociate-wireless-gateway-from-thing seguente annulla l’associazione di un gateway wireless all’oggetto a cui è 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 IoT Core for WAN nella IoT Developers Guide. AWS LoRa AWS

L’esempio di codice seguente mostra come utilizzare get-destination.

AWS CLI

Come ottenere informazioni su una destinazione wireless IoT

L’esempio get-destination seguente ottiene informazioni sulla risorsa di destinazione creata con il nome IoTWirelessDestination.

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 for LoRa WAN nella AWS IoT Developers Guide.

  • Per i dettagli sulle API, consulta la sezione GetDestination AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-device-profile.

AWS CLI

Come ottenere informazioni su un profilo del dispositivo

L’esempio get-device-profile seguente ottiene informazioni sul profilo del dispositivo creato con l’ID specificato.

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 for LoRa WAN nella IoT Developers Guide. AWS

  • Per i dettagli sulle API, consulta la sezione GetDeviceProfile AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-partner-account.

AWS CLI

Come ottenere informazioni sull’account partner

L’esempio get-partner-account seguente ottiene informazioni sull’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

L’esempio di codice seguente mostra come utilizzare get-service-endpoint.

AWS CLI

Come ottenere l’endpoint del servizio

L’esempio get-service-endpoint 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 Connecting devices and gateway to AWS IoT Core for LoRa WAN nella IoT Developers Guide. AWS

L’esempio di codice seguente mostra come utilizzare get-service-profile.

AWS CLI

Come ottenere informazioni su un profilo del servizio

L’esempio get-service-profile seguente ottiene informazioni sul profilo del servizio creato con l’ID specificato.

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 for LoRa WAN nella IoT Developers Guide. AWS

L’esempio di codice seguente mostra come utilizzare get-wireless-device-statistics.

AWS CLI

Come ottenere informazioni operative su un dispositivo wireless

L’esempio get-wireless-device-statistics 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 Connecting devices and gateway to IoT Core for WAN nella IoT Developers Guide AWS . LoRa AWS

L’esempio di codice seguente mostra come utilizzare get-wireless-device.

AWS CLI

Come ottenere informazioni sul dispositivo wireless

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

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 Connecting devices and gateway to AWS IoT Core for LoRa WAN nella IoT Developers AWS Guide.

L’esempio di codice seguente mostra come utilizzare get-wireless-gateway-certificate.

AWS CLI

Come ottenere l’ID di un certificato associato a un gateway wireless

L’esempio get-wireless-gateway-certificate 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 Connecting devices and gateway to IoT Core for WAN nella IoT Developers Guide AWS . LoRa AWS

L’esempio di codice seguente mostra come utilizzare get-wireless-gateway-firmware-information.

AWS CLI

Come ottenere informazioni sul firmware di un gateway wireless

L’esempio get-wireless-gateway-firmware-information 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 Connecting devices and gateway to IoT Core for WAN nella IoT Developers Guide. AWS LoRa AWS

L’esempio di codice seguente mostra come utilizzare get-wireless-gateway-statistics.

AWS CLI

Come ottenere informazioni operative su un gateway wireless

L’esempio get-wireless-gateway-statistics 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 Connecting devices and gateway to IoT Core for WAN nella IoT Developers Guide AWS . LoRa AWS

L’esempio di codice seguente mostra come utilizzare get-wireless-gateway-task-definition.

AWS CLI

Come ottenere informazioni sulla definizione dell’attività di un gateway wireless

L’esempio get-wireless-gateway-task-definition 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 Connecting devices and gateway to IoT Core for WAN nella IoT Developers Guide. AWS LoRa AWS

L’esempio di codice seguente mostra come utilizzare get-wireless-gateway-task.

AWS CLI

Come ottenere informazioni sull’attività del gateway wireless

L’esempio get-wireless-gateway-task 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 Connecting devices and gateway to IoT Core for WAN nella IoT Developers Guide AWS . LoRa AWS

L’esempio di codice seguente mostra come utilizzare get-wireless-gateway.

AWS CLI

Come ottenere informazioni su un gateway wireless

L’esempio get-wireless-gateway seguente ottiene informazioni sul gateway wireless myFirstLoRaWANGateway.

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 Connecting devices and gateway to AWS IoT Core for LoRa WAN nella IoT Developers Guide. AWS

L’esempio di codice seguente mostra come utilizzare list-destinations.

AWS CLI

Come 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 for LoRa WAN nella AWS IoT Developers Guide.

  • Per i dettagli sulle API, consulta la sezione ListDestinations AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-device-profiles.

AWS CLI

Come elencare i profili di dispositivo

L'list-device-profilesesempio seguente elenca i profili dei dispositivi disponibili registrati nel tuo account. AWS 

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 for LoRa WAN nella AWS IoT Developers Guide.

L’esempio di codice seguente mostra come utilizzare list-partner-accounts.

AWS CLI

Come elencare gli account partner

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

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 AWS IoT Developers Guide.

L’esempio di codice seguente mostra come utilizzare list-service-profiles.

AWS CLI

Come elencare i profili di servizio

L'list-service-profilesesempio seguente elenca i profili di servizio disponibili registrati nel tuo account. AWS 

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 for LoRa WAN nella AWS IoT Developers Guide.

L’esempio di codice seguente mostra come utilizzare list-tags-for-resource.

AWS CLI

Come elencare i tag assegnati alla risorsa

L’esempio list-tags-for-resource 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 Descrivere le risorse AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

L’esempio di codice seguente mostra come utilizzare list-wireless-devices.

AWS CLI

Come elencare i dispositivi wireless disponibili

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

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 Connecting devices and gateway to AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

L’esempio di codice seguente mostra come utilizzare list-wireless-gateway-task-definitions.

AWS CLI

Come elencare le definizioni di attività del gateway wireless

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

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 Connecting devices and gateway to AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

L’esempio di codice seguente mostra come utilizzare list-wireless-gateways.

AWS CLI

Come elencare i gateway wireless

L'list-wireless-gatewaysesempio seguente elenca i gateway wireless disponibili nel tuo 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 for LoRa WAN nella AWS IoT Developers Guide.

L’esempio di codice seguente mostra come utilizzare send-data-to-wireless-device.

AWS CLI

Come inviare dati al dispositivo wireless

L’esempio send-data-to-wireless-device 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 Connecting devices and gateway to IoT Core for WAN nella IoT Developers Guide. AWS LoRa AWS

L’esempio di codice seguente mostra come utilizzare tag-resource.

AWS CLI

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

L’esempio tag-resource seguente assegna alla destinazione wireless IoTWirelessDestination il tag con la chiave MyTag e il valore MyValue.

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 Descrivere le risorse AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

  • Per i dettagli sulle API, consulta la sezione TagResource AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare test-wireless-device.

AWS CLI

Come testare il dispositivo wireless

L’esempio test-wireless-device seguente invia i dati di uplink Hello a un dispositivo con l’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 Connecting devices and gateway to AWS IoT Core for LoRa WAN nella IoT Developers Guide. AWS

L’esempio di codice seguente mostra come utilizzare untag-resource.

AWS CLI

Come rimuovere uno o più tag da una risorsa

L’esempio untag-resource seguente rimuove il tag MyTag e il relativo valore dalla destinazione wireless IoTWirelessDestination.

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 Descrivere le risorse AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

  • Per i dettagli sulle API, consulta la sezione UntagResource AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare update-destination.

AWS CLI

Come aggiornare le proprietà di una destinazione

L’esempio update-destination 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 for LoRa WAN nella IoT Developers AWS Guide.

L’esempio di codice seguente mostra come utilizzare update-partner-account.

AWS CLI

Come aggiornare le proprietà di un account partner

L’esempio update-partner-account seguente aggiorna 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

L’esempio di codice seguente mostra come utilizzare update-wireless-device.

AWS CLI

Come aggiornare le proprietà di un dispositivo wireless

L'update-wireless-deviceesempio seguente aggiorna le proprietà di un dispositivo wireless registrato nel tuo account. AWS 

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 Connecting devices and gateway to AWS IoT Core for LoRa WAN nella AWS IoT Developers Guide.

L’esempio di codice seguente mostra come utilizzare update-wireless-gateway.

AWS CLI

Come aggiornare il gateway wireless

L’esempio update-wireless-gateway 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 Connecting devices and gateway to AWS IoT Core for WAN nella IoT Developers Guide. LoRa AWS