文档首页/ 云防火墙 CFW/ API参考/ API/ 标签管理/ 保存资源标签接口
更新时间:2024-12-25 GMT+08:00

保存资源标签接口

功能介绍

保存资源标签接口

调用方法

请参见如何调用API

URI

PUT /v2/{project_id}/cfw-cfw/{fw_instance_id}/tags/save

表1 路径参数

参数

是否必选

参数类型

描述

fw_instance_id

String

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

project_id

String

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

表2 Query参数

参数

是否必选

参数类型

描述

enterprise_project_id

String

企业项目ID,用户根据组织规划企业项目,对应的ID为企业项目ID,可通过如何获取企业项目ID获取,用户未开启企业项目时为0

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

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

表4 请求Body参数

参数

是否必选

参数类型

描述

tags

Array of CreateTag objects

创建防火墙标签列表

表5 CreateTag

参数

是否必选

参数类型

描述

key

String

标签键

value

String

标签值

响应参数

状态码: 200

表6 响应Body参数

参数

参数类型

描述

data

String

请求示例

保存项目id为408972e72dcd4c1a9b033e955802a36b的防火墙资源标签,防火墙id为e743cfaf-8164-4807-aa13-d893d83313cf,企业项目id为fb55459c-41b3-47fc-885d-540946fddda4。请求体中包含两个标签,分别为key:test、value:1和key:tag_zjw-1、value:1。

https://{Endpoint}/v2/408972e72dcd4c1a9b033e955802a36b/cfw-cfw/e743cfaf-8164-4807-aa13-d893d83313cf/tags/save?fw_instance_id=e743cfaf-8164-4807-aa13-d893d83313cf&enterprise_project_id=fb55459c-41b3-47fc-885d-540946fddda4

{
  "tags" : [ {
    "key" : "test",
    "value" : "1"
  }, {
    "key" : "tag_zjw-1",
    "value" : "1"
  } ]
}

响应示例

状态码: 200

OK

{ }

状态码

状态码

描述

200

OK

201

Created

401

Unauthorized

403

Forbidden

404

Not Found

错误码

请参见错误码