Query ACL Rules
Last Updated：2020-09-29
Description
Query the ACL rule information. The system creates 2 default ACL rules (no Id) for the users. And there is one ACL rule for the ingress and the egress respectively, and the rule contents are all for ingress or egress. The default rule doesn't support change and deletion.
Request Structure
GET /v{version}/acl/rule?marker={marker}&maxKeys={maxKeys}&subnetId={subnetId} HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization stringRequest Header
There are no other special headers except the public headers.
Request Parameter
| Parameter name | Type | Required or not | Parameter position | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | API version number |
| marker | String | No | Query parameter | The starting location of query for batch acquisition of lists, and is one string generated by the system. |
| maxKeys | Integer | No | Query parameter | Maximum number contained in each page, generally not exceeding 1000. The default value is 1000. |
| subnetId | String | Yes | Query parameter | ID of subnet |
Return Header
There are no other special headers except the public headers.
Return Parameter
| Parameter name | Type | Description |
|---|---|---|
| marker | String | It marks the queried starting position. |
| isTruncated | boolean | True means there are additional data in the following pages and false means the current page is the last page. |
| nextMarker | String | The marker value requiring to be passed in order to acquire the next page. The domain doesn't appear when isTruncated is false. |
| maxKeys | Integer | Maximum number contained in each page. |
| aclRules | List<AclRule> | Set composed by the ACL rule information |
Request Example
GET /v1/acl/rule?marker=ar-ik9p9zq6u5ry&maxKeys=1&subnetId=sbn-svz99ha4a40w HTTP/1.1
Host: bcc.bj.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2017-03-11T04:17:29Z/3600/ host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1deReturn Example
HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Thu, 16 Mar 2017 06:29:48 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS
{
"nextMarker": "ar-Iy8p6arqenI7",
"marker": "ar-ik9p9zq6u5ry",
"maxKeys": 1,
"isTruncated": true,
"aclRules":[
{
"id":"ar-ik9p9zq6u5ry",
"subnetId":"sbn-svz99ha4a40w",
"description":"",
"protocol":"tcp",
"sourceIpAddress":"192.168.0.0",
"destinationIpAddress":"192.168.0.0/20",
"sourcePort":"1-65535",
"destinationPort":"443",
"position":2,
"direction":"ingress",
"action":"allow"
}
]
}