AWS IoT Wireless 使用範例 AWS CLI - AWS Command Line Interface

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

AWS IoT Wireless 使用範例 AWS CLI

下列程式碼範例說明如何使用 AWS Command Line Interface 與來執行動作及實作常見案例 AWS IoT Wireless。

Actions 是大型程式的程式碼摘錄,必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數,但您可以在其相關情境和跨服務範例中查看內容中的動作。

Scenarios (案例) 是向您展示如何呼叫相同服務中的多個函數來完成特定任務的程式碼範例。

每個範例都包含一個連結 GitHub,您可以在其中找到如何在內容中設定和執行程式碼的指示。

主題

動作

下列程式碼範例會示範如何使用associate-aws-account-with-partner-account

AWS CLI

將合作夥伴帳戶與您的 AWS 帳戶建立關聯

下列associate-aws-account-with-partner-account範例會將下列 Sidewalk 帳戶認證與您的 AWS 帳戶建立關聯。

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

輸出:

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

如需詳細資訊,請參閱 IoT 開發人員指南中的適用於 AWS IoT 核心的AWS Amazon 人行道整合

下列程式碼範例會示範如何使用associate-wireless-device-with-thing

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

此命令不會產生輸出。

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將閘道和無線裝置新增至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用associate-wireless-gateway-with-certificate

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

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將閘道和無線裝置新增至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用associate-wireless-gateway-with-thing

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

此命令不會產生輸出。

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將閘道和無線裝置新增至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用create-destination

AWS CLI

若要建立 IoT 無線目的地

下列create-destination範例會建立將裝置訊息對應至 AWS IoT 規則的目的地。在執行此命令之前,您必須先建立 IAM 角色,該角色可為 LoRa WAN 專用 AWS IoT Core 提供傳送資料至 AWS IoT 規則所需的權限。

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

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將目標新增至 LoRa WAN 的AWS IoT 核心

下列程式碼範例會示範如何使用create-device-profile

AWS CLI

建立新的裝置設定檔

下列create-device-profile範例會建立新的 IoT 無線裝置設定檔。

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

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將設定檔新增至 LoRa WAN 的AWS IoT 核心

下列程式碼範例會示範如何使用create-service-profile

AWS CLI

若要建立新的服務設定檔

下列create-service-profile範例會建立新的 IoT 無線服務設定檔。

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

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將設定檔新增至 LoRa WAN 的AWS IoT 核心

下列程式碼範例會示範如何使用create-wireless-device

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

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將裝置和閘道連接至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用create-wireless-gateway-task-definition

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

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將裝置和閘道連接至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用create-wireless-gateway-task

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

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將裝置和閘道連接至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用create-wireless-gateway

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

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將裝置和閘道連接至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用delete-destination

AWS CLI

若要刪除 IoT 無線目的地

下列delete-destination範例會以您建立的名稱刪除無線目IoTWirelessDestination的地資源。

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

此命令不會產生輸出。

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將目標新增至 LoRa WAN 的AWS IoT 核心

下列程式碼範例會示範如何使用delete-device-profile

AWS CLI

刪除裝置描述檔

下列delete-device-profile範例會刪除具有您建立之指定 ID 的裝置設定檔。

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

此命令不會產生輸出。

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將設定檔新增至 LoRa WAN 的AWS IoT 核心

下列程式碼範例會示範如何使用delete-service-profile

AWS CLI

若要刪除服務設定檔

下列delete-service-profile範例會刪除具有您建立之指定 ID 的服務設定檔。

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

此命令不會產生輸出。

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將設定檔新增至 LoRa WAN 的AWS IoT 核心

下列程式碼範例會示範如何使用delete-wireless-device

AWS CLI

若要刪除無線裝置

下列delete-wireless-device範例會刪除具有指定 ID 的無線裝置。

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

此命令不會產生輸出。

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將裝置和閘道連接至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用delete-wireless-gateway-task-definition

AWS CLI

