更新时间:2022-02-21 GMT+08:00

查看API绑定的ACL策略列表

功能介绍

查看API绑定的ACL策略列表。

URI

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

表1 HTTP/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]

  • 可以在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列表

表4 acls参数说明

名称

类型

说明

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