
# 获取资产属性最新值
#### 功能介绍
获取资产属性最新值
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=IoTAnalytics&api=ShowLastPropertyValue)中调试该接口，支持自动认证鉴权。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                                                                         | 待查询的资产属性名列表,不携带该字段表示查询全部                                                                                             |
   
 表4PropertyFilter 
| 参数            | 是否必选 | 参数类型   | 描述                                                         |
|:---|:---|:---|:---|
| 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 | 查询到的资产属性列表 |
   
 表6AssetPropertyLastValue 
| 参数            | 参数类型   | 描述          |
|:---|:---|:---|
| 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 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-iotanalytics/ErrorCode.html)。
