DDoS防护
DDoS防护
文档指南
请输入
- 文档首页
DDoS防护API 参考DDoS 高防防护策略AddWebDefCcRule-添加 CC 防护规则
复制全文
下载 pdfAddWebDefCcRule-添加 CC 防护规则
文档反馈
问问助手为防护网站配置 CC 规则后，DDoS 高防服务会限制对网站特定路径的访问频率，精准识别 CC 攻击，缓解 CC 攻击对服务器的影响。
注意事项
每个域名最多支持配置 20 条 CC 防护规则。
请求说明
- 请求方式：POST
- 请求地址：https://advdefence.volcengineapi.com/?Action=AddWebDefCcRule&Version=2023-03-08
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Query
Action String 必选 示例值：AddWebDefCcRule
接口名称。当前 API 的名称为 AddWebDefCcRule。
Version String 必选 示例值：2023-03-08
接口版本。当前 API 的版本为 2023-03-08。
Body
AccurateGroup Object 可选 示例值：--
更多请求特征配置。
Logic Integer 可选 示例值：1
规则组中高级条件运算关系。
- 1：与
- 2：或
AccurateRules Object[] 可选 示例值：--
规则组的请求特征信息。
HttpObj String 可选 示例值：request.method
自定义对象，与ObjType存在映射关系。
- 请求协议：request.schema
- 请求 uri：request.uri
- 请求方法：request.method
- 请求路径：request.path
- 请求参数：request.queryargs
- 请求头：request.header
- 请求 User-Agent：request.header.ua
- 请求 refer：request.header.refer
- 请求 Cookies：request.header.cookies
- 请求体长度：request.header.content-length
- 请求体格式：request.header.content-type
- X-forwarded-for：request.header.x-forwarded-for
- 客户端 IP：request.header.clientip
- 自定义 Args：request.queryargs.自定义参数名称。例如request.queryargs.abc。
- 自定义 header：request.header.自定义Header 名称。例如request.header.abc。
- 自定义 cookie：request.cookie.自定义 cookie 名称。例如request.cookie.abc。
ObjType Integer 可选 示例值：2
匹配字段。
- 0：请求协议
- 1：请求 uri
- 2：请求方法
- 3：请求路径
- 4：请求参数
- 5：请求头
- 6：请求 User-Agent
- 7：请求 refer
- 8：请求 Cookies
- 9：请求体长度
- 10：请求体格式
- 11：X-forwarded-for
- 12：客户端 IP
- 13：自定义 Args
- 14：自定义 header
- 15：自定义 cookie
Opretar Integer 可选 示例值：2
逻辑运算符。
- 0：大于
- 1：大于等于
- 2：等于
- 3：小于
- 4：小于等于
- 5：不等于
- 6：包含子串
- 7：不包含子串
- 8：包含前缀
- 9：不包含前缀
- 10：包含后缀
- 11：不包含后缀
- 12：包含所有匹配集合
- 13：不包含所有匹配集合
- 14：属于匹配集合
- 15：不属于匹配集合
- 16：正则
- 17：判断为 IP
- 18：判断为 IPv4
- 19：判断为 IPv6
- 20：判断为私网 IP
- 21：判断为公网 IP
Property Integer 可选 示例值：0
固定取值为 0，取 HttpObj 的值用于匹配对应详情。
ValueString String 可选 示例值：GET
匹配内容。
说明
逻辑关系判断为 IP、 IPv4、 IPv6、私网 IP 或公网 IP 时不需要填写。
CCType Integer 必选 示例值：7
规则执行动作。
- 0：仅告警，放行满足条件的请求，但会将对应请求行为计入攻击日志。
- 1：限速，拦截超出阈值的请求，被拦截的请求将不会转发回源站。
- 2：拦截，拦截满足条件的请求，被拦截的请求将不会转发回源站。
- 7：人机验证，对满足条件的请求执行人机验证，验证通过则放行，否则拦截。
CountTime Integer 必选 示例值：60
统计时长，单位：秒。
EffectTime Integer 可选 示例值：60
生效时长，即限制时长，单位：秒。执行动作为"仅告警"时无需填写。
Enable Integer 必选 示例值：1
是否启用规则。
- 0：关闭
- 1：启用
Field String 必选 示例值：HEADER:User-Agent
统计对象，多个对象用逗号分隔。格式为类型:对应值。
- 自定义 Header。格式为HEADER:具体参数，例如HEADER:Authorization
- 自定义 Cookie。格式为COOKIE:具体参数，例如COOKIE:PHPSESSId。
- 自定义参数。格式为ARGS:具体参数，例如ARGS:device_Id。
- 源 IP。直接配置为CLIENTIP。统计对象，多个对象用逗号分隔。格式为类型:对应值
Host String 必选 示例值：www.test.com
防护域名。
Name String 必选 示例值：test
规则名称。
- 支持英文、汉字和数字，不支持特殊字符。
- 最多不超过 20 个字符。
PathThreshold Integer 可选 示例值：100
请求路径访问的总次数阈值。
PrefixSwitch Integer 必选 示例值：0
前缀匹配开关。启用前缀匹配后，可提供包含某个前缀的路径匹配模式。如设置路径为/test*，则匹配/test.html，/test123.html，/test/page.html等
- 0：关闭
- 1：开启
RulePriority Integer 必选 示例值：0
规则匹配的优先级，P0 优先级最高，P9 优先级最低。
说明
同一请求特征下的 CC 防护规则优先级不可重复。
SingleThreshold Integer 必选 示例值：10
每个统计对象访问的次数阈值。
Url String 可选 示例值：/cctest
需要进行 CC 防护规则匹配的网站路径，可以填写具体的某个页面 URL，也可以填写整个网站。
- 默认填写：
- 支持某个具体的 URL 地址，例如针对test.com/abc.html页面生效，则填写/abc.html即可。
- 支持含通配符的路径，如/test/*。通配符仅可使用一次。
- 针对整个网站，则填写/*即可。
- 前缀匹配：勾选前缀匹配后，可提供包含某个前缀的路径匹配模式。如设置/test*，则匹配/test.html，/test123.html，/test/page.html等。
说明
默认模式下（即未勾选前缀匹配时）配置的/*路径规则优先级高于前缀匹配模式下配置/*路径的规则。
返回参数
无。
请求示例
返回示例
最近更新时间：2026.02.09 21:44:44
这个页面对您有帮助吗？
有用
有用
无用
无用