# 查看ACL策略列表
#### 功能介绍
查询所有的ACL策略列表。
#### URI
HTTP/HTTPS请求方法以及URI如下表所示。
表1HTTP/HTTPS请求方法以及URI 
| 请求方法 | URI                                                                      |
|:---|:---|
| GET  | /v1.0/apigw/acls\[?page_size, page_no, id, name, acl_type, entity_type\] |
   
![](https://support.huaweicloud.com/api-apig/public_sys-resources/note_3.0-zh-cn.png)
- 可以在URI后面用'?'和'\&'添加不同的查询条件组合。
- 查询条件可为以下字段以及对应的值：id、name、acl_type、entity_type、page_size、page_no。
 
URI中的参数说明如下表所示。
表2参数说明 
| 名称             | 是否必选 | 类型      | 说明                        |
|:---|:---|:---|:---|
| id             | 否    | String  | 编号                        |
| name           | 否    | String  | 名称                        |
| acl_type       | 否    | String  | 类型：PERMIT或DENY            |
| entity_type    | 否    | String  | 作用的对象类型：IP或DOMAIN         |
| page_size      | 否    | Integer | 每页显示的条数，默认值：20            |
| page_no        | 否    | Integer | 页码，默认值：1                  |
| precise_search | 否    | String  | 指定需要精确匹配查找的参数名称，目前仅支持name |
   
#### 请求消息
无。
#### 响应消息
表3参数说明 
| 名称    | 类型      | 说明             |
|:---|:---|:---|
| size  | Integer | 当前页返回的ACL策略个数  |
| total | Integer | ACL策略总个数       |
| acls  | 字典数据类型  | 本次查询返回的ACL策略列表 |
   
表4acls参数说明 
| 名称          | 类型        | 说明                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|
| id          | String    | 编号                                                                                                                                                                                                                                                                                                                                                                                 |
| acl_name    | String    | 名称                                                                                                                                                                                                                                                                                                                                                                                 |
| acl_type    | String    | 类型 - PERMIT（白名单类型）  - DENY（黑名单类型）   |
| acl_value   | String    | ACL策略的值                                                                                                                                                                                                                                                                                                                                                                            |
| entity_type | String    | 对象类型： - IP  - DOMAIN                  |
| update_time | Timestamp | 更新时间                                                                                                                                                                                                                                                                                                                                                                               |
| bind_num    | Integer   | 绑定的API数量                                                                                                                                                                                                                                                                                                                                                                           |
   
响应消息样例：
```
{
"total": 1,
"size": 1,
"acls": [{
"id": "d402b35e-1054-4280-b1c5-0d741a28c995",
"acl_name": "goodone",
"entity_type": "DOMAIN",
"acl_type": "PERMIT",
"acl_value": "19asdfaf-adfadf",
"update_time": "2017-11-18T14:27:36.918578+08:00",
                "bind_num":1
}]
}
```
#### 状态码
表5返回消息说明 
| 状态码 | 说明                    |
|:---|:---|
| 200 | OK                    |
| 400 | Bad Request           |
| 500 | Server Internal Error |