文档中心

云防火墙

DNS防火墙

DescribeDnsControlPolicy-查询域名黑名单访问控制策略列表

DescribeDnsControlPolicy-查询域名黑名单访问控制策略列表

查询域名黑名单访问控制策略列表。

请求说明

请求方式：POST

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

调试

API Explorer

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

请求参数

Query

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

Body

参数	类型	是否必选	示例值	描述
Description	String	否	Description	查询条件，模糊查询。描述信息。
Destination	Array of String	否	********.com	查询条件，模糊查询。访问目的，多个值间为或条件。每个值使用模糊查询查询时会先根据查询条件关联地址簿的名字和内容再进行查询。
InternetFirewallId	String	否	ifw-****	互联网边界防火墙实例ID，获取方式可参考AssetList - 查询互联网边界资产列表。
OrderDir	String	否	desc	按优先级排序，支持的取值如下所示。 asc：升序，即优先级字段从小到大，优先级顺序从高到低 desc：降序，即优先级字段从大到小，优先级顺序从低到高
PageNumber	Integer	否	1	分页页码，默认值为 1。
PageSize	Integer	否	10	分页大小，默认值为 10，最大值为 1000。
RuleId	Array of String	否	f04ac7ce-**---**********	访问控制策略唯一标识ID，模糊查询，多个取值之间为或的关系。获取方式可参考DescribeDnsControlPolicy-查询域名黑名单访问控制策略列表。
Source	Array of String	否	vpc-********	访问源地址，VPC列表，模糊查询，多个取值之间为或的关系。获取方式可参考DescribeVpcs-查询VPC列表。
Status	Array of Boolean	否	true	策略状态，精确查询，多个取值之间为或的关系。

返回参数

参数	类型	示例值	描述
Count	Integer	1	返回数据的实际数量，当查询数据为空且使用 Python SDK 调用时此项为 None。
Data	Array of DnsControlPolicyDetail	--	数据详情，包含域名黑名单访问控制策略的具体信息列表。
PageNumber	Integer	1	返回数据的分页页码，表示当前查询结果所在的页码。
PageSize	Integer	10	返回数据的分页大小，表示每页显示的记录数量。
TotalCount	Integer	100	返回数据的总数量，当查询数据为空且使用 Python SDK 调用时此项为 None。

DnsControlPolicyDetail

参数	类型	示例值	描述
HitCnt	Integer	10	命中计数，表示该域名黑名单访问控制策略被触发的次数。
RuleId	String	f04ac7ce-**---**********	访问控制策略的唯一标识 ID，用于区分不同的域名黑名单策略。
Source	Array of SourceStructure	--	访问源信息，包含 VPC 列表，每个 VPC 包含以下属性。 VpcId：VPC 的唯一标识 ID； Region：VPC所在的地域信息。
Status	Boolean	true	表示域名黑名单访问控制策略的开关状态。 false：关闭； true：开启。
UseCount	Integer	10	表示该域名黑名单访问控制策略占用的策略数量。
AccountId	String	2100******	用户的唯一标识 ID，用于区分不同的用户账号。
DomainList	Array of String	["example.com","test.com"]	如果目的类型为地址簿，返回域名地址簿的域名列表。
Description	String	允许来自特定IP段的入站SSH访问	访问控制策略的描述信息，用于记录该策略的用途、备注或其他相关信息。
Destination	String	example.com	访问目的，可以是域名或域名地址簿的唯一标识 ID。当目的类型为 domain 时，此处填写具体的域名；当目的类型为 group 时，此处填写域名地址簿的唯一标识 ID。
LastHitTime	Integer	1703157199	最近命中时间戳，表示该域名黑名单访问控制策略最后一次被触发的时间，以 Unix 时间戳格式返回。
DomainListV1	Array of AddressStructureResp	--	如果目的类型为地址簿，返回域名地址簿的域名列表，每个域名地址簿包含以下属性。 Type：地址类型； Address：具体地址信息； Description：描述信息。
DestinationType	String	group	访问目的的类型，取值如下所示。 domain：表示目的为单个域名； group：表示目的为域名地址簿。
DestinationGroupList	Array of String	["7d54a3cf-**---**********"]	如果目的类型为地址簿，返回域名地址簿名称列表。每个名称对应一个域名地址簿的唯一标识 ID。

SourceStructure

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

AddressStructureResp

参数	类型	示例值	描述
Type	String	port	地址类型，支持的取值如下所示。 ip：IPv4 地址； ipv6：IPv6 地址； domain：域名； port：端口。
Address	String	22/22	具体地址值，其格式取决于 GroupType 的取值：当GroupTyp为ip时，对应 IPv4 地址或 CIDRv4 信息；当GroupTyp为ipv6时，对应 IPv6 地址或 CIDRv6 信息；当GroupTyp为port时，对应端口信息；当GroupTyp为domain时，对应域名信息。
Description	String	允许 SSH 访问	描述信息，用于记录相关用途、备注或其他相关信息。

请求示例

返回示例

错误码

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

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

这个页面对您有帮助吗？

有用

有用

无用

无用