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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
NetworkAclId String 否 nacl-bp1lhl0taikrbgnh****

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

网络ACL的名称。

名称长度为1～128个字符，不能以http://或https://开头。
VpcId String 否 vpc-m5ebpc2xh64mqm27e****

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

关联实例的类型。取值：VSwitch，交换机。

ResourceType和ResourceId参数需要同时指定才生效。
ResourceId String 否 vsw-bp1de348lntdwnhbg****

关联实例的ID。
PageNumber Integer 否 1

列表的页码。默认值：1。
PageSize Integer 否 10

分页查询时每页的行数。最大值：50。默认值：10。
RegionId String 是 cn-hangzhou

网络ACL所属的地域ID。

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

Tags.N.Key String 否 FinanceDept

标签键。最多支持输入20个标签键。一旦传入该值，则不允许为空字符串。

一个标签键最多支持64个字符，必须以字母或中文开头，可包含数字、半角句号（.）、下划线（_）和短划线（-），不能以aliyun和acs:开头，不能包含http://或者https://。
Tags.N.Value String 否 FinanceJoshua

标签值。最多支持输入20个标签值。一旦传入该值，可以为空字符串。

一个标签值最多支持128个字符，必须以字母或中文开头，可包含数字、半角句号（.）、下划线（_）和短划线（-），不能以aliyun和acs:开头，不能包含http://或者https://。
ClientToken String 否 123e4567-e89b-12d3-a456-426655440000

客户端Token，用于保证请求的幂等性。

从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符。

说明 若您未指定，则系统自动使用API请求的RequestId作为ClientToken标识。每次API请求的RequestId不一样。
Action String 是 DescribeNetworkAcls

系统规定参数。取值：DescribeNetworkAcls。

返回数据

名称 类型 示例值 描述
PageSize String 10

分页查询时每页的行数。
RequestId String F7DDDC17-FA06-4AC2-8F35-59D2470FCFC1

请求ID。
PageNumber String 1

列表的页码。
TotalCount String 2

列表条目数。
NetworkAcls Array of NetworkAcl

网络ACL的详细信息。
NetworkAcl
Status String Available

网络ACL的状态。取值：

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

关联的VPC的ID。
CreationTime String 2021-12-25 11:44:17

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

网络ACL的描述信息。

NetworkAclName String acl-1

网络ACL的名称。
NetworkAclId String nacl-a2do9e413e0spxscd****

网络ACL的ID。
OwnerId Long 253460731706911258

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

网络ACL所属的地域ID。
IngressAclEntries Array of IngressAclEntry

入方向规则信息。
IngressAclEntry
NetworkAclEntryId String nae-a2dk86arlydmezasw****

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

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

授权策略，取值：

  • accept：允许。
  • drop：拒绝。
Description String This is IngressAclEntries.

入方向规则的描述信息。
SourceCidrIp String 10.0.0.0/24

源地址段。
Protocol String all

协议类型，取值：

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

入方向规则的目的端口范围。

  • 当入方向规则的Protocol（协议类型）为all、icmp或gre时，端口范围为-1/-1，表示不限制端口。
  • 当入方向规则的Protocol（协议类型）为tcp或udp时，端口范围为1~65535，格式为1/200或80/80，表示端口1到端口200或端口80。
EgressAclEntries Array of EgressAclEntry

出方向规则信息。
EgressAclEntry
NetworkAclEntryId String nae-a2d447uw4tillfvgb****

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

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

授权策略，取值：

  • accept：允许。
  • drop：拒绝。
Description String This is EgressAclEntries.

出方向规则的描述信息。
Protocol String all

协议类型，取值：

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

目标地址段。
Port String -1/-1

出方向规则的目的端口范围。

  • 当出方向规则的Protocol（协议类型）为all、icmp或gre时，端口范围为-1/-1，表示不限制端口。
  • 当出方向规则的Protocol（协议类型）为tcp或udp时，端口范围为1~65535，格式为1/200或80/80，表示端口1到端口200或端口80。
Resources Array of Resource

关联的资源。
Resource
Status String BINDED

关联资源的状态。取值：

  • BINDED：已绑定。
  • BINDING：绑定中。
  • UNBINDING：已解绑。
ResourceType String VSwitch

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

关联资源的ID。
Tags Array of Tag

标签列表信息。
Tag
Key String FinanceDept

标签键。
Value String FinanceJoshua

标签值。

示例

请求示例

http(s)://[Endpoint]/?NetworkAclId=nacl-bp1lhl0taikrbgnh****
&NetworkAclName=acl-1
&VpcId=vpc-m5ebpc2xh64mqm27e****
&ResourceType=VSwitch
&ResourceId=vsw-bp1de348lntdwnhbg****
&PageNumber=1
&PageSize=10
&RegionId=cn-hangzhou
&Tags=[{"Key":"FinanceDept","Value":"FinanceJoshua"}]
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&Action=DescribeNetworkAcls
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

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

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

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

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