DescribeNetworkAcls - API参考| 阿里云

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	DescribeNetworkAcls	要执行的操作，取值：DescribeNetworkAcls。
RegionId	String	是	cn-hangzhou	网络ACL所属的地域。您可以通过调用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。

返回数据


名称	类型	示例值	描述
RequestId	String	F7DDDC17-FA06-4AC2-8F35-59D2470FCFC1	请求ID。
TotalCount	String	2	列表条目数。
PageNumber	String	1	当前页码。
PageSize	String	10	当前分页包含的条目数。
NetworkAcls	Array		网络ACL的详细信息。
NetworkAclId	String	nacl-a2do9e413e0spxscd****	网络ACL的ID。
RegionId	String	cn-hangzhou	网络ACL所属的地域。
NetworkAclName	String	acl-8	网络ACL的名称。
Description	String	This is my NetworkAcl.	网络ACL的描述信息。
VpcId	String	vpc-a2d33rfpl72k5defr****	关联的VPC的ID。
CreationTime	String	2019-04-25 11:44:17	网络ACL的创建时间。
Status	String	Available	网络ACL的状态。 Available：可用。 Modifying：配置中。
IngressAclEntries	Array		入方向规则信息。
NetworkAclEntryId	String	nae-a2dk86arlydmezasw****	入方向规则条目的ID。
Policy	String	accept	授权策略，取值： accept：允许。 drop：拒绝。
Protocol	String	all	传输层协议，取值： icmp gre tcp udp all：支持所有协议
SourceCidrIp	String	10.0.0.0/24	源地址段。
Port	String	-1/-1	源端口范围。
EntryType	String	custom	规则类型，取值： custom：自定义。 system：系统。
NetworkAclEntryName	String	acl-3	入方向规则条目的名称。
Description	String	This is IngressAclEntries.	入方向规则的描述信息。
EgressAclEntries	Array		出方向规则信息。
NetworkAclEntryId	String	nae-a2d447uw4tillfvgb****	出方向规则条目的ID。
Policy	String	accept	授权策略，取值： accept：允许。 drop：拒绝。
Protocol	String	all	传输层协议，取值： icmp gre tcp udp all：支持所有协议
DestinationCidrIp	String	10.0.0.0/24	目的地址段。
Port	String	-1/-1	目的端口范围。
EntryType	String	custom	规则类型，取值： custom：自定义。 system：系统。
Description	String	This is EgressAclEntries.	出方向规则的描述信息。
NetworkAclEntryName	String	acl-2	出方向规则条目的名称。
Resources	Array		关联的资源。
ResourceId	String	vsw-bp1de348lntdwcdf****	关联资源的ID。
ResourceType	String	VSwitch	关联资源的类型。
Status	String	BINDED	关联资源的状态。 BINDED：已绑定。 BINDING：绑定中。 UNBINDING：已解绑。

示例

请求示例

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

正常返回示例

XML 格式

