调用DescribeNetworkAcls接口查看网络ACL列表。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeNetworkAcls

要执行的操作，取值：DescribeNetworkAcls。

RegionId String 是 cn-hangzhou

网络ACL所属的地域ID。

您可以通过调用DescribeRegions接口获取地域ID。

NetworkAclId String 否 nacl-bp1lhl0taikrbgnh****

网络ACL的ID。
NetworkAclName String 否 acl-1

网络ACL的名称。

长度为2~128个字符，必须以字母或中文开头，可包含数字、下划线（_）和短划线（-），但不能以http://或https://开头。

VpcId String 否 vpc-123456

网络ACL关联的VPC的ID。
ResourceType String 否 VSwitch

关联实例的类型。

ResourceType和ResourceId需要同时指定才生效。

ResourceId String 否 vsw-bp1de348lntdwnhbg****

关联实例的ID。

ResourceType和ResourceId需要同时指定才生效。

PageNumber Integer 否 1

列表的页码，默认值为1。

PageSize Integer 否 10

分页查询时每页的行数，最大值为50，默认值为10。

ClientToken String 否 123

保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符，且不能超过64个字符。

返回数据

名称 类型 示例值 描述
NetworkAcls Array of NetworkAcl

网络ACL的详细信息。
NetworkAcl
CreationTime String 2019-04-25 11:44:17

网络ACL的创建时间。
Description String This is my NetworkAcl.

网络ACL的描述信息。

EgressAclEntries Array of EgressAclEntry

出方向规则信息。
EgressAclEntry
Description String This is EgressAclEntries.

出方向规则的描述信息。
DestinationCidrIp String 10.0.0.0/24

目的地址段。
NetworkAclEntryId String nae-a2d447uw4tillfvgb****

出方向规则条目的ID。
NetworkAclEntryName String acl-2

出方向规则条目的名称。
Policy String accept

授权策略，取值：

  • accept：允许。
  • drop：拒绝。
Port String -1/-1

目的端口范围。
Protocol String all

传输层协议，取值：

  • icmp：网络控制报文协议。
  • gre：通用路由封装协议。
  • tcp：传输控制协议。
  • udp：用户数据报协议。
  • all：支持所有协议
IngressAclEntries Array of IngressAclEntry

入方向规则信息。
IngressAclEntry
Description String This is IngressAclEntries.

入方向规则的描述信息。
NetworkAclEntryId String nae-a2dk86arlydmezasw****

入方向规则条目的ID。
NetworkAclEntryName String acl-3

入方向规则条目的名称。
Policy String accept

授权策略，取值：

  • accept：允许。
  • drop：拒绝。
Port String -1/-1

源端口范围。
Protocol String all

传输层协议，取值：

  • icmp：网络控制报文协议。
  • gre：通用路由封装协议。
  • tcp：传输控制协议。
  • udp：用户数据报协议。
  • all：支持所有协议
SourceCidrIp String 10.0.0.0/24

源地址段。
NetworkAclId String nacl-a2do9e413e0spxscd****

网络ACL的ID。
NetworkAclName String acl-8

网络ACL的名称。
OwnerId Long 12345678

网络ACL所属账号ID。
RegionId String cn-hangzhou

网络ACL所属的地域。
Resources Array of Resource

关联的资源。
Resource
ResourceId String vsw-bp1de348lntdwcdf****

关联资源的ID。
ResourceType String VSwitch

关联资源的类型。
Status String BINDED

关联资源的状态。

  • BINDED：已绑定。
  • BINDING：绑定中。
  • UNBINDING：已解绑。
Status String Available

网络ACL的状态。

  • Available：可用。
  • Modifying：配置中。
VpcId String vpc-a2d33rfpl72k5defr****

关联的VPC的ID。
PageNumber String 1

当前页码。
PageSize String 10

当前分页包含的条目数。
RequestId String F7DDDC17-FA06-4AC2-8F35-59D2470FCFC1

请求ID。
TotalCount String 2

列表条目数。

示例

请求示例

