文档中心

Web应用防火墙

漏洞防护

UpdateCustomSystemVulRule - 更新自定义漏洞规则

更新自定义模式下各个规则的开启状态。

注意事项

服务接口调用总上限：1000 QPS

单账号调用上限：50 QPS

请求说明

请求方式：POST

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

请求参数

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

Query

Action String 必选示例值：UpdateCustomSystemVulRule

接口名称。当前 API 的名称为 UpdateCustomSystemVulRule。

Version String 必选示例值：2023-12-25

接口版本。当前 API 的版本为 2023-12-25。

Body

Host String 可选示例值：example.volcwaf001.com

对应的防护网站域名，当HostAddType为1（默认值）或未传HostAddType时使用。

ProjectName String 可选示例值：default

当前资源关联的项目名称，仅可关联当前身份下具有权限的项目。项目名称可通过调用ListProjectResources接口获取。

SystemRuleSwitch Object[] 必选示例值：--

自定义规则开关详情，配置多个规则则需要传入多组元素。

CustomSystemRuleSwitch Integer 可选示例值：1

每个规则的开关。

0：关闭

1：开启

RuleID Integer 必选示例值：1059

系统规则的唯一标识，取值来源于调用ListVulnerabilityRule接口返回的RuleDetail.RuleID。

HostAddType Integer 可选示例值：1

指定域名的设置方式，默认值为 1。支持的取值如下所示。

1：单域名；

3：域名列表。

HostList String[] 可选示例值： ["a.b.com"]

当HostAddType取值为3时使用的多域名列表，数组元素为已接入当前WAF实例的域名且不能重复。

返回参数

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

错误码

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

输入示例 1

输入示例

POST https://waf.volcengineapi.com/?Action=UpdateCustomSystemVulRule&Version=2023-12-25&ProjectName=default
X-Date: 20230711T035055Z
Authorization: HMAC-SHA256 Credential=AKLTNGU0OGEyMT***/20230711/cn-beijing/waf/request, SignedHeaders=content-type;x-content-sha256;x-date, Signature=da4fac562d00f41ad8***

{
  "Host": "example.volcwaf001.com",
  "HostAddType": 1,
  "SystemRuleSwitch": [
    {
      "CustomSystemRuleSwitch": 1,
      "RuleID": 1059
    }
  ]
}

输出示例

{
    "ResponseMetadata": {
        "RequestId": "20231009200242CE25C146B591DDCE****",
        "Action": "UpdateCustomSystemVulRule",
        "Version": "2023-12-25",
        "Service": "waf",
        "Region": "cn-beijing"
    },
    "Result": {}
}

最近更新时间：2026.06.03 17:05:16

这个页面对您有帮助吗？

有用

无用