<DescribeNetworkAclsResponse>
  <PageNumber>1</PageNumber>
  <TotalCount>2</TotalCount>
  <PageSize>10</PageSize>
  <RequestId>F7DDDC17-FA06-4AC2-8F35-59D2470FCFC1</RequestId>
  <NetworkAcls>
        <NetworkAcl>
              <EgressAclEntries>
                    <EgressAclEntry>
                          <Port>-1/-1</Port>
                          <Policy>accept</Policy>
                          <NetworkAclEntryId>nae-a2d8hqm2ueaeucdvf****</NetworkAclEntryId>
                          <DestinationCidrIp>10.0.0.0/24</DestinationCidrIp>
                          <Protocol>all</Protocol>
                    </EgressAclEntry>
              </EgressAclEntries>
              <CreationTime>2019-04-25 11:44:17</CreationTime>
              <Status>Available</Status>
              <RegionId>cn-hangzhou</RegionId>
              <IngressAclEntries>
                    <IngressAclEntry>
                          <SourceCidrIp>10.0.0.0/24</SourceCidrIp>
                          <Port>-1/-1</Port>
                          <Policy>accept</Policy>
                          <NetworkAclEntryId>nae-a2dv360rgpczdcdvf****</NetworkAclEntryId>
                          <Protocol>all</Protocol>
                    </IngressAclEntry>
              </IngressAclEntries>
              <VpcId>vpc-a2d33rfpl72k5cdvf****</VpcId>
              <NetworkAclId>nacl-a2d504869xhaecdvf****</NetworkAclId>
              <Resources>
        </Resources>
        </NetworkAcl>
        <NetworkAcl>
              <EgressAclEntries>
                    <EgressAclEntry>
                          <Port>-1/-1</Port>
                          <Policy>accept</Policy>
                          <NetworkAclEntryId>nae-a2d05l0auxh7icdvf****</NetworkAclEntryId>
                          <DestinationCidrIp>10.0.0.0/24</DestinationCidrIp>
                          <Protocol>all</Protocol>
                    </EgressAclEntry>
              </EgressAclEntries>
              <CreationTime>2019-04-25 11:44:14</CreationTime>
              <Status>Available</Status>
              <RegionId>cn-hangzhou</RegionId>
              <IngressAclEntries>
                    <IngressAclEntry>
                          <SourceCidrIp>10.0.0.0/24</SourceCidrIp>
                          <Port>-1/-1</Port>
                          <Policy>accept</Policy>
                          <NetworkAclEntryId>nae-a2dy2eq7mudblcdvf****</NetworkAclEntryId>
                          <Protocol>all</Protocol>
                    </IngressAclEntry>
              </IngressAclEntries>
              <VpcId>vpc-a2d33rfpl72k5cdvf****</VpcId>
              <NetworkAclId>nacl-a2detw6o77x7lcdvf****</NetworkAclId>
              <Resources>
        </Resources>
        </NetworkAcl>
  </NetworkAcls>
</DescribeNetworkAclsResponse>

JSON 格式

{
   "PageNumber": 1,
   "TotalCount": 2,
   "PageSize": 10,
   "RequestId": "F7DDDC17-FA06-4AC2-8F35-59D2470FCFC1",
   "NetworkAcls": {"NetworkAcl":    [
            {
         "EgressAclEntries": {"EgressAclEntry": [         {
            "Port": "-1/-1",
            "Policy": "accept",
            "NetworkAclEntryId": "nae-a2d8hqm2ueaeucdvf****",
            "DestinationCidrIp": "10.0.0.0/24",
            "Protocol": "all"
         }]},
         "CreationTime": "2019-04-25 11:44:17",
         "Status": "Available",
         "RegionId": "cn-hangzhou",
         "IngressAclEntries": {"IngressAclEntry": [         {
            "SourceCidrIp": "10.0.0.0/24",
            "Port": "-1/-1",
            "Policy": "accept",
            "NetworkAclEntryId": "nae-a2dv360rgpczdcdvf****",
            "Protocol": "all"
         }]},
         "VpcId": "vpc-a2d33rfpl72k5cdvf****",
         "NetworkAclId": "nacl-a2d504869xhaecdvf****",
         "Resources": {"Resource": []}
      },
            {
         "EgressAclEntries": {"EgressAclEntry": [         {
            "Port": "-1/-1",
            "Policy": "accept",
            "NetworkAclEntryId": "nae-a2d05l0auxh7icdvf****",
            "DestinationCidrIp": "10.0.0.0/24",
            "Protocol": "all"
         }]},
         "CreationTime": "2019-04-25 11:44:14",
         "Status": "Available",
         "RegionId": "cn-hangzhou",
         "IngressAclEntries": {"IngressAclEntry": [         {
            "SourceCidrIp": "10.0.0.0/24",
            "Port": "-1/-1",
            "Policy": "accept",
            "NetworkAclEntryId": "nae-a2dy2eq7mudblcdvf****",
            "Protocol": "all"
         }]},
         "VpcId": "vpc-a2d33rfpl72k5cdvf****",
         "NetworkAclId": "nacl-a2detw6o77x7lcdvf****",
         "Resources": {"Resource": []}
      }
   ]}
}

错误码


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

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