AWS IoT Wireless 使用示例 AWS CLI

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

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

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

主题

操作

操作

以下代码示例显示了如何使用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"
    }
}

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

有关API详细信息，请参阅 “AssociateAwsAccountWithPartnerAccount AWS CLI命令参考”。

以下代码示例显示了如何使用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"

此命令不生成任何输出。

有关更多信息，请参阅《物联网开发人员指南》 LoRaWAN中的将网关和无线设备添加到AWS Io AWS T Core。

有关API详细信息，请参阅 “AssociateWirelessDeviceWithThing AWS CLI命令参考”。

以下代码示例显示了如何使用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"
}

有关更多信息，请参阅《物联网开发人员指南》 LoRaWAN中的将网关和无线设备添加到AWS Io AWS T Core。

有关API详细信息，请参阅 “AssociateWirelessGatewayWithCertificate AWS CLI命令参考”。

以下代码示例显示了如何使用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"

此命令不生成任何输出。

有关更多信息，请参阅《物联网开发人员指南》 LoRaWAN中的将网关和无线设备添加到AWS Io AWS T Core。

有关API详细信息，请参阅 “AssociateWirelessGatewayWithThing AWS CLI命令参考”。

以下代码示例显示了如何使用create-destination。

AWS CLI

创建物联网无线目的地

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


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 物联网开发人员指南》 LoRaWAN中的向 I AWS oT Core 添加目标。

有关API详细信息，请参阅 “CreateDestination AWS CLI命令参考”。

以下代码示例显示了如何使用create-device-profile。

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

有关API详细信息，请参阅 “CreateDeviceProfile AWS CLI命令参考”。

以下代码示例显示了如何使用create-service-profile。

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

有关API详细信息，请参阅 “CreateServiceProfile AWS CLI命令参考”。

以下代码示例显示了如何使用create-wireless-device。

AWS CLI

创建 IoT 无线设备

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


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

有关API详细信息，请参阅 “CreateWirelessDevice AWS CLI命令参考”。

以下代码示例显示了如何使用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"
}

有关API详细信息，请参阅 “CreateWirelessGatewayTaskDefinition AWS CLI命令参考”。

以下代码示例显示了如何使用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"
}

有关API详细信息，请参阅 “CreateWirelessGatewayTask AWS CLI命令参考”。

以下代码示例显示了如何使用create-wireless-gateway。

AWS CLI

创建无线网关

以下create-wireless-gateway示例创建了一个无线 LoRaWAN设备网关。


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

有关API详细信息，请参阅 “CreateWirelessGateway AWS CLI命令参考”。

以下代码示例显示了如何使用delete-destination。

AWS CLI

删除 IoT 无线目标

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


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

此命令不生成任何输出。

有关更多信息，请参阅《AWS 物联网开发人员指南》 LoRaWAN中的向 I AWS oT Core 添加目标。

有关API详细信息，请参阅 “DeleteDestination AWS CLI命令参考”。

以下代码示例显示了如何使用delete-device-profile。

AWS CLI

删除设备配置文件

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


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

此命令不生成任何输出。

有关API详细信息，请参阅 “DeleteDeviceProfile AWS CLI命令参考”。

以下代码示例显示了如何使用delete-service-profile。

AWS CLI

删除服务配置文件

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


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

此命令不生成任何输出。

有关API详细信息，请参阅 “DeleteServiceProfile AWS CLI命令参考”。

以下代码示例显示了如何使用delete-wireless-device。

AWS CLI

删除无线设备

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


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

此命令不生成任何输出。

有关API详细信息，请参阅 “DeleteWirelessDevice AWS CLI命令参考”。

以下代码示例显示了如何使用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"

此命令不生成任何输出。

有关API详细信息，请参阅 “DeleteWirelessGatewayTaskDefinition AWS CLI命令参考”。

以下代码示例显示了如何使用delete-wireless-gateway-task。

AWS CLI

删除无线网关任务

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


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

此命令不生成任何输出。

有关API详细信息，请参阅 “DeleteWirelessGatewayTask AWS CLI命令参考”。

以下代码示例显示了如何使用delete-wireless-gateway。

AWS CLI

删除无线网关

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


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

此命令不生成任何输出。

有关API详细信息，请参阅 “DeleteWirelessGateway AWS CLI命令参考”。

以下代码示例显示了如何使用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"

此命令不生成任何输出。

有关更多信息，请参阅《物联网开发人员指南》 LoRaWAN中的将网关和无线设备添加到AWS Io AWS T Core。

有关API详细信息，请参阅 “DisassociateAwsAccountFromPartnerAccount AWS CLI命令参考”。

以下代码示例显示了如何使用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"

此命令不生成任何输出。

有关更多信息，请参阅《物联网开发人员指南》 LoRaWAN中的将网关和无线设备添加到AWS Io AWS T Core。

有关API详细信息，请参阅 “DisassociateWirelessDeviceFromThing AWS CLI命令参考”。

以下代码示例显示了如何使用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"

此命令不生成任何输出。

有关更多信息，请参阅《物联网开发人员指南》 LoRaWAN中的将网关和无线设备添加到AWS Io AWS T Core。

有关API详细信息，请参阅 “DisassociateWirelessGatewayFromCertificate AWS CLI命令参考”。

以下代码示例显示了如何使用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"

此命令不生成任何输出。

