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> Actualización de un canal de VPC

Actualización más reciente 2023-03-29 GMT+08:00

Ver PDF

Actualización de un canal de VPC

Función

Esta API se utiliza para actualizar los parámetros de un canal 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
PUT	/v1.0/apigw/vpc-channels/{id}

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
name	Sí	String	Nombre del canal de VPC Un nombre de canal de VPC consta de 3 a 64 caracteres, comenzando con una letra. Solo se permiten letras, dígitos, guiones (-) y guiones bajos (_).
type	Sí	Integer	Tipo de canal VPC, que puede ser: 2: canal rápido con la función de balanceo de carga
member_type	Obligatorio si type es 2	String	Tipo de miembro del canal VPC, que puede ser: ip (no soportado actualmente) instance Este parámetro es válido sólo cuando el tipo de canal de VPC se establece en 2. El valor predeterminado es instance.
port	Obligatorio si type es 2	Integer	Puerto de host del canal de VPC Este parámetro es válido sólo cuando el tipo de canal de VPC se establece en 2. El intervalo de valores es de 1 a 65535.
balance_strategy	Obligatorio si type es 2	Integer	Algoritmo de distribución, que puede ser: 1: WRR 2: WLC 3: SH 4: URI hashing Este parámetro es válido sólo cuando el tipo de canal de VPC se establece en 2. El valor predeterminado es 1.
vpc_health_config	Obligatorio si type es 2	Dictionary	Detalles de la comprabación de salud. Este parámetro es válido sólo cuando el tipo de canal de VPC se establece en 2.
vpc_instances	Sí	Dictionary	Lista de instancias de backend. Solo se incluye una instancia de back-end si el tipo de canal de VPC se establece en 1.

**Tabla 4** Detalles de la comprobación de estado
Parámetro	Obligatorio	Tipo	Descripción
protocol	Sí	String	Protocolo para realizar comprobaciones de estado en servidores en la nube en el canal VPC. El valor puede ser: TCP HTTP HTTPS
path	Requerido si protocol está establecido en http.	String	Ruta de destino para las comprobaciones de estado NOTA: El valor de este parámetro debe cumplir con las especificaciones de URI.
port	No	Integer	Puerto de destino para las comprobaciones de estado. De forma predeterminada, se utiliza el puerto de host del canal VPC. Alcance: 1 a 65535
threshold_normal	Sí	Integer	Umbral de control de buen funcionamiento Se refiere al número (x) de comprobaciones consecutivas correctas necesarias para que un servidor en la nube se marque como saludable. Alcance: 2 a 10
threshold_abnormal	Sí	Integer	Umbral de control de mal funcionamiento Se refiere al número (x) de comprobaciones consecutivas fallidas necesarias para que un servidor en la nube se marque como no saludable. Alcance: 2 a 10
time_out	Sí	Integer	Tiempo de espera para determinar si una comprobación de estado falla. Unidad: s. El valor debe ser menor que el valor de time_interval. Alcance: 2 a 30
time_interval	Sí	Integer	Intervalo entre comprobaciones consecutivas. Unidad: s. El valor debe ser mayor que el valor de time_out. Alcance: 5 a 300
http_code	Requerido si protocol está establecido en http.	String	Códigos de respuesta de HTTP para determinar una respuesta de HTTP correcta El valor puede ser cualquier entero dentro de 100–599 en uno de los siguientes formatos: Múltiples valores, por ejemplo 200,201,202 Rango, por ejemplo, 200-299 Múltiples valores e intervalos, por ejemplo, 201,202,210-299

**Tabla 5** Lista de instancias de backend
Parámetro	Obligatorio	Tipo	Descripción
instance_name	Sí	String	Nombre de instancia de backend El nombre debe contener 1 a 64 caracteres. Solo se permiten letras, dígitos, puntos (.), guiones (-) y guiones bajos (_).
instance_id	Sí	String	ID de instancia de backend El ID debe contener 1 a 64 caracteres. Solo se permiten letras, dígitos, guiones (-) y guiones bajos (_).
weight	Obligatorio si type es 2	Integer	Ponderación del servidor en la nube Cuanto mayor sea el peso, más solicitudes se reenvían a la instancia de backend. Este parámetro es válido sólo cuando el tipo de canal de VPC se establece en 2. El intervalo de valores es de 1 a 100.

Ejemplo de solicitud:

{
  "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
    }
  ]
}

Respuesta

**Tabla 6** Descripción de parámetro
Parámetro	Tipo	Descripción
id	String	ID de canal de VPC
name	String	Nombre del canal de VPC
type	Integer	Tipo de canal VPC, que puede ser: 2: canal rápido con la función de balanceo de carga
member_type	String	Tipo de miembro del canal VPC, que puede ser: ip (no soportado actualmente) instance Este parámetro es válido sólo cuando el tipo de canal de VPC se establece en 2.
status	Integer	Estado del canal de VPC, que puede ser: 1: normal 2: anormal
port	Integer	Puerto de host del canal de VPC
balance_strategy	Integer	Algoritmo de distribución, que puede ser: 1: WRR 2: WLC 3: SH 4: URI hashing
create_time	Timestamp	Hora en que se crea el canal de VPC

Ejemplo de respuesta:

{
  "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
}