文档中心

云防火墙

VPC边界防火墙

AddVpcFirewallAclRule - 创建 VPC 边界防火墙访问控制策略

AddVpcFirewallAclRule - 创建 VPC 边界防火墙访问控制策略

创建 VPC 边界防火墙访问控制策略。

使用说明

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

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

其中访问源计数逻辑为：

访问源为 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=AddVpcFirewallAclRule&Version=2021-09-06

调试

API Explorer

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

请求参数

Query

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

Body

参数	类型	是否必选	示例值	描述
Action	String	是	accept	策略动作： accept：放行 deny：阻断 monitor：观察
Description	String	否	Description	策略描述信息，可用于说明策略的用途、作用等。
DestPort	String	否	22/22	目的端口，格式为单个端口（如 22/22）或端口范围（如 100/200）。具体取值规则如下：当协议类型为 ICMP 或 ALL 时，该字段为空；当 DestPortType 为 group 时，该字段为端口地址簿的 UUID 列表，多个地址簿通过英文逗号分隔；当 DestPortType 为 port时，该字段为端口范围。
DestPortType	String	否	port	访问控制策略的目的端口类型，用于指定 DestPort 字段的取值方式。支持的取值如下所示。 port：端口或端口范围； group：端口地址簿。
Destination	String	是	192.168.0.2/32	目的地址，其具体格式和取值取决于 DestinationType 字段的设置。支持的取值方式如下所示。当 DestinationType 为 net 时，该字段为目的 CIDR 地址，例如 192.168.0.2/32；当 DestinationType 为 group 时，该字段为目的地址簿的 UUID，例如 f04ac7ce-**---**********；当 DestinationType 为 domain 时，该字段为目的域名，例如 example.com。
DestinationType	String	是	net	目的地址类型，用于指定 Destination 字段的格式和取值方式。支持的取值如下所示。 net：网段（CIDR 格式）； group：地址簿（UUID 格式）； domain：域名。
EndTime	Integer	否	1725724740	策略生效的截止时间，使用 Unix 时间戳格式，精确到设定日期的 23:59:00。具体规则如下：当 RepeatType 为 Permanent（始终生效）时，该字段无需填写；当 RepeatType 为 Once（单时间段生效）时，需填写精确到分钟的 Unix 时间戳；当 RepeatType 为 Daily、Weekly 或 Monthly（重复生效）时，需填写设定日期的 23:59:00 对应的时间戳。
Prio	Integer	否	1	策略的优先级，数值越小优先级越高。默认值为 1（最高优先级）。支持的取值如下所示。 0：最低优先级； 1：最高优先级；其他数值：自定义优先级（数值越小优先级越高）。
Proto	String	是	TCP	访问控制策略的协议类型。当 DestinationType 为 domain 时，该字段仅支持 TCP。支持的协议类型如下所示。 ICMP：ICMP 协议； TCP：TCP 协议； UDP：UDP 协议； ANY：任何协议。
RepeatDays	Array of Integer	否	[1,3,5]	策略重复生效的具体日期，仅在 RepeatType 为 Weekly 或 Monthly 时有效。当 RepeatType 为 Weekly 时，取值范围为 [0, 6]，分别对应周日到周六；当 RepeatType 为 Monthly 时，取值范围为 [1, 31]，对应每月的具体日期。
RepeatEndTime	String	否	23:59	策略重复生效的结束时间，格式为 hh:mm。仅在 RepeatType 为 Weekly 或 Monthly时有效，表示策略在重复生效周期内的每日结束时间。
RepeatStartTime	String	否	08:00	策略重复生效的起始时间，格式为 hh:mm。仅在 RepeatType 为 Daily、Weekly 或 Monthly时有效，表示策略在重复生效周期内的每日开始时间。
RepeatType	String	否	Weekly	策略的生效时间重复类型，用于指定策略生效的时间周期。支持的取值如下所示。 Permanent：始终生效； Once：单次生效； Daily：每日重复； Weekly：每周重复； Monthly：每月重复。
Source	String	是	192.168.0.1/32	访问控制策略的源地址，其具体格式和取值取决于 SourceType 字段的设置。支持的取值方式如下所示。当 SourceType 为 net 时，该字段为源 CIDR 地址，例如 192.168.0.1/32；当 SourceType 为 group 时，该字段为源地址簿的 UUID，例如 f04ac7ce-**---**********。
SourceType	String	是	net	访问控制策略的源地址类型，用于指定 Source 字段的格式和取值方式。支持的取值如下所示。 net：网段（CIDR 格式）； group：地址簿（UUID 格式）。
StartTime	Integer	否	1725638400	策略生效的起始时间，使用 Unix 时间戳格式，精确到设定日期的 00:00:00。具体规则如下：当 RepeatType 为 Permanent（始终生效）时，该字段无需填写；当 RepeatType 为 Once（单时间段生效）时，需填写精确到分钟的 Unix 时间戳；当 RepeatType 为 Daily、Weekly 或 Monthly（重复生效）时，需填写设定日期的 00:00:00 对应的时间戳。
Status	Boolean	否	false	策略启用状态。默认为false，关闭。 true：开启 false：关闭
VpcFirewallId	String	是	vfw-********	VPC 边界防火墙实例 ID，获取方式可参考DescribeVpcFirewallList - 查询 VPC 边界防火墙实例列表。

返回参数

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

请求示例

返回示例

错误码

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

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

这个页面对您有帮助吗？

有用

有用

无用

无用