# 更新VPC通道
#### 功能介绍
更新指定VPC通道的参数。
#### URI
HTTP/HTTPS请求方法以及URI如下表所示。
表1HTTP/HTTPS请求方法以及URI 
| 请求方法 | URI                           |
|:---|:---|
| PUT  | /v1.0/apigw/vpc-channels/{id} |
   
URI中的参数说明如下表所示。
表2参数说明 
| 名称 | 是否必选 | 类型     | 说明        |
|:---|:---|:---|:---|
| id | 是    | String | VPC通道的编号。 |
   
#### 请求消息
表3参数说明 
| 参数                | 是否必选        | 类型      | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|:---|
| name              | 是           | String  | VPC通道的名称。 长度为3 \~ 64位的字符串，字符串由中文、英文字母、数字、"-"、"_"组成，且只能以英文或中文开头。 说明： 中文字符必须为UTF-8或者unicode编码。                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| type              | 是           | Integer | VPC通道的类型。 - 2：API网关内置支持负载均衡功能的快速通道类型                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| member_type       | type = 2时必选 | String  | VPC通道的成员类型。 - ip（暂不支持）  - instance   仅VPC通道类型为2时有效，缺省为instance。                                                                                                                                                                                                                                                                                  |
| port              | type = 2时必选 | Integer | VPC通道中主机的端口号。 取值范围1 \~ 65535，仅VPC通道类型为2时有效。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| balance_strategy  | type = 2时必选 | Integer | 分发算法。 - 1：加权轮询（wrr）  - 2：加权最少连接（wleastconn）  - 3：源地址哈希（source）  - 4：URI哈希（uri）   仅VPC通道类型为2时有效，缺省为1。 |
| vpc_health_config | type = 2时必选 | 字典数据类型  | 健康检查详情，仅VPC通道类型为2时有效。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| vpc_instances     | 是           | 字典数据类型  | 后端实例列表，VPC通道类型为1时，有且仅有1个后端实例。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
   
表4健康检查详情 
| 参数                 | 是否必选               | 类型      | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
|:---|:---|:---|:---|
| protocol           | 是                  | String  | 使用以下协议，对VPC中主机执行健康检查。 - TCP  - HTTP  - HTTPS                                                                                                                                                                                                       |
| path               | protocol = http时必选 | String  | 健康检查时的目标路径。 说明： 需要服从URI规范。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| port               | 否                  | Integer | 健康检查的目标端口，缺省时为VPC中主机的端口号。 取值范围1 \~ 65535。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| threshold_normal   | 是                  | Integer | 正常阈值。 判定VPC通道中主机正常的依据为：连续检查*x*成功，x为您设置的正常阈值。 取值范围2 \~ 10                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| threshold_abnormal | 是                  | Integer | 异常阈值。 判定VPC通道中主机异常的依据为：连续检查*x失败*，x为您设置的异常阈值。 取值范围2 \~ 10。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| time_out           | 是                  | Integer | 超时时间：检查期间，无响应的时间，单位为秒。必须小于time_interval字段取值。 取值范围2 \~ 30。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| time_interval      | 是                  | Integer | 间隔时间：连续两次检查的间隔时间，单位为秒。必须大于time_out字段取值。 取值范围5 \~ 300。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| http_code          | protocol = http时必选 | String  | 检查目标HTTP响应时，判断成功使用的HTTP响应码。 取值范围为100到599之前的任意整数值，支持如下三种格式： - 多个值，如：200,201,202  - 一系列值，如：200-299  - 组合值，如：201,202,210-299   |
   
表5后端实例列表 
| 参数            | 是否必选        | 类型      | 说明                                                                                                                                                                                                                                                        |
|:---|:---|:---|:---|
| instance_name | 是           | String  | 后端实例的名称。 支持汉字，英文，数字，"-","_","."，1 \~ 64字符。 说明： 中文字符必须为UTF-8或者unicode编码。 |
| instance_id   | 是           | String  | 后端实例的编号。 支持英文，数字，"-","_"，1 \~ 64字符。                                                                                                                                                              |
| weight        | type = 2时必选 | Integer | 权重值。 权重值越大，转发到该后端实例的请求数量越多。 取值范围1 \~ 100，仅VPC通道类型为2时有效。                                                                             |
   
请求消息样例：
```
{
  "balance_strategy": 1,
  "name": "vpc_001",
  "port": 15565,
  "type": 2,
  "member_type": "instance",
  "vpc_health_config": {
    "http_code": "205",
    "path": "/hc",
    "port": 15563,
    "protocol": "http",
    "threshold_abnormal": 5,
    "threshold_normal": 5,
    "time_interval": 200,
    "time_out": 30
  },
  "vpc_instances": [
    {
      "instance_id": "instance01",
      "instance_name": "instance_name01",
      "weight": 10
    }
  ]
}
```
#### 响应消息
表6参数说明 
| 名称               | 类型        | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|
| id               | String    | VPC通道的编号。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| name             | String    | VPC通道的名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| type             | Integer   | VPC通道的类型。 - 2：API网关内置支持负载均衡功能的快速通道类型                                                                                                                                                                                                                                                                                                                                                                                                                |
| member_type      | String    | VPC通道的成员类型。 - ip（暂不支持）  - instance   仅VPC通道类型为2时有效。                                                                                                                                                                                                                                                                          |
| status           | Integer   | VPC通道的状态。 - 1：正常  - 2：异常                                                                                                                                                                                                                                                                                                          |
| port             | Integer   | VPC通道中主机的端口号。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| balance_strategy | Integer   | 分发算法。 - 1：加权轮询（wrr）  - 2：加权最少连接（wleastconn）  - 3：源地址哈希（source）  - 4：URI哈希（uri）   |
| create_time      | Timestamp | VPC通道的创建时间。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
   
响应消息样例：
```
{
  "name": "vpc_001",
  "type": 2,
  "member_type": "instance",
  "port": 15565,
  "balance_strategy": 1,
  "id": "c3e6a7d85d9e47be89dfcc3cd37405d7",
  "create_time": "2018-07-27T12:30:48.027484Z",
  "status": 1
}
```
#### 状态码
表7返回消息说明 
| 状态码 | 说明                    |
|:---|:---|
| 200 | OK                    |
| 400 | Bad Request           |
| 401 | Unauthorized          |
| 403 | Forbidden             |
| 404 | Not Found             |
| 500 | Server Internal Error |