# 查询标签的值列表
#### 功能介绍
查询标签的值列表
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=IoTAnalytics&api=ListTagValues)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
GET /v1/{project_id}/data-stores/{data_store_id}/tags/{tag_name}
表1路径参数 
| 参数            | 是否必选 | 参数类型   | 描述                                        |
|:---|:---|:---|:---|
| project_id    | 是    | String | 项目ID 最小长度：**1** 最大长度：**128**              |
| data_store_id | 是    | String | 存储ID 最小长度：**1** 最大长度：**64**               |
| tag_name      | 是    | String | tag 名称，例如：deviceId 最小长度：**1** 最大长度：**64** |
表2Query参数 
| 参数      | 是否必选 | 参数类型    | 描述                                                                                       |
|:---|:---|:---|:---|
| filters | 否    | String  | 查询标签的值的过滤条件，例如: {"deviceCategory": "class1"}，注意特殊字符需要 urlencode 最小长度：**0** 最大长度：**1024** |
| offset  | 否    | Integer | 查询起始元素的偏移 最小值：**0** 最大值：**2000** 缺省值：**0**                                               |
| limit   | 否    | Integer | 返回的元素列表大小限制,默认为 100 最小值：**1** 最大值：**2000** 缺省值：**100**                                   |
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 租户Token 最小长度：**1** 最大长度：**65535** |
   
#### 响应参数
**状态码： 200**
表4响应Body参数 
| 参数         | 参数类型             | 描述                              |
|:---|:---|:---|
| tag_name   | String           | 标签的名称 最小长度：**1** 最大长度：**64**    |
| tag_values | Array of strings | 标签的值列表                          |
| count      | Integer          | 当前列表元素总数 最小值：**0** 最大值：**2000** |
   
**状态码： 400**
表5响应Body参数 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| error_code | String | 错误编码 |
| error_msg  | String | 错误消息 |
   
**状态码： 401**
表6响应Body参数 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| error_code | String | 错误编码 |
| error_msg  | String | 错误消息 |
   
**状态码： 403**
表7响应Body参数 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| error_code | String | 错误编码 |
| error_msg  | String | 错误消息 |
   
**状态码： 500**
表8响应Body参数 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| error_code | String | 错误编码 |
| error_msg  | String | 错误消息 |
   
#### 请求示例
无
#### 响应示例
**状态码： 200**
OK
```
{
  "tag_name" : "deviceId",
  "tag_values" : [ "device_1", "device_2", "device_3" ],
  "count" : 3
}
```
#### 状态码
| 状态码 | 描述                    |
|:---|:---|
| 200 | OK                    |
| 400 | Bad Request           |
| 401 | Unauthorized          |
| 403 | Forbidden             |
| 500 | Internal Server Error |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-iotanalytics/ErrorCode.html)。