Adición de instancias de backend (servidores en la nube)
Función
Esta API se utiliza para agregar servidores en la nube a un canal de VPC especificado.
URI
La siguiente tabla muestra el método de solicitud HTTP/HTTPS y el URI de la API.
|
Método de solicitud |
URI |
|---|---|
|
POST |
/v1.0/apigw/vpc-channels/{id}/members |
En la siguiente tabla se muestra el parámetro en el URI.
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
|---|---|---|---|
|
id |
Sí |
String |
ID de canal de VPC |
Solicitud
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
|---|---|---|---|
|
vpc_instances |
Sí |
Dictionary |
Lista de instancias de backend |
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
|---|---|---|---|
|
instance_name |
Sí |
String |
Nombre del servidor en la nube El nombre debe contener 1 a 64 caracteres. Solo se permiten letras, dígitos, puntos (.), guiones (-) y guiones bajos (_). |
|
instance_id |
Sí |
String |
ID del servidor en la nube El ID debe contener 1 a 64 caracteres. Solo se permiten letras, dígitos, guiones (-) y guiones bajos (_). |
|
weight |
Sí |
Integer |
Ponderación del servidor en la nube Cuanto mayor sea el peso, más solicitudes se reenvían al servidor en la nube. Alcance: 1 a 100 |
Ejemplo de solicitud:
{
"vpc_instances": [
{
"instance_id": "instance02",
"instance_name": "instance_name02",
"weight": 10
}
]
}
Respuesta
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
total |
Integer |
Número total de servidores en la nube bajo el canal de VPC |
|
size |
Integer |
Número total de servidores en la nube devueltos |
|
vpc_instances |
Dictionary |
Lista de servidores en la nube |
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
id |
String |
ID de objeto de instancia de backend |
|
vpc_id |
String |
ID de canal de VPC |
|
status |
Integer |
Estado del objeto de instancia de backend |
|
instance_name |
String |
Nombre del servidor en la nube |
|
instance_id |
String |
ID del servidor en la nube |
|
host |
String |
Dirección IP del servidor en la nube |
|
weight |
Integer |
Ponderación del servidor en la nube Cuanto mayor sea el peso, más solicitudes se reenvían al servidor en la nube. Alcance: 1 a 100 |
|
create_time |
Timestamp |
Hora en la que se agrega el servidor en la nube al canal de VPC |
Ejemplo de respuesta:
{
"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"
}
]
}
Códigos de estado
|
Código de estado |
Descripción |
|---|---|
|
201 |
Created |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
|
500 |
Server Internal Error |