文档中心

Web应用防火墙

网站设置

UpdateDomain - 更新云 WAF 实例的防护网站信息

更新已添加的域名防护信息，包括接入能力、回源配置等参数。

注意事项

更新防护网站信息时的请求参数为网站的全量参数，如不传入，则对应参数会被默认值覆盖。建议您先查询对应网站的详情，参考ListDomain-查询云 WAF 实例防护网站信息。

域名、接入协议、接入端口和回源方式不可修改。

请求说明

请求方式：POST

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

请求参数

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

Query

Action String 必选示例值：UpdateDomain

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

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

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

Body

ProjectName String 可选示例值：default

所属项目资源名称，获取方式可参考ListDomain-查询云 WAF 实例防护网站信息。

TLSEnable Integer 可选示例值：1

是否开启日志服务。默认为关闭。

0：关闭

1：开启

说明

更新域名时不填则为关闭状态。

SSLProtocols String[] 可选示例值："TLSv1","TLSv1.1","TLSv1.2","TLSv1.3"

TLS 协议版本。仅CNAME 方式接入，且协议类型包括 HTTPS 时需要配置，默认为全部勾选。支持以下版本：

TLSv1

TLSv1.1

TLSv1.2

TLSv1.3

说明

不支持仅选择 TLSv1和TLSv1.2

支持选择以下几个组合：

TLSv1 和 TLSv1.1

TLSv1 和 TLSv1.1

TLSv1、TLSv1.1和TLSv1.2

SSLCiphers String[] 可选示例值："AES128-SHA","ECDHE-RSA-AES256-SHA","ECDHE-RSA-AES128-SHA","ECDHE-ECDSA-AES256-SHA"

SSL 加密套件列表，用于指定 HTTPS 协议支持的加密算法组合。仅CNAME 方式接入，且协议类型包括 HTTPS 时需要配置。

不同 TLS 协议版本支持的加密套件不同，每个选择的 TLS 协议版本必须至少有一个对应的加密套件。对应关系如下：

TLSv1

ECDHE-ECDSA-AES128-SHA

ECDHE-ECDSA-AES256-SHA

ECDHE-RSA-AES128-SHA

ECDHE-RSA-AES256-SHA

AES128-SHA

AES256-SHA

DES-CBC3-SHA

TLSv1.1

ECDHE-ECDSA-AES128-SHA

ECDHE-ECDSA-AES256-SHA

ECDHE-RSA-AES128-SHA

ECDHE-RSA-AES256-SHA

AES128-SHA

AES256-SHA

DES-CBC3-SHA

TLSv1.2

ECDHE-ECDSA-AES128-SHA

ECDHE-ECDSA-AES256-SHA

ECDHE-RSA-AES128-SHA

ECDHE-RSA-AES256-SHA

AES128-SHA

AES256-SHA

DES-CBC3-SHA

ECDHE-ECDSA-AES128-GCM-SHA256

ECDHE-ECDSA-AES256-GCM-SHA384

ECDHE-ECDSA-AES128-SHA256

ECDHE-ECDSA-AES256-SHA384

ECDHE-RSA-AES128-GCM-SHA256

ECDHE-RSA-AES256-GCM-SHA384

ECDHE-RSA-AES128-SHA256

ECDHE-RSA-AES256-SHA384

AES128-GCM-SHA256

AES256-GCM-SHA384

AES128-SHA256

AES256-SHA256

TLSv1.3

TLS_AES_128_GCM_SHA256

TLS_AES_256_GCM_SHA384

TLS_CHACHA20_POLY1305_SHA256

TLS_AES_128_CCM_SHA256

TLS_AES_128_CCM_8_SHA256

说明

每个选择的 TLS 协议版本必须至少有一个对应的加密套件。

Region String 必选示例值：cn-beijing

云 WAF 实例所在区域。

华北 2（北京）：cn-beijing

华东 2（上海）：cn-shanghai

华南 1（广州）：cn-guangzhou

亚太东南（柔佛）：ap-southeast-1

PublicRealServer Integer 可选示例值：1

CNAME 接入回源方式，仅 CNAME 方式接入时需要配置。当前仅支持：

1：公网回源

ProxyWriteTimeOut Integer 可选示例值：60