有关更多信息，请参阅《物联网开发人员指南》 LoRaWAN中的将网关和无线设备添加到AWS Io AWS T Core。

有关API详细信息，请参阅 “DisassociateWirelessGatewayFromThing AWS CLI命令参考”。

以下代码示例显示了如何使用get-destination。

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

有关更多信息，请参阅《AWS 物联网开发人员指南》 LoRaWAN中的向 I AWS oT Core 添加目标。

有关API详细信息，请参阅 “GetDestination AWS CLI命令参考”。

以下代码示例显示了如何使用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
    }
}

有关API详细信息，请参阅 “GetDeviceProfile AWS CLI命令参考”。

以下代码示例显示了如何使用get-partner-account。

AWS 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 AWS o AWS T Core 集成。

有关API详细信息，请参阅 “GetPartnerAccount AWS CLI命令参考”。

以下代码示例显示了如何使用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"
}

有关API详细信息，请参阅 “GetServiceEndpoint AWS CLI命令参考”。

以下代码示例显示了如何使用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
    }
}

有关API详细信息，请参阅 “GetServiceProfile AWS CLI命令参考”。

以下代码示例显示了如何使用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"
}

有关API详细信息，请参阅 “GetWirelessDeviceStatistics AWS CLI命令参考”。

以下代码示例显示了如何使用get-wireless-device。

AWS CLI

获取有关无线设备的信息

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


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

有关API详细信息，请参阅 “GetWirelessDevice AWS CLI命令参考”。

以下代码示例显示了如何使用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"
}

有关API详细信息，请参阅 “GetWirelessGatewayCertificate AWS CLI命令参考”。

以下代码示例显示了如何使用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"
        }
    }
}

有关API详细信息，请参阅 “GetWirelessGatewayFirmwareInformation AWS CLI命令参考”。

以下代码示例显示了如何使用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"
}

有关API详细信息，请参阅 “GetWirelessGatewayStatistics AWS CLI命令参考”。

以下代码示例显示了如何使用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"
            }
        }
    }
}

有关API详细信息，请参阅 “GetWirelessGatewayTaskDefinition AWS CLI命令参考”。

以下代码示例显示了如何使用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"
}

有关API详细信息，请参阅 “GetWirelessGatewayTask AWS CLI命令参考”。

以下代码示例显示了如何使用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"
}

有关API详细信息，请参阅 “GetWirelessGateway AWS CLI命令参考”。

以下代码示例显示了如何使用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 物联网开发人员指南》 LoRaWAN中的向 I AWS oT Core 添加目标。

有关API详细信息，请参阅 “ListDestinations AWS CLI命令参考”。

以下代码示例显示了如何使用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"
        }
    ]
}

有关API详细信息，请参阅 “ListDeviceProfiles AWS CLI命令参考”。

以下代码示例显示了如何使用list-partner-accounts。

AWS CLI

列出合作伙伴账户

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


aws iotwireless list-partner-accounts

输出：


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

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

有关API详细信息，请参阅 “ListPartnerAccounts AWS CLI命令参考”。

以下代码示例显示了如何使用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"
        }
    ]
}

有关API详细信息，请参阅 “ListServiceProfiles AWS CLI命令参考”。

以下代码示例显示了如何使用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"
        }
    ]
}

有关API详细信息，请参阅 “ListTagsForResource AWS CLI命令参考”。

以下代码示例显示了如何使用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"
        }
    ]
}

有关API详细信息，请参阅 “ListWirelessDevices AWS CLI命令参考”。

以下代码示例显示了如何使用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"
                }
            }
        }
    ]
}

有关API详细信息，请参阅 “ListWirelessGatewayTaskDefinitions AWS CLI命令参考”。

以下代码示例显示了如何使用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"
        }
    ]
}

有关API详细信息，请参阅 “ListWirelessGateways AWS CLI命令参考”。

以下代码示例显示了如何使用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"
}

有关API详细信息，请参阅 “SendDataToWirelessDevice AWS CLI命令参考”。

以下代码示例显示了如何使用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"

此命令不生成任何输出。

有关API详细信息，请参阅 “TagResource AWS CLI命令参考”。

以下代码示例显示了如何使用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"
}

有关API详细信息，请参阅 “TestWirelessDevice AWS CLI命令参考”。

以下代码示例显示了如何使用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"

此命令不生成任何输出。

有关API详细信息，请参阅 “UntagResource AWS CLI命令参考”。

以下代码示例显示了如何使用update-destination。

AWS CLI

更新目的地的属性

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


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

此命令不生成任何输出。

有关更多信息，请参阅《AWS 物联网开发人员指南》 LoRaWAN中的向 I AWS oT Core 添加目标。

有关API详细信息，请参阅 “UpdateDestination AWS CLI命令参考”。

以下代码示例显示了如何使用update-partner-account。

AWS CLI

更新合作伙伴账户的属性

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


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

此命令不生成任何输出。

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

有关API详细信息，请参阅 “UpdatePartnerAccount AWS CLI命令参考”。

以下代码示例显示了如何使用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"

此命令不生成任何输出。

有关API详细信息，请参阅 “UpdateWirelessDevice AWS CLI命令参考”。

以下代码示例显示了如何使用update-wireless-gateway。

AWS CLI

更新无线网关

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


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

此命令不生成任何输出。

有关API详细信息，请参阅 “UpdateWirelessGateway AWS CLI命令参考”。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

AWS IoT Things Graph

Amazon IVS