Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda/ API Gateway/ Referencia de la API/ Las API de gateway compartido (para usuarios existentes)/ Gestión de canales de VPC/ Adición de instancias de backend (servidores en la nube)
Actualización más reciente 2025-12-22 GMT+08:00
Ver PDF
Compartir

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.

Tabla 1 Método de solicitud de HTTP/HTTPS y URI

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.

Tabla 2 Descripción de parámetro

Parámetro

Obligatorio

Tipo

Descripción

id

Sí

String

ID de canal de VPC

Solicitud

Tabla 3 Descripción de parámetro

Parámetro

Obligatorio

Tipo

Descripción

vpc_instances

Sí

Dictionary

Lista de instancias de backend
Tabla 4 Detalles de la instancia 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

Tabla 5 Descripción de parámetro

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
Tabla 6 Detalles de la instancia de backend

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

Tabla 7 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
Tema principal: Gestión de canales de VPC