文档中心

Web应用防火墙

网站设置

ModifyServiceDefenceMode - 更新域名防护模式

已添加的域名默认为“启用防护”状态，即按域名对应的防护策略启用 WAF 防护。您可以调用 ModifyServiceDefenceMode 接口，更新指定域名的防护模式。

使用说明

ALB 接入方式下，存在多个实例同时接入且按实例维度回源。通过该方式接入的防护网站，支持在设定防护模式的基础上，配置例外实例，即为不同 ALB 实例的流量来源配置不同的防护模式。

未配置例外实例时，网站的防护模式即为基础防护模式，包括“启用防护/暂停防护/回源模式”。

如配置了例外实例，网站的防护模式会显示为“部分防护/部分暂停/部分回源”。

注意事项

防护模式会对 ALB 实例关联的所有域名同时生效。

请求说明

请求方式：POST

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

请求参数

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

Query

Action String 必选示例值：ModifyServiceDefenceMode

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

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

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

Body

ExtraDefenceModeLBInstance Object[] 可选示例值：--

例外实例的防护模式。

当接入模式为通过应用型负载均衡（ALB）实例接入（AccessMode=20）时生效。

ALB 实例接入模式下，存在多个实例同时接入且按实例维度回源。通过该方式接入的防护网站，支持在设定防护模式的基础上，配置例外实例，即为不同 ALB 实例的流量来源配置不同的防护模式。

InstanceID String 必选示例值：alb-3rey4fwmd8jcw5zsk2hr2****

关联的 ALB 实例 ID，获取方式可参考ListDomain-查询云 WAF 实例防护网站信息。

DefenceMode Integer 可选示例值：1

为例外 ALB 实例设置防护模式。

1：启用防护，已配置的防护策略生效。

2：暂停防护，仅执行转发而不检测，已配置的防护策略不生效。

3：回源模式，直接将请求解析至源站，不再转发至 WAF 实例。

设置例外防护实例后，域名可能还会存在以下防护状态：

5：部分启用，默认防护模式为启用防护，但存在例外实例为暂停防护或回源模式状态。

6：部分暂停，默认防护模式为暂停防护，但存在例外实例为启用防护或回源模式状态。

7：部分回源，默认防护模式为回源模式，但存在例外实例为启用防护或暂停防护状态。

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

需要修改防护模式的网站域名。

DefenceMode Integer 必选示例值：1

实例的防护模式。

1：启用防护，已配置的防护策略生效。

2：暂停防护，仅执行转发而不检测，已配置的防护策略不生效。

3：回源模式，直接将请求解析至源站，不再转发至 WAF 实例。

ProjectName String 可选示例值：default

所属项目资源名称，获取方式可参考ListProjectResources - 获取项目资源列表。

返回参数

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

错误码

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

输入示例 1

输入示例 2

输入示例

POST https://waf.volcengineapi.com/?Action=ModifyServiceDefenceMode&Version=2023-12-25

{
    "ExtraDefenceModeLBInstance": [
        {
            "InstanceID": "alb-3rey4fwmd8jcw5zsk2hr2****",
            "DefenceMode": 2
        }
    ],
    "Host": "example.volcwaf001.com",
    "DefenceMode": 1,
    "ProjectName": "default"
}

输出示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "ModifyServiceDefenceMode",
        "Version": "2023-12-25",
        "Service": "waf",
        "Region": "cn-beijing"
    }
}

最近更新时间：2026.01.20 15:17:11

这个页面对您有帮助吗？

有用

无用