Amazon IoT Wireless 使用示例 Amazon CLI - Amazon Command Line Interface
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

Amazon IoT Wireless 使用示例 Amazon CLI

以下代码示例向您展示了如何使用with来执行操作和实现常见场景 Amazon IoT Wireless。 Amazon Command Line Interface

操作是大型程序的代码摘录,必须在上下文中运行。您可以通过操作了解如何调用单个服务函数,还可以通过函数相关场景和跨服务示例的上下文查看操作。

场景是展示如何通过在同一服务中调用多个函数来完成特定任务任务的代码示例。

每个示例都包含一个指向的链接 GitHub,您可以在其中找到有关如何在上下文中设置和运行代码的说明。

主题

操作

以下代码示例演示如何使用 associate-aws-account-with-partner-account

Amazon CLI

将合作伙伴账户与您的 Amazon 账户关联

以下associate-aws-account-with-partner-account示例将以下 Sidewalk 账户凭证与您的 Amazon 账户相关联。

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

输出:

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

有关更多信息,请参阅《物联网开发人员指南》中的 Amazon Sidewalk I Amazon o Amazon T Core 集成

以下代码示例演示如何使用 associate-wireless-device-with-thing

Amazon CLI

将事物与无线设备关联

以下associate-wireless-device-with-thing示例将事物与具有指定 ID 的无线设备相关联。

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

此命令不生成任何输出。

有关更多信息,请参阅《物联开发人员指南》中的将您的网关和无线设备添加到 Amazon Io Amazon T Core for LoRa WAN

以下代码示例演示如何使用 associate-wireless-gateway-with-certificate

Amazon CLI

将证书与无线网关关联

以下内容associate-wireless-gateway-with-certificate将无线网关与证书相关联。

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

输出:

{ "IotCertificateId": "a123b45c6d78e9f012a34cd5e6a7890b12c3d45e6f78a1b234c56d7e890a1234" }

有关更多信息,请参阅《物联开发人员指南》中的将您的网关和无线设备添加到 Amazon Io Amazon T Core for LoRa WAN

以下代码示例演示如何使用 associate-wireless-gateway-with-thing

Amazon CLI

将事物与无线网关关联

以下associate-wireless-gateway-with-thing示例将事物与无线网关关联。

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

此命令不生成任何输出。

有关更多信息,请参阅《物联开发人员指南》中的将您的网关和无线设备添加到 Amazon Io Amazon T Core for LoRa WAN

以下代码示例演示如何使用 create-destination

Amazon CLI

创建物联网无线目的地

以下create-destination示例创建用于将设备消息映射到 Amazon 物联网规则的目标。在运行此命令之前,您必须创建一个 IAM 角色,该角色向适用于 LoRa WAN 的 I Amazon oT Core 授予向 Amazon 物联网规则发送数据所需的权限。

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

输出:

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

有关更多信息,请参阅《物联网开发人员指南》中的向 Amazon IoT Core f Amazon o r LoRa WAN 添加目标

  • 有关 API 的详细信息,请参阅Amazon CLI 命令参考CreateDestination中的。

以下代码示例演示如何使用 create-device-profile

Amazon CLI

创建新的设备配置文件

以下create-device-profile示例创建了新的物联网无线设备配置文件。

aws iotwireless create-device-profile

输出:

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

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的向适用于 LoRa WAN 的Amazon IoT Core 添加配置文件

以下代码示例演示如何使用 create-service-profile

Amazon CLI

创建新的服务配置文件

以下create-service-profile示例创建了新的物联网无线服务配置文件。

aws iotwireless create-service-profile

输出:

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

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的向适用于 LoRa WAN 的Amazon IoT Core 添加配置文件

以下代码示例演示如何使用 create-wireless-device

Amazon CLI

创建 IoT 无线设备

以下create-wireless-device示例创建 LoRa WAN 类型的无线设备资源。

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

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 }

输出:

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

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的将设备和网关连接到适用于 LoRa WAN 的Amazon IoT Core

