查询ACL列表
更新时间：2025-08-05
接口描述
本接口用于查询ACL列表。
请求结构
Plain Text
1GET /v1/vpc/acl/list?vpcId=®ionId=&keywordType=&keyword&pageNo=1&pageSize=10 HTTP/1.1
2Host: bec.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| pageNo | Integer | 否 | Query参数 | 页号，缺省值为1 |
| pageSize | Integer | 否 | Query参数 | 查询返回每页个数，取值范围为1～100，缺省值为100 |
| keywordType | String | 否 | Query参数 | 关键字类型，取值为aclName、vpcName |
| keyword | String | 否 | Query参数 | 查询的关键字值 |
| vpcId | String | 否 | Query参数 | VPC ID |
| regionId | String | 否 | Query参数 | 节点ID。用于查询所属节点的资源 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| result | List<AclVo> | ACL列表数据 |
| orderBy | String | 排序字段，缺省为createTime |
| order | String | 排序顺序,取值为DESC、ASC，分别表示为降序、升序。缺省为DESC |
| pageNo | Integer | 页码 |
| pageSize | Integer | 每页结果数 |
| totalCount | Integer | 结果总数 |
请求示例
Plain Text
1GET /v1/vpc/acl/list?pageNo=1&pageSize=10 HTTP/1.1
2Host: bec.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2021-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4 返回示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 7e789a40-adac-414a-8bd4-916d6be61112
3Date: Mon, 02 Apr 2018 08:14:25 GMT
4Content-Type: application/json;charset=UTF-8
5Server: BWS
6{
7 "result":{
8 "order":"desc",
9 "orderBy":"createTime",
10 "orders":null,
11 "pageNo":1,
12 "pageSize":10,
13 "result":[
14 {
15 "aclId":"acl-osgqdity",
16 "aclName":"默认ACL",
17 "city":"CHANGCHUN",
18 "region":"NORTH_EAST",
19 "regionId":"cn-changchun-ix",
20 "serviceProvider":"TRIPLE_LINE",
21 "subnetCount":0,
22 "vpcCidr":"192.168.0.0/16",
23 "vpcId":"vpc-8vd3r0pe",
24 "vpcName":"test-1221"
25 },
26 {
27 "aclId":"acl-vc07ez6b",
28 "aclName":"默认ACL",
29 "city":"HANGZHOU",
30 "region":"EAST_CHINA",
31 "regionId":"cn-hangzhou-cm",
32 "serviceProvider":"CHINA_MOBILE",
33 "subnetCount":1,
34 "vpcCidr":"192.168.0.0/16",
35 "vpcId":"vpc-djn3wxpu",
36 "vpcName":"vpc-test-hangzhou-m-156"
37 }
38 ],
39 "totalCount":2
40 },
41 "success":true
42}错误码
请参照错误返回章节的内容。
Model对象定义
AclVo
| 参数名称 | 类型 | 描述 |
|---|---|---|
| aclId | String | ACL ID |
| aclName | String | ACL名称 |
| vpcId | String | VPC ID |
| vpcName | String | VPC名称 |
| vpcCidr | String | VPC 网段及子网掩码CIDR |
| subnetCount | Integer | 子网数量 |
| region | String | 地域 |
| serviceProvider | String | 运营商 |
| city | String | 城市 |
| regionId | String | 节点ID |