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

调试

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

请求参数

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

要执行的操作,取值: DescribeNetworkAclAttributes

NetworkAclId String nacl-a2do9e413e0spzasx****

网络ACL的ID。

RegionId String cn-hangzhou

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

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

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

返回数据

名称 类型 示例值 描述
NetworkAclAttribute Struct

网络ACL的详细信息。

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

网络ACL创建的时间。

Description String This is my NetworkAcl.

网络ACL的描述信息。

EgressAclEntries Array of EgressAclEntry

网络ACL出方向规则信息。

EgressAclEntry
Description String This is EgressAclEntries.

出方向规则的描述信息。

DestinationCidrIp String 10.0.0.0/24

目的地址段。

NetworkAclEntryId String nae-a2d447uw4tillxdcv****

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

网络ACL入方向规则信息。

IngressAclEntry
Description String This is IngressAclEntries.

入方向规则的描述信息。

NetworkAclEntryId String nae-a2dk86arlydmevfbg****

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

网络ACL的ID。

NetworkAclName String acl-1

网络ACL的名称。

OwnerId Long 12345678

网络ACL所属的账号ID。

RegionId String cn-hangzhou

网络ACL所属的地域ID。

Resources Array of Resource

关联的资源。

Resource
ResourceId String vsw-bp1de348lntdwxscd****

关联资源的实例ID。

ResourceType String VSwitch

关联资源的类型。

Status String BINDED

关联资源的状态。

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

关联资源的状态。

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

网络ACL关联的VPC的ID。

RequestId String F5905F9C-0161-4E72-9CB1-1F3F3CF6268A

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeNetworkAclAttributes
&NetworkAclId=nacl-a2do9e413e0spzasx****
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML格式

<DescribeNetworkAclAttributesResponse>
  <RequestId>F5905F9C-0161-4E72-9CB1-1F3F3CF6268A</RequestId>
  <NetworkAclAttribute>
        <Status>Available</Status>
        <Description>This is my NetworkAcl.</Description>
        <OwnerId>12345678</OwnerId>
        <VpcId>vpc-a2d33rfpl72k5defr****</VpcId>
        <NetworkAclId>nacl-a2do9e413e0spnhmj****</NetworkAclId>
        <CreationTime>2019-04-25 11:33:27</CreationTime>
        <NetworkAclName>acl-1</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-a2dk86arlydmevfbg****</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-a2d447uw4tillxdcv****</NetworkAclEntryId>
              </EgressAclEntry>
        </EgressAclEntries>
        <Resources>
              <Resource>
                    <Status>BINDED</Status>
                    <ResourceId>vsw-bp1de348lntdwxscd****</ResourceId>
                    <ResourceType>VSwitch</ResourceType>
              </Resource>
        </Resources>
  </NetworkAclAttribute>
</DescribeNetworkAclAttributesResponse>

JSON格式

{
    "RequestId": "F5905F9C-0161-4E72-9CB1-1F3F3CF6268A",
    "NetworkAclAttribute": {
        "Status": "Available",
        "Description": "This is my NetworkAcl.",
        "OwnerId": 12345678,
        "VpcId": "vpc-a2d33rfpl72k5defr****",
        "NetworkAclId": "nacl-a2do9e413e0spnhmj****",
        "CreationTime": "2019-04-25 11:33:27",
        "NetworkAclName": "acl-1",
        "RegionId": "cn-hangzhou",
        "IngressAclEntries": {
            "IngressAclEntry": {
                "Policy": "accept",
                "Description": "This is IngressAclEntries.",
                "Port": "-1/-1",
                "SourceCidrIp": "10.0.0.0/24",
                "NetworkAclEntryName": "acl-3",
                "Protocol": "all",
                "NetworkAclEntryId": "nae-a2dk86arlydmevfbg****"
            }
        },
        "EgressAclEntries": {
            "EgressAclEntry": {
                "Policy": "accept",
                "Description": "This is EgressAclEntries.",
                "DestinationCidrIp": "10.0.0.0/24",
                "Port": "-1/-1",
                "NetworkAclEntryName": "acl-2",
                "Protocol": "all",
                "NetworkAclEntryId": "nae-a2d447uw4tillxdcv****"
            }
        },
        "Resources": {
            "Resource": {
                "Status": "BINDED",
                "ResourceId": "vsw-bp1de348lntdwxscd****",
                "ResourceType": "VSwitch"
            }
        }
    }
}

错误码

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

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