调用 UpdateNetworkAclEntries 接口，更新网络ACL的出方向、入方向规则。 ## 使用说明 * 更新入方向规则：`UpdateIngressAclEntries` 传入true，传入新的入方向规则参数，系统将删除当前的入方向规则后，按传入的参数信息新创建入方向规则。 * 更新出方向规则：`UpdateEgressAclEntries` 传入true，传入新的出方向规则参数，系统将删除当前的出方向规则后，按传入的参数信息新创建出方向规则。 * 参数 \- N：表示规则信息的序号，单次调用数量上限为20个。多个规则信息之间用&分隔。 ## 请求说明 * 请求方式：**GET** * 请求地址： **/?Action=UpdateNetworkAclEntries&Version=2020\-04\-01** ## 调试 [去调试](https://api.volcengine.com/api-explorer/?action=UpdateNetworkAclEntries&groupName=%E7%BD%91%E7%BB%9CACL&serviceCode=vpc&version=2020-04-01) ## 请求参数下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见[公共参数](https://www.volcengine.com/docs/6369/67268)。 **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出方向规则的目的端口范围。 * 当`IngressAclEntries.N.Protocol`传入all、icmp、icmpv6、gre时。 * 无需传入本参数。 * 默认取值\-1/\-1，表示不限制端口。 * 当`IngressAclEntries.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。您可以调用 [DescribeNetworkAcls](https://www.volcengine.com/docs/6401/108592) 接口，查询网络ACL的ID。 ## 返回参数下方仅列出本接口特有的返回参数。更多信息请参见[返回结构](https://www.volcengine.com/docs/6369/80336)。 **RequestId** string `示例值：2021062415303301022514515207C4****` 请求ID。 **AsyncTaskId** string `示例值：asynctask-13f0odozfrdvk3n6nu41lt59g` 异步请求中用于标识异步任务的唯一ID。 ## 请求示例 ```text GET /?Action=UpdateNetworkAclEntries&Version=2020-04-01&NetworkAclId=nacl-bp1fg655nh68xyz9****&IngressAclEntries.1.NetworkAclEntryId=nae-2zepn32de59j8m4****&IngressAclEntries.2.NetworkAclEntryId=nae-xyz2dmndek90e****&IngressAclEntries.1.NetworkAclEntryName=acl-3***&IngressAclEntries.2.NetworkAclEntryName=acl-es***&IngressAclEntries.1.Description=ThisisIngressAclEntries01.&IngressAclEntries.2.Description=ThisisIngressAclEntries02.&IngressAclEntries.1.Policy=accept&IngressAclEntries.2.Policy=&IngressAclEntries.1.SourceCidrIp=10.XX.XX.0/24&IngressAclEntries.2.SourceCidrIp=10.XX.XX.0/24&IngressAclEntries.1.Protocol=all&IngressAclEntries.2.Protocol=tcp&IngressAclEntries.1.Port=22/22&IngressAclEntries.2.Port=80/80&EgressAclEntries.1.NetworkAclEntryId=nae-2zecs97e0brcge46****&EgressAclEntries.2.NetworkAclEntryId=nae-0iswk4d88jvds****&EgressAclEntries.1.NetworkAclEntryName=acl-01&EgressAclEntries.2.NetworkAclEntryName=acl-02&EgressAclEntries.1.Description=ThisisEgressAclEntries01.&EgressAclEntries.2.Description=ThisisEgressAclEntries02.&EgressAclEntries.1.Policy=accept&EgressAclEntries.2.Policy=accept&EgressAclEntries.1.DestinationCidrIp=10.XX.XX.0/24&EgressAclEntries.2.DestinationCidrIp=10.XX.XX.0/24&EgressAclEntries.1.Protocol=all&EgressAclEntries.2.Protocol=icmp&EgressAclEntries.1.Port=-1/-1&EgressAclEntries.2.Port=80/80&UpdateIngressAclEntries=false&UpdateEgressAclEntries=false HTTP/1.1 Host: vpc.cn-beijing.volcengineapi.com X-Date: 20251121T094038Z Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251121/cn-beijing/vpc/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f ``` ## 返回示例 ```text { "ResponseMetadata": { "RequestId": "20230604110420****100232280022D31", "Action": "UpdateNetworkAclEntries", "Version": "2020-04-01", "Service": "vpc", "Region": "cn-beijing" }, "Result": { "RequestId": "2021062415303301022514515207C4****" } } ``` ## 错误码下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见[公共错误码](https://www.volcengine.com/docs/6369/68677)文档。 |状态码 |错误码 |错误信息 |说明 | |---|---|---|---| |400 |MissingParameter |The request is missing a required parameter. |该请求缺少必要参数。 | |400 |InvalidParameter |A parameter specified in the request is not valid, is unsupported or cannot be used. |该请求传入了非法或不支持的参数。 | |400 |InvalidDescription.Malformed |The specified description is malformed. |指定的描述格式不合法。请修复描述格式后重试。 | |400 |InvalidDescription.Malformed |The specified description is malformed. Ensure the maximum length of description is 255. |指定的描述格式不合法。描述长度不能超过255个字符。 | |400 |DryRunOperation |Exception raised to indicate a successfully authorized action when the DryRun flag is set to true. |该请求设置为DryRun操作，操作授权已获得许可，但未被实际执行。 | |400 |InvalidRouteCidr.Malformed |The specified CIDR is malformed. |指定的网段不合法。 | |400 |InvalidName.Malformed |The specified name is malformed. Ensure the maximum length of name is 128. |指定的名称格式不合法。名称长度不能超过128个字符。 | |400 |InvalidName.Malformed |The specified name is malformed. |指定的名称格式不合法。请修复名称格式后重试。 | |400 |InvalidNetworkAcl.InvalidStatus |The specified Network ACL is not in the correct status for the request. |指定的网络ACL所处状态无法响应该请求。 | |400 |IdempotentParameterMismatch |Arguments on this idempotent request are inconsistent with arguments used in previous request(s). |此幂等请求的参数与前一个请求中使用的参数不一致。 | |400 |InvalidParameter.ClientTokenMalformed |The specified parameter ClientToken is malformed. |指定的参数ClientToken格式不合法，长度不能超过64个ASCII字符。 | |400 |InvalidNetworkAclEntry.Disorder |The specified Network ACL entry index orders are malformed. |指定的网络ACL规则条目的序号不合法。 | |400 |InvalidNetworkAclEntryPort.Malformed |The specified Network ACL entry port is malformed. |指定的网络ACL规则端口不合法。 | |400 |InvalidNetworkAclEntryProtocol.Malformed |The specified Network ACL entry protocol is malformed. |指定的网络ACL规则协议不合法。 | |400 |InvalidNetworkAclEntryPolicy.Malformed |The specified Network ACL entry policy is malformed. |指定的网络ACL规则授权策略不合法。 | |400 |InvalidCidr.Malformed |The specified cidr block is malformed. |指定的网段格式不合法。 | |400 |QuotaExceeded.NetworkAclEntryEgress |Network ACL egress entry number exceeded quota. |已达到单个网络ACL可创建出方向规则的上限。 | |400 |QuotaExceeded.NetworkAclEntryIngress |Network ACL ingress entry number exceeded quota. |已达到单个网络ACL可创建入方向规则的上限。 | |400 |InvalidCidr.ProtocolMismatch |The specified cidr block mismatch the protocol type. |指定的网段格式和协议类型不匹配。 | |400 |InvalidCidr.AddressMismatch |The network types of the specified source and destination CIDRs are different. |指定的源和目标CIDR的网络类型不同。 | |404 |InvalidNetworkAclEntryId.NotFound |The specified Network ACL entry does not exist. |指定网络ACL规则ID不存在。 | |404 |InvalidNetworkAcl.NotFound |The specified Network ACL does not exist. |指定的网络ACL不存在。 | |409 |InvalidOperation.Conflict |The specified resource operation conflicts. |指定的资源操作冲突。 | |409 |InvalidNetworkAclEntryId.Conflict |The specified Network ACL has duplicated entry id. |指定的网络ACL存在重复规则ID。 | |412 |IdempotentProcessing |The request uses the same client token as a previous one that is still in process. |幂等请求处理中。 | |500 |InternalError |An internal error has occurred. |发生内部错误。 |

私有网络