如果您的防护网站接入了火山引擎应用型负载均衡(ALB)实例,可以通过 ALB 与监听器方式接入云 WAF 防护。
本接口适用于通过负载均衡与监听器方式添加防护网站,如果您的控制台为最新版本(支持通过 ALB 实例方式接入),可通过负载均衡实例方式添加防护网站,详情请参考CreateDomain-通过应用型负载均衡(ALB)实例方式接入。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
Region | String | 是 |
| 云 WAF 实例所在区域。
|
AccessMode | Integer | 是 |
| 接入模式。应用型负载均衡接入时请填入
|
ClientIPLocation | Integer | 否 |
| 客户端 IP 获取方式。
|
Domain | String | 是 |
| 需要防护的域名信息,支持泛域名和精确域名。 |
TLSEnable | Integer | 否 |
| 是否开启日志服务,默认为开启。
|
ProxyConfig | Integer | 否 |
| 是否开启代理配置,默认为关闭。
|
CloudAccessConfig | Array of CloudAccessConfig objects | 是 | - | 应用型负载均衡配置。 |
参数 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
InstanceID | String | 是 |
| 应用型负载均衡实例 ID。获取方式,请参考DescribeLoadBalancers。 |
ListenerID | String | 是 |
| 应用型负载均衡监听器 ID。获取方式,请参考DescribeListeners。 |
Protocol | String | 是 |
| 监听器协议类型。获取方式,请参考DescribeListeners。 |
Port | Integer | 是 |
| 监听器对应的端口号。获取方式,请参考DescribeListeners。 |
AccessProtocol | String | 是 |
| 接入协议,需要与监听协议保持一致。 |
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
Domain | String |
| 防护网站域名。 |
Cname | String | - | WAF 实例生成的 CNAME 值。应用型负载均衡接入时该值为空。 |
ServerIps | String | - | WAF 防护实例的 IP。应用型负载均衡接入时该值为空。 |
POST https://open.volcengineapi.com/?Action=CreateDomain&Version=2023-12-25 X-Date: 20230711T035055Z Authorization: HMAC-SHA256 Credential=AKLTNGU0OGEyMT***/20230711/cn-beijing/waf/request, SignedHeaders=content-type;x-content-sha256;x-date, Signature=da4fac562d00f41ad8*** { "Region": "cn-beijing", "AccessMode": 12, "ClientIPLocation": 1, "Domain": "example.volcwaf001.com", "TLSEnable": 1, "ProxyConfig": 1, "CloudAccessConfig": [ { "InstanceID": "alb-2wxp9jkmrl3wg7ootqnl8****", "ListenerID": "lsn-3qdz125x0bfuo7prml113****", "AccessProtocol": "HTTP", "Protocol": "HTTP", "Port": "80" } ] }
{ "ResponseMetadata": { "RequestId": "2024013121155819E39E763AACD04E****", "Action": "CreateDomain", "Version": "2023-12-25", "Service": "waf", "Region": "cn-beijing" }, "Result": { "Domain": "example.volcwaf001.com", "Cname": "", "ServerIps": "" } }