以下代码示例演示如何使用 create-wireless-gateway-task-definition

Amazon CLI

创建无线网关任务定义

以下内容使用此任务定义create-wireless-gateway-task-definition自动为所有具有指定当前版本的网关创建任务。

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

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

输出:

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

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的将设备和网关连接到适用于 LoRa WAN 的Amazon IoT Core

以下代码示例演示如何使用 create-wireless-gateway-task

Amazon CLI

为无线网关创建任务

以下create-wireless-gateway-task示例为无线网关创建任务。

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

输出:

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

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的将设备和网关连接到适用于 LoRa WAN 的Amazon IoT Core

以下代码示例演示如何使用 create-wireless-gateway

Amazon CLI

创建无线网关

以下create-wireless-gateway示例创建了无线 LoRa WAN 设备网关。

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

输出:

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

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的将设备和网关连接到适用于 LoRa WAN 的Amazon IoT Core

以下代码示例演示如何使用 delete-destination

Amazon CLI

删除 IoT 无线目的地

以下delete-destination示例使用您创建的名称IoTWirelessDestination删除无线目标资源。

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

此命令不生成任何输出。

有关更多信息,请参阅《物联网开发人员指南》中的向 Amazon IoT Core f Amazon o r LoRa WAN 添加目标

  • 有关 API 的详细信息,请参阅Amazon CLI 命令参考DeleteDestination中的。

以下代码示例演示如何使用 delete-device-profile

Amazon CLI

删除设备配置文件

以下delete-device-profile示例删除了您创建的具有指定 ID 的设备配置文件。

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

此命令不生成任何输出。

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的向适用于 LoRa WAN 的Amazon IoT Core 添加配置文件

以下代码示例演示如何使用 delete-service-profile

Amazon CLI

删除服务配置文件

以下delete-service-profile示例删除了您创建的具有指定 ID 的服务配置文件。

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

此命令不生成任何输出。

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的向适用于 LoRa WAN 的Amazon IoT Core 添加配置文件

以下代码示例演示如何使用 delete-wireless-device

Amazon CLI

删除无线设备

以下delete-wireless-device示例删除具有指定 ID 的无线设备。

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

此命令不生成任何输出。

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的将设备和网关连接到适用于 LoRa WAN 的Amazon IoT Core

以下代码示例演示如何使用 delete-wireless-gateway-task-definition

Amazon CLI

删除无线网关任务定义

以下delete-wireless-gateway-task-definition示例删除您使用以下 ID 创建的无线网关任务定义。

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

此命令不生成任何输出。

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的将设备和网关连接到适用于 LoRa WAN 的Amazon IoT Core

以下代码示例演示如何使用 delete-wireless-gateway-task

Amazon CLI

删除无线网关任务

以下delete-wireless-gateway-task示例删除具有指定 ID 的无线网关任务。

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

此命令不生成任何输出。

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的将设备和网关连接到适用于 LoRa WAN 的Amazon IoT Core

以下代码示例演示如何使用 delete-wireless-gateway

Amazon CLI

删除无线网关

以下delete-wireless-gateway示例删除具有指定 ID 的无线网关。

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

此命令不生成任何输出。

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的将设备和网关连接到适用于 LoRa WAN 的Amazon IoT Core

以下代码示例演示如何使用 disassociate-aws-account-from-partner-account

Amazon CLI

取消合作伙伴账户与账户的 Amazon 关联

以下disassociate-aws-account-from-partner-account示例取消合作伙伴账户与您当前关联 Amazon 账户的关联。

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

此命令不生成任何输出。

有关更多信息,请参阅《物联开发人员指南》中的将您的网关和无线设备添加到 Amazon Io Amazon T Core for LoRa WAN

以下代码示例演示如何使用 disassociate-wireless-device-from-thing

Amazon CLI

断开设备与无线设备的关联

以下disassociate-wireless-device-from-thing示例将无线设备与其当前关联的事物断开关联。

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

此命令不生成任何输出。

