文档首页/ IoT数据分析 IoTA/ API参考/ API列表/ 资产属性/ 获取资产属性最新值
更新时间：2022-07-13 GMT+08:00
查看PDF
分享

获取资产属性最新值

功能介绍

获取资产属性最新值

调试

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

URI

POST /v1/{project_id}/assets/{asset_id}/property-values/query-last

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

最大长度：128

asset_id

是

String

资产ID

最大长度：256

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

租户Token

最大长度：65535
表3 请求Body参数

参数

是否必选

参数类型

描述

tags

否

map<string, object>

对property按指定tags标签进行过滤查询，填入资产标签属性的属性名与属性值，不可为空，例如 {"tagPropertyA": "id0001"}；注意，标签过滤只对打上标签时刻之后的数据生效，打标签之前的数据不能通过标签过滤

property_filter

否

Array of PropertyFilter objects

属性过滤器，最多5个

property_names

否

Array of strings

待查询的资产属性名列表,不携带该字段表示查询全部
表4 PropertyFilter

参数

是否必选

参数类型

描述

property_name

是

String

过滤属性名称，正则："^[a-zA-Z0-9_]{1,64}$"

最小长度：1

最大长度：64

operator

是

String

过滤操作方式,当前仅支持“=”

最小长度：1

最大长度：64

value

是

Object

过滤属性值

响应参数

状态码： 200

表5 响应Body参数

参数

参数类型

描述

properties

Array of AssetPropertyLastValue objects

查询到的资产属性列表
表6 AssetPropertyLastValue

参数

参数类型

描述

property_name

String

资产属性名称

value

Object

资产属性值

timestamp

String

资产属性值最后更新时间

请求示例

{
  "tags" : {
    "tagPropertyA" : "IA2006300"
  },
  "property_filter" : [ {
    "property_name" : "string",
    "operator" : "=",
    "value" : 1
  } ],
  "property_names" : [ "string" ]
}

响应示例

状态码： 200

OK

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

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

409

Conflict

500

Internal Server Error

错误码

请参见错误码。

父主题： 资产属性

相关文档