调用DescribeNetworkAclAttributes接口查询网络ACL的详细信息。

调试

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

请求参数

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

要执行的操作,取值: DescribeNetworkAclAttributes

NetworkAclId String nacl-a2do9e413e0spzasx****

网络ACL的ID。

RegionId String cn-hangzhou

网络ACL所在的地域。您可以通过调用DescribeRegions接口获取地域ID。

ClientToken String 0c593ea1-3bea-11e9-b96b-88e9fe637760

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

返回数据

名称 类型 示例值 描述
RequestId String F5905F9C-0161-4E72-9CB1-1F3F3CF6268A

请求ID。

NetworkAclAttribute Struct

网络ACL的详细信息。

NetworkAclId String nacl-a2do9e413e0spnhmj****

网络ACL的ID。

RegionId String cn-hangzhou

网络ACL所属的地域。

NetworkAclName String acl-1

网络ACL的名称。

Description String This is my NetworkAcl.

网络ACL的描述信息。

VpcId String vpc-a2d33rfpl72k5defr****

网络ACL关联的VPC的ID。

CreationTime String 2019-04-25 11:33:27

网络ACL创建的时间。

Status String Available

关联资源的状态。

  • Available:可用。
  • Modifying:配置中。
IngressAclEntries Array

网络ACL入方向规则信息。

NetworkAclEntryId String nae-a2dk86arlydmevfbg****

入方向规则条目的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

网络ACL出方向规则信息。

NetworkAclEntryId String nae-a2d447uw4tillxdcv****

出方向规则条目的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-bp1de348lntdwxscd****

关联资源的实例ID。

ResourceType String VSwitch

关联资源的类型。

Status String BINDED

关联资源的状态。

  • BINDED:已绑定。
  • BINDING:绑定中。
  • UNBINDING:已解绑。

示例

请求示例

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

正常返回示例

XML 格式

<DescribeNetworkAclAttributesResponse>
  <NetworkAclAttribute>
        <CreationTime>2019-04-25 11:33:27</CreationTime>
        <EgressAclEntries>
              <EgressAclEntry>
                    <Port>-1/-1</Port>
                    <Policy>accept</Policy>
                    <NetworkAclEntryId>nae-a2d447uw4tillcdvf****</NetworkAclEntryId>
                    <DestinationCidrIp>10.0.0.0/24</DestinationCidrIp>
                    <Protocol>all</Protocol>
              </EgressAclEntry>
        </EgressAclEntries>
        <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-a2dk86arlydmecdvf****</NetworkAclEntryId>
                    <Protocol>all</Protocol>
              </IngressAclEntry>
        </IngressAclEntries>
        <NetworkAclId>nacl-a2do9e413e0spcdvf****</NetworkAclId>
        <VpcId>vpc-a2d33rfpl72k5cdvfcdvf****</VpcId>
        <Resources>
    </Resources>
  </NetworkAclAttribute>
  <RequestId>F5905F9C-0161-4E72-9CB1-1F3F3CF6268A</RequestId>
</DescribeNetworkAclAttributesResponse>

JSON 格式

{
   "NetworkAclAttribute":    {
      "CreationTime": "2019-04-25 11:33:27",
      "EgressAclEntries": {"EgressAclEntry": [      {
         "Port": "-1/-1",
         "Policy": "accept",
         "NetworkAclEntryId": "nae-a2d447uw4tillcdvf****",
         "DestinationCidrIp": "10.0.0.0/24",
         "Protocol": "all"
      }]},
      "Status": "Available",
      "RegionId": "cn-hangzhou",
      "IngressAclEntries": {"IngressAclEntry": [      {
         "SourceCidrIp": "10.0.0.0/24",
         "Port": "-1/-1",
         "Policy": "accept",
         "NetworkAclEntryId": "nae-a2dk86arlydmecdvf****",
         "Protocol": "all"
      }]},
      "NetworkAclId": "nacl-a2do9e413e0spcdvf****",
      "VpcId": "vpc-a2d33rfpl72k5cdvfcdvf****",
      "Resources": {"Resource": []}
   },
   "RequestId": "F5905F9C-0161-4E72-9CB1-1F3F3CF6268A"
}

错误码

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

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