新增互联网边界防火墙访问控制策略。

使用说明

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

每条规则占用的策略数 = 访问源数量 * 访问目的地址数量 * 目的端口数量。

其中访问源计数逻辑为：

访问源为 IP 地址/地址段时，统计为 1 条。

访问源为地址簿类型时，按地址簿内实际 IP 地址和地址段个数统计数量。

访问源为区域类型时，逻辑如下：

中国：每个省级行政区计为 1 条；全选计为 1 条。

国际区域：亚洲（国内除外）计为 2 条，其余每个洲各计为 1 条；全选计为 2 条。

中国+国际区域：按前两条规则计和，如果两者全选，计为 1 条。

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

请求说明

请求方式：POST

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

调试

API Explorer

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

去调试

请求参数

Query

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

Body

参数	类型	是否必选	示例值	描述
Action	String	是	accept	访问控制策略的动作： accept：放行 deny：阻断 monitor：观察
Description	String	否	test	描述信息
DestPort	String	否	22/22	访问控制策略中的目的端口。格式为单个端口22，端口范围100/200：当协议类型为ICMP/ALL时，取值为空当DestPortType为group时，取值为端口地址簿的uuid列表，多个地址簿通过英文逗号分隔当DestPortType为port时，取值为端口范围
DestPortType	String	否	port	访问控制策略的目的端口类型： port：端口 group：端口地址簿
Destination	String	是	180...1/32	访问控制策略中的目的地址：当DestinationType为net时，Destination为目的CIDR地址。例如：192.168.0.2/32 当DestinationType为group时，Destination为目的址簿的uuid列表，多个地址簿用英文逗号分隔。例如：f04ac7ce-628b-4cb7-be61-310222b7**, f04ac7ce-628b-4cb7-be61-310222b7** 当DestinationType为location时，Destination为目的区域，多个地域用英文逗号分隔。例如：BJ11, ZB 当DestinationType为Domain时，Destination为目的域名。例如：www.baidu.com
DestinationType	String	是	net	访问控制策略中的目的地址类型： net：目的网段(CIDR) group：目的地址簿 location：目的区域 domain：目的域名
Direction	String	是	in	策略方向： in - 入方向 out - 出方向
EndTime	Integer	否	1725708600	策略生效截止日期，Unix 时间戳，支持精确到设定日期的 23:59:00。当 RepeatType 为 Permanent（始终生效）时，该字段无需填写。当 RepeatType 为 Once（单时间段生效）或 Daily、Weekly、Monthly（重复生效）时，需填写该字段，字段需要精确到设定日期的 23:59:00。例如 2024.11.30 截止，则取值为 1732982340，实际截止时间为 2024.11.30 23:59:00。
Prio	Integer	否	1	策略的优先级，数值越小优先级越高。 0：最低优先级； 1：最高优先级；其他数值：其他优先级。默认值为 0（最低优先级）。
Proto	String	是	TCP	协议类型，用于指定访问控制策略的传输协议。 ICMP：互联网控制报文协议； TCP：传输控制协议； UDP：用户数据报协议； ANY：任意协议。当 DestinationType 为 domain 时，协议类型只能为 TCP。
RepeatDays	Array of Integer	否	1,2,3	重复生效周期。当 RepeatType 为 Daily（每日重复）时，无需填写。当 RepeatType 为 Weekly（每周重复）、Monthly（每月重复）时，需要填写。当 RepeatType 为 Weekly 时，取值范围[0, 6] 当 RepeatType 为 Monthly 时，取值范围[1, 31]
RepeatEndTime	String	否	10:00	重复生效截止时间。当 RepeatType 为 Daily、Weekly、Monthly（重复生效）时，需要填写。精确到分钟，格式为 hh:mm。例如：12:00。
RepeatStartTime	String	否	08:00	重复生效起始时间。当重复生效时，需要填写。精确到分钟，格式为 hh:mm。例如：12:00。
RepeatType	String	否	Permanent	重复类型： Permanent：始终生效 Once：单次生效 Daily：每日重复 Weekly：每周重复 Monthly：每月重复
Source	String	是	180...1/32	源地址: 当SourceType为net时，Source为源CIDR地址。例如：180...1/32 当SourceType为group时，Source为源地址簿的uuid。例如：f04ac7ce----******** 当SourceType为区域时，Source为区域代码。例如：BJ11
SourceType	String	是	net	源地址类型: net：网段(CIDR) group：地址簿 location：区域
StartTime	Integer	否	1725705000	策略生效起始日期，Unix 时间戳，支持精确到设定日期的 00:00:00。当 RepeatType 为 Permanent（始终生效）时，该字段无需填写。当 RepeatType 为 Once（单时间段生效）或 Daily、Weekly、Monthly（重复生效）时，需填写该字段，字段需要精确到设定日期的 00:00:00。例如 2024.10.01 开始，则取值为 1727712000，实际起始时间为 2024.10.01 00:00:00。
Status	Boolean	否	false	策略启用状态。默认为false，关闭。 true：开启 false：关闭
InternetFirewallId	String	否	ifw-****	互联网边界防火墙实例ID，获取方式可参考AssetList。
IpType	String	否	v4	IP 版本，用于指定访问控制策略的 IP 地址类型。 v4：IPv4； v6：IPv6。默认值为 v4。

返回参数

参数	类型	示例值	描述
RuleId	String	f04ac7ce-**---**********	成功后返回访问控制策略唯一标识ID

请求示例

返回示例

错误码

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

云防火墙