查看ACL策略列表

功能介绍

查询所有的ACL策略列表。

URI

HTTP/HTTPS请求方法以及URI如下表所示。

表1 HTTP/HTTPS请求方法以及URI
请求方法	URI
GET	/v1/{project_id}/apigw/instances/{instance_id}/acls[?page_size, page_no, id, name, acl_type, entity_type]

可以在URI后面用‘?’和‘&’添加不同的查询条件组合。
查询条件可为以下字段以及对应的值：id、name、acl_type、entity_type、page_size、page_no。

URI中的参数说明如下表所示。

表2 参数说明
名称	是否必选	类型	说明
project_id	是	String	项目ID。可从控制台“我的凭证”中获取region下项目ID，管理员权限可查询。
instance_id	是	String	实例ID，可从API网关控制台的专享版实例信息中获取。
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策略列表

表4 acls参数说明
名称	类型	说明
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
	}]
}