
# 批量添加/删除公网NAT网关资源标签
#### 功能介绍
为指定公网NAT网关实例批量添加或删除标签。
标签管理服务需要使用该接口批量管理实例的标签。
一个资源上最多有10个标签。
此接口为幂等接口：
创建时如果请求体中存在重复key则报错。
创建时，不允许重复key,如果数据库存在就覆盖。
删除时，如果删除的标签不存在，默认处理成功,删除时不对标签字符集范围做校验。Key长度127个unicode字符，value为255个unicode字符。删除时tags结构体不能缺失，key不能为空，或者空字符串。
#### URI
- URI格式
POST /v2.0/{project_id}/nat_gateways/{nat_gateway_id}/tags/action
表1参数说明 
| 参数             | 是否必选 | 参数类型   | 描述         |
|:---|:---|:---|:---|
| project_id     | 是    | String | 项目的ID。     |
| nat_gateway_id | 是    | String | 公网NAT网关ID。 |
   
#### 请求消息
请求参数如[表2]所示。
 表2请求参数 
| 参数     | 是否必选 | 参数类型   | 描述                                                                     |
|:---|:---|:---|:---|
| tags   | 是    | Array  | 标签列表。请参考[表3] |
| action | 是    | String | 操作标识：仅限于create（创建）、delete（删除）                                          |
   
 表3tags字段数据结构说明 
| 参数    | 是否必选 | 参数类型   | 描述                                                                                                                                     |
|:---|:---|:---|:---|
| key   | 是    | String | 键。最大长度36个unicode字符。key不能为空。不能包含非打印字符ASCII(0-31)，"=","\*","\<","\>","\\",",","\|","/"                                                   |
| value | 是    | String | 值。每个值最大长度43个unicode字符，删除时如果value有值按照key/value删除，如果value没值，则按照key删除，可以为空字符串。,不能包含非打印字符ASCII(0-31), "=","\*","\<","\>","\\",",","\|","/" |
   
#### 响应消息
无
#### 示例
- 请求样例
  ```
  POST  https://{VPC_endpoint}/v2.0/9ad601814ac94c80bf7bb9073ded66fc/nat_gateways/fe1a4cf0-27fe-4b97-a9b1-2c67c127f0e0/tags/action
  {
      "action": "create",
      "tags": [
          {
              "key": "key1",
              "value": "value1"
          },
          {
              "key": "key2",
              "value": "value2"
          }
      ]
  }
  或
  {
      "action": "delete",
      "tags": [
          {
              "key": "key1",
              "value": "value1             
           },
          {
              "key": "key2",
              "value": "value2"
          }
      ]
  }
  ```
  
 
#### 响应样例
无
#### 状态码
请参考[状态码](https://support.huaweicloud.com/api-natgateway/nat_api_0038.html)。
