更新 CC 防护规则,支持修改创建 CC 规则时传入的所有参数,包括规则名称、请求路径等。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | UpdWebDefCcRule | 接口名称。当前 API 的名称为 UpdWebDefCcRule 。 |
Version | String | 是 | 2023-03-08 | 接口版本。当前 API 的版本为 2023-03-08 。 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
AccurateGroup | Object of WafV3Accurate | 否 | -- | 高级条件配置,未开启高级条件时无需配置此字段。 |
CCType | Integer | 是 |
| 规则执行动作。
|
CountTime | Integer | 是 | 60 | 统计时长,单位:秒。 |
DdosId | Integer | 是 | 70 | 规则 ID,可调用DescWebDefCcRule接口获取。 |
EffectTime | Integer | 是 |
| 生效时长,单位:秒。 说明 执行动作为"仅告警"时无需填写。 |
Enable | Integer | 是 |
| 是否启用规则。
|
Field | String | 是 | HEADER:User-Agent | 统计对象,格式为类型:对应值 。 |
Host | String | 是 | www.test.com | 防护域名。 |
Name | String | 是 | test | 规则名称。 |
PathThreshold | Integer | 是 | 100 | 请求路径访问的总次数阈值。 |
PrefixSwitch | Integer | 是 |
| 是否开启前缀匹配。
|
RulePriority | Integer | 是 | 0 | 规则执行优先级,数字越大优先级越低。 |
SingleThreshold | Integer | 是 | 10 | 每个统计对象访问的次数阈值。 |
Url | String | 是 | /cctest | 请求路径。 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Id | Integer | 否 | 56697 | 规则组ID |
Logic | Integer | 否 |
| 规则组中高级条件运算关系。
|
AccurateRules | Array of WafAccurateRuleItem | 否 | -- | 规则组的请求特征信息 |
AccurateGroupPriority | Integer | 否 | 1073741824 | 规则创建完成后,自动生成的规则组优先级 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
HttpObj | String | 否 |
| 自定义对象,与
|
ObjType | Integer | 否 |
| 匹配字段。
|
Opretar | Integer | 否 |
| 逻辑运算符。
|
Property | Integer | 否 | 0 | 固定取值为 0,取 HttpObj 的值用于匹配对应详情。 |
ValueString | String | 否 |
| 匹配内容。 说明 逻辑关系判断为 IP、 IPv4、 IPv6、私网 IP 或公网 IP 时不需要填写。 |
无。
POST https://open.volcengineapi.com/?Action=UpdWebDefCcRule&Version=2023-03-08 Host: https://open.volcengineapi.com Content-Type: application/json; charset=UTF-8 X-Date: 20240610T082509Z X-content-Sha256: 287e874e******d653b44d21e Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20240610/cn-beijing/AdvDefence/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f { "AccurateGroup": { "Id": 56697, "Logic": 1, "AccurateRules": [ { "HttpObj": "request.method", "ObjType": 2, "Opretar": 2, "Property": 0, "ValueString": "GET" } ], "AccurateGroupPriority": 1073741824 }, "CCType": 7, "CountTime": 60, "DdosId": 70, "EffectTime": 60, "Enable": 1, "Field": "HEADER:User-Agent", "Host": "www.test.com", "Name": "test", "PathThreshold": 100, "PrefixSwitch": 0, "RulePriority": 0, "SingleThreshold": 10, "Url": "/cctest" }
{ "ResponseMetadata": { "RequestId": "20230604110420****100232280022D31", "Action": "UpdWebDefCcRule", "Version": "2023-03-08", "Service": "AdvDefence", "Region": "cn-beijing" } }