调用该接口查询指定设备的标签列表。

请求参数

名称 类型 是否必需 描述
Action String 要执行的操作,取值:QueryDeviceProp
IotId String 物联网平台为该设备颁发的设备ID,作为该设备的唯一标识符。
说明 如果传入该参数,则无需传入ProductKeyDeviceNameIotId作为设备唯一标识符,与ProductKeyDeviceName组合是一一对应的关系。如果您同时传入IotIdProductKeyDeviceName组合,则以IotId为准。
ProductKey String 要查询的设备所隶属的产品Key。
说明 如果传入该参数,需同时传入DeviceName
DeviceName String 要查询的设备的名称。
说明 如果传入该参数,需同时传入ProductKey
IotInstanceId String 公共实例不传此参数;仅独享实例需传入实例ID。
公共请求参数 - 请参见公共参数

返回参数

名称 类型 描述
RequestId String 阿里云为该请求生成的唯一标识符。
Success Boolean 表示是否调用成功。true表示调用成功,false表示调用失败。
ErrorMessage String 调用失败时,返回的出错信息。
Code String 调用失败时,返回的错误码。错误码详情,请参见错误码
Props String 调用成功时,返回的设备标签信息列表。

示例

请求示例

https://iot.cn-shanghai.aliyuncs.com/?Action=QueryDeviceProp
&ProductKey=al*********
&DeviceName=device1
&公共请求参数

返回示例

  • JSON 格式
    {
        "RequestId": "D8CEF5E7-1484-4164-A242-C06BA3A54E0F",
        "Props": "{\"coordinate\":\"104.07086:30.549169\"}",
        "Success": true
    }
  • XML格式
    <?xml version="1.0" encoding="UTF-8" ?>
    <QueryDevicePropResponse>
        <RequestId>D8CEF5E7-1484-4164-A242-C06BA3A54E0F</RequestId>
        <Props>
            <coordinate>104.07086:30.549169</coordinate>
        </Props>
        <Success>true</Success>
    </QueryDevicePropResponse>