刪除無線閘道工作定義

下列delete-wireless-gateway-task-definition範例會刪除您使用下列 ID 建立的無線閘道作業定義。

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

此命令不會產生輸出。

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將裝置和閘道連接至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用delete-wireless-gateway-task

AWS CLI

若要刪除無線閘道工作

下列delete-wireless-gateway-task範例會刪除具有指定 ID 的無線閘道工作。

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

此命令不會產生輸出。

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將裝置和閘道連接至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用delete-wireless-gateway

AWS CLI

刪除無線閘道

下列delete-wireless-gateway範例會刪除具有指定 ID 的無線閘道。

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

此命令不會產生輸出。

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將裝置和閘道連接至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用disassociate-aws-account-from-partner-account

AWS CLI

取消合作夥伴帳戶與帳戶的 AWS 關聯

下列disassociate-aws-account-from-partner-account範例會取消合作夥伴帳戶與您目前關聯 AWS 帳戶的關聯。

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

此命令不會產生輸出。

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將閘道和無線裝置新增至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用disassociate-wireless-device-from-thing

AWS CLI

取消物件與無線裝置的關聯

下列disassociate-wireless-device-from-thing範例會取消無線裝置與其目前關聯物件的關聯。

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

此命令不會產生輸出。

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將閘道和無線裝置新增至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用disassociate-wireless-gateway-from-certificate

AWS CLI

取消憑證與無線閘道的關聯

下列項目disassociate-wireless-gateway-from-certificate會取消無線閘道與其目前關聯憑證的關聯。

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

此命令不會產生輸出。

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將閘道和無線裝置新增至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用disassociate-wireless-gateway-from-thing

AWS CLI

取消物件與無線閘道的關聯

下列disassociate-wireless-gateway-from-thing範例會取消無線閘道與其目前關聯物件之間的關聯。

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

此命令不會產生輸出。

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將閘道和無線裝置新增至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用get-destination

AWS CLI

取得 IoT 無線目的地的相關資訊

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

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將目標新增至 LoRa WAN 的AWS IoT 核心

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考GetDestination中的。

下列程式碼範例會示範如何使用get-device-profile

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

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將設定檔新增至 LoRa WAN 的AWS IoT 核心

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考GetDeviceProfile中的。

下列程式碼範例會示範如何使用get-partner-account

AWS CLI

取得合作夥伴帳戶資訊

下列get-partner-account範例會取得有關具有下列 ID 的人行道帳戶的資訊。

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

輸出:

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

如需詳細資訊,請參閱 IoT 開發人員指南中的適用於 AWS IoT 核心的AWS Amazon 人行道整合

下列程式碼範例會示範如何使用get-service-endpoint

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

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將裝置和閘道連接至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用get-service-profile

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

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將設定檔新增至 LoRa WAN 的AWS IoT 核心

下列程式碼範例會示範如何使用get-wireless-device-statistics

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

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將裝置和閘道連接至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用get-wireless-device

AWS CLI

取得有關無線裝置的資訊

下列get-wireless-device範例會列出您 AWS 帳戶中可用的 Widget。

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

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將裝置和閘道連接至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用get-wireless-gateway-certificate

AWS CLI

取得與無線閘道相關聯之憑證的 ID

下列get-wireless-gateway-certificate範例會取得與具有指定 ID 之無線閘道相關聯的憑證 ID。

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

輸出:

{ "IotCertificateId": "8ea4aeae3db34c78cce75d9abd830356869ead6972997e0603e5fd032c804b6f" }

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將裝置和閘道連接至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用get-wireless-gateway-firmware-information

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

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將裝置和閘道連接至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用get-wireless-gateway-statistics

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

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將裝置和閘道連接至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用get-wireless-gateway-task-definition

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

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將裝置和閘道連接至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用get-wireless-gateway-task

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

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將裝置和閘道連接至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用get-wireless-gateway

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

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將裝置和閘道連接至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用list-destinations

AWS CLI

