更新时间:2026-01-07 GMT+08:00

批量删除ACL资源标签

功能介绍

为指定的ACL资源实例批量删除标签。

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

调用方法

请参见如何调用API

URI

POST /v3/{project_id}/firewalls/{firewall_id}/tags/delete

表1 路径参数

参数

是否必选

参数类型

描述

firewall_id

String

功能说明:ACL唯一标识

取值范围:合法UUID

约束:ID对应的ACL必须存在

project_id

String

项目ID

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

tags

Array of DeleteResourceTagRequestBody objects

标签列表

约束:最大支持20组标签键值对

表3 DeleteResourceTagRequestBody

参数

是否必选

参数类型

描述

key

String

功能说明:标签键

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

最小长度:1

最大长度:128

value

String

功能说明:标签值

最大长度:255

响应参数

状态码:204

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

请求示例

批量删除网络ACL标签,标签key为keyxxx,value为value1。

POST https://{Endpoint}/v3/{project_id}/firewalls/{firewall_id}/tags/delete

{
  "tags" : [ {
    "key" : "keyxxx",
    "value" : "value1"
  } ]
}

响应示例

状态码

状态码

描述

204

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

错误码

请参见错误码