
# 修改ACL策略
#### 功能介绍
修改指定的ACL策略，其中可修改的属性为：acl_name、acl_type、acl_value，其它属性不可修改。
#### URI
HTTP/HTTPS请求方法以及URI如下表所示。
表1HTTPS请求方法以及URI 
| 请求方法 | URI                                                      |
|:---|:---|
| PUT  | /v1/{project_id}/apigw/instances/{instance_id}/acls/{id} |
   
URI中的参数说明如下表所示。
表2参数说明 
| 名称          | 是否必选 | 类型     | 说明                                       |
|:---|:---|:---|:---|
| project_id  | 是    | String | 项目ID。可从控制台"我的凭证"中获取region下项目ID，管理员权限可查询。 |
| instance_id | 是    | String | 实例ID，可从API网关控制台的专享版实例信息中获取。              |
| id          | 是    | String | ACL策略的编号。可通过查询ACL信息获取该ID。                |
   
#### 请求消息
表3参数说明 
| 参数          | 类型     | 说明                                                                                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|
| acl_name    | String | ACL策略名称。 支持汉字，英文，数字，下划线，且只能以英文和汉字开头，3 \~ 64字符。 说明： 中文字符必须为UTF-8或者unicode编码。                                                                                                                                                                   |
| acl_type    | String | 类型 - PERMIT（白名单类型）  - DENY（黑名单类型）                              |
| acl_value   | String | ACL策略值，支持一个或多个值，使用英文半角逗号分隔                                                                                                                                                                                                                                                                                                                                                                                                |
| entity_type | String | ACL策略约束对象。取值范围： - IP  - DOMAIN （租户名称）   |
   
请求消息样例：
```
{
"acl_name": "string",
"acl_type": "PERMIT",
"acl_value": "19asdfaf-adfadf",
"entity_type": "IP"
}
```
#### 响应消息
表4参数说明 
| 名称          | 类型        | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|
| id          | String    | 编号                                                                                                                                                                                                                                                                                                                                                                                                                                |
| acl_name    | String    | 名称                                                                                                                                                                                                                                                                                                                                                                                                                                |
| entity_type | String    | ACL策略约束对象。取值范围： - IP  - DOMAIN （租户名称）   |
| acl_type    | String    | 类型 - PERMIT（白名单类型）  - DENY（黑名单类型）                  |
| acl_value   | String    | ACL策略的值                                                                                                                                                                                                                                                                                                                                                                                                                           |
| update_time | Timestamp | 更新时间                                                                                                                                                                                                                                                                                                                                                                                                                              |
   
响应消息样例：
```
{
"id": "d402b35e-1054-4280-b1c5-0d741a28c995",
"acl_name": "goodone",
"entity_type": "IP",
"acl_type": "PERMIT",
"acl_value": "19asdfaf-adfadf",
"update_time": "2017-11-18T14:27:36.918578+08:00"
}
```
#### 状态码
表5返回消息说明 
| 状态码 | 说明          |
|:---|:---|
| 200 | OK          |
| 400 | Bad Request |
| 403 | Forbidden   |
| 404 | Not Found   |
   