列出無線目的地

下列list-destinations範例會列出您帳戶中註冊的可用 AWS 目的地。

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

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將目標新增至 LoRa WAN 的AWS IoT 核心

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考ListDestinations中的。

下列程式碼範例會示範如何使用list-device-profiles

AWS CLI

列出裝置描述檔

下列list-device-profiles範例會列出您 AWS 帳戶中註冊的可用裝置描述檔。

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

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將設定檔新增至 LoRa WAN 的AWS IoT 核心

下列程式碼範例會示範如何使用list-partner-accounts

AWS CLI

列出合作夥伴帳戶

下列list-partner-accounts範例會列出與您帳戶相關聯的可用合作夥伴 AWS 帳戶。

aws iotwireless list-partner-accounts

輸出:

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

如需詳細資訊,請參閱 IoT 開發人員指南中的適用於 AWS IoT 核心的AWS Amazon 人行道整合

下列程式碼範例會示範如何使用list-service-profiles

AWS CLI

若要列出服務設定檔

下列list-service-profiles範例會列出您 AWS 帳戶中註冊的可用服務設定檔。

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

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將設定檔新增至 LoRa WAN 的AWS IoT 核心

下列程式碼範例會示範如何使用list-tags-for-resource

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

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的針對 LoRa WAN 資源描述AWS IoT 核心

下列程式碼範例會示範如何使用list-wireless-devices

AWS CLI

列出可用的無線裝置

下列list-wireless-devices範例會列出您 AWS 帳戶中註冊的可用無線裝置。

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

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將裝置和閘道連接至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用list-wireless-gateway-task-definitions

AWS CLI

列出無線閘道工作定義

下列list-wireless-gateway-task-definitions範例會列出您 AWS 帳戶中註冊的可用無線閘道工作定義。

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

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將裝置和閘道連接至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用list-wireless-gateways

AWS CLI

列出無線閘道

下列list-wireless-gateways範例會列出您 AWS 帳戶中可用的無線閘道。

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

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將裝置和閘道連接至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用send-data-to-wireless-device

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

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將裝置和閘道連接至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用tag-resource

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

此命令不會產生輸出。

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的針對 LoRa WAN 資源描述AWS IoT 核心

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考TagResource中的。

下列程式碼範例會示範如何使用test-wireless-device

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

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將裝置和閘道連接至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用untag-resource

AWS CLI

若要從資源中移除一或多個標籤

下列untag-resource範例會從無線目的地移除標籤MyTag及其值IoTWirelessDestination

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

此命令不會產生輸出。

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的針對 LoRa WAN 資源描述AWS IoT 核心

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考UntagResource中的。

下列程式碼範例會示範如何使用update-destination

AWS CLI

更新目標屬性的步驟

下列update-destination範例會更新無線目的地的 description 屬性。

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

此命令不會產生輸出。

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將目標新增至 LoRa WAN 的AWS IoT 核心

下列程式碼範例會示範如何使用update-partner-account

AWS CLI

更新合作夥伴帳戶的屬性

以下內容會update-partner-accountAppServerPrivateKey更新具有指定 ID 的帳戶。

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

此命令不會產生輸出。

如需詳細資訊,請參閱 IoT 開發人員指南中的適用於 AWS IoT 核心的AWS Amazon 人行道整合

下列程式碼範例會示範如何使用update-wireless-device

AWS CLI

更新無線裝置的內容

下列update-wireless-device範例會更新您 AWS 帳戶中註冊之無線裝置的內容。

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

此命令不會產生輸出。

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將裝置和閘道連接至 LoRa WAN 的AWS IoT Core

下列程式碼範例會示範如何使用update-wireless-gateway

AWS CLI

更新無線閘道

下列update-wireless-gateway範例會更新無線閘道的說明。

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

此命令不會產生輸出。

如需詳細資訊,請參閱 AWS IoT 開發人員指南中的將裝置和閘道連接至 LoRa WAN 的AWS IoT Core