文档首页/API网关 APIG/API参考/共享版API（仅存量用户使用）/ACL策略管理/对象模型
更新时间：2025-05-07 GMT+08:00
查看PDF
分享

对象模型

API发布后，如果不想API被某些IP地址访问到，可以将这些IP地址加入黑名单，或者想API被某些特性的IP地址访问到，也可以将这些IP地址加入白名单。这样可以提高API的访问安全性，保护API免受攻击。本节介绍API的黑白名单（ACL策略）管理的对象模型，如表1 ACL策略对象模型所示。

  • “操作类型”用于描述字段的属性，表示对应字段的值可进行的操作：

    C：创建；U：更新；R：读取

  • “是否必选”列表示对于“操作类型”为“C”的创建操作，对应字段是否为必选字段。
表1 ACL策略对象模型

参数

类型

说明

操作类型

是否必选

id

String

黑白名单的编号

R

-

acl_name

String

黑白名单的名称

CRU

是

entity_type

String

对象类型

  • IP
  • DOMAIN （租户名称）

CRU

是

acl_type

String

黑白名单的类型

  • PERMIT (白名单)
  • DENY (黑名单)

CRU

是

acl_value

String

ip或者租户名称

CRU

是

project_id

String

创建该ACL策略的租户编号

-

-

update_time

Timestamp

最近一次更新时间

-

-

父主题：ACL策略管理