文档首页/ API网关 APIG/ API参考/ 专享版API（V1）（待下线）/ ACL策略管理（待下线）/ 查看ACL策略列表
更新时间：2022-08-30 GMT+08:00
查看PDF
分享

查看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
	}]
}

状态码

表5 返回消息说明

状态码

说明

200

OK

400

Bad Request

500

Server Internal Error

相关文档