更新时间:2025-11-21 GMT+08:00

标签创建接口

功能介绍

创建标签

调用方法

请参见如何调用API

URI

POST /v2/{project_id}/cfw-cfw/{fw_instance_id}/tags/create

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,可以从调API处获取,也可以从控制台获取。项目ID获取方式

fw_instance_id

String

防火墙ID,可通过防火墙ID获取方式获取

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。可通过如何获取用户Token获取。

表3 请求Body参数

参数

是否必选

参数类型

描述

tags

Array of CreateTag objects

创建防火墙标签列表

表4 CreateTag

参数

是否必选

参数类型

描述

key

String

标签键

value

String

标签值

响应参数

状态码:200

表5 响应Body参数

参数

参数类型

描述

-

String

请求示例

给项目id为0b2179bbe180d3762fb0c01a2d5725c7,防火墙ID为5e7eba7f-5de4-4ce9-8f60-11330dfc6565添加标签,标签的键为keytest,值为valuetest。

https://{Endpoint}/v2/0b2179bbe180d3762fb0c01a2d5725c7/cfw-cfw/5e7eba7f-5de4-4ce9-8f60-11330dfc6565/tags/create

{
  "tags" : [ {
    "key" : "keytest",
    "value" : "valuetest"
  } ]
}

响应示例

状态码:200

OK

{ }

状态码

状态码

描述

200

OK

错误码

请参见错误码