文档中心

云防火墙

DNS防火墙

AddDnsControlPolicy-新增域名黑名单访问控制策略

创建域名黑名单访问控制策略。

使用说明

访问控制策略会按策略内的访问源地址/区域数量、目的地址数量、目的端口数量统计占用策略配额数。

例如，某条规则访问源为区域类型，选择中国 3 个省级行政区和全部国际区域为访问源，访问目的地址簿内包含 4 个 IP 地址，目的端口地址簿内有 2 个端口，则占用策略数 =（3 + 2）* 4 * 2 = 40。

请求说明

请求地址：https://fw-center.volcengineapi.com/?Action=AddDnsControlPolicy&Version=2021-09-06

调试

API Explorer

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

请求参数

Query

参数	类型	是否必选	示例值	描述
Action	String	是	AddDnsControlPolicy	接口名称。当前 API 的名称为 AddDnsControlPolicy。
Version	String	是	2021-09-06	接口版本。当前 API 的版本为 2021-09-06。

Body

参数	类型	是否必选	示例值	描述
Description	String	否	description	策略描述信息，可用于说明策略的用途、作用等。
Destination	String	是	********.com	访问目的，可以是域名或域名地址簿的唯一标识 ID。当前仅支持一个地址簿。当 DestinationTyple为domain时：填写域名；当 DestinationTyple为group时：填写域名地址簿名称。
DestinationType	String	是	domain	目的类型，用于指定访问目的的类型。 domain：域名； group：地址簿。
InternetFirewallId	String	否	ifw-****	互联网边界防火墙实例ID，获取方式可参考AssetList - 查询互联网边界资产列表。
Source	Array of SourceStructure	是	--	访问源：VPC列表，获取方式可参考DescribeVpcs-查询VPC列表。

SourceStructure

参数	类型	是否必选	示例值	描述
VpcId	String	是	vpc-xxxx	VPC ID，获取方式可参考DescribeVpcs-查询VPC列表。
Region	String	是	cn-beijing	VPC 地域信息，获取方式可参考DescribeVpcs-查询VPC列表。

返回参数

参数	类型	示例值	描述
RuleId	String	f04ac7ce-**---**********	访问控制策略的唯一标识 ID，用于标识新增的域名黑名单访问控制策略。

请求示例

返回示例

错误码

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

最近更新时间：2025.08.11 12:01:34

这个页面对您有帮助吗？

有用

无用