网络ACL插入规则

firewall_id

是

String

参数解释：

网络ACL的资源ID。您可以先通过查询网络ACL列表API获取目标网络ACL的ID，再使用当前API插入网络ACL规则。

取值范围：

不涉及。

project_id

是

String

参数解释：

网络ACL所属的项目ID。

取值范围：

不涉及。

firewall

是

FirewallInsertRuleOption object

参数解释：

插入网络ACL规则的请求体。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

dry_run

否

Boolean

参数解释：

是否只预检此次请求。

约束限制：

不涉及。

取值范围：

• true：发送检查请求，不会插入网络ACL规则。检查项包括是否填写了必需参数、请求格式、业务限制。如果检查不通过，则返回对应错误。如果检查通过，则返回响应码202。

• false：发送正常请求，并直接插入网络ACL规则。

默认取值：

false

ingress_rules

否

Array of FirewallInsertRuleItemOption objects

参数解释：

网络ACL添加入方向规则列表。

约束限制：

每次插入的ingress_rules和egress_rules合计不超过100条。

取值范围：

不涉及。

默认取值：

不涉及。

egress_rules

否

Array of FirewallInsertRuleItemOption objects

参数解释：

网络ACL添加出方向规则列表。

约束限制：

每次插入的ingress_rules和egress_rules合计不超过100条。

取值范围：

不涉及。

默认取值：

不涉及。

insert_after_rule

否

String

参数解释：

在入方向或者出方向某条网络ACL规则位置后插入新的网络ACL规则，指定此条网络ACL规则的ID。不指定则在入方向或者出方向规则列表最前面插入网络ACL规则。

约束限制：

指定了insert_after_rule，ingress_rules和egress_rules同时只能设置一个，即插入规则时，出方向和入方向二选一。并且指定的规则必须存在于网络ACL的入方向或者出方向中。

取值范围：

不涉及。

默认取值：

不涉及。

name

否

String

参数解释：

网络ACL规则的名称。

约束限制：

0-255个字符，支持数字、字母、中文、_(下划线)、-（中划线）、.（点）。

取值范围：

不涉及。

默认取值：

不涉及。

description

否

String

参数解释：

网络ACL规则的描述信息。

约束限制：

0-255个字符，不能包含“<”和“>”。

取值范围：

不涉及。

默认取值：

不涉及。

action

是

String

参数解释：

网络ACL规则对流量执行的操作放通或拒绝。

约束限制：

不涉及。

取值范围：

• allow：流量放通。

• deny：流量拒绝。

默认取值：

不涉及。

protocol

是

String

参数解释：

网络ACL规则的通信协议类型。

约束限制：

• 协议不能为空。

• 协议为icmpv6时，网络类型应该为IPv6。

• 协议为icmp时，网络类型应该为IPv4。

• tcp

• udp

• icmp

• icmpv6

• IP协议号(0-255)

• any，表示全部协议

取值范围：

默认取值：

不涉及。

ip_version

是

Integer

参数解释：

网络ACL规则的IP地址协议类型。

约束限制：

不涉及。

取值范围：

• 4：表示IPv4的网络ACL规则。

• 6：表示IPv6的网络ACL规则。

默认取值：

不涉及。

source_ip_address

否

String

参数解释：

网络ACL规则的源IP地址或源IP网段。

约束限制：

source_ip_address和source_address_group_id不能同时设置。

取值范围：

不涉及。

默认取值：

不涉及。

destination_ip_address

否

String

参数解释：

网络ACL规则的目的IP地址或目的IP网段。

约束限制：

destination_ip_address和destination_address_group_id不能同时设置。

取值范围：

不涉及。

默认取值：

不涉及。

source_port

否

String

参数解释：

网络ACL规则的源端口。

约束限制：

• 单个端口：例如22

• 连续端口：例如22-30

• 多个端口：例如22,23-30，一次最多支持20个不连续端口组， 端口组之间不能重复。

• 全部端口：为空或1-65535

取值范围：

不涉及。

默认取值：

不涉及。

destination_port

否

String

参数解释：

网络ACL规则的目的端口。

约束限制：

• 单个端口：例如22

• 连续端口：例如22-30

• 多个端口：例如22,23-30，一次最多支持20个不连续端口组， 端口组之间不能重复。

• 全部端口：为空或1-65535

取值范围：

不涉及。

默认取值：

不涉及。

source_address_group_id

否

String

参数解释：

网络ACL规则的源IP地址组ID。

约束限制：

• source_ip_address和source_address_group_id不能同时设置。

• source_address_group_id和destination_address_group_id不能同时设置。

取值范围：

不涉及。

默认取值：

不涉及。

destination_address_group_id

否

String

参数解释：

网络ACL规则的目的IP地址组ID。

约束限制：

• destination_ip_address和destination_address_group_id不能同时设置。

• destination_address_group_id和source_address_group_id不能同时设置。

取值范围：

不涉及。

默认取值：

不涉及。

enabled

否

Boolean

参数解释：

是否启用网络ACL规则。

约束限制：

不涉及。

取值范围：

• true：表示启用网络ACL规则。

• false：表示停用网络ACL规则。

默认取值：

true

firewall

FirewallDetail object

参数解释：

网络ACL插入规则的响应体。

取值范围：

不涉及。

request_id

String

参数解释：

请求ID。

取值范围：

不涉及。

id

String

参数解释：

网络ACL的资源ID。网络ACL创建成功后，会生成一个网络ACL ID，是网络ACL对应的唯一标识。

