AWS IoT Wireless exemplos usando AWS CLI - AWS Command Line Interface
Ações

Esta documentação é para a AWS CLI única versão 1. Para obter a documentação relacionada à versão 2 do AWS CLI, consulte o Guia do usuário da versão 2.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

AWS IoT Wireless exemplos usando AWS CLI

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface with AWS IoT Wireless.

Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar funções de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, onde você pode encontrar instruções sobre como configurar e executar o código no contexto.

Tópicos

Ações

O código de exemplo a seguir mostra como usar associate-aws-account-with-partner-account.

AWS CLI

Para associar uma conta de parceiro à sua AWS conta

O associate-aws-account-with-partner-account exemplo a seguir associa as seguintes credenciais da conta Sidewalk à sua conta. AWS 

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

Saída:

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

Para obter mais informações, consulte Integração do Amazon Sidewalk para AWS IoT Core no Guia de desenvolvedores de AWS IoT.

O código de exemplo a seguir mostra como usar associate-wireless-device-with-thing.

AWS CLI

Para associar algo a um dispositivo sem fio

O associate-wireless-device-with-thing exemplo a seguir associa algo ao seu dispositivo sem fio que tem o ID especificado.

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

Este comando não produz saída.

Para obter mais informações, consulte Adicionar seus gateways e dispositivos sem fio ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar associate-wireless-gateway-with-certificate.

AWS CLI

Para associar o certificado ao gateway sem fio

O seguinte associate-wireless-gateway-with-certificate associa um gateway sem fio a um certificado.

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

Saída:

{
    "IotCertificateId": "a123b45c6d78e9f012a34cd5e6a7890b12c3d45e6f78a1b234c56d7e890a1234"
}

Para obter mais informações, consulte Adicionar seus gateways e dispositivos sem fio ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar associate-wireless-gateway-with-thing.

AWS CLI

Para associar algo a um gateway sem fio

O associate-wireless-gateway-with-thing exemplo a seguir associa algo a um gateway sem fio.

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

Este comando não produz saída.

Para obter mais informações, consulte Adicionar seus gateways e dispositivos sem fio ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar create-destination.

AWS CLI

Para criar um destino sem fio de IoT

O create-destination exemplo a seguir cria um destino para mapear uma mensagem do dispositivo para uma regra de AWS IoT. Antes de executar esse comando, você deve ter criado uma IAM função que forneça ao AWS IoT Core LoRa WAN as permissões necessárias para enviar dados para a regra de IoT AWS .

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

Saída:

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

Para obter mais informações, consulte Adicionar destinos ao AWS IoT Core LoRa WAN no Guia do Desenvolvedor de AWS IoT.

  • Para API obter detalhes, consulte CreateDestinationna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar create-device-profile.

AWS CLI

Para criar um novo perfil de dispositivo

O create-device-profile exemplo a seguir cria um novo perfil de dispositivo sem fio de IoT.

aws iotwireless create-device-profile

Saída:

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

Para obter mais informações, consulte Adicionar perfis ao AWS IoT Core LoRa WAN no Guia do Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar create-service-profile.

AWS CLI

Para criar um novo perfil de serviço

O create-service-profile exemplo a seguir cria um novo perfil de serviço sem fio de IoT.

aws iotwireless create-service-profile

Saída:

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

Para obter mais informações, consulte Adicionar perfis ao AWS IoT Core LoRa WAN no Guia do Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar create-wireless-device.

AWS CLI

Para criar um dispositivo sem fio de IoT

O create-wireless-device exemplo a seguir cria um recurso de dispositivo sem fio do tipo LoRaWAN.

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

Conteúdo de input.json:

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

Saída:

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

Para obter mais informações, consulte Conectando dispositivos e gateways ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar create-wireless-gateway-task-definition.

AWS CLI

Para criar uma definição de tarefa de gateway sem fio

