Queries the network access control lists (ACLs) in a region.

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 ListAcls

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

AclIds Array of String No nacl-hp34s2h0xx1ht4nwo****

The ID of the network ACL. You can specify at most 20 network ACL IDs in each request.

AclNames Array of String No test-acl

The names of the network ACLs. You can specify at most 10 network ACL names in each request.

ResourceGroupId String No rg-atstuj3rtopty****

The ID of the resource group. You can filter the query results based on the specified ID.

NextToken String No FFmyTO70tTpLG6I3FmYAXGKPd****

The token that is used for the next query. Valid values:

  • If this is your first query or no next query is to be sent, ignore this parameter.
  • If a next query is to be sent, set the value to the value of NextToken that is returned from the last call.
MaxResults Integer No 50

The maximum number of entries to return. This parameter is optional. Valid values: 1 to 100. Default value: 20.

Response parameters

Parameter Type Example Description
Acls Array of Acl

The network ACLs.

AclId String nacl-hp34s2h0xx1ht4nwo****

The ID of the network ACL.

AclName String test-acl

The name of the network ACL.

AclStatus String Available

The status of the network ACL. Valid values:

  • Creating: The network ACL is being created.
  • Available: The network ACL is available.
  • Configuring: The network ACL is being configured.
AddressIPVersion String IPv4

The IP version. IPv4 is returned.

ResourceGroupId String rg-atstuj3rtopty****

The ID of the resource group.

ConfigManagedEnabled Boolean false

The status of configuration management. Valid values:

  • true: configuration management is enabled.
  • false: configuration management is disabled.
MaxResults Integer 20

The maximum number of network ACLs returned. This parameter is optional. Valid values: 1 to 100. If this parameter is not set, the default value 20 is returned.

NextToken String FFmyTO70t****

The token that is used for the next query. Valid values:

  • If NextToken is empty, it indicates that no next query is to be sent.
  • If NextToken is returned, the value indicates the token that is used for the next query.
RequestId String 593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3

The ID of the request.

TotalCount Integer 10

The total number of entries returned.

Examples

Sample requests

http(s)://[Endpoint]/?Action=ListAcls
&AclIds=["nacl-hp34s2h0xx1ht4nwo****"]
&AclNames=["test-acl"]
&ResourceGroupId=rg-atstuj3rtopty****
&NextToken=FFmyTO70tTpLG6I3FmYAXGKPd****
&MaxResults=50
&Common request parameters

Sample success responses

XML format 

HTTP/1.1 200 OK
Content-Type:application/xml

<ListAclsResponse>
    <Acls>
        <AclId>nacl-hp34s2h0xx1ht4nwo****</AclId>
        <AclName>test-acl</AclName>
        <AclStatus>Available</AclStatus>
        <AddressIPVersion>IPv4</AddressIPVersion>
        <ResourceGroupId>rg-atstuj3rtopty****</ResourceGroupId>
        <ConfigManagedEnabled>false</ConfigManagedEnabled>
    </Acls>
    <MaxResults>20</MaxResults>
    <NextToken>FFmyTO70t****</NextToken>
    <RequestId>593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3</RequestId>
    <TotalCount>10</TotalCount>
</ListAclsResponse>

JSON format 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Acls" : [ {
    "AclId" : "nacl-hp34s2h0xx1ht4nwo****",
    "AclName" : "test-acl",
    "AclStatus" : "Available",
    "AddressIPVersion" : "IPv4",
    "ResourceGroupId" : "rg-atstuj3rtopty****",
    "ConfigManagedEnabled" : false
  } ],
  "MaxResults" : 20,
  "NextToken" : "FFmyTO70t****",
  "RequestId" : "593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3",
  "TotalCount" : 10
}

Error codes

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