Queries the configurations of a network access control list (ACL).

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeAccessControlListAttribute

The operation that you want to perform. Set the value to DescribeAccessControlListAttribute.

AclId String Yes acl-bp1l0k********kzet04s

The ID of the network ACL that you want to query.

RegionId String Yes cn-hangzhou

The ID of the region where the network ACL is created.

You can call the DescribeRegions operation to query region IDs.

AclEntryComment String No test

The description of the network ACL entry.

Response parameters

Parameter Type Example Description
AclEntrys Array of AclEntry

The information about the network ACL entries.

AclEntry
AclEntryComment String The network ACL entry.

The description of the network ACL entry.

AclEntryIP String 192.168.0.1

The IP address specified in the network ACL entry.

AclId String acl-bp1l0k********kzet04s

The ID of the network ACL.

AclName String doctest

The name of the network ACL.

AddressIPVersion String ipv4

The IP version of the instance with which the network ACL is associated.

RelatedListeners Array of RelatedListener

The list of listeners with which the network ACL is associated.

RelatedListener
AclType String white

The type of network ACL. Valid values:

  • black: a blacklist.
  • white: a whitelist.
ListenerPort Integer 443

The frontend port of the listener with which the network ACL is associated.

LoadBalancerId String lb-bp13j********1miup

The ID of the Server Load Balancer (SLB) instance.

Protocol String https

The type of protocol that the associated listener uses.

RequestId String C9906A1D-86F7-4C9C-A369-54DA42EF206A

The ID of the request.

ResourceGroupId String rg-******************

The ID of the enterprise resource group.

Examples

Sample requests

http(s)://[Endpoint]/?Action=DescribeAccessControlListAttribute
&AclId=acl-bp1l0k********kzet04s
&RegionId=cn-hangzhou
&<Common request parameters>

Sample success responses

XML format 

<DescribeAccessControlListAttributeResponse>
  <AclEntrys>
        <AclEntry>
              <AclEntryIP>192.168.0.1</AclEntryIP>
              <AclEntryComment>The network ACL entry. </AclEntryComment>
        </AclEntry>
  </AclEntrys>
  <ResourceGroupId>rg-******************</ResourceGroupId>
  <RequestId>C9906A1D-86F7-4C9C-A369-54DA42EF206A</RequestId>
  <AddressIPVersion>ipv4</AddressIPVersion>
  <AclId>acl-bp1l0k********kzet04s</AclId>
  <RelatedListeners>
        <RelatedListener>
              <ListenerPort>443</ListenerPort>
              <AclType>white</AclType>
              <LoadBalancerId>lb-bp13j********1miup</LoadBalancerId>
              <Protocol>https</Protocol>
        </RelatedListener>
  </RelatedListeners>
  <AclName>doctest</AclName>
</DescribeAccessControlListAttributeResponse>

JSON format 

{
    "AclEntrys":
    {
        "AclEntry":
        [
            {
                "AclEntryIP":"192.168.0.1",
                "AclEntryComment":"The network ACL entry."
                }
                ]
                },
                "ResourceGroupId":"rg-******************",
                "RequestId":"C9906A1D-86F7-4C9C-A369-54DA42EF206A",
                "AddressIPVersion":"ipv4",
                "AclId":"acl-bp1l0k********kzet04s",
                "RelatedListeners":
                {
                    "RelatedListener":
                    [
                        {
                            "ListenerPort":"443",
                            "AclType":"white",
                            "LoadBalancerId":"lb-bp13j********1miup",
                            "Protocol":"https"
                            }
                            ]
                            },
                            "AclName":"doctest"}

Error codes

For a list of error codes, visit the API Error Center.