WAF 将请求传输到后端服务器的超时时间，仅CNAME 方式接入时需要配置。支持 30-3600 秒，默认为 60 秒。

ProxyRetry Integer 可选示例值：3

WAF 回源重试次数，仅CNAME 方式接入时需要配置。支持 1-10 次，默认为 3 次。

ProxyReadTimeOut Integer 可选示例值：60

WAF 从后端服务器读取响应的超时时间，仅CNAME 方式接入时需要配置。支持 0-900 秒，默认为 60 秒。

ProxyKeepAliveTimeOut Integer 可选示例值：15

空闲长连接超时时间，仅CNAME 方式接入时需要配置。支持 1-60 秒，默认为 15 秒。

ProxyKeepAlive Integer 可选示例值：100

WAF 回源长连接可复用个数，仅CNAME 方式接入时需要配置。支持 60-1000 个，默认为 100 个。

ProxyConnectTimeOut Integer 可选示例值：4

WAF 和后端服务器的建连超时时间，仅CNAME 方式接入时需要配置。支持 4-120 秒，默认为 4 秒。

ProxyConfig Integer 可选示例值：1

是否开启代理配置，默认为关闭。

0：关闭

1：开启

ClientIPLocation Integer 可选示例值：1

客户端 IP 获取方式，用于指定 WAF 实例如何获取客户端的真实 IP 地址。当您的业务使用代理（ProxyConfig=1）时需要配置。

0：通过自定义 Header 字段获取，需要配置具体的CustomHeader。

1：通过 X-Forwarded-For（XFF）字段中第一个公网 IP 地址获取。

2：从 TCP 的option字段获取客户端IP，覆盖X-Real-IP字段，同时添加在X-Forwarded-For字段最左侧

ProtocolFollow Integer 可选示例值：1

是否开启协议跟随功能，开启后，WAF 将根据客户端请求的协议类型（HTTP/HTTPS）自动匹配回源协议。仅CNAME 方式接入时需要配置，默认值为 0（关闭）。

0：关闭

1：开启

说明

开启协议跟随时，需在 Protocols 字段中同时勾选 HTTP 和 HTTPS 协议。

该功能适用于需要保持客户端-WAF-源站协议一致性的场景。

LBAlgorithm String 可选示例值：wrr

负载均衡算法类型。用于指定 WAF 实例在回源时采用的负载均衡策略。仅CNAME 方式接入时需要配置。

wrr：加权轮询

wlc：加权最小连接数

sh：源地址哈希

KeepAliveTimeOut Integer 可选示例值：75

长连接保持时间，仅CNAME 方式接入时需要配置。支持 0-900 秒，默认为 75 秒。

KeepAliveRequest Integer 可选示例值：100

长连接复用个数，用于指定 WAF 实例在回源时保持的长连接可复用请求数。仅CNAME 方式接入时需要配置。支持 60-1000 个，默认为 100个。

EnableIPv6 Integer 可选示例值：0

是否开启 IPv6 支持，仅CNAME 方式接入时需要配置。默认为0（关闭）。

0：关闭

1：开启

EnableHTTP2 Integer 可选示例值：0

是否开启 HTTP 2.0，仅CNAME 方式接入时需要配置。默认为0（关闭）。

0：关闭

1：开启

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

防护的域名信息，支持泛域名和精确域名。

ClientMaxBodySize Integer 可选示例值：10000

客户端请求 body 的最大值，用于限制客户端上传数据的体积。仅CNAME 方式接入时需要配置。支持 1-10240 MB，默认值为 60MB。

AccessMode Integer 必选示例值：20

接入模式。

10：CNAME 接入

11：负载均衡（CLB） 7 层监听器接入

20：应用型负载均衡（ALB）实例接入

Protocols String[] 可选示例值：HTTP

接入协议类型，仅CNAME 方式接入时需要配置。支持单选和多选。

HTTP

HTTPS

说明

当EnableHTTP2=1时，需勾选HTTPS。

当ProtocolFollow=1时，需同时勾选HTTP和HTTPS。

ProtocolPorts Object 可选示例值：--

接入端口信息，仅CNAME 方式接入时需要配置。

HTTP Integer[] 可选示例值：[80]

