Queries ACL entries.

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 ListAclEntries

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

NextToken String No caeba0bbb2be03f84eb48b699f0a****

The start position of the query. If this parameter is left empty, the query starts from the beginning.

MaxResults Integer No 50

The maximum number of data records to be queried. Valid values: 1 to 100. Default value: 20.

AclId String Yes nacl-hp34s2h0xx1ht4nwo****

The ID of the ACL instance

Response parameters

Parameter Type Example Description
AclEntries Array of AclEntry

The ACL entries.
Description String test-entry

The description of the ACL entry The description must be 1 to 256 characters in length, and can contain letters, digits, hyphens (-), forward slashes (/), periods (.), and underscores (_). It can also contain Chinese characters.

Entry String 10.0.1.1/24

The IP address of the ACL entry.
Status String Available

The status of the ACL entry. Valid values:

  • Adding: The entry is being added.
  • Available: The entry is added and available.
  • Removing: The entry is being removed.
MaxResults Integer 50

The maximum number of data records that was queried. Thisparameter is optional. Valid values: 1 to 100. Default value: 20.

NextToken String caeba0bbb2be03f84eb48b699f0a****

The end position where the query. If the response does not contain this parameter, all data is queried.

RequestId String CEF72CEB-54B6-4AE8-B225-F876FF7BA984

The ID of the request.
TotalCount Integer 1000

The total numer of entries returned.

Examples

Sample requests

http(s)://[Endpoint]/?Action=caeba0bbb2be03f84eb48b699f0a****
&NextToken=caeba0bbb2be03f84eb48b699f0a****
&MaxResults=50
&AclId=nacl-hp34s2h0xx1ht4nwo****
&<Common request parameters>

Sample success responses

XML format 

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

<ListAclEntriesResponse>
    <AclEntries>
        <Description>test-entry</Description>
        <Entry>10.0.1.1/24</Entry>
        <Status>Available</Status>
    </AclEntries>
    <MaxResults>50</MaxResults>
    <NextToken>caeba0bbb2be03f84eb48b699f0a****</NextToken>
    <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
    <TotalCount>1000</TotalCount>
</ListAclEntriesResponse>

JSON format 

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

{
  "AclEntries" : [ {
    "Description" : "test-entry",
    "Entry" : "10.0.1.1/24",
    "Status" : "Available"
  } ],
  "MaxResults" : 50,
  "NextToken" : "caeba0bbb2be03f84eb48b699f0a****",
  "RequestId" : "CEF72CEB-54B6-4AE8-B225-F876FF7BA984",
  "TotalCount" : 1000
}

Error codes

HttpCode Error code Error message Description
404 ResourceNotFound.Acl The specified resource %s is not found. The error message returned because the specified resource %s does not exist.

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