黑名单规则 列表
更新时间：2026-03-10
POST
/v1/waf/blackRules/list
黑名单规则 列表
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
pageNo
integer
页码
必选
pageSize
integer
每页数量
必选
switch
integer
开关
可选
subdomain
array
域名
可选
显示子属性
隐藏子属性
items
string
ruleID
string
规则id
可选
ruleName
string
规则名称
可选
action
string
拦截规则。可选值: log, deny。log => 观察，deny => 拦截
可选
请求结构
{
"pageNo": 0,
"pageSize": 0,
"switch": 0,
"subdomain": [
"string"
],
"ruleID": "string",
"ruleName": "string",
"action": "string"
}示例代码
查询黑名单规则列表
基础调用
curl -X POST "https://example.com/v1/waf/blackRules/list" \
-H "Content-Type: application/json" \
-d '{
"pageNo": 1,
"pageSize": 10,
"switch": 1,
"subdomain": ["example.com"],
"ruleID": "rule_123",
"ruleName": "测试规则",
"action": "deny"
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
success
boolean
请求是否成功
必选
status
integer
状态码
必选
result
object {2}
必选
显示子属性
隐藏子属性
result
array
规则列表
必选
显示子属性
隐藏子属性
items
object {8}
显示子属性
隐藏子属性
ruleName
string
规则名称
必选
protectionDomains
array
防护站点
必选
显示子属性
隐藏子属性
items
string
switch
integer
开关状态。可选值: 0, 1。0 => 关，1 => 开
必选
updateTime
string
更新时间
必选
ruleKey
string
规则唯一标识
必选
ruleID
integer
全局规则ID
必选
ruleType
integer
接入类型。可选值: saas, native。saas => Saas，native => 云原生
必选
action
string
处置动作。可选值: log, deny。log => 观察，deny => 拦截
必选
totalCount
integer
总数
必选
成功获取黑名单规则列表
成功响应
{
"success": true,
"status": 200,
"result": {
"result": [
{
"ruleName": "黑名单规则1",
"protectionDomains": [
"www.example.com"
],
"switch": 1,
"updateTime": "2023-10-01 12:00:00",
"ruleKey": "key_12345",
"ruleID": 1001,
"ruleType": "saas",
"action": "deny"
}
],
"totalCount": 1
}
}