更新时间:2026-01-07 GMT+08:00
批量添加ACL资源标签
功能介绍
为指定的ACL资源实例批量添加标签。
此接口为幂等接口:创建时如果请求体中存在重复key则报错。创建时,不允许设置重复key数据,如果数据库已存在该key,就覆盖value的值。
调用方法
请参见如何调用API。
URI
POST /v3/{project_id}/firewalls/{firewall_id}/tags/create
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
firewall_id |
是 |
String |
功能说明:ACL唯一标识 取值范围:合法UUID 约束:ID对应的ACL必须存在 |
|
project_id |
是 |
String |
项目ID |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
tags |
是 |
Array of ResourceTag objects |
标签列表 约束:最大支持20组标签键值对 |
请求示例
批量添加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 |
请求正常返回,更多状态码请参见状态码。 |
错误码
请参见错误码。
父主题: 网络ACL资源标签管理