HTTP 协议支持的端口列表，用于指定 WAF 实例在 CNAME 接入方式下监听的 HTTP 协议端口。

HTTPS Integer[] 可选示例值：[443, 8443]

HTTPS 协议支持的端口列表，用于指定 WAF 实例在 CNAME 接入方式下监听的 HTTPS 协议端口。

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

回源配置详情，仅CNAME 方式接入时需要配置。

Name String 可选示例值：default

源站组名称。预置默认分组（名称为default），您可以直接在默认分组中添加源站信息，也可以新建源站组。

长度1～15个字符。

仅支持中文、英文、数字、下划线，不支持特殊字符。

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

每个源站的配置详情，包括源站协议、源站地址、源站端口以及权重信息。

IP String 可选示例值：10.249.**.**

源站的 IP 地址，用于指定 WAF 实例回源时访问的后端服务器地址。

Port Integer 可选示例值：80

源站的端口号，用于指定 WAF 实例回源时访问后端服务器的端口。

Weight Integer 可选示例值：100

源站规则的权重，用于指定在负载均衡算法为加权轮询（wrr）或加权最小连接数（wlc）时，各源站的请求分配比例。

取值范围为 1-100，默认为 100。权重越高，分配的请求越多。

当负载均衡算法为源站地址哈希（sh）时无需填写。

Protocol String 可选示例值：HTTP

源站的请求协议，用于指定 WAF 实例回源时访问后端服务器所使用的协议类型。支持的取值如下所示：

HTTP：HTTP 协议；

HTTPS：HTTPS 协议。

同一个域名下所有源站组内的源站协议全局保持一致。

AccessPort Integer[] 可选示例值：[80]

接入端口号，用于标识源站组对应的生效接入端口，与ProtocolPorts的端口号信息一致。

仅自定义源站组需要配置，默认分组将统一对所有未关联到自定义源站组的接入端口号生效。

例如接入端口号信息为HTTP：80，81和HTTPS：443，自定义分组中添加了80，则默认分组对接入的81和443端口生效。

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

负载均衡接入参数配置，仅应用型负载均衡（ALB）方式或负载均衡（CLB）7 层方式接入时需要配置。用于指定 WAF 实例通过负载均衡方式接入时的相关参数，支持配置多个负载均衡实例。

Port String 可选示例值：80

负载均衡监听器监听的端口号，仅负载均衡（CLB）7 层方式接入时需要配置。获取方式，请参考DescribeListeners。

Protocol String 可选示例值：HTTP

负载均衡监听器协议类型，仅负载均衡（CLB）7 层方式接入时需要配置。获取方式，请参考DescribeListeners。

InstanceID String 可选示例值：clb-5fwg9tybr5s073inqkbl****

负载均衡实例 ID。

负载均衡（CLB）7 层方式接入：请参考DescribeLoadBalancers获取实例 ID。

应用型负载均衡方式接入：请参考DescribeLoadBalancers获取实例 ID。

ListenerID String 可选示例值：lsn-3qdz125x0bfuo7prml113****

负载均衡监听器 ID，仅负载均衡（CLB）7 层方式接入时需要配置。获取方式，请参考DescribeListeners。

CustomHeader String[] 可选示例值："abcd","test"

自定义 Header 字段列表，用于指定 WAF 实例在转发请求时添加的自定义 HTTP 头部信息。

当客户端 IP 获取方式为自定义 Header 字段，即ClientIPLocation=0时需要填写。

最多支持配置 5 个自定义 Header。

VolcCertificateID String 可选示例值：cert-42361e9491154d07b03b46be277d****

托管至证书中心的证书 ID，仅CNAME 方式接入，且协议类型包括 HTTPS 时需要配置。可通过CertificateGetInstanceList - 获取证书实例列表查询当前账号下的证书实例 ID 信息。

CertificatePlatform String 可选示例值：waf

证书托管平台:

waf：Web 应用防火墙

certificate-service：证书服务中心

CustomSNI String 可选示例值：example2.com

自定义 SNI，仅CNAME 方式接入，且开启 SNI （EnableSNI=1）时需要配置。

如果您的源站 IP 绑定了多个域名，且 WAF 以 HTTPS 协议回源访问您的源站，您需要配置回源 SNI（Server Name Indication）指明请求的具体域名。源站根据配置的 SNI 名称返回对应域名的 SSL 证书，以确保正常回源。

