UpdateBotAnalyseProtectRule - 更新 bot 频率限制或统计防护规则--Web应用防火墙-火山引擎

文档中心

立即注册

导航

UpdateBotAnalyseProtectRule - 更新 bot 频率限制或统计防护规则

最近更新时间：2025.06.04 10:43:44首次发布时间：2024.10.12 12:01:30

调用 UpdateBotAnalyseProtectRule 接口更新 bot 频率限制和统计防护规则都可以参考此接口，通过规则 ID 和传入不同的统计方式参数修改对应的规则。

注意事项

更新规则前，请调用ListBotAnalyseProtectRulePriorityAvailable接口查询可用的规则优先级，避免冲突。

请求说明

请求方式：POST
请求地址：https://waf.volcengineapi.com/?Action=UpdateBotAnalyseProtectRule&Version=2023-12-25

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

参数	类型	是否必填	示例值	描述
Action	String	是	UpdateBotAnalyseProtectRule	要执行的操作，取值：UpdateBotAnalyseProtectRule。
Version	String	是	2023-12-25	API的版本，取值：2023-12-25。

Body

参数	类型	是否必填	示例值	描述
StatisticalDuration	Integer	是	10	统计时长，单位：秒。取值范围：1～60。
StatisticalType	Integer	是	1	统计内容方式。 1：访问频率 2：重复次数 3：重复占比
Field	String	是	HEADER:User-Agent	统计对象，多个对象用逗号分隔。格式为`类型:对应值`。自定义 Header。格式为`HEADER:具体参数`，例如`HEADER:Authorization` 自定义 Cookie。格式为`COOKIE:具体参数`，例如`COOKIE:PHPSESSId`。自定义参数。格式为`ARGS:具体参数`，例如`ARGS:device_Id`。源 IP。直接配置为`CLIENTIP`。
AccurateGroup	Array of Object	否	--	高级条件详情。
ActionAfterVerification	Integer	否	1	验证/挑战后执行动作 1：拦截 2：观察
ActionType	Integer	是	6	执行动作。 0：告警 1：限速 2：拦截 7：人机验证 8：JS 挑战 9：工作量证明 10：动态令牌 11：丢弃
EffectTime	Integer	是	50	限制时长，单位：秒。取值范围 1～86,400。
Enable	Integer	是	1	是否启用规则。 0：不启用 1：启用
ExemptionTime	Integer	否	60	豁免时间，当执行动作为人机挑战/JS/工作量证明时生效，单位：秒。取值范围：1～3600。
Host	String	是	example.volc001.com	需要更新防护规则的网站域名。
Name	String	是	Bot规则1	规则名称。
Path	String	是	/path	填写需要匹配规则的网站路径，可以是具体的某个页面 URL，也可以针对整个网站。某个具体的 URL 地址，例如需要对`test.com/test.html`设置规则，则填写 `/test.html`。支持填写通配符``，仅可出现一次，例如`/test/`。针对整个网站，则填写`/`即可。如需同时配置多个请求路径，请先将主请求路径配置为通配路径，再添加匹配字段为请求路径的条件。例如需要配置`/test/123.html`和`/test/abc.jpg`，则可参考如下操作：将请求路径设置为`/test/`。增加 2 条条件：条件一：请求路径等于`/test/123.html` 条件二：请求路径等于`/test/abc.jpg` 两者条件关系设置为`或`。
PathThreshold	Integer	否	1000	访问次数阈值，StatisticalType=1 （即统计类型为访问频率）时需要填写。
RulePriority	Integer	是	0	规则执行优先级。
SingleProportion	String	否	0.25	相同统计对象的 IP 占比，StatisticalType=3 （即统计内容方式为重复占比时）需要配置。格式：百分比对应的小数。例如，100% 则输入 1，50% 则输入 0.5。
SingleThreshold	Integer	是	100	相同统计对象的最大值。
Id	Integer	是	16	规则唯一标识符（对应`RuleTag`）的实际计数位，例如`RuleTag = K000001088116`，则`Id = 1088116`。获取方式可参考ListBotAnalyseProtectRule-查询 Bot 统计防护规则。
ProjectName	String	否	default	所属项目资源名称，获取方式可参考ListDomain-查询云 WAF 实例防护网站信息。

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

POST /?Action=UpdateBotAnalyseProtectRule&Version=2023-12-25 HTTP/1.1
Host: waf.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20250328T123637Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250328/cn-beijing/waf/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
  "StatisticalDuration": 10,
  "StatisticalType": 1,
  "Field": "HEADER:User-Agent",
  "AccurateGroup": [
    {
      "Logic": 1,
      "AccurateRules": [
        {
          "ValueString": "http",
          "Opretar": 2,
          "ObjType": 0,
          "HttpObj": "request.schema",
          "Property": 0
        }
      ]
    }
  ],
  "ActionAfterVerification": 1,
  "ActionType": 6,
  "EffectTime": 50,
  "Enable": 1,
  "ExemptionTime": 60,
  "Host": "example.volc001.com",
  "Name": "Bot规则1",
  "Path": "/path",
  "PathThreshold": 1000,
  "RulePriority": 0,
  "SingleProportion": "0.25",
  "SingleThreshold": 100,
  "Id": 1088116,
  "ProjectName": "default"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20250328203741165194224193C65BEE",
    "Action": "UpdateBotAnalyseProtectRule",
    "Version": "2023-12-25",
    "Service": "waf",
    "Region": "cn-beijing"
  },
  "Result": {}
}

错误码

您可访问公共错误码，获取更多错误码信息。