# 添加后端实例（云服务器）
#### 功能介绍
为指定的VPC通道添加云服务器。
#### URI
HTTP/HTTPS请求方法以及URI如下表所示。
表1HTTP/HTTPS请求方法以及URI 
| 请求方法 | URI                                   |
|:---|:---|
| POST | /v1.0/apigw/vpc-channels/{id}/members |
   
URI中的参数说明如下表所示。
表2参数说明 
| 名称 | 是否必选 | 类型     | 说明        |
|:---|:---|:---|:---|
| id | 是    | String | VPC通道的编号。 |
   
#### 请求消息
表3参数说明 
| 参数            | 是否必选 | 类型     | 说明      |
|:---|:---|:---|:---|
| vpc_instances | 是    | 字典数据类型 | 后端实例列表。 |
   
表4后端实例详情 
| 参数            | 是否必选 | 类型      | 说明                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| instance_name | 是    | String  | 云服务器的名称。 支持汉字，英文，数字，"-","_","."，1\~ 64字符。 说明： 中文字符必须为UTF-8或者unicode编码。 |
| instance_id   | 是    | String  | 云服务器的ID。 支持英文，数字，"-","_"，1 \~ 64字符。                                                                                                                                                     |
| weight        | 是    | Integer | 权重值。 权重值越大，转发到该云服务器的请求数量越多。 取值范围1 \~ 100。                                                                                   |
   
请求消息样例：
```
{
  "vpc_instances": [
    {
      "instance_id": "instance02",
      "instance_name": "instance_name02",
      "weight": 10
    }
  ]
}
```
#### 响应消息
表5参数说明 
| 名称            | 类型      | 说明              |
|:---|:---|:---|
| total         | Integer | 该VPC通道下的云服务器总数。 |
| size          | Integer | 本次返回的云服务器总数。    |
| vpc_instances | 字典数据类型  | 云服务器列表。         |
   
表6后端实例详情 
| 名称            | 类型        | 说明                                                                                                                                                                |
|:---|:---|:---|
| id            | String    | 后端实例对象的编号。                                                                                                                                                        |
| vpc_id        | String    | VPC通道的编号。                                                                                                                                                         |
| status        | Integer   | 后端实例对象的状态。                                                                                                                                                        |
| instance_name | String    | 云服务器的名称。                                                                                                                                                          |
| instance_id   | String    | 云服务器的ID。                                                                                                                                                          |
| host          | String    | 云服务器的主机地址                                                                                                                                                         |
| weight        | Integer   | 权重值。 权重值越大，转发到该云服务器的请求数量越多。 取值范围1 \~ 100。 |
| create_time   | Timestamp | 云服务器增加到VPC通道的时间。                                                                                                                                                  |
   
响应消息样例：
```
{
  "total": 2,
  "size": 2,
  "vpc_instances": [
    {
      "instance_id": "instance02",
      "instance_name": "instance_name02",
      "host": "127.0.0.2",
      "weight": 10,
      "id": "680e42fab429447ca23b9623107523d9",
      "vpc_id": "c3e6a7d85d9e47be89dfcc3cd37405d7",
      "status": 1,
      "create_time": "2018-07-27T12:42:32Z"
    },
    {
      "instance_id": "instance01",
      "instance_name": "instance_name01",
      "host": "127.0.0.1",
      "weight": 10,
      "id": "c3bc73605a8b400793363c87574fbad7",
      "vpc_id": "c3e6a7d85d9e47be89dfcc3cd37405d7",
      "status": 1,
      "create_time": "2018-07-27T12:30:48Z"
    }
  ]
}
```
#### 状态码
表7返回消息说明 
| 状态码 | 说明                    |
|:---|:---|
| 201 | Created               |
| 400 | Bad Request           |
| 401 | Unauthorized          |
| 403 | Forbidden             |
| 404 | Not Found             |
| 500 | Server Internal Error |