私有网络
私有网络
文档指南
请输入
- 文档首页
私有网络API参考网络ACLUpdateNetworkAclEntries - 更新网络ACL出/入方向规则
复制全文
下载 pdfUpdateNetworkAclEntries - 更新网络ACL出/入方向规则
文档反馈
问问助手调用 UpdateNetworkAclEntries 接口，更新网络ACL的出方向、入方向规则。
使用说明
- 更新入方向规则：UpdateIngressAclEntries 传入true，传入新的入方向规则参数，系统将删除当前的入方向规则后，按传入的参数信息新创建入方向规则。
- 更新出方向规则：UpdateEgressAclEntries 传入true，传入新的出方向规则参数，系统将删除当前的出方向规则后，按传入的参数信息新创建出方向规则。
- 参数 - N：表示规则信息的序号，单次调用数量上限为20个。多个规则信息之间用&分隔。
请求说明
- 请求方式：GET
- 请求地址：/?Action=UpdateNetworkAclEntries&Version=2020-04-01
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Action string 必选 示例值：UpdateNetworkAclEntries
要执行的操作，取值：UpdateNetworkAclEntries。
Version string 必选 示例值：2020-04-01
API的版本，取值：2020-04-01。
UpdateEgressAclEntries boolean 可选 示例值：false
是否更新出方向规则。
请严格按照以下枚举值的大小写输入，不要传入其他取值。
- true：更新。
- false（默认值）：不更新。
ClientToken string 可选 示例值：123e4567-e89b-12d3-a456-42665544****
客户端Token，用于保证请求幂等性。
- 由客户端自动生成一个参数值，确保不同请求间该参数值唯一，避免当调用API超时或服务器内部错误时，客户端多次重试导致重复性操作。
- 仅支持ASCII字符，且不能超过64个字符。
- 若不传入ClientToken，则此次API调用不进行幂等校验。
EgressAclEntries.N.Port string[] 可选 示例值：-1/-1
网络ACL出方向规则的目的端口范围。
- 当EgressAclEntries.N.Protocol 传入all、icmp、icmpv6、gre时。
- 无需传入本参数。
- 默认取值-1/-1，表示不限制端口。
- 当EgressAclEntries.N.Protocol传入tcp或udp时。
- 本参数为必选。
- 取值范围1～65535。
- 使用正斜线（/）隔开起始端口和终止端口，如1/50、80/80。
EgressAclEntries.N.Protocol string[] 可选 示例值：all
网络ACL出方向规则的协议类型，取值如下：
- tcp：TCP协议。
- udp：UDP协议。
- icmp：ICMP协议。
- icmpv6：ICMPV6协议。
- gre：GRE协议。
- all（默认值）：支持所有协议。
EgressAclEntries.N.DestinationCidrIp string[] 可选 示例值：10.XX.XX.0/24
网络ACL出方向规则的目标地址的网段。
说明
参数UpdateEgressAclEntries取值为“true”时，该参数必须传入。
EgressAclEntries.N.Policy string[] 可选 示例值：accept
网络ACL出方向规则的授权策略。即子网内资源访问外部资源。取值如下：
- accept（默认）：允许访问。
- drop：拒绝访问。
EgressAclEntries.N.Description string[] 可选 示例值：ThisIsEgressAclEntries
网络ACL出方向规则的描述信息。
- 长度限制为0 ~ 255个字符。
- 需要以字母、中文或数字开头。可包含英文逗号（,）、点号（.）、下划线（_）、空格（ ）、等号（=）、短横线（-）、中文逗号（，）、中文句号（。）。
- 不填默认空字符串。
EgressAclEntries.N.NetworkAclEntryName string[] 可选 示例值：acl-01
网络ACL出方向规则的名称。
- 长度限制为1 ~ 128个字符。
- 需要以字母、中文或数字开头，可包含点号（.）、下划线（_）和短横线（-）。
- 不填默认空字符串。
EgressAclEntries.N.NetworkAclEntryId string[] 可选 示例值：nae-2zecs97e0brcge46****
网络ACL出方向规则的ID。
若传入当前出方向规则的ID，新的规则将继续使用该ID。
IngressAclEntries.N.Port string[] 可选 示例值：22/22
网络ACL入方向规则的目的端口范围。
- 当IngressAclEntries.N.Protocol传入all、icmp、icmpv6、gre时。
- 无需传入本参数。
- 默认取值-1/-1，表示不限制端口。
- 当IngressAclEntries.N.Protocol传入tcp或udp时。
- 本参数为必选。
- 取值范围1～65535。
- 使用正斜线（/）隔开起始端口和终止端口，如1/50、80/80。
IngressAclEntries.N.Protocol string[] 可选 示例值：all
网络ACL入方向规则的协议类型，取值如下：
- tcp：TCP协议。
- udp：UDP协议。
- icmp：ICMP协议。
- icmpv6：ICMPV6协议。
- gre：GRE协议。
- all（默认值）：支持所有协议。
IngressAclEntries.N.SourceCidrIp string[] 可选 示例值：10.XX.XX.0/24
网络ACL入方向规则的源地址网段。
说明
参数UpdateIngressAclEntries取值为“true”时，该参数必须传入。
IngressAclEntries.N.Policy string[] 可选 示例值：accept
网络ACL入方向规则的授权策略。即外部资源访问子网内的资源。取值如下：
- accept（默认）：允许访问。
- drop：拒绝访问。
IngressAclEntries.N.Description string[] 可选 示例值：ThisIsIngressAclEntries
网络ACL入方向规则的描述信息。
- 长度限制为0 ~ 255个字符。
- 需要以字母、中文或数字开头。可包含英文逗号（,）、点号（.）、下划线（_）、空格（ ）、等号（=）、短横线（-）、中文逗号（，）、中文句号（。）。
- 不填默认空字符串。
IngressAclEntries.N.NetworkAclEntryName string[] 可选 示例值：acl-3****
网络ACL入方向规则的名称。
- 长度限制为1 ~ 128个字符。
- 需要以字母、中文或数字开头，可包含点号（.）、下划线（_）和短横线（-）。
- 不填默认空字符串。
IngressAclEntries.N.NetworkAclEntryId string[] 可选 示例值：nae-2zepn32de59j8m4****
网络ACL入方向规则的ID。
若传入当前入方向规则的ID，新的规则将继续使用该ID。
UpdateIngressAclEntries boolean 可选 示例值：false
是否更新入方向规则：
请严格按照以下枚举值的大小写输入，不要传入其他取值。
- true：更新。
- false（默认值）：不更新。
NetworkAclId string 必选 示例值：nacl-bp1fg655nh68xyz9****
网络ACL的ID。
返回参数
RequestId string 示例值：2021062415303301022514515207C4****
请求ID。
AsyncTaskId string 示例值：asynctask-13f0odozfrdvk3n6nu41lt59g
异步请求中用于标识异步任务的唯一ID。
请求示例
返回示例
错误码
最近更新时间：2026.11.05 17:36:49
这个页面对您有帮助吗？
有用
有用
无用
无用