调用该接口查询指定设备的属性记录。

限制说明

仅能查询最近30天内的属性数据。

说明 数据存储时间从属性时间戳表示的时间当日开始计算。

请求参数

名称 类型 是否必需 描述
Action String 要执行的操作,取值:QueryDevicePropertyData
IotId String

要查询的设备ID,设备的唯一标识符。

说明 如果传入该参数,则无需传入ProductKeyDeviceNameIotId作为设备唯一标识符,与ProductKeyDeviceName组合是一一对应的关系。如果您同时传入IotIdProductKeyDeviceName组合,则以IotId为准。
ProductKey String

指定要查询的设备隶属的产品Key。

说明 如果传入该参数,需同时传入DeviceName
DeviceName String

指定要查询的设备的名称。

说明 如果传入该参数,需同时传入ProductKey
Identifier String

要查询的属性标识符。

设备的属性Identifier,可在控制台中设备所属的产品的功能定义中查看。若设备有多个属性,您可以多次调用该接口进行查询,一次输入一个Identifier。

StartTime Long 要查询的属性记录的开始时间。取值为毫秒值时间戳。
说明 只能查询最近30天内的属性数据记录。
EndTime Long 要查询的属性记录的结束时间。取值为毫秒值时间戳。
PageSize Integer 返回结果中每页显示的记录数。数量限制:每页最多可显示50条。
Asc Integer

返回结果中属性记录的排序方式,取值:

0:倒序。

1:正序。

IotInstanceId String 公共实例不传此参数;仅独享实例需传入实例ID。
公共请求参数 - 请参见公共参数

返回参数

名称 类型 描述
RequestId String 阿里云为该请求生成的唯一标识符。
Success Boolean 表示是否调用成功。true表示调用成功,false表示调用失败。
ErrorMessage String 调用失败时,返回的出错信息。
Code String 调用失败时,返回的错误码。错误码详情,请参见错误码
Data Data 调用成功时,返回的设备属性记录。详情参见下表Data。
表 1. Data
名称 类型 描述
List List<PropertyList> 属性集合。每个元素代表一个属性。元素的结构参见下表PropertyInfo。
说明 返回的属性信息按照属性生成时间倒序排列。
NextValid Boolean 是否有下一页属性记录。true表示有,false表示没有。

返回NextValidtrue时,可以将NextTime的值作为下次查询的StartTime,查询下一页数据。

NextTime Long 下一页面中的属性记录的起始时间。

调用本接口查询下一页属性记录时,该值可作为入参StartTime的值。

表 2. PropertyInfo
名称 类型 描述
Value String 属性值。
Time Long 属性修改时间。

示例

请求示例

https://iot.cn-shanghai.aliyuncs.com/?Action=QueryDevicePropertyData
&IotId=SR8FiTu1R9tlUR2V1bmi0010*****
&ProductKey=al*********
&DeviceName=device1
&Identifier=lightLevel
&StartTime=1516538300303
&EndTime=1516541900303
&PageSize=10
&Asc=1
&公共请求参数

返回示例

  • JSON格式

    {
      "RequestId":"57b144cf-09fc-4916-a272-a62902d5b207",
      "Success": true,
      "Data": {
        "NextValid": true,
        "NextTime": 1516541821599,
        "List": {
          "PropertyInfo": [
            {
              "Value": "32",
              "Time": 1516541894876
            },
            {
              "Value": "2",
              "Time": 1516541885630
            },
            {
              "Value": "95",
              "Time": 1516541875947
            },
            {
              "Value": "14",
              "Time": 1516541830905
            },
            {
              "Value": "78",
              "Time": 1516541821600
            }
          ]
        }
      }
    }
  • XML格式

    <?xml version='1.0' encoding='utf-8'?>
    <QueryDevicePropertyDataResponse>
        <RequestId>57b144cf-09fc-4916-a272-a62902d5b207</RequestId>
        <Success>true</Success>
        <Data>
            <NextValid>true</NextValid>
            <NextTime>1516541821599</NextTime>
            <List>
                <PropertyInfo>
                    <Value>32</Value>
                    <Time>1516541894876</Time>
                </PropertyInfo>
                <PropertyInfo>
                    <Value>2</Value>
                    <Time>1516541885630</Time>
                </PropertyInfo>
                <PropertyInfo>
                    <Value>95</Value>
                    <Time>1516541875947</Time>
                </PropertyInfo>
                <PropertyInfo>
                    <Value>14</Value>
                    <Time>1516541830905</Time>
                </PropertyInfo>
                <PropertyInfo>
                    <Value>78</Value>
                    <Time>1516541821600</Time>
                </PropertyInfo>
            </List>
        </Data>
    </QueryDevicePropertyDataResponse>