取值范围：

带“-”的标准UUID格式。

name

String

参数解释：

网络ACL的名称。

取值范围：

1-64个字符，支持数字、字母、中文、_(下划线)、-（中划线）、.（点）。

description

String

参数解释：

网络ACL的描述信息。

取值范围：

0-255个字符，不能包含“<”和“>”。

project_id

String

参数解释：

网络ACL所属的项目ID。

取值范围：

不涉及。

created_at

String

参数解释：

网络ACL的创建时间，系统自动生成。

取值范围：

UTC时间格式，yyyy-MM-ddTHH:mm:ssZ。

updated_at

String

参数解释：

网络ACL的最近一次更新的时间，系统自动生成。

取值范围：

UTC时间格式，yyyy-MM-ddTHH:mm:ssZ。

admin_state_up

Boolean

参数解释：

网络ACL的管理状态。

取值范围：

• true：表示网络ACL处于开启状态。

• false：表示网络ACL处于关闭状态。

status

String

参数解释：

网络ACL的状态。

取值范围：

• ACTIVE：表示网络ACL已绑定子网。

• INACTIVE：表示网络ACL未绑定子网。

enterprise_project_id

String

参数解释：

网络ACL所属的企业项目ID。

取值范围：

最大长度36字节，带“-”连字符的UUID格式，或者是字符串“0”。“0”表示默认企业项目。

tags

Array of ResponseTag objects

参数解释：

网络ACL的标签信息，包括标签键和标签值，可用来分类和标识资源。详情请参见Tag对象。

取值范围：

不涉及。

associations

Array of FirewallAssociation objects

参数解释：

网络ACL绑定的子网列表。

取值范围：

不涉及。

ingress_rules

Array of FirewallRuleDetail objects

参数解释：

网络ACL入方向规则列表。

取值范围：

不涉及。

egress_rules

Array of FirewallRuleDetail objects

参数解释：

网络ACL出方向规则列表。

取值范围：

不涉及。

key

String

参数解释：

标签键。

取值范围：

• 最大长度128个unicode字符， key不能为空。

• 同一资源的key不能重复。

• 可以包含的字符范围：

  • 英文字母

  • 数字

  • 特殊字符：下划线（_）、点（.）、冒号（:）、加号（+）、中划线（-）、等号（=）

value

String

参数解释：

标签值。

取值范围：

• 每个值最大长度255个unicode字符，value可以为空。

• 可以包含的字符范围：

  • 英文字母

  • 数字

  • 特殊字符：下划线（_）、冒号（:）、加号（+）、中划线（-）、等号（=）

virsubnet_id

String

参数解释：

网络ACL绑定的子网ID。

取值范围：

• 网络ACL的type为normal时，只支持绑定普通子网；

• 网络ACL的type为CloudDCN时，只支持绑定CloudDCN子网。

id

String

参数解释：

网络ACL规则的资源ID。网络ACL规则创建成功后，会生成一个网络ACL规则ID，是网络ACL规则对应的唯一标识。

取值范围：

带“-”的标准UUID格式。

name

String

参数解释：

网络ACL规则的名称。

取值范围：

0-255个字符，支持数字、字母、中文、_(下划线)、-（中划线）、.（点）。

description

String

参数解释：

网络ACL规则的描述信息。

取值范围：

0-255个字符，不能包含“<”和“>”。

action

String

参数解释：

网络ACL规则对流量执行的操作放通或拒绝。

取值范围：

• allow：流量放通。

• deny：流量拒绝。

project_id

String

参数解释：

网络ACL规则所属的项目ID。

取值范围：

不涉及。

protocol

String

参数解释：

网络ACL规则的通信协议类型。

取值范围：

• tcp

• udp

• icmp

• icmpv6

• IP协议号(0-255)

• any，表示全部协议

ip_version

Integer

参数解释：

网络ACL规则的IP地址协议类型。

取值范围：

• 4：表示IPv4的网络ACL规则。

• 6：表示IPv6的网络ACL规则。

source_ip_address

String

参数解释：

网络ACL规则的源IP地址或源IP网段。

取值范围：

source_ip_address和source_address_group_id不能同时设置。

destination_ip_address

String

参数解释：

网络ACL规则的目的IP地址或目的IP网段。

取值范围：

destination_ip_address和destination_address_group_id不能同时设置。

source_port

String

参数解释：

网络ACL规则的源端口。

取值范围：

• 单个端口：例如22

• 连续端口：例如22-30

• 多个端口：例如22,23-30，一次最多支持20个不连续端口组， 端口组之间不能重复。

• 全部端口：为空或1-65535

destination_port

String

参数解释：

网络ACL规则的目的端口。

取值范围：

• 单个端口：例如22

• 连续端口：例如22-30

• 多个端口：例如22,23-30，一次最多支持20个不连续端口组， 端口组之间不能重复。

• 全部端口：为空或1-65535

source_address_group_id

String

参数解释：

网络ACL规则源地址对应的IP地址组ID。

取值范围：

source_ip_address和source_address_group_id不能同时设置。

destination_address_group_id

String

参数解释：

网络ACL规则目的地址对应的IP地址组ID。

取值范围：

destination_ip_address和destination_address_group_id不能同时设置。

enabled

Boolean

参数解释：

是否启用网络ACL规则。

取值范围：

• true：默认值，表示启用网络ACL规则。

• false：表示停用网络ACL规则。

200

PUT操作正常返回，更多状态码请参见状态码。