获取资产属性历史值
功能介绍
获取资产属性历史值
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
POST /v1/{project_id}/assets/{asset_id}/property-values/query
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 项目ID 最大长度：128 |
asset_id | 是 | String | 资产ID 最大长度：256 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | 租户Token 最大长度：65535 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
time_span | 否 | TimeSpanDT object | 起止时间 |
tags | 否 | map<string, object> | 对property按指定tags标签进行过滤查询，填入资产标签属性的属性名与属性值，不可为空，例如 {"tagPropertyA": "id0001"}；注意，标签过滤只对打上标签时刻之后的数据生效，打标签之前的数据不能通过标签过滤 |
property_filter | 否 | Array of PropertyFilter objects | 属性过滤器，最多5个 |
property_names | 是 | Array of strings | 待查询的资产属性列表 |
limit | 否 | Integer | 返回值个数限制 最大值：2000 缺省值：2000 |
响应参数
状态码： 200
参数 | 参数类型 | 描述 |
|---|---|---|
timestamps | Array of strings | 时间序列,使用UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss.SSS'Z',示例：2021-02-01T00:00:00.123Z |
properties | Array of RawValue objects | 响应属性列表 |
请求示例
{
"time_span" : {
"from" : "2021-02-01T00:00:00.123Z",
"to" : "2021-02-05T20:00:00.100Z"
},
"tags" : {
"tagPropertyA" : "IA2006300"
},
"property_filter" : [ {
"property_name" : "string",
"operator" : "=",
"value" : 1
} ],
"property_names" : [ "string" ],
"limit" : 2000
} 响应示例
状态码： 200
OK
{
"timestamps" : [ "string" ],
"properties" : [ {
"property_name" : "string",
"values" : [ { } ]
} ]
} 状态码
状态码 | 描述 |
|---|---|
200 | OK |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
409 | Conflict |
500 | Internal Server Error |
错误码
请参见错误码。
