创建 CC 防护规则,可根据网络访问 IP、Session 等各种 HTTP 请求对象进行请求限制,当满足设定的统计条件后,对其访问执行防护动作,以防止服务器资源被过度占用,确保正常访问业务不受影响。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
Name | String | 是 |
| 规则名称,支持英文、汉字和数字,不支持特殊字符。长度限制在 20 个字符内。 |
Url | String | 是 |
| 请求路径,支持通配符 |
AdvancedEnable | Boolean | 否 |
| 是否启用高级条件。
|
Field | String | 是 |
| 统计对象,多个对象用逗号分隔。格式为
|
SingleThreshold | Integer | 是 |
| 每个统计对象访问的次数阈值。取值范围 1~300,000。 |
PathThreshold | Integer | 是 |
| 请求路径访问的次数阈值。取值范围 1~300,000。 |
CountTime | Integer | 是 |
| 统计时长,单位:秒。取值范围 1~1,800。 |
CCType | Integer | 是 |
| 执行动作。
|
EffectTime | Integer | 是 |
| 统计时长,单位:秒。取值范围 1~86,400。 说明 执行动作为“观察”时无需填写。 |
RulePriority | Integer | 是 |
| 规则执行优先级,数字越大优先级越低。
|
Enable | Enum | 是 |
| 是否启用规则。
|
AccurateGroup | AccurateGroupobject | 否 | - | 高级条件配置,未开启高级条件时无需配置此字段。 |
Host | String | 是 |
| 需要设置防护规则的网站域名。 |
参数 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
AccurateRules | Array of AccurateRules objects | 是 | - | 规则详情。 |
Logic | Integer | 是 |
| 规则间的运算关系。
|
参数 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
HttpObj | String | 是 |
| 自定义对象,与
|
ObjType | Integer | 是 |
| 匹配字段。
|
Opretar | Integer | 是 |
| 逻辑运算符。
|
Property | Integer | 是 |
| 固定取值为 0,取 |
ValueString | string | 是 |
| 匹配内容。 |
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
Id | String |
| 创建的规则 ID。 |
POST https://open.volcengineapi.com/?Action=CreateCCRule&Version=2020-12-09 X-Date: 20230711T035055Z Authorization: HMAC-SHA256 Credential=AKLTNGU0OGEyMT***/20230711/cn-beijing/waf/request, SignedHeaders=content-type;x-content-sha256;x-date, Signature=da4fac562d00f41ad8*** { "Name": "123", "Url": "/test.html", "AdvancedEnable": true, "Field": "CLIENTIP", "SingleThreshold": 10, "PathThreshold": 100, "CountTime": 60, "CCType": 1, "RulePriority": 0, "Enable": 1, "AccurateGroup": { "Logic": 1, "AccurateRules": [ { "Property": 0, "HttpObj": "request.schema", "ObjType": 0, "Opretar": 2, "ValueString": "HTTP" } ] }, "EffectTime": 60, "Host": "example.volcwaf001.com" }
{ "ResponseMetadata": { "RequestId": "202310091729184CEFD57F221FFCBF****", "Action": "CreateCCRule", "Version": "2020-12-09", "Service": "waf", "Region": "cn-beijing" }, "Result": { "Id": 144565 } }