O seguinte cria tarefas create-wireless-gateway-task-definition automaticamente usando essa definição de tarefa para todos os gateways com a versão atual especificada.

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

Conteúdo de input.json:

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

Saída:

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

Para obter mais informações, consulte Conectando dispositivos e gateways ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar create-wireless-gateway-task.

AWS CLI

Para criar a tarefa para um gateway sem fio

O create-wireless-gateway-task exemplo a seguir cria uma tarefa para um gateway sem fio.

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

Saída:

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

Para obter mais informações, consulte Conectando dispositivos e gateways ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar create-wireless-gateway.

AWS CLI

Para criar um gateway sem fio

O create-wireless-gateway exemplo a seguir cria um gateway de LoRa WAN dispositivo sem fio.

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

Saída:

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

Para obter mais informações, consulte Conectando dispositivos e gateways ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar delete-destination.

AWS CLI

Para excluir um destino sem fio de IoT

O delete-destination exemplo a seguir exclui o recurso de destino sem fio com o nome IoTWirelessDestination que você criou.

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

Este comando não produz saída.

Para obter mais informações, consulte Adicionar destinos ao AWS IoT Core LoRa WAN no Guia do Desenvolvedor de AWS IoT.

  • Para API obter detalhes, consulte DeleteDestinationna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar delete-device-profile.

AWS CLI

Para excluir um perfil de dispositivo

O delete-device-profile exemplo a seguir exclui um perfil de dispositivo com a ID especificada que você criou.

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

Este comando não produz saída.

Para obter mais informações, consulte Adicionar perfis ao AWS IoT Core LoRa WAN no Guia do Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar delete-service-profile.

AWS CLI

Para excluir um perfil de serviço

O delete-service-profile exemplo a seguir exclui um perfil de serviço com a ID especificada que você criou.

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

Este comando não produz saída.

Para obter mais informações, consulte Adicionar perfis ao AWS IoT Core LoRa WAN no Guia do Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar delete-wireless-device.

AWS CLI

Para excluir um dispositivo sem fio

O delete-wireless-device exemplo a seguir exclui um dispositivo sem fio que tem a ID especificada.

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

Este comando não produz saída.

Para obter mais informações, consulte Conectando dispositivos e gateways ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar delete-wireless-gateway-task-definition.

AWS CLI

Para excluir uma definição de tarefa de gateway sem fio

O delete-wireless-gateway-task-definition exemplo a seguir exclui a definição de tarefa do gateway sem fio que você criou com a seguinte ID.

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

Este comando não produz saída.

Para obter mais informações, consulte Conectando dispositivos e gateways ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar delete-wireless-gateway-task.

AWS CLI

Para excluir uma tarefa de gateway sem fio

O delete-wireless-gateway-task exemplo a seguir exclui a tarefa do gateway sem fio que tem a ID especificada.

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

Este comando não produz saída.

Para obter mais informações, consulte Conectando dispositivos e gateways ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar delete-wireless-gateway.

AWS CLI

Para excluir um gateway sem fio

O delete-wireless-gateway exemplo a seguir exclui um gateway sem fio que tem a ID especificada.

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

Este comando não produz saída.

Para obter mais informações, consulte Conectando dispositivos e gateways ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar disassociate-aws-account-from-partner-account.

AWS CLI

Para desassociar a conta do parceiro da AWS conta

O disassociate-aws-account-from-partner-account exemplo a seguir desassocia uma conta de parceiro da sua conta atualmente associada AWS .

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

Este comando não produz saída.

Para obter mais informações, consulte Adicionar seus gateways e dispositivos sem fio ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar disassociate-wireless-device-from-thing.

AWS CLI

Para desassociar a coisa do dispositivo sem fio

O disassociate-wireless-device-from-thing exemplo a seguir dissocia um dispositivo sem fio de sua coisa atualmente associada.

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

Este comando não produz saída.

Para obter mais informações, consulte Adicionar seus gateways e dispositivos sem fio ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar disassociate-wireless-gateway-from-certificate.

AWS CLI

Para desassociar o certificado do gateway sem fio

O seguinte disassociate-wireless-gateway-from-certificate dissocia um gateway sem fio de seu certificado atualmente associado.

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

Este comando não produz saída.

Para obter mais informações, consulte Adicionar seus gateways e dispositivos sem fio ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar disassociate-wireless-gateway-from-thing.

AWS CLI

Para desassociar a coisa do gateway sem fio

O disassociate-wireless-gateway-from-thing exemplo a seguir dissocia um gateway sem fio de sua coisa atualmente associada.

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

Este comando não produz saída.

Para obter mais informações, consulte Adicionar seus gateways e dispositivos sem fio ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar get-destination.

AWS CLI

Para obter informações sobre um destino sem fio de IoT

O get-destination exemplo a seguir obtém informações sobre o recurso de destino com o nome IoTWirelessDestination que você criou.

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

Saída:

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

Para obter mais informações, consulte Adicionar destinos ao AWS IoT Core LoRa WAN no Guia do Desenvolvedor de AWS IoT.

  • Para API obter detalhes, consulte GetDestinationna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-device-profile.

AWS CLI

Para obter informações sobre um perfil de dispositivo

O get-device-profile exemplo a seguir obtém informações sobre o perfil do dispositivo com a ID especificada que você criou.

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

Saída:

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

Para obter mais informações, consulte Adicionar perfis ao AWS IoT Core LoRa WAN no Guia do Desenvolvedor de AWS IoT.

  • Para API obter detalhes, consulte GetDeviceProfilena Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-partner-account.

AWS CLI

Para obter as informações da conta do parceiro

O get-partner-account exemplo a seguir obtém informações sobre sua conta do Sidewalk que tem o seguinte ID.

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

Saída:

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

Para obter mais informações, consulte Integração do Amazon Sidewalk para AWS IoT Core no Guia de desenvolvedores de AWS IoT.

  • Para API obter detalhes, consulte GetPartnerAccountna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-service-endpoint.

AWS CLI

Para obter o endpoint do serviço

O get-service-endpoint exemplo a seguir obtém o endpoint específico da conta para o protocolo. CUPS

aws iotwireless get-service-endpoint

Saída:

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

Para obter mais informações, consulte Conectando dispositivos e gateways ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar get-service-profile.

AWS CLI

Para obter informações sobre um perfil de serviço

O get-service-profile exemplo a seguir obtém informações sobre o perfil de serviço com a ID especificada que você criou.

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

Saída:

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

Para obter mais informações, consulte Adicionar perfis ao AWS IoT Core LoRa WAN no Guia do Desenvolvedor de AWS IoT.

  • Para API obter detalhes, consulte GetServiceProfilena Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-wireless-device-statistics.

AWS CLI

Para obter informações operacionais sobre um dispositivo sem fio

O get-wireless-device-statistics exemplo a seguir obtém informações operacionais sobre um dispositivo sem fio.

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

Saída:

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

Para obter mais informações, consulte Conectando dispositivos e gateways ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar get-wireless-device.

AWS CLI

Para obter informações sobre o dispositivo sem fio

O get-wireless-device exemplo a seguir lista os widgets disponíveis na sua AWS conta.

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

Saída:

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

Para obter mais informações, consulte Conectando dispositivos e gateways ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

  • Para API obter detalhes, consulte GetWirelessDevicena Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-wireless-gateway-certificate.

AWS CLI

Para obter a ID de um certificado associado a um gateway sem fio

O get-wireless-gateway-certificate exemplo a seguir obtém a ID do certificado associada a um gateway sem fio que tem a ID especificada.

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

Saída:

{
    "IotCertificateId": "8ea4aeae3db34c78cce75d9abd830356869ead6972997e0603e5fd032c804b6f"
}

Para obter mais informações, consulte Conectando dispositivos e gateways ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar get-wireless-gateway-firmware-information.

AWS CLI

Para obter informações de firmware sobre um gateway sem fio

O get-wireless-gateway-firmware-information exemplo a seguir obtém a versão do firmware e outras informações sobre um gateway sem fio.

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

Saída:

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

Para obter mais informações, consulte Conectando dispositivos e gateways ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar get-wireless-gateway-statistics.

AWS CLI

Para obter informações operacionais sobre um gateway sem fio

O get-wireless-gateway-statistics exemplo a seguir obtém informações operacionais sobre um gateway sem fio.

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

Saída:

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

Para obter mais informações, consulte Conectando dispositivos e gateways ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar get-wireless-gateway-task-definition.

AWS CLI

Para obter informações sobre uma definição de tarefa de gateway sem fio

O get-wireless-gateway-task-definition exemplo a seguir obtém informações sobre a definição da tarefa sem fio com o ID especificado.

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

Saída:

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

Para obter mais informações, consulte Conectando dispositivos e gateways ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar get-wireless-gateway-task.

AWS CLI

Para obter informações sobre a tarefa do gateway sem fio

O get-wireless-gateway-task exemplo a seguir obtém informações sobre a tarefa do gateway sem fio com a ID especificada.

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

Saída:

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

Para obter mais informações, consulte Conectando dispositivos e gateways ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar get-wireless-gateway.

AWS CLI

Para obter informações sobre um gateway sem fio

O get-wireless-gateway exemplo a seguir obtém informações sobre o gateway sem fiomyFirstLoRaWANGateway.

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

Saída:

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

Para obter mais informações, consulte Conectando dispositivos e gateways ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar list-destinations.

AWS CLI

Para listar os destinos sem fio

O list-destinations exemplo a seguir lista os destinos disponíveis registrados em sua AWS conta.

aws iotwireless list-destinations

Saída:

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

Para obter mais informações, consulte Adicionar destinos ao AWS IoT Core LoRa WAN no Guia do Desenvolvedor de AWS IoT.

  • Para API obter detalhes, consulte ListDestinationsna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar list-device-profiles.

AWS CLI

Para listar os perfis do dispositivo

O list-device-profiles exemplo a seguir lista os perfis de dispositivos disponíveis registrados em sua AWS conta.

aws iotwireless list-device-profiles

Saída:

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

Para obter mais informações, consulte Adicionar perfis ao AWS IoT Core LoRa WAN no Guia do Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar list-partner-accounts.

AWS CLI

Para listar as contas de parceiros

O list-partner-accounts exemplo a seguir lista as contas de parceiros disponíveis associadas à sua AWS conta.

aws iotwireless list-partner-accounts

Saída:

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

Para obter mais informações, consulte Integração do Amazon Sidewalk para AWS IoT Core no Guia de desenvolvedores de AWS IoT.

O código de exemplo a seguir mostra como usar list-service-profiles.

AWS CLI

Para listar os perfis de serviço

O list-service-profiles exemplo a seguir lista os perfis de serviço disponíveis registrados em sua AWS conta.

aws iotwireless list-service-profiles

Saída:

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

Para obter mais informações, consulte Adicionar perfis ao AWS IoT Core LoRa WAN no Guia do Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar list-tags-for-resource.

AWS CLI

Para listar as tags atribuídas ao recurso

O list-tags-for-resource exemplo a seguir lista as tags atribuídas a um recurso de destino sem fio.

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

Saída:

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

Para obter mais informações, consulte Descreva seu AWS IoT Core para obter LoRa WAN recursos no Guia para desenvolvedores de AWS IoT.

O código de exemplo a seguir mostra como usar list-wireless-devices.

AWS CLI

Para listar os dispositivos sem fio disponíveis

O list-wireless-devices exemplo a seguir lista os dispositivos sem fio disponíveis registrados em sua AWS conta.

aws iotwireless list-wireless-devices

Saída:

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

Para obter mais informações, consulte Conectando dispositivos e gateways ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar list-wireless-gateway-task-definitions.

AWS CLI

Para listar as definições de tarefas do gateway sem fio

O list-wireless-gateway-task-definitions exemplo a seguir lista as definições de tarefas de gateway sem fio disponíveis registradas AWS em sua conta.

aws iotwireless list-wireless-gateway-task-definitions

Saída:

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

Para obter mais informações, consulte Conectando dispositivos e gateways ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar list-wireless-gateways.

AWS CLI

Para listar os gateways sem fio

O list-wireless-gateways exemplo a seguir lista os gateways sem fio disponíveis em sua AWS conta.

aws iotwireless list-wireless-gateways

Saída:

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

Para obter mais informações, consulte Conectando dispositivos e gateways ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar send-data-to-wireless-device.

AWS CLI

Para enviar dados para o dispositivo sem fio

O send-data-to-wireless-device exemplo a seguir envia um quadro de dados de aplicativo descriptografado para o dispositivo sem fio.

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

Saída:

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

Para obter mais informações, consulte Conectando dispositivos e gateways ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar tag-resource.

AWS CLI

Para especificar uma tag, chave e valor para um recurso

O tag-resource exemplo a seguir marca o destino sem fio IoTWirelessDestination com a chave MyTag e o valorMyValue.

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

Este comando não produz saída.

Para obter mais informações, consulte Descreva seu AWS IoT Core para obter LoRa WAN recursos no Guia para desenvolvedores de AWS IoT.

  • Para API obter detalhes, consulte TagResourcena Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar test-wireless-device.

AWS CLI

Para testar o dispositivo sem fio

O test-wireless-device exemplo a seguir envia dados de uplink de Hello para um dispositivo com ID especificado.

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

Saída:

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

Para obter mais informações, consulte Conectando dispositivos e gateways ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar untag-resource.

AWS CLI

Para remover uma ou mais tags de um recurso

O untag-resource exemplo a seguir remove a tag MyTag e seu valor do destino sem fioIoTWirelessDestination.

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

Este comando não produz saída.

Para obter mais informações, consulte Descreva seu AWS IoT Core para obter LoRa WAN recursos no Guia para desenvolvedores de AWS IoT.

  • Para API obter detalhes, consulte UntagResourcena Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar update-destination.

AWS CLI

Para atualizar as propriedades de um destino

O update-destination exemplo a seguir atualiza a propriedade de descrição de um destino sem fio.

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

Este comando não produz saída.

Para obter mais informações, consulte Adicionar destinos ao AWS IoT Core LoRa WAN no Guia do Desenvolvedor de AWS IoT.

  • Para API obter detalhes, consulte UpdateDestinationna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar update-partner-account.

AWS CLI

Para atualizar as propriedades de uma conta de parceiro

O seguinte update-partner-account atualiza o AppServerPrivateKey para a conta que tem o ID especificado.

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

Este comando não produz saída.

Para obter mais informações, consulte Integração do Amazon Sidewalk para AWS IoT Core no Guia de desenvolvedores de AWS IoT.

O código de exemplo a seguir mostra como usar update-wireless-device.

AWS CLI

Para atualizar as propriedades de um dispositivo sem fio

O update-wireless-device exemplo a seguir atualiza as propriedades de um dispositivo sem fio registrado AWS em sua conta.

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

Este comando não produz saída.

Para obter mais informações, consulte Conectando dispositivos e gateways ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.

O código de exemplo a seguir mostra como usar update-wireless-gateway.

AWS CLI

Para atualizar o gateway sem fio

O update-wireless-gateway exemplo a seguir atualiza a descrição do seu gateway sem fio.

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

Este comando não produz saída.

Para obter mais informações, consulte Conectando dispositivos e gateways ao AWS IoT Core no Guia do LoRa WAN Desenvolvedor de AWS IoT.