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

添加ACL资源标签

功能介绍

给指定ACL资源实例增加标签信息。

此接口为幂等接口:创建时,如果创建的标签已经存在(key相同),则覆盖。

调用方法

请参见如何调用API

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

firewall_id

String

功能说明:ACL唯一标识

取值范围:合法UUID

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

project_id

String

项目ID

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

tag

ResourceTag object

创建ACL资源标签请求体

表3 ResourceTag

参数

是否必选

参数类型

描述

key

String

  • 功能说明:标签键。

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

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

最小长度:1

最大长度:128

value

String

  • 功能说明:标签值。

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

最大长度:255

响应参数

状态码:204

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

请求示例

添加一条ACL标签,key为key4,value为value4。

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

{
  "tag" : {
    "key" : "key4",
    "value" : "value4"
  }
}

响应示例

状态码

状态码

描述

204

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

错误码

请参见错误码