Queries network access control lists (ACLs).

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 DescribeAccessControlLists

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

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.

AclName String No rule1

NetworkACLName. The name of the network ACL. The name must be 1 to 80 characters in length, and can contain only letters, digits, periods (.), hyphens (-), forward slashes (/), and underscores (_). The name of the network ACL must be unique within each region.

AddressIPVersion String No ipv4

The IP version of the SLB instance with which the network ACL is associated. Valid values:

  • ipv4: specifies a Server Load Balancer (SLB) instance that uses an IPv4 address.
  • ipv6: specifies an SLB instance that uses an IPv6 address.
PageSize Integer No 10

The number of entries to return on each page. Maximum value: 50. Default value: 10.

PageNumber Integer No 1

The number of the page to return. Default value: 1.

ResourceGroupId String No rg-atstuj3rtop*****

The ID of the resource group.

Response parameters

Parameter Type Example Description
Acls Array of Acl

The list of network ACLs.

Acl
AclId String acl-bp1l0kk4gxce43k*****

The ID of the network ACL.

AclName String rule1

The name of the network ACL.

AddressIPVersion String ipv4

The IP version that is used by the associated SLB instance.

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

The ID of the resource group.

Count Integer 5

The number of network ACLs on the current page.

PageNumber Integer 2

The number of the returned page. Minimum value: 1. Default value: 1.

PageSize Integer 3

The number of entries returned per page.

Default value: 50.

RequestId String 3CB646EF-6147-4566-A9D9-CE8FBE86F971

The ID of the request.

TotalCount Integer 3

The number of network ACLs.

Examples

Sample requests

http(s)://[Endpoint]/?Action=DescribeAccessControlLists
&RegionId=cn-hangzhou
&<Common request parameters>

Sample success responses

XML format 

<DescribeAccessControlListsResponse>
	  <RequestId>3CB646EF-6147-4566-A9D9-CE8FBE86F971</RequestId>
	  <Acls>
		    <Acl>
			      <AclId>acl-bp1j9vn2g7wm9wn0*****</AclId>
			      <AclName>test</AclName>
			      <AddressIPVersion>ipv4</AddressIPVersion>
		    </Acl>
		    <Acl>
			      <AclId>acl-bp1l0kk4gxce43*****</AclId>
			      <AclName>doctest</AclName>
			      <AddressIPVersion>ipv4</AddressIPVersion>
		    </Acl>
	  </Acls>
</DescribeAccessControlListsResponse>

JSON format 

{
    "RequestId": "3CB646EF-6147-4566-A9D9-CE8FBE86F971", 
    "Acls": {
        "Acl": [
            {
                "AclId": "acl-bp1j9vn2g7wm9wn0****", 
                "AclName": "test", 
                "AddressIPVersion": "ipv4"
            }, 
            {
                "AclId": "acl-bp1l0kk4gxce43*****", 
                "AclName": "doctest", 
                "AddressIPVersion": "ipv4"
            }
        ]
    }
}

Error codes

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