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.
| Método de solicitud | URI |
|---|---|
| PUT | /v1.0/apigw/vpc-channels/{id} |
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 |
|---|---|---|---|
| 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:
|
| member_type | Obligatorio si type es 2 | String | Tipo de miembro del canal VPC, que puede ser:
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:
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. |
| 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:
|
| 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:
|
| 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
| 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:
|
| member_type | String | Tipo de miembro del canal VPC, que puede ser:
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:
|
| port | Integer | Puerto de host del canal de VPC |
| balance_strategy | Integer | Algoritmo de distribución, que puede ser:
|
| 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
} Códigos de estado
| Código de estado | Descripción |
|---|---|
| 200 | OK |
| 400 | Bad Request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
| 500 | Server Internal Error |
