批量创建和删除安全组资源标签

功能介绍

为指定的安全组资源实例批量添加或删除标签。

此接口为幂等接口：

创建时如果请求体中存在重复key则报错。创建时，不允许设置重复key数据，如果数据库已存在该key，就覆盖value的值。

删除时，如果删除的标签不存在，默认处理成功；删除时不对标签字符集范围做校验。删除时tags结构体不能缺失，key不能为空，或者空字符串。

接口约束

此接口为幂等接口：

创建时如果请求体中存在重复key则报错。创建时，不允许设置重复key数据，如果数据库已存在该key，就覆盖value的值。

删除时，如果删除的标签不存在，默认处理成功；删除时不对标签字符集范围做校验。删除时tags结构体不能缺失，key不能为空，或者空字符串。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。

URI

POST /v2.0/{project_id}/security-groups/{security_group_id}/tags/action

请求参数

响应参数

状态码：204

请求正常返回，更多状态码请参见状态码。

无

请求示例

• 批量创建两条安全组资源标签，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"
    } ]
  }

响应示例

无

状态码

错误码

请参见错误码。