# 批量创建和删除VPC资源标签 - BatchCreateDeleteVpcTags
#### 功能介绍
为指定的VPC资源实例批量添加或删除标签。
此接口为幂等接口：
创建时如果请求体中存在重复key则报错。
创建时，不允许设置重复key数据，如果数据库已存在该key，就覆盖value的值。
删除时，如果删除的标签不存在，默认处理成功，删除时不对标签字符集范围做校验。删除时tags结构体不能缺失，key不能为空，或者空字符串。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=VPC&version=v2&api=BatchCreateVpcTags)中调试该接口。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-vpc/vpc_permission_0000.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                                                    | 访问级别                                        | 资源类型（\*为必须） | 条件键                                                                                                                                                                                                                                                                                                                                                                                                                                 | 别名                                                                                                                             | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | vpc:vpcs:createTags                                    | Tagging                                     | vpc \*      | - [g:EnterpriseProjectId](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html)  - [g:ResourceTag/\<tag-key\>](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html)  - vpc:VpcId         | - vpc:vpcTags:create             | -      |
  | vpc:vpcs:createTags                                    | Tagging                                     | -           | - [g:RequestTag/\<tag-key\>](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html)  - [g:TagKeys](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html)                                                                                               | - vpc:vpcTags:create             | -      |
  | vpc:vpcs:deleteTags  | Tagging  | vpc \*      | - [g:EnterpriseProjectId](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html)  - [g:ResourceTag/\<tag-key\>](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html)  - vpc:VpcId   | - vpc:vpcTags:delete    | -      |
  | vpc:vpcs:deleteTags  | Tagging  | -           | [g:TagKeys](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html)                                                                                                                                                                                                                                                                                                                                                       | - vpc:vpcTags:delete    | -      |
     
  
 
#### URI
POST /v2.0/{project_id}/vpcs/{vpc_id}/tags/action
参数说明请参见[表1]。
 表1参数说明 
| 名称         | 是否必选 | 说明                                                                           |
|:---|:---|:---|
| project_id | 是    | 项目ID，请参见[获取项目ID](https://support.huaweicloud.com/api-vpc/vpc_api_0011.html)。 |
| vpc_id     | 是    | 虚拟私有云唯一标识                                                                    |
   
#### 请求参数
表2请求参数 
| 参数名称   | 类型                                                       | 是否必选 | 说明                                                                                                                                                                                                                              |
|:---|:---|:---|:---|
| tags   | Array of [tag] objects | 是    | tag对象，请参见[表3]。 约束：最大支持20组标签键值对。                                                                                                                                 |
| action | String                                                   | 是    | 操作标识： - create：创建  - delete：删除   |
   
 表3tag对象 
| 参数名称  | 类型     | 是否必选 | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|:---|
| key   | String | 是    | - 标签名称。  - 不能为空。  - 长度不超过128个字符。  - 由英文字母、数字、下划线、中划线、中文字符组成。  - 同一资源的key值不能重复。   |
| value | String | 是    | - 标签值。  - 长度不超过255个字符。  - 由英文字母、数字、下划线、点、中划线、中文字符组成。                                                                                                                                                                                                                                                                                                                                                       |
   
#### 请求示例
- 批量创建两条VPC资源标签，action为create。
  ```
  POST https://{Endpoint}/v2.0/{project_id}/vpcs/{vpc_id}/tags/action
  {
      "action": "create",
      "tags": [
          {
              "key": "key1",
              "value": "value1"
          },
          {
              "key": "key2",
              "value": "value3"
          }
      ]
  }
  ```
  
- 批量删除两条VPC资源标签，action为delete。
  ```
  POST https://{Endpoint}/v2.0/{project_id}/vpcs/{vpc_id}/tags/action
  {
      "action": "delete",
      "tags": [
          {
              "key": "key1",
              "value": "value1"
          },
          {
              "key": "key2",
              "value": "value3"
          }
      ]
  }
  ```
  
 
#### 响应参数
无
#### 响应示例
无
#### 状态码
请参见[状态码](https://support.huaweicloud.com/api-vpc/vpc_api_0002.html)。
#### 错误码
请参考[错误码](https://support.huaweicloud.com/api-vpc/vpc_api_0003.html)。