
# 对象模型
API发布后，如果不想API被某些IP地址访问到，可以将这些IP地址加入黑名单，或者想API被某些特性的IP地址访问到，也可以将这些IP地址加入白名单。这样可以提高API的访问安全性，保护API免受攻击。本节介绍API的黑白名单（ACL策略）管理的对象模型，如[表1 ACL策略对象模型](https://support.huaweicloud.com/api-apig/apig-api-180713083.html)所示。
![](https://support.huaweicloud.com/api-apig/public_sys-resources/note_3.0-zh-cn.png)
- "操作类型"用于描述字段的属性，表示对应字段的值可进行的操作： C：创建；U：更新；R：读取
  
- "是否必选"列表示对于"操作类型"为"C"的创建操作，对应字段是否为必选字段。
 
表1ACL策略对象模型 
| 参数          | 类型        | 说明                                                                                                                                                                                                                                                                                                                                                                                                                | 操作类型 | 是否必选 |
|:---|:---|:---|:---|:---|
| 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 | 最近一次更新时间                                                                                                                                                                                                                                                                                                                                                                                                          | -    | -    |
   
