# 添加监听器标签
#### 功能介绍
给指定监听器添加标签。
#### 接口约束
- 一个资源上最多有20个标签。
- 添加时注意以下两点：
  - 如果请求体中存在重复key，则报错。
  
  - 如果请求体中无重复key，但是数据库中存在请求体中的key，则将数据库中的key值覆盖。
   
 
#### URI
POST /v2.0/{project_id}/listeners/{listener_id}/tags
表1参数说明 
| 参数          | 是否必选 | 参数类型   | 描述                                                                                                               |
|:---|:---|:---|:---|
| project_id  | 是    | String | 标签所在的项目ID。 获取方法详见[获取项目ID](https://support.huaweicloud.com/api-elb/elb_fl_0008.html)。 |
| listener_id | 是    | String | 要添加标签的监听器的ID。                                                                                                    |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述      |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户token |
   
表3请求参数 
| 参数  | 是否必选 | 参数类型   | 描述                                                |
|:---|:---|:---|:---|
| tag | 是    | Object | 标签对象。详见[表4]。 |
   
 表4tag 字段数据结构说明 
| 参数    | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|:---|
| key   | 是    | String | 标签名称。 - 不能为空。  - 长度不超过128个字符。  - 由英文字母、数字、下划线、中划线、中文字符组成。  - 同一资源的key值不能重复。   |
| value | 是    | String | 标签值。 - 长度不超过255个字符。  - 由英文字母、数字、下划线、点、中划线、中文字符组成。                                                                                                                                                                      |
   
#### 响应参数
无
#### 请求示例
- 请求样例
  ```
  POST https://{Endpoint}/v2.0/6a0de1c3-7d74-4f4a-b75e-e57135bd2b97/listeners/7add33ad-11dc-4ab9-a50f-419703f13163/tags
  {
      "tag": {
          "key": "key1", 
          "value": "value1"
      }
  }
  ```
  
 
#### 响应示例
- 响应样例 无
  
 
#### 返回码
请参见[返回码](https://support.huaweicloud.com/api-elb/elb_zq_bq_0013.html)。