文档首页/ Web应用防火墙 WAF/ API参考（安卡拉区域）/ API/ 策略规则管理/ 创建引用表
更新时间：2024-04-15 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建引用表

功能介绍

创建引用表，引用表能够被CC攻击防护规则和精准访问防护中的规则所引用。

URI

POST /v1/{project_id}/waf/valuelist

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID，对应控制台用户名->我的凭证->项目列表->项目ID
表2 Query参数

参数

是否必选

参数类型

描述

enterprise_project_id

否

String

您可以通过调用企业项目管理服务（EPS）的查询企业项目列表接口（ListEnterpriseProject）查询企业项目id

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token，通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

Content-Type

是

String

内容类型

缺省值：application/json;charset=utf8
表4 请求Body参数

参数

是否必选

参数类型

描述

name

是

String

引用表名称，只能由数字、字母、中划线、下划线和英文句点组成，长度不能超过64

最小长度：2

最大长度：64

type

是

String

引用表类型，参见枚举列表

最小长度：2

最大长度：32

枚举值：

  • url

  • params

  • ip

  • cookie

  • referer

  • user-agent

  • header

  • response_code

  • response_header

  • response_body

values

是

Array of strings

引用表的值

description

否

String

引用表描述，最长128字符

最小长度：0

最大长度：128

响应参数

状态码： 200

表5 响应Body参数

参数

参数类型

描述

id

String

引用表id

name

String

引用表名称

type

String

引用表类型

description

String

引用表描述

timestamp

Long

引用表时间戳

values

Array of strings

引用表的值

producer

Integer

引用表来源：

  • 1:表示来源于用户手动创建

  • 2:表示来源于智能访问控制自动创建

状态码： 400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

状态码： 401

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

状态码： 500

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

请求示例

POST https://{Endpoint}/v1/{project_id}/waf/valuelist?enterprise_project_id=0

{
  "name" : "demo",
  "type" : "url",
  "values" : [ "/124" ],
  "description" : "demo"
}

响应示例

状态码： 200

请求成功

{
  "id" : "e5d9032d8da64d169269175c3e4c2849",
  "name" : "demo",
  "type" : "url",
  "values" : [ "/124" ],
  "timestamp" : 1650524684892,
  "description" : "demo",
  "producer" : 1
}

状态码

状态码

描述

200

请求成功

400

请求失败

401

token权限不足

500

服务器内部错误

错误码

请参见错误码。

父主题： 策略规则管理