Esempi di Wireless AWS IoT con la AWS CLI - AWS Command Line Interface
Operazioni

Esempi di Wireless AWS IoT con la AWS CLI

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

Le operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le operazioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, dove è possibile trovare le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Operazioni

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

AWS CLI

Come associare un account partner all’account AWS

L’esempio associate-aws-account-with-partner-account seguente associa le seguenti credenziali dell’account Sidewalk all’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 Guida per gli sviluppatori di AWS IoT.

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 Add your gateways and wireless devices to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

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 Add your gateways and wireless devices to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

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 Add your gateways and wireless devices to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

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

AWS CLI

Come creare una destinazione wireless IoT

L’esempio create-destination seguente crea una destinazione per mappare un messaggio del dispositivo a una regola AWS IoT. Prima di eseguire questo comando, è necessario aver creato un ruolo IAM che fornisce ad AWS IoT Core per LoRaWAN le autorizzazioni necessarie per inviare i 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 Add destinations to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sull’API, consulta CreateDestination in AWS CLI Command Reference.

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 Add profiles to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sull’API, consulta CreateDeviceProfile in AWS CLI Command Reference.

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 Add profiles to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sulla API, consulta CreateServiceProfile in AWS CLI Command Reference.

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

AWS CLI

Come creare un dispositivo wireless IoT

L’esempio create-wireless-device seguente crea una risorsa dispositivo wireless di 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 Connecting devices and gateways to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sulla API, consulta CreateWirelessDevice in AWS CLI Command Reference.

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 gateways to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

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 gateways to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

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

AWS CLI

Come creare un gateway wireless

L’esempio create-wireless-gateway seguente crea un gateway per dispositivo LoRaWAN 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 Connecting devices and gateways to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

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 Add destinations to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sull’API, consulta DeleteDestination in AWS CLI Command Reference.

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 Add profiles to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sull’API, consulta DeleteDeviceProfile in AWS CLI Command Reference.

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 Add profiles to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sull’API, consulta DeleteServiceProfile in AWS CLI Command Reference.

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 gateways to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sull’API, consulta DeleteWirelessDevice in AWS CLI Command Reference.

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 gateways to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

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 gateways to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

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 gateways to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

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

AWS CLI

Come annullare l’associazione dell’account partner all’account AWS

L’esempio disassociate-aws-account-from-partner-account seguente annulla l’associazione di un account partner all’account AWS a cui è attualmente associato.

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 Add your gateways and wireless devices to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

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 Add your gateways and wireless devices to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

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 Add your gateways and wireless devices to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

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 Add your gateways and wireless devices to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

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 Add destinations to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sull’API, consulta GetDestination in 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 Add profiles to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sull’API, consulta GetDeviceProfile in 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 Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sull’API, consulta GetPartnerAccount in AWS CLI Command Reference.

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 gateways to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sull’API, consulta GetServiceEndpoint in AWS CLI Command Reference.

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 Add profiles to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sull’API, consulta GetServiceProfile in AWS CLI Command Reference.

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 gateways to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

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

AWS CLI

Come ottenere informazioni sul dispositivo wireless

L’esempio get-wireless-device 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 gateways to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sull’API, consulta GetWirelessDevice in AWS CLI Command Reference.

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 gateways to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

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 gateways to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

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 gateways to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

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 gateways to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

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 gateways to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

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 gateways to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sull’API, consulta GetWirelessGateway in AWS CLI Command Reference.

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

AWS CLI

Come elencare le destinazioni wireless

L’esempio list-destinations seguente elenca le destinazioni disponibili registrate nell’account AWS.

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 Add destinations to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sull’API, consulta ListDestinations in AWS CLI Command Reference.

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

AWS CLI

Come elencare i profili di dispositivo

L’esempio list-device-profiles seguente elenca i profili di dispositivo disponibili registrati nell’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 Add profiles to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sull’API, consulta ListDeviceProfiles in AWS CLI Command Reference.

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

AWS CLI

Come elencare gli account partner

L’esempio list-partner-accounts seguente elenca gli account partner disponibili associati all’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 Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sull’API, consulta ListPartnerAccounts in AWS CLI Command Reference.

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

AWS CLI

Come elencare i profili di servizio

L’esempio list-service-profiles seguente elenca i profili di servizio disponibili registrati nell’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 Add profiles to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sull’API, consulta ListServiceProfiles in AWS CLI Command Reference.

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 Describe your AWS IoT Core for LoRaWAN resources nella Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sull'API, consulta ListTagsForResource nella Documentazione di riferimento dei comandi della AWS CLI.

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

AWS CLI

Come elencare i dispositivi wireless disponibili

L’esempio list-wireless-devices seguente elenca i dispositivi wireless disponibili registrati nell’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 gateways to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sull’API, consulta ListWirelessDevices in AWS CLI Command Reference.

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’esempio list-wireless-gateway-task-definitions seguente elenca le definizioni di 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 gateways to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

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

AWS CLI

Come elencare i gateway wireless

L’esempio list-wireless-gateways 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 Connecting devices and gateways to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sull’API, consulta ListWirelessGateways in AWS CLI Command Reference.

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 gateways to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

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 Describe your AWS IoT Core for LoRaWAN resources nella Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sull’API, consulta TagResource in 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 gateways to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sull’API, consulta TestWirelessDevice in AWS CLI Command Reference.

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 Describe your AWS IoT Core for LoRaWAN resources nella Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sull’API, consulta UntagResource in 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 Add destinations to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sull’API, consulta UpdateDestination in AWS CLI Command Reference.

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 Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sull’API, consulta UpdatePartnerAccount in AWS CLI Command Reference.

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

AWS CLI

Come aggiornare le proprietà di un dispositivo wireless

L’esempio update-wireless-device seguente aggiorna le proprietà di un dispositivo wireless registrato nell’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 gateways to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.

  • Per informazioni dettagliate sull’API, consulta UpdateWirelessDevice in AWS CLI Command Reference.

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 gateways to AWS IoT Core for LoRaWAN nella Guida per gli sviluppatori di AWS IoT.