# 创建ACL策略
#### 功能介绍
增加一个ACL策略，策略类型通过字段acl_type来确定（permit或者deny），限制的对象的类型可以为IP或者DOMAIN，这里的DOMAIN对应的acl_value的值为您的租户名称， 而非"www.exampleDomain.com"之类的网络域名。
#### URI
HTTP/HTTPS请求方法以及URI如下表所示。
表1HTTP/HTTPS请求方法以及URI 
| 请求方法 | URI              |
|:---|:---|
| POST | /v1.0/apigw/acls |
   
#### 请求消息
表2参数说明 
| 参数          | 类型     | 说明                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|
| acl_name    | String | ACL策略名称。 支持汉字，英文，数字，下划线，且只能以英文和汉字开头，3 \~ 64字符。 说明： 中文字符必须为UTF-8或者unicode编码。                                                                                                                                 |
| acl_type    | String | 类型 - PERMIT (白名单类型)  - DENY (黑名单类型)   |
| acl_value   | String | ACL策略值，支持一个或多个值，使用英文半角逗号分隔                                                                                                                                                                                                                                                                                                                                                        |
| entity_type | String | 对象类型： - IP  - DOMAIN               |
   
请求消息样例：
```
{
        "acl_name": "test001",
"acl_type": "PERMIT",
        "acl_value": "192.168.1.5,192.168.10.0/24,192.168.12.12-192.168.12.19",
        "entity_type": "IP"
}
```
#### 响应消息
表3参数说明 
| 名称          | 类型        | 说明                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|
| id          | String    | 编号                                                                                                                                                                                                                                                                                                                                                                                 |
| acl_name    | String    | 名称                                                                                                                                                                                                                                                                                                                                                                                 |
| acl_type    | String    | 类型 - PERMIT（白名单类型）  - DENY（黑名单类型）   |
| acl_value   | String    | ACL策略值                                                                                                                                                                                                                                                                                                                                                                             |
| entity_type | String    | 对象类型： - IP  - DOMAIN                |
| update_time | Timestamp | 更新时间                                                                                                                                                                                                                                                                                                                                                                               |
   
响应消息样例：
```
{
"id": "d402b35e-1054-4280-b1c5-0d741a28c995",
        "acl_name": "test",
        "entity_type": "IP",
"acl_type": "PERMIT",
        "acl_value": "192.168.1.5,192.168.10.0/24,192.168.12.12-192.168.12.19",
"update_time": "2017-11-18T14:27:36.918578+08:00"
}
```
#### 状态码
表4返回消息说明 
| 状态码 | 说明                    |
|:---|:---|
| 201 | Created               |
| 400 | Bad Request           |
| 500 | Server Internal Error |