批量删除安全组资源标签

功能介绍

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

此接口为幂等接口：删除时，如果删除的标签不存在，默认处理成功；删除时不对标签字符集范围做校验。删除时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	请求未完成。服务异常。