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

批量添加ACL资源标签

功能介绍

为指定的ACL资源实例批量添加标签。

此接口为幂等接口:创建时如果请求体中存在重复key则报错。创建时,不允许设置重复key数据,如果数据库已存在该key,就覆盖value的值。

调用方法

请参见如何调用API

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

firewall_id

String

功能说明:ACL唯一标识

取值范围:合法UUID

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

project_id

String

项目ID

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

tags

Array of ResourceTag objects

标签列表

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

表3 ResourceTag

参数

是否必选

参数类型

描述

key

String

  • 功能说明:标签键。

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

  • 取值范围:1-128个字符。

最小长度:1

最大长度:128

value

String

  • 功能说明:标签值。

  • 取值范围:0-255个字符。

最大长度:255

响应参数

状态码:204

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

请求示例

批量添加2条ACL标签,一条标签key为keyxxx,value为value1;另一条标签的key为keyyyy,value为value2。

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

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

响应示例

状态码

状态码

描述

204

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

错误码

请参见错误码