# 查看API绑定的ACL策略列表
#### 功能介绍
查看API绑定的ACL策略列表。
#### URI
HTTP/HTTPS请求方法以及URI如下表所示
表1HTTP/HTTPS请求方法以及URI 
| 请求方法 | URI                                                                                               |
|:---|:---|
| GET  | /v1.0/apigw/acl-bindings/binded-acls\[?page_no,page_size,api_id,env_id,env_name,acl_id,acl_name\] |
   
![](https://support.huaweicloud.com/api-apig/public_sys-resources/note_3.0-zh-cn.png)
- 可以在URI后面用'?'和'\&'添加不同的查询条件组合。
- 查询条件可为以下字段以及对应的值：api_id、env_id、env_name、acl_id、acl_name、page_size、page_no。
 
URI中的参数说明如下表所示。
表2参数说明 
| 名称        | 是否必选 | 类型      | 说明             |
|:---|:---|:---|:---|
| api_id    | 是    | String  | API编号          |
| env_id    | 否    | String  | 环境编号           |
| env_name  | 否    | String  | 环境名称           |
| acl_id    | 否    | String  | ACL策略编号        |
| acl_name  | 否    | String  | ACL策略名称        |
| page_size | 否    | Integer | 每页显示的条数，默认值：20 |
| page_no   | 否    | Integer | 页码，默认值：1       |
   
#### 请求消息
无
#### 响应消息
表3参数说明 
| 参数    | 类型      | 说明           |
|:---|:---|:---|
| total | Integer | 绑定的ACL总数     |
| size  | Integer | 本次查询返回的ACL数量 |
| acls  | 字典数据类型  | 本次查询返回的ACL列表 |
   
表4acls参数说明 
| 名称          | 类型        | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|
| acl_id      | String    | ACL策略编号                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| acl_name    | String    | ACL策略名称                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| acl_type    | String    | ACL策略类型 - PERMIT (白名单类型)  - DENY (黑名单类型)                                                                                                                          |
| acl_value   | String    | ACL策略值                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| entity_type | String    | ACL策略作用的对象类型： - IP  - DOMAIN  - ADMIN   |
| env_id      | String    | 生效的环境编号                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| env_name    | String    | 生效的环境名称                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| bind_id     | String    | 绑定关系编号                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| bind_time   | Timestamp | 绑定时间                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
   
响应消息样例：
```
{
  "total": 1,
  "size": 1,
  "acls": [
    {
      "acl_id": "206bb985d8a04ec09f13c3e51ef77095",
      "acl_name": "acl_001",
      "entity_type": "IP",
      "acl_type": "PERMIT",
      "acl_value": "192.168.1.14,192.168.2.0/24,192.168.1.8-192.168.1.110",
      "env_id": "DEFAULT_ENVIRONMENT_RELEASE_ID",
      "env_name": "RELEASE",
      "bind_id": "4ffc0da71ddd4c22add8ff801e19846c",
      "bind_time": "2018-07-27T11:27:10Z"
    }
  ]
}
```
#### 状态码
表5返回消息说明 
| 状态码 | 说明                    |
|:---|:---|
| 200 | OK                    |
| 400 | Bad Request           |
| 403 | Forbidden             |
| 404 | Not Found             |
| 500 | Server Internal Error |