黑名单规则 保存
更新时间：2026-03-10
POST
/v1/waf/blackRules/save
黑名单规则 保存
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
ruleName
string
规则名称
必选
bindInfo
array
站点绑定信息
必选
显示子属性
隐藏子属性
items
object {2}
显示子属性
隐藏子属性
instanceID
string
必选
subdomains
array
必选
显示子属性
隐藏子属性
items
string
ruleKey
string
规则唯一标识。编辑时必传
可选
action
string
处置动作。可选值: deny, log。(deny: 拦截, log: 观察)
必选
ruleType
string
接入类型。可选值: saas, native。(saas: Saas, native: 云原生)
必选
ipList
array
黑名单列表
必选
显示子属性
隐藏子属性
items
string
请求结构
{
"ruleName": "规则名称",
"bindInfo": [
{
"instanceID": "实例ID",
"subdomains": ["子域名1"]
}
],
"ruleKey": "规则唯一标识（编辑时必传）",
"action": "deny",
"ruleType": "saas",
"ipList": ["IP地址"]
}示例代码
保存黑名单规则示例
curl -X POST "https://example.com/v1/waf/blackRules/save" \
-H "Content-Type: application/json" \
-d '{
"ruleName": "测试黑名单规则",
"bindInfo": [
{
"instanceID": "instance-001",
"subdomains": ["www.example.com"]
}
],
"action": "deny",
"ruleType": "saas",
"ipList": ["192.168.1.1", "10.0.0.1"]
}'{
"ruleName": "测试黑名单规则",
"bindInfo": [
{
"instanceID": "instance-001",
"subdomains": ["www.example.com"]
}
],
"action": "deny",
"ruleType": "saas",
"ipList": ["192.168.1.1", "10.0.0.1"]
}返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
success
boolean
请求是否成功
必选
result
object {1}
必选
显示子属性
隐藏子属性
ruleKey
string
规则唯一标识
必选
保存成功后的返回结果
成功响应
{
"success": true,
"result": {
"ruleKey": "rule-abc123456"
}
}