AI 助理
文档备案控制台
官方文档
首页

AddDnsFirewallPolicy - 添加DNS防火墙ACL

更新时间：
复制 MD 格式
产品详情
我的收藏

添加DNS防火墙ACL。

接口说明

使用本接口创建 DNS 防火墙访问控制策略，对经过 DNS 防火墙的流量执行放行、拒绝或观察。

配额说明

DNS 防火墙策略在 DNS 策略表中独立计数（按 IP 版本分别统计），但与互联网访问控制策略共用同一套配额上限（按云防火墙版本档位确定）。单条策略展开后的地址组合数超限，或用户策略总数超限时，返回 ErrorAclExtendedCountExceed（-200139）。

说明

DescribeAclCheckQuota 返回的是「ACL 策略检查（体检）次数」配额，与策略条数配额无关，不能用于预判本接口的配额是否足够；策略条数配额请在云防火墙控制台确认。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。

  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

    • 对于必选的资源类型，用前面加 * 表示。

    • 对于不支持资源级授权的操作，用全部资源表示。

  • 条件关键字：是指云产品自身定义的条件关键字。

  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

yundun-cloudfirewall:AddDnsFirewallPolicy

get

*DnsFirewallPolicy

acs:yundun-cloudfirewall::{#accountId}:dnsfirewallpolicy/*

 无 无

请求参数

名称

类型

必填

描述

示例值
SourceIp

string

否

访问者源 ip 地址。

140.205.118.97
Lang

string

否

请求和接收消息的语言类型。取值：-zh：中文-en：英文

zh
AclAction

string

是

安全访问控制策略中流量通过云防火墙的方式。取值：

  • accept：放行

  • drop：拒绝

  • log：观察

log
Description

string

是

访问控制策略的描述信息。

放行指定域名
Destination

string

是

安全访问控制策略中的目的地址。

  • 当 DestinationType 为 net 时，Destination 为目的 CIDR。例如：1.2.3.4/24

  • 当 DestinationType 为 group 时，Destination 为目的地址簿名称。例如：db_group

  • 当 DestinationType 为 domain 时，Destination 为目的域名。例如：*.aliyuncs.com

  • 当 DestinationType 为 location 时，Destination 为目的区域（具体区域位置编码见后文）。例如： ["BJ11", "ZB"]

db_group
DestinationType

string

是

DNS 防火墙访问控制策略的目的地址类型。仅支持 group（目的地址簿）和 domain（目的域名）；net 与 CIDR 地址不适用于本接口。

domain
Direction

string

否

DNS 防火墙访问控制策略的流量方向。

说明

本参数不参与后端校验：创建和修改 DNS 防火墙策略时，方向恒按 out（内对外）落库，传入 in 既不会报错也不会生效。DNS 防火墙仅支持出方向策略。

out
Source

string

是

访问控制策略中的源地址。取值：

  • 当 SourceType 为net时，Source 为源 CIDR 地址，例如：10.2.XX.XX/24

  • 当 SourceType 为group时，Source 为源地址簿名称，例如：db_group。

192.168.0.223/32
SourceType

string

是

访问控制策略中的源地址类型。取值：

  • net：源网段（CIDR）

  • group：源地址簿

net
Priority

string

是

新建 DNS 防火墙策略的优先级。取值范围为 1～20000，数值越小，策略优先级越高。

1
Release

string

是

访问控制策略的启用状态。策略创建后默认启用该策略。取值：

  • true：启用访问控制策略

  • false：不启用访问控制策略

true
IpVersion

string

是

支持的 IP 地址版本。

取值：

  • 4：表示 IPv4 地址

  • 6：表示 IPv6 地址

枚举值：

  • 4 :

    IPv4

  • 6 :

    IPv6

4

返回参数

名称

类型

描述

示例值

object

AclUuid

string

安全访问控制策略的唯一标识 ID。

f88dae6f-XXX-XXX-613de9ab2be8
RequestId

string

结果的请求 id。

71209DFE-XXX-XXX-52B4A4E9DA3B

示例

正常返回示例

JSON格式

{
  "AclUuid": "f88dae6f-XXX-XXX-613de9ab2be8",
  "RequestId": "71209DFE-XXX-XXX-52B4A4E9DA3B"
}

错误码

HTTP status code

错误码

错误信息

描述
400 ErrorParametersUid The aliUid parameter is invalid. aliUid 不合法
400 ErrorDBSelect An error occurred while querying database. 内部错误：数据库查询错误
400 ErrorParameterIpVersion The IP version is invalid. IP版本参数错误
400 ErrorParametersSource The source is invalid. 无效的来源
400 ErrorParametersDestination The Destination parameter is invalid. Destination参数非法
400 ErrorParametersAction The action is invalid. 无效的动作
400 ErrorParametersNewOrder The newOrder is invalid. 无效的newOrder
400 ErrorParameters Parameters error. 参数错误。
400 ErrorAddressCountExceed The maximum number of addresses is exceeded. 地址簿内地址数量超出上限
400 ErrorDBInsert An error occurred while performing an insert operation in the database. 内部错误：数据库插入错误
400 ErrorRecordLog An error occurred while updating the operation log. 写日志失败
400 ErrorMarshalJSON An error occurred while encoding JSON. 内部错误：JSON编码错误
400 ErrorAclExtendedCountExceed ACL or extended ACL rules are not matched. ACL或扩展ACL规格超出限制
400 ErrorAclRuleDuplicate acl rule duplicate. 相同策略以存在。
400 ErrorUUIDNew The UUID is invalid. 内部错误：UUID错误

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。

上一篇：DescribePrefixLists - 查询前缀列表下一篇：ModifyDnsFirewallPolicy - 修改DNS防火墙规则