https://vpc.aliyuncs.com/?Action=DescribeNetworkAcls
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML格式 

<DescribeNetworkAclsResponse>
  <TotalCount>2</TotalCount>
  <NetworkAcls>
        <NetworkAcl>
              <Status>Available</Status>
              <Description>This is my NetworkAcl.</Description>
              <OwnerId>12345678</OwnerId>
              <VpcId>vpc-a2d33rfpl72k5defr****</VpcId>
              <NetworkAclId>nacl-a2do9e413e0spxscd****</NetworkAclId>
              <CreationTime>2019-04-25 11:44:17</CreationTime>
              <NetworkAclName>acl-8</NetworkAclName>
              <RegionId>cn-hangzhou</RegionId>
              <IngressAclEntries>
                    <IngressAclEntry>
                          <Policy>accept</Policy>
                          <Description>This is IngressAclEntries.	</Description>
                          <Port>-1/-1	</Port>
                          <SourceCidrIp>10.0.0.0/24	</SourceCidrIp>
                          <NetworkAclEntryName>acl-3	</NetworkAclEntryName>
                          <Protocol>all</Protocol>
                          <NetworkAclEntryId>nae-a2dk86arlydmezasw****</NetworkAclEntryId>
                    </IngressAclEntry>
              </IngressAclEntries>
              <EgressAclEntries>
                    <EgressAclEntry>
                          <Policy>accept</Policy>
                          <Description>This is EgressAclEntries.	</Description>
                          <DestinationCidrIp>10.0.0.0/24	</DestinationCidrIp>
                          <Port>-1/-1	</Port>
                          <NetworkAclEntryName>acl-2	</NetworkAclEntryName>
                          <Protocol>all</Protocol>
                          <NetworkAclEntryId>nae-a2d447uw4tillfvgb****</NetworkAclEntryId>
                    </EgressAclEntry>
              </EgressAclEntries>
              <Resources>
                    <Resource>
                          <Status>BINDED</Status>
                          <ResourceId>vsw-bp1de348lntdwcdf****</ResourceId>
                          <ResourceType>VSwitch</ResourceType>
                    </Resource>
              </Resources>
        </NetworkAcl>
  </NetworkAcls>
  <PageSize>10</PageSize>
  <RequestId>F7DDDC17-FA06-4AC2-8F35-59D2470FCFC1</RequestId>
  <PageNumber>1</PageNumber>
</DescribeNetworkAclsResponse>

JSON格式 

{"TotalCount":"2","NetworkAcls":{"NetworkAcl":[{"Status":"Available","Description":"This is my NetworkAcl.","OwnerId":"12345678","VpcId":"vpc-a2d33rfpl72k5defr****","NetworkAclId":"nacl-a2do9e413e0spxscd****","CreationTime":"2019-04-25 11:44:17","NetworkAclName":"acl-8","RegionId":"cn-hangzhou","IngressAclEntries":{"IngressAclEntry":[{"Policy":"accept","Description":"This is IngressAclEntries.\t","Port":"-1/-1\t","SourceCidrIp":"10.0.0.0/24\t","NetworkAclEntryName":"acl-3\t","Protocol":"all","NetworkAclEntryId":"nae-a2dk86arlydmezasw****"}]},"EgressAclEntries":{"EgressAclEntry":[{"Policy":"accept","Description":"This is EgressAclEntries.\t","DestinationCidrIp":"10.0.0.0/24\t","Port":"-1/-1\t","NetworkAclEntryName":"acl-2\t","Protocol":"all","NetworkAclEntryId":"nae-a2d447uw4tillfvgb****"}]},"Resources":{"Resource":[{"Status":"BINDED","ResourceId":"vsw-bp1de348lntdwcdf****","ResourceType":"VSwitch"}]}}]},"PageSize":"10","RequestId":"F7DDDC17-FA06-4AC2-8F35-59D2470FCFC1","PageNumber":"1"}

错误码

HttpCode 错误码 错误信息 描述
500 InternalError The request processing has failed due to some unknown error. 请求处理由于某些未知错误失败。

访问错误中心查看更多错误码。