文档首页/ API网关 APIG/ API参考/ 专享版API（V1）（待下线）/ VPC通道管理（待下线）/ 添加后端实例（云服务器）
更新时间：2022-08-30 GMT+08:00
查看PDF
分享

添加后端实例（云服务器）

功能介绍

为指定的VPC通道添加云服务器。

URI

HTTP/HTTPS请求方法以及URI如下表所示。

表1 HTTP/HTTPS请求方法以及URI

请求方法

URI

POST

/v1/{project_id}/apigw/instances/{instance_id}/vpc-channels/{id}/members

URI中的参数说明如下表所示。

表2 参数说明

名称

是否必选

类型

说明

project_id

是

String

项目ID。可从控制台“我的凭证”中获取region下项目ID，管理员权限可查询。

instance_id

是

String

实例ID，可从API网关控制台的专享版实例信息中获取。

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

相关文档