
# 查询所有监听器的标签集合
#### 功能介绍
查询用户下所有监听器的标签集合。
#### 接口约束
无。
#### URI
GET /v2.0/{project_id}/listeners/tags
表1参数说明 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                               |
|:---|:---|:---|:---|
| project_id | 是    | String | 标签所在的项目ID。 获取方法详见[获取项目ID](https://support.huaweicloud.com/api-elb/elb_fl_0008.html)。 |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述      |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户token |
   
#### 响应参数
表3响应参数 
| 参数   | 参数类型  | 描述                                                                                                                                                                                                                   |
|:---|:---|:---|
| tags | Array | 标签列表，按key值聚合。详见[表4]。 例如：一个用户共有2个监听器，监听器A标签的键为"test",值为"value1"；监听器B标签的键为"test",值为"value2"。则查询到的标签列表中对象的key为"test"，values为\["value1","value2"\] |
   
 表4tags 字段数据结构说明 
| 参数     | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|
| key    | String | 键。 - 不能为空。  - 长度不超过128个字符。  - 由英文字母、数字、下划线、中划线、中文字符组成。  - 同一资源的key值不能重复。   |
| values | Array  | 标签值列表。 - 长度不超过255个字符。  - 由英文字母、数字、下划线、点、中划线、中文字符组成。                                                                                                                                                                  |
   
#### 请求示例
- 请求样例
  ```
  GET https://{Endpoint}/v2.0/6a0de1c3-7d74-4f4a-b75e-e57135bd2b97/listeners/tags
  ```
  
 
#### 响应示例
- 响应样例
  ```
  {
      "tags": [
          {
              "key": "key1", 
              "values": [
                  "value1", 
                  "value2"
              ]
          }, 
          {
              "key": "key2", 
              "values": [
                  "value1", 
                  "value2"
              ]
          }
      ]
  }
  ```
  
 
#### 返回码
请参见[返回码](https://support.huaweicloud.com/api-elb/elb_zq_bq_0013.html)。
