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