文档首页/IoT数据分析 IoTA/API参考/API列表/设备存储数据查询/查询设备属性最新状态值
更新时间：2022-07-13 GMT+08:00
查看PDF
分享

查询设备属性最新状态值

功能介绍

查询设备属性最新状态值

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

POST /v1/{project_id}/data-stores/{data_store_id}/property-values/query-last

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

最小长度：1

最大长度：128

data_store_id

是

String

存储ID

最小长度：1

最大长度：64

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

租户Token

最小长度：1

最大长度：65535

表3 请求Body参数

参数

是否必选

参数类型

描述

tags

是

map<string, object>

对property按指定tags标签进行过滤查询，填入设备标签与标签值，不可为空，例如 {"deviceId": "id0001"}

property_names

否

Array of strings

查询设备的属性名称

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

properties

Array of PropertyValue objects

查询设备的属性值

表5 PropertyValue

参数

参数类型

描述

property_name

String

属性名称

value

Object

属性值

timestamp

String

属性值最后更新时间

最小长度：0

最大长度：64

状态码： 400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误编码

error_msg

String

错误消息

状态码： 401

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误编码

error_msg

String

错误消息

状态码： 403

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误编码

error_msg

String

错误消息

状态码： 500

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误编码

error_msg

String

错误消息

请求示例

{
  "tags" : {
    "deviceId" : "IA2006300"
  },
  "property_names" : [ "prop_1", "prop_2" ]
}

响应示例

状态码： 200

OK

{
  "properties" : [ {
    "property_name" : "prop_1",
    "value" : 1,
    "timestamp" : "2021-01-08T02:03:41.907Z"
  } ]
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

500

Internal Server Error

错误码

请参见错误码。

相关文档