文档首页/ 虚拟私有云 VPC/ API参考/ API/ 安全组资源标签管理/ 批量删除安全组资源标签
更新时间：2024-09-03 GMT+08:00
在线调试
CLI示例
查看PDF
分享

批量删除安全组资源标签

功能介绍

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

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

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

功能说明：操作标识

取值范围：delete

tags

是

Array of ResourceTag objects

标签列表
表3 ResourceTag

参数

是否必选

参数类型

描述

key

是

String

功能说明：标签键

约束：同一资源的key值不能重复。

最小长度：0

最大长度：36

value

是

String

功能说明：标签值

最小长度：0

最大长度：43

响应参数

状态码： 400

表4 响应Body参数

参数

参数类型

描述

code

String

请求返回的错误码

message

String

请求返回的错误信息

最小长度：1

最大长度：999

状态码： 401

表5 响应Body参数

参数

参数类型

描述

code

String

请求返回的错误码

message

String

请求返回的错误信息

最小长度：1

最大长度：999

状态码： 403

表6 响应Body参数

参数

参数类型

描述

code

String

请求返回的错误码

message

String

请求返回的错误信息

最小长度：1

最大长度：999

状态码： 404

表7 响应Body参数

参数

参数类型

描述

code

String

请求返回的错误码

message

String

请求返回的错误信息

最小长度：1

最大长度：999

状态码： 409

表8 响应Body参数

参数

参数类型

描述

code

String

请求返回的错误码

message

String

请求返回的错误信息

最小长度：1

最大长度：999

状态码： 500

表9 响应Body参数

参数

参数类型

描述

code

String

请求返回的错误码

message

String

请求返回的错误信息

最小长度：1

最大长度：999

请求示例

  • example-1：创建资源标签

    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"
  } ]
}

  • example-2：删除资源标签

    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

正常返回

400

服务器未能处理请求。

401

被请求的页面需要用户名和密码。

403

对被请求页面的访问被禁止。

404

服务器无法找到被请求的页面。

409

由于冲突，请求无法被完成。

500

请求未完成。服务异常。

错误码

请参见错误码。

相关文档