如果未配置域名，则根据流量中的实际 host 回源。

EnableCustomRedirect Integer 可选示例值：1

是否开启非标端口强制重定向，仅CNAME 方式接入，且协议类型包括 HTTPS 时需要设置。默认为 0（不开启）。

0：不开启强制重定向

1：开启强制重定向

开启后，当用户通过非标准 HTTPS 端口访问时，WAF 会自动将请求重定向至标准 HTTPS 端口（443）。

EnableSNI Integer 可选示例值：1

是否开启 SNI（Server Name Indication）配置，用于在 HTTPS 回源时指明请求的具体域名。仅CNAME 方式接入时需要设置，默认为 0（关闭）。

0：关闭

1：开启

当开启时，需配合 CustomSNI字段指定回源域名。

TLSFieldsConfig Object 可选示例值：--

日志采集字段自定义配置。

HeadersConfig Object 可选示例值：--

用于配置 TLS 日志中 HTTP 头部字段的采集行为。

Enable Integer 可选示例值：1

是否在日志中包含 HTTP 头部字段，默认为 0（不包含）。支持的取值如下所示。

0：关闭，仅记录常见头部字段；

1：开启，记录全量头部字段，并可配置例外字段和统计字段。

*ExcludedKeyList 排除不记录的字段，通过 StatisticalKeyList配置用于统计分析的字段。

ExcludedKeyList String[] 可选示例值：["X-Sensitive-Data", "Authorization"]

例外 HTTP 头部字段列表，用于指定在记录全量 header 时排除不记录的字段。当 HeadersConfig.Enable 为 1时生效。

配置后，对应字段将不会出现在日志的 JSON 数据中，可帮助节约日志存储空间。

StatisticalKeyList String[] 可选示例值：["User-Agent","Referer","X-Forwarded-For"]

用于日志统计分析和告警的 HTTP 头部字段列表，当 HeadersConfig.Enable 为 1时生效。

配置后，对应字段将用于日志统计分析和告警。

返回参数

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

错误码

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

修改 CNAME 方式接入的网站信息

修改应用型负载均衡（ALB）实例方式接入的网站信息

修改负载均衡（CLB）7 层接入的网站信息

输入示例

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

{
  "ProjectName": "default",
  "Region": "cn-beijing",
  "AccessMode": 10,
  "ClientIPLocation": 2,
  "Domain": "example.volcwaf001.com",
  "PublicRealServer": 1,
  "ProtocolFollow": 0,
  "EnableHTTP2": 0,
  "EnableIPv6": 0,
  "Protocols": [
    "HTTP"
  ],
  "LBAlgorithm": "wrr",
  "ProxyConfig": 1,
  "TrafficTagConfig": {},
  "TLSEnable": 1,
  "TLSFieldsConfig": {
    "HeadersConfig": {
      "Enable": 0
    }
  },
  "ClientMaxBodySize": 60,
  "KeepAliveTimeOut": 75,
  "KeepAliveRequest": 100,
  "ProxyConnectTimeOut": 4,
  "ProxyWriteTimeOut": 60,
  "ProxyReadTimeOut": 60,
  "ProxyKeepAlive": 100,
  "ProxyRetry": 3,
  "ProxyKeepAliveTimeOut": 15,
  "CertificatePlatform": "certificate-service",
  "ProtocolPorts": {
    "HTTP": [
      80,
      81
    ],
    "HTTPS": []
  },
  "BackendGroups": [
    {
      "AccessPort": [
        80,
        81
      ],
      "Backends": [
        {
          "Protocol": "HTTP",
          "Port": 80,
          "IP": "180.184.**.**",
          "Weight": 100
        }
      ],
      "Name": "default"
    }
  ]
}

输出示例

{
    "ResponseMetadata": {
        "RequestId": "20251014191226****7166BE0C92B4B584",
        "Action": "UpdateDomain",
        "Version": "2023-12-25",
        "Service": "waf",
        "Region": "cn-beijing"
    },
    "Result": null
}

最近更新时间：2025.11.20 16:39:05

这个页面对您有帮助吗？

有用

无用