有关更多信息,请参阅《物联开发人员指南》中的将您的网关和无线设备添加到 Amazon Io Amazon T Core for LoRa WAN

以下代码示例演示如何使用 disassociate-wireless-gateway-from-certificate

Amazon CLI

取消证书与无线网关的关联

以下步骤将无线网关与其当前关联的证书disassociate-wireless-gateway-from-certificate断开关联。

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

此命令不生成任何输出。

有关更多信息,请参阅《物联开发人员指南》中的将您的网关和无线设备添加到 Amazon Io Amazon T Core for LoRa WAN

以下代码示例演示如何使用 disassociate-wireless-gateway-from-thing

Amazon CLI

断开设备与无线网关的关联

以下disassociate-wireless-gateway-from-thing示例将无线网关与其当前关联的事物断开关联。

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

此命令不生成任何输出。

有关更多信息,请参阅《物联开发人员指南》中的将您的网关和无线设备添加到 Amazon Io Amazon T Core for LoRa WAN

以下代码示例演示如何使用 get-destination

Amazon CLI

获取有关物联网无线目的地的信息

以下get-destination示例使用您创建的名称IoTWirelessDestination获取有关目标资源的信息。

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

输出:

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

有关更多信息,请参阅《物联网开发人员指南》中的向 Amazon IoT Core f Amazon o r LoRa WAN 添加目标

  • 有关 API 的详细信息,请参阅Amazon CLI 命令参考GetDestination中的。

以下代码示例演示如何使用 get-device-profile

Amazon CLI

获取有关设备配置文件的信息

以下get-device-profile示例使用您创建的指定 ID 获取有关设备配置文件的信息。

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

输出:

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

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的向适用于 LoRa WAN 的Amazon IoT Core 添加配置文件

  • 有关 API 的详细信息,请参阅Amazon CLI 命令参考GetDeviceProfile中的。

以下代码示例演示如何使用 get-partner-account

Amazon CLI

获取合作伙伴账户信息

以下get-partner-account示例获取有关具有以下 ID 的 Sidewalk 账户的信息。

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

输出:

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

有关更多信息,请参阅《物联网开发人员指南》中的 Amazon Sidewalk I Amazon o Amazon T Core 集成

  • 有关 API 的详细信息,请参阅Amazon CLI 命令参考GetPartnerAccount中的。

以下代码示例演示如何使用 get-service-endpoint

Amazon CLI

获取服务终端节点

以下get-service-endpoint示例获取 CUPS 协议的账户特定端点。

aws iotwireless get-service-endpoint

输出:

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

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的将设备和网关连接到适用于 LoRa WAN 的Amazon IoT Core

  • 有关 API 的详细信息,请参阅Amazon CLI 命令参考GetServiceEndpoint中的。

以下代码示例演示如何使用 get-service-profile

Amazon CLI

获取有关服务配置文件的信息

以下get-service-profile示例获取有关您创建的具有指定 ID 的服务配置文件的信息。

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

输出:

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

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的向适用于 LoRa WAN 的Amazon IoT Core 添加配置文件

  • 有关 API 的详细信息,请参阅Amazon CLI 命令参考GetServiceProfile中的。

以下代码示例演示如何使用 get-wireless-device-statistics

Amazon CLI

获取有关无线设备的操作信息

以下get-wireless-device-statistics示例获取有关无线设备的操作信息。

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

输出:

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

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的将设备和网关连接到适用于 LoRa WAN 的Amazon IoT Core

以下代码示例演示如何使用 get-wireless-device

Amazon CLI

获取有关无线设备的信息

以下get-wireless-device示例列出了您 Amazon 账户中可用的微件。

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

输出:

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

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的将设备和网关连接到适用于 LoRa WAN 的Amazon IoT Core

  • 有关 API 的详细信息,请参阅Amazon CLI 命令参考GetWirelessDevice中的。

以下代码示例演示如何使用 get-wireless-gateway-certificate

Amazon CLI

获取与无线网关关联的证书的 ID

以下get-wireless-gateway-certificate示例获取与具有指定 ID 的无线网关关联的证书 ID。

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

输出:

{ "IotCertificateId": "8ea4aeae3db34c78cce75d9abd830356869ead6972997e0603e5fd032c804b6f" }

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的将设备和网关连接到适用于 LoRa WAN 的Amazon IoT Core

以下代码示例演示如何使用 get-wireless-gateway-firmware-information

Amazon CLI

获取有关无线网关的固件信息

以下get-wireless-gateway-firmware-information示例获取有关无线网关的固件版本和其他信息。

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

输出:

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

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的将设备和网关连接到适用于 LoRa WAN 的Amazon IoT Core

以下代码示例演示如何使用 get-wireless-gateway-statistics

Amazon CLI

获取有关无线网关的操作信息

以下get-wireless-gateway-statistics示例获取有关无线网关的操作信息。

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

输出:

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

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的将设备和网关连接到适用于 LoRa WAN 的Amazon IoT Core

以下代码示例演示如何使用 get-wireless-gateway-task-definition

Amazon CLI

获取有关无线网关任务定义的信息

以下get-wireless-gateway-task-definition示例获取有关具有指定 ID 的无线任务定义的信息。

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

输出:

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

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的将设备和网关连接到适用于 LoRa WAN 的Amazon IoT Core

以下代码示例演示如何使用 get-wireless-gateway-task

Amazon CLI

获取有关无线网关任务的信息

以下get-wireless-gateway-task示例使用指定 ID 获取有关无线网关任务的信息。

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

输出:

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

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的将设备和网关连接到适用于 LoRa WAN 的Amazon IoT Core

以下代码示例演示如何使用 get-wireless-gateway

Amazon CLI

获取有关无线网关的信息

以下get-wireless-gateway示例获取有关无线网关的信息myFirstLoRaWANGateway

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

输出:

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

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的将设备和网关连接到适用于 LoRa WAN 的Amazon IoT Core

  • 有关 API 的详细信息,请参阅Amazon CLI 命令参考GetWirelessGateway中的。

以下代码示例演示如何使用 list-destinations

Amazon CLI

列出无线目的地

以下list-destinations示例列出了在您的 Amazon 账户中注册的可用目的地。

aws iotwireless list-destinations

输出:

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

有关更多信息,请参阅《物联网开发人员指南》中的向 Amazon IoT Core f Amazon o r LoRa WAN 添加目标

  • 有关 API 的详细信息,请参阅Amazon CLI 命令参考ListDestinations中的。

以下代码示例演示如何使用 list-device-profiles

Amazon CLI

列出设备配置文件

以下list-device-profiles示例列出了注册到您的 Amazon 账户的可用设备配置文件。

aws iotwireless list-device-profiles

输出:

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

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的向适用于 LoRa WAN 的Amazon IoT Core 添加配置文件

  • 有关 API 的详细信息,请参阅Amazon CLI 命令参考ListDeviceProfiles中的。

以下代码示例演示如何使用 list-partner-accounts

Amazon CLI

列出合作伙伴账户

以下list-partner-accounts示例列出了与您的账户关联的可用合作伙伴 Amazon 账户。

aws iotwireless list-partner-accounts

输出:

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

有关更多信息,请参阅《物联网开发人员指南》中的 Amazon Sidewalk I Amazon o Amazon T Core 集成

以下代码示例演示如何使用 list-service-profiles

Amazon CLI

列出服务配置文件

以下list-service-profiles示例列出了注册到您的 Amazon 账户的可用服务配置文件。

aws iotwireless list-service-profiles

输出:

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

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的向适用于 LoRa WAN 的Amazon IoT Core 添加配置文件

以下代码示例演示如何使用 list-tags-for-resource

Amazon CLI

列出分配给资源的标签

以下list-tags-for-resource示例列出了分配给无线目标资源的标签。

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

输出:

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

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的 “描述适用于 LoRa WAN 的Amazon IoT Core 资源”。

以下代码示例演示如何使用 list-wireless-devices

Amazon CLI

列出可用的无线设备

以下list-wireless-devices示例列出了注册到您的 Amazon 账户的可用无线设备。

aws iotwireless list-wireless-devices

输出:

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

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的将设备和网关连接到适用于 LoRa WAN 的Amazon IoT Core

以下代码示例演示如何使用 list-wireless-gateway-task-definitions

Amazon CLI

列出无线网关任务定义

以下list-wireless-gateway-task-definitions示例列出了注册到您的 Amazon 账户的可用无线网关任务定义。

aws iotwireless list-wireless-gateway-task-definitions

输出:

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

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的将设备和网关连接到适用于 LoRa WAN 的Amazon IoT Core

以下代码示例演示如何使用 list-wireless-gateways

Amazon CLI

列出无线网关

以下list-wireless-gateways示例列出了您 Amazon 账户中可用的无线网关。

aws iotwireless list-wireless-gateways

输出:

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

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的将设备和网关连接到适用于 LoRa WAN 的Amazon IoT Core

以下代码示例演示如何使用 send-data-to-wireless-device

Amazon CLI

向无线设备发送数据

以下send-data-to-wireless-device示例将解密后的应用程序数据帧发送到无线设备。

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

输出:

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

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的将设备和网关连接到适用于 LoRa WAN 的Amazon IoT Core

以下代码示例演示如何使用 tag-resource

Amazon CLI

为资源指定标签键和值

以下tag-resource示例IoTWirelessDestination使用密钥MyTag和值标记无线目的地MyValue

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

此命令不生成任何输出。

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的 “描述适用于 LoRa WAN 的Amazon IoT Core 资源”。

  • 有关 API 的详细信息,请参阅Amazon CLI 命令参考TagResource中的。

以下代码示例演示如何使用 test-wireless-device

Amazon CLI

测试无线设备

以下test-wireless-device示例将的上行链路数据发送Hello到具有指定 ID 的设备。

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

输出:

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

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的将设备和网关连接到适用于 LoRa WAN 的Amazon IoT Core

  • 有关 API 的详细信息,请参阅Amazon CLI 命令参考TestWirelessDevice中的。

以下代码示例演示如何使用 untag-resource

Amazon CLI

从资源中移除一个或多个标签

以下untag-resource示例将标签MyTag及其值从无线目标中删除IoTWirelessDestination

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

此命令不生成任何输出。

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的 “描述适用于 LoRa WAN 的Amazon IoT Core 资源”。

  • 有关 API 的详细信息,请参阅Amazon CLI 命令参考UntagResource中的。

以下代码示例演示如何使用 update-destination

Amazon CLI

更新目的地的属性

以下update-destination示例更新了无线目标的描述属性。

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

此命令不生成任何输出。

有关更多信息,请参阅《物联网开发人员指南》中的向 Amazon IoT Core f Amazon o r LoRa WAN 添加目标

  • 有关 API 的详细信息,请参阅Amazon CLI 命令参考UpdateDestination中的。

以下代码示例演示如何使用 update-partner-account

Amazon CLI

更新合作伙伴账户的属性

以下内容update-partner-account更新AppServerPrivateKey了具有指定 ID 的账户的。

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

此命令不生成任何输出。

有关更多信息,请参阅《物联网开发人员指南》中的 Amazon Sidewalk I Amazon o Amazon T Core 集成

以下代码示例演示如何使用 update-wireless-device

Amazon CLI

更新无线设备的属性

以下update-wireless-device示例更新了注册到您的 Amazon 帐户的无线设备的属性。

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

此命令不生成任何输出。

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的将设备和网关连接到适用于 LoRa WAN 的Amazon IoT Core

以下代码示例演示如何使用 update-wireless-gateway

Amazon CLI

更新无线网关

以下update-wireless-gateway示例更新了您的无线网关的描述。

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

此命令不生成任何输出。

有关更多信息,请参阅《Amazon 物联网开发人员指南》中的将设备和网关连接到适用于 LoRa WAN 的Amazon IoT Core