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/ API de gateway dedicados (V2)/ Gestión de canales de VPC/ Actualización de un canal de VPC

Actualización más reciente 2025-12-22 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 de VPC especificado.

Si el canal de VPC se sobrescribe con una lista de instancias de backend vacía, se eliminarán todas las instancias de backend existentes.

Si el canal de VPC se sobrescribe con una lista de grupos de servidores backend vacía, se eliminarán todos los grupos de servidores backend existentes.

Método de invocación

Para obtener más información, véase invocación de API.

URI

PUT /v2/{project_id}/apigw/instances/{instance_id}/vpc-channels/{vpc_channel_id}

**Tabla 1** Parámetros de ruta
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	ID del proyecto. Para obtener más información sobre cómo obtenerlo, véase Obtención de un ID de proyecto.
instance_id	Sí	String	ID de gateway, que se puede obtener de la información de gateway en la consola de APIG.
vpc_channel_id	Sí	String	ID de canal de VPC.

Parámetros de solicitud

**Tabla 2** Parámetros de encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Token de usuario. Se puede obtener invocando a la API de IAM utilizada para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es un token.

**Tabla 3** Parámetros del cuerpo de solicitud
Parámetro	Obligatorio	Tipo	Descripción
name	Sí	String	Nombre del canal de VPC. Puede contener de 3 a 64 caracteres, comenzando con una letra. Solo se permiten letras, dígitos, guiones (-), guiones bajos (_) y puntos (.).
port	Sí	Integer	Puerto de host del canal VPC. Rango: 1–65535.
balance_strategy	Sí	Integer	Algoritmo de distribución. 1: Round robin ponderado (WRR). 2: Conexiones mínimas ponderadas (WLC). 3: Hashing de origen. 4: Hashing de URI. Predeterminado: 1
member_type	Sí	String	Tipo de miembro del canal VPC. ip ecs Predeterminado: ecs
type	No	Integer	Tipo de canal de VPC. El tipo predeterminado es servidor. 2: Tipo de servidor 3: Tipo de microservicio Si vpc_channel_type está vacío, el tipo de canal de balanceo de carga está determinado por el campo de type. Si el valor de type no es 3 o el valor de microservice_info está vacío, el tipo de canal de balanceo de carga es server por defecto. Si el valor de type es 3 y el valor de microservice_info no está vacío, el tipo de canal de balanceo de carga es microservice. Cuando se modifica un canal de balanceo de carga, el tipo de canal permanecerá sin cambios. Este campo debe descartarse. Utilice el campo vpc_channel_type para especificar el tipo de canal de balanceo de carga. Predeterminado: 2
vpc_channel_type	No	String	Tipo de canal de VPC. builtin: tipo de servidor microservice: tipo de microservicio reference: canal de balanceo de carga de referencia Si vpc_channel_type está vacío, el tipo de canal de balanceo de carga depende del valor del campo de type. Si vpc_channel_type no está vacío y type no está vacío o no es cero, se produce un error cuando se especifican. Si vpc_channel_type no está vacío y type está vacío o 0, el valor de vpc_channel_type se utiliza para especificar el tipo de canal de equilibrio de carga. Cuando se modifica un canal de balanceo de carga, el tipo de canal permanecerá sin cambios.
dict_code	No	String	Código de diccionario del canal VPC. El valor puede contener letras, dígitos, guiones (-), guiones bajos (_), y puntos (.). Este parámetro no se admite actualmente. Mínimo: 3 Máximo: 64
member_groups	No	Array of MemberGroupCreate objects	Grupos de servidores backend del canal VPC. Si el valor de service_type de microservice_info es NACOS, la ponderación del grupo de servidores no se puede configurar manualmente.
members	No	Array of MemberInfo objects	Las instancias de backend del canal VPC. Este campo no se utilizará para agregar o actualizar instancias de backend para un canal de balanceo de carga de referencia.
vpc_health_config	No	VpcHealthConfig object	Detalles de la comprobación de estado.
microservice_info	No	MicroServiceCreate object	Detalles del microservicio.

**Tabla 4** MemberGroupCreate
Parámetro	Obligatorio	Tipo	Descripción
member_group_name	Sí	String	Nombre del grupo de servidores backend del canal de VPC. Puede contener de 3 a 64 caracteres, comenzando con una letra. Solo se permiten letras, dígitos, guiones bajos (_), guiones medios (-) y puntos (.).
member_group_remark	No	String	Descripción del grupo de servidores backend. Máximo: 255
member_group_weight	No	Integer	Ponderación del grupo de servidores backend. Si el grupo de servidores contiene servidores y se ha establecido una ponderación para él, la ponderación se utiliza automáticamente para asignar ponderaciones a los servidores de este grupo. Mínimo: 0 Máximo: 100
dict_code	No	String	Código de diccionario del grupo de servidores backend. El valor puede contener letras, dígitos, guiones (-), guiones bajos (_), y puntos (.). Actualmente, este parámetro no es compatible. Mínimo: 3 Máximo: 64
microservice_version	No	String	Versión del grupo de servidores backend. Este parámetro solo se admite cuando el tipo de canal de VPC es microservicio. Máximo: 64
microservice_port	No	Integer	Puerto del grupo de servidores backend. Este parámetro solo se admite cuando el tipo de canal de VPC es microservicio. Si el número de puerto es 0, todas las direcciones en el grupo de servidores backend utilizan el puerto de equilibrio de carga original para heredar la lógica. Mínimo: 0 Máximo: 65535
microservice_labels	No	Array of MicroserviceLabel objects	Etiquetas del grupo de servidores de backend. Este parámetro solo se admite cuando el tipo de canal de VPC es microservicio.
reference_vpc_channel_id	No	String	ID del canal de balanceo de carga de referencia. Este parámetro solo se admite cuando el tipo de canal de VPC es de referencia (vpc_channel_type=reference). Mínimo: 0 Máximo: 64

**Tabla 5** MicroserviceLabel
Parámetro	Obligatorio	Tipo	Descripción
label_name	Sí	String	Nombre de la etiqueta. Se comienza y se termina con una letra o un dígito. Se utiliza solo letras, dígitos, guiones (-), guiones bajos (_) y puntos (.). (Máx. 63 caracteres.) Mínimo: 1 Máximo: 63
label_value	Sí	String	Valor de la etiqueta. Se comienza y se termina con una letra o un dígito. Se utiliza solo letras, dígitos, guiones (-), guiones bajos (_) y puntos (.). (Máx. 63 caracteres.) Mínimo: 1 Máximo: 63

**Tabla 6** MemberInfo
Parámetro	Obligatorio	Tipo	Descripción
host	No	String	Dirección del servidor backend. Este parámetro es necesario cuando el tipo de miembro es dirección IP. Máximo: 255
weight	No	Integer	Ponderación. Cuanto mayor sea la ponderación, más solicitudes recibirá un servicio de backend. Mínimo: 0 Máximo: 10000
is_backup	No	Boolean	Indica si el servicio backend es un nodo en espera. Después de habilitar esta opción, el servicio de backend correspondiente actúa como nodo en espera y funciona solo cuando todos los nodos que no son en espera presentan fallas. Esta función solo se admite cuando el gateway se ha actualizado a la versión correspondiente. Si su gateway no admite esta función, póngase en contacto con el soporte técnico. Predeterminado: false
member_group_name	No	String	Nombre del grupo de servidores backend. El grupo de servidores facilita la modificación de la dirección del servicio de backend.
status	No	Integer	Estado del servidor de backend. 1: disponible 2: no disponible
port	No	Integer	Puerto de servidor de backend. Mínimo: 0 Máximo: 65535
ecs_id	No	String	ID del servidor de backend. Este parámetro es necesario si el tipo de instancia de backend es ecs. El valor puede contener de 1 a 64 caracteres, incluidos letras, dígitos, guiones (-) y guiones bajos (_). Máximo: 255
ecs_name	No	String	Nombre del servidor de backend. Este parámetro es necesario si el tipo de instancia de backend es ecs. El valor puede contener de 1 a 64 caracteres, incluidos letras, dígitos, guiones (-), guiones bajos (_) y puntos (.). Máximo: 64

**Tabla 7** VpcHealthConfig
Parámetro	Obligatorio	Tipo	Descripción
protocol	Sí	String	Protocolo para realizar comprobaciones de estado en servidores backend en el canal VPC. TCP HTTP HTTPS
path	No	String	Ruta de destino para las comprobaciones de estado. Este parámetro es necesario si el protocolo se establece en http o https.
method	No	String	Método de solicitud de comprobación de salud. Predeterminado: GET
port	No	Integer	Puerto de destino para las comprobaciones de estado. Si este parámetro no se especifica o se establece en 0, se utiliza el puerto de host del canal VPC. Si este parámetro se establece en un valor distinto de cero, se utiliza el puerto correspondiente para las comprobaciones de estado. Mínimo: 0 Máximo: 65535
threshold_normal	Sí	Integer	Umbral saludable. Se refiere al número de comprobaciones exitosas consecutivas requeridas para que un servidor backend se considere saludable. Mínimo: 1 Máximo: 10
threshold_abnormal	Sí	Integer	Umbral insalubre, que se refiere al número de comprobaciones consecutivas fallidas necesarias para que un servidor backend se considere insalubre. Mínimo: 1 Máximo: 10
time_interval	Sí	Integer	Intervalo entre comprobaciones consecutivas. Unidad: s. El valor debe ser mayor que el valor del tiempo de espera. Mínimo: 1 Máximo: 300
http_code	No	String	Códigos de respuesta para determinar una respuesta HTTP correcta. El valor puede ser cualquier entero dentro de 100 a 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. Este parámetro es necesario si el protocolo se establece en http.
enable_client_ssl	No	Boolean	Indica si se debe habilitar la autenticación bidireccional. Si esta función está habilitada, se utiliza el certificado especificado en el elemento de configuración backend_client_certificate de la instancia. Predeterminado: false
status	No	Integer	Resultado de comprobación de salud. 1: disponible 2: no disponible
timeout	Sí	Integer	Tiempo de espera para determinar si falla una comprobación de estado. Unidad: s. El valor debe ser menor que el valor de time_interval. Mínimo: 1 Máximo: 30

**Tabla 8** MicroServiceCreate
Parámetro	Obligatorio	Tipo	Descripción
service_type	No	String	Tipo de centro de microservicios. Opciones: CSE: Centro de registro de microservicios CSE. CCE: Carga de trabajo de CCE - CCE_SERVICE: Servicio de CCE NACOS: Centro de registro de Nacos. nacos_info es obligatorio.
cse_info	No	MicroServiceInfoCSEBase object	Detalles del microservicio de CSE. Este parámetro es necesario si service_type se establece en CSE.
cce_info	No	MicroServiceInfoCCEBase object	Detalles de carga de trabajo de CCE. Este parámetro es necesario si service_type se establece en CCE. Se debe configurar app_name o bien label_key o label_value. Si solo se configura app_name, label_key='app' y label_value=app_name.
cce_service_info	No	MicroServiceInfoCCEServiceBase object	Detalles del servicio de CCE.
nacos_info	No	MicroServiceInfoNacosBase object	Información básica de Nacos.

**Tabla 9** MicroServiceInfoCSEBase
Parámetro	Obligatorio	Tipo	Descripción
engine_id	Sí	String	ID del motor de microservicio. Máximo: 64
service_id	Sí	String	ID de microservicio. Máximo: 64

**Tabla 10** MicroServiceInfoCCEBase
Parámetro	Obligatorio	Tipo	Descripción
cluster_id	Sí	String	ID del clúster de CCE. Máximo: 64
namespace	Sí	String	Espacio de nombres. Máximo: 64
workload_type	Sí	String	Tipo de carga de trabajo. deployment statefulset daemonset
app_name	No	String	Nombre de la aplicación. Se comienza con una letra e incluya solo letras, dígitos, puntos (.), guiones (-) y guiones bajos (_). (de 1 a 64 caracteres) Mínimo: 1 Máximo: 64
label_key	No	String	Clave de etiqueta de servicio. Se comienza con una letra o un dígito, y se usa solo letras, dígitos y estos caracteres especiales: -_./:(). (de 1 a 64 caracteres) Mínimo: 1 Máximo: 64
label_value	No	String	Valor de etiqueta de servicio. Se comienza con una letra e incluya solo letras, dígitos, puntos (.), guiones (-) y guiones bajos (_). (de 1 a 64 caracteres) Mínimo: 1 Máximo: 64

**Tabla 11** MicroServiceInfoCCEServiceBase
Parámetro	Obligatorio	Tipo	Descripción
cluster_id	Sí	String	ID del clúster de CCE. Máximo: 64
namespace	Sí	String	Espacio de nombres. De 1 a 63 caracteres. Se utiliza letras minúsculas, dígitos y guiones (-). Se comienza con una letra y se termina con una letra o un dígito. Mínimo: 1 Máximo: 63
service_name	Sí	String	Nombre del servicio. Se comienza con una letra y se utiliza solo letras, dígitos, puntos (.), guiones (-) y guiones bajos (_). (de 1 a 64 caracteres) Mínimo: 1 Máximo: 64

**Tabla 12** MicroServiceInfoNacosBase
Parámetro	Obligatorio	Tipo	Descripción
namespace	No	String	ID de espacio de nombres. Si se utiliza el espacio de nombres predeterminado public, deje este parámetro vacío. Solo se permiten letras, números, guiones (-) y guiones bajos (_). Máximo: 64 caracteres Mínimo: 0 Máximo: 64
cluster_name	No	String	Nombre del clúster. El valor predeterminado es DEFAULT. Solo se permiten letras, números, guiones (-) y guiones bajos (_). Máximo: 64 caracteres Mínimo: 0 Máximo: 64
group_name	No	String	Nombre del grupo. El valor predeterminado es DEFAULT_GROUP. Solo se permiten letras, números, guiones (-), guiones bajos (_), puntos (.) y dos puntos. Máximo: 128 caracteres Mínimo: 0 Máximo: 128
service_name	Sí	String	Nombre del microservicio. El valor no puede comenzar con @ o contener @@. Máximo: 512 caracteres Mínimo: 1 Máximo: 512
server_config	Sí	Array of NacosServerConfig objects	Configuraciones del servidor Nacos. Longitud de matriz: 1 - 9
user_info	Sí	NacosUserInfo object	Información del usuario de Nacos.

**Tabla 13** NacosServerConfig
Parámetro	Obligatorio	Tipo	Descripción
ip_address	Sí	String	Dirección IP del servidor de Nacos. No ingrese caracteres chinos. Mínimo: 7 Máximo: 128
port	Sí	Integer	Número de puerto del servidor de Nacos. Rango: 1–65535. Mínimo: 1 Máximo: 65535
grpc_port	No	Integer	Número de puerto gRPC del servidor de Nacos. Predeterminado: número de puerto + 1000 Rango: 1–65535. Mínimo: 1 Máximo: 65535

**Tabla 14** NacosUserInfo
Parámetro	Obligatorio	Tipo	Descripción
user_name	Sí	String	Nombre de usuario de Nacos. Mínimo: 1 Máximo: 64
password	Sí	String	Contraseña de Nacos. Mínimo: 1 Máximo: 64

Parámetros de respuesta

Código de estado: 200

**Tabla 15** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
name	String	Nombre del canal de VPC. Puede contener de 3 a 64 caracteres, comenzando con una letra. Solo se permiten letras, dígitos, guiones (-), guiones bajos (_) y puntos (.).
port	Integer	Puerto de host del canal VPC. Rango: 1–65535.
balance_strategy	Integer	Algoritmo de distribución. 1: Round robin ponderado (WRR). 2: Conexiones mínimas ponderadas (WLC). 3: Hashing de origen. 4: Hashing de URI. Predeterminado: 1
member_type	String	Tipo de miembro del canal VPC. ip ecs Predeterminado: ecs
type	Integer	Tipo de canal de VPC. El tipo predeterminado es servidor. 2: Tipo de servidor 3: Tipo de microservicio Si vpc_channel_type está vacío, el tipo de canal de balanceo de carga está determinado por el campo de type. Si el valor de type no es 3 o el valor de microservice_info está vacío, el tipo de canal de balanceo de carga es server por defecto. Si el valor de type es 3 y el valor de microservice_info no está vacío, el tipo de canal de balanceo de carga es microservice. Cuando se modifica un canal de balanceo de carga, el tipo de canal permanecerá sin cambios. Este campo debe descartarse. Utilice el campo vpc_channel_type para especificar el tipo de canal de balanceo de carga. Predeterminado: 2
vpc_channel_type	String	Tipo de canal de VPC. builtin: tipo de servidor microservice: tipo de microservicio reference: canal de balanceo de carga de referencia Si vpc_channel_type está vacío, el tipo de canal de balanceo de carga depende del valor del campo de type. Si vpc_channel_type no está vacío y type no está vacío o no es cero, se produce un error cuando se especifican. Si vpc_channel_type no está vacío y type está vacío o 0, el valor de vpc_channel_type se utiliza para especificar el tipo de canal de equilibrio de carga. Cuando se modifica un canal de balanceo de carga, el tipo de canal permanecerá sin cambios.
dict_code	String	Código de diccionario del canal VPC. El valor puede contener letras, dígitos, guiones (-), guiones bajos (_), y puntos (.). Este parámetro no se admite actualmente. Mínimo: 3 Máximo: 64
create_time	String	Hora en la que se crea el canal VPC.
id	String	ID de canal de VPC.
status	Integer	Estado del canal de VPC. 1: normal 2: anormal
member_groups	Array of MemberGroupInfo objects	Grupos de servidores backend.
microservice_info	MicroServiceInfo object	Información de microservicio.

**Tabla 16** MemberGroupInfo
Parámetro	Tipo	Descripción
member_group_name	String	Nombre del grupo de servidores backend del canal de VPC. Puede contener de 3 a 64 caracteres, comenzando con una letra. Solo se permiten letras, dígitos, guiones bajos (_), guiones medios (-) y puntos (.).
member_group_remark	String	Descripción del grupo de servidores backend. Máximo: 255
member_group_weight	Integer	Ponderación del grupo de servidores backend. Si el grupo de servidores contiene servidores y se ha establecido una ponderación para él, la ponderación se utiliza automáticamente para asignar ponderaciones a los servidores de este grupo. Mínimo: 0 Máximo: 100
dict_code	String	Código de diccionario del grupo de servidores backend. El valor puede contener letras, dígitos, guiones (-), guiones bajos (_), y puntos (.). Actualmente, este parámetro no es compatible. Mínimo: 3 Máximo: 64
microservice_version	String	Versión del grupo de servidores backend. Este parámetro solo se admite cuando el tipo de canal de VPC es microservicio. Máximo: 64
microservice_port	Integer	Puerto del grupo de servidores backend. Este parámetro solo se admite cuando el tipo de canal de VPC es microservicio. Si el número de puerto es 0, todas las direcciones en el grupo de servidores backend utilizan el puerto de equilibrio de carga original para heredar la lógica. Mínimo: 0 Máximo: 65535
microservice_labels	Array of MicroserviceLabel objects	Etiquetas del grupo de servidores de backend. Este parámetro solo se admite cuando el tipo de canal de VPC es microservicio.
reference_vpc_channel_id	String	ID del canal de balanceo de carga de referencia. Este parámetro solo se admite cuando el tipo de canal de VPC es de referencia (vpc_channel_type=reference). Mínimo: 0 Máximo: 64
member_group_id	String	ID del grupo de servidores backend del canal VPC.
create_time	String	Hora en la que se crea el grupo de servidores de backend.
update_time	String	Hora en la que se actualiza el grupo de servidores de backend.

**Tabla 17** MicroserviceLabel
Parámetro	Tipo	Descripción
label_name	String	Nombre de la etiqueta. Se comienza y se termina con una letra o un dígito. Se utiliza solo letras, dígitos, guiones (-), guiones bajos (_) y puntos (.). (Máx. 63 caracteres.) Mínimo: 1 Máximo: 63
label_value	String	Valor de la etiqueta. Se comienza y se termina con una letra o un dígito. Se utiliza solo letras, dígitos, guiones (-), guiones bajos (_) y puntos (.). (Máx. 63 caracteres.) Mínimo: 1 Máximo: 63

**Tabla 18** MicroServiceInfo
Parámetro	Tipo	Descripción
id	String	ID de microservicio.
instance_id	String	ID de gateway.
service_type	String	Tipo de centro de microservicios. Opciones: CSE: Centro de registro de microservicios CSE. CCE: Carga de trabajo de CCE - CCE_SERVICE: Servicio de CCE NACOS: motor de Nacos. nacos_info es obligatorio.
cse_info	MicroServiceInfoCSE object	Detalles del microservicio de CSE.
cce_info	MicroServiceInfoCCE object	Detalles de carga de trabajo de microservicios de CCE.
cce_service_info	MicroServiceInfoCCEService object	Detalles del servicio de microservicios de CCE.
nacos_info	MicroServiceInfoNacosBase object	Información básica de Nacos.
update_time	String	Tiempo de actualización del microservicio.
create_time	String	Tiempo de creación de microservicios.

**Tabla 19** MicroServiceInfoCSE
Parámetro	Tipo	Descripción
engine_id	String	ID del motor de microservicio. Máximo: 64
service_id	String	ID de microservicio. Máximo: 64
engine_name	String	Nombre del motor de microservicios.
service_name	String	Nombre del microservicio.
register_address	String	Dirección del centro de registro.
cse_app_id	String	Aplicación a la que pertenece el microservicio.
version	String	Versión de microservicio, que se ha descartado y se refleja en la versión del grupo de servidores de backend. Máximo: 64

**Tabla 20** MicroServiceInfoCCE
Parámetro	Tipo	Descripción
cluster_id	String	ID del clúster de CCE. Máximo: 64
namespace	String	Espacio de nombres. Máximo: 64
workload_type	String	Tipo de carga de trabajo. deployment statefulset daemonset
app_name	String	Nombre de la aplicación. Se comienza con una letra e incluya solo letras, dígitos, puntos (.), guiones (-) y guiones bajos (_). (de 1 a 64 caracteres) Mínimo: 1 Máximo: 64
label_key	String	Clave de etiqueta de servicio. Se comienza con una letra o un dígito, y se usa solo letras, dígitos y estos caracteres especiales: -_./:(). (de 1 a 64 caracteres) Mínimo: 1 Máximo: 64
label_value	String	Valor de etiqueta de servicio. Se comienza con una letra e incluya solo letras, dígitos, puntos (.), guiones (-) y guiones bajos (_). (de 1 a 64 caracteres) Mínimo: 1 Máximo: 64
cluster_name	String	Nombre del clúster de CCE.

**Tabla 21** MicroServiceInfoCCEService
Parámetro	Tipo	Descripción
cluster_id	String	ID del clúster de CCE. Máximo: 64
namespace	String	Espacio de nombres. De 1 a 63 caracteres. Se utiliza letras minúsculas, dígitos y guiones (-). Se comienza con una letra y se termina con una letra o un dígito. Mínimo: 1 Máximo: 63
service_name	String	Nombre del servicio. Se comienza con una letra y se utiliza solo letras, dígitos, puntos (.), guiones (-) y guiones bajos (_). (de 1 a 64 caracteres) Mínimo: 1 Máximo: 64
cluster_name	String	Nombre del clúster de CCE.

**Tabla 22** MicroServiceInfoNacosBase
Parámetro	Tipo	Descripción
namespace	String	ID de espacio de nombres. Si se utiliza el espacio de nombres predeterminado public, deje este parámetro vacío. Solo se permiten letras, números, guiones (-) y guiones bajos (_). Máximo: 64 caracteres Mínimo: 0 Máximo: 64
cluster_name	String	Nombre del clúster. El valor predeterminado es DEFAULT. Solo se permiten letras, números, guiones (-) y guiones bajos (_). Máximo: 64 caracteres Mínimo: 0 Máximo: 64
group_name	String	Nombre del grupo. El valor predeterminado es DEFAULT_GROUP. Solo se permiten letras, números, guiones (-), guiones bajos (_), puntos (.) y dos puntos. Máximo: 128 caracteres Mínimo: 0 Máximo: 128
service_name	String	Nombre del microservicio. El valor no puede comenzar con @ o contener @@. Máximo: 512 caracteres Mínimo: 1 Máximo: 512
server_config	Array of NacosServerConfig objects	Configuraciones del servidor Nacos. Longitud de matriz: 1 - 9
user_info	NacosUserInfo object	Información del usuario de Nacos.

**Tabla 23** NacosServerConfig
Parámetro	Tipo	Descripción
ip_address	String	Dirección IP del servidor de Nacos. No ingrese caracteres chinos. Mínimo: 7 Máximo: 128
port	Integer	Número de puerto del servidor de Nacos. Rango: 1–65535. Mínimo: 1 Máximo: 65535
grpc_port	Integer	Número de puerto gRPC del servidor de Nacos. Predeterminado: número de puerto + 1000 Rango: 1–65535. Mínimo: 1 Máximo: 65535

**Tabla 24** NacosUserInfo
Parámetro	Tipo	Descripción
user_name	String	Nombre de usuario de Nacos. Mínimo: 1 Máximo: 64
password	String	Contraseña de Nacos. Mínimo: 1 Máximo: 64

Código de estado: 400

**Tabla 25** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error.
error_msg	String	Mensaje de error.

Código de estado: 401

**Tabla 26** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error.
error_msg	String	Mensaje de error.

Código de estado: 403

**Tabla 27** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error.
error_msg	String	Mensaje de error.

Código de estado: 404

**Tabla 28** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error.
error_msg	String	Mensaje de error.

Código de estado: 500

**Tabla 29** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error.
error_msg	String	Mensaje de error.

Ejemplo de las solicitudes

Actualización de un canal de VPC del tipo de servidor

{
  "balance_strategy" : 2,
  "member_type" : "ip",
  "name" : "VPC_demo",
  "port" : 22,
  "type" : 2,
  "vpc_health_config" : {
    "http_code" : "200",
    "path" : "/vpc/demo",
    "port" : 22,
    "protocol" : "http",
    "threshold_abnormal" : 5,
    "threshold_normal" : 2,
    "time_interval" : 10,
    "timeout" : 5,
    "enable_client_ssl" : false
  },
  "member_groups" : [ {
    "member_group_name" : "test",
    "member_group_weight" : 1,
    "member_group_remark" : "remark"
  }, {
    "member_group_name" : "default",
    "member_group_weight" : 2,
    "member_group_remark" : "remark"
  } ],
  "members" : [ {
    "host" : "192.168.0.5",
    "weight" : 1,
    "member_group_name" : "test"
  }, {
    "host" : "192.168.1.124",
    "weight" : 2,
    "member_group_name" : "default"
  } ]
}

Actualización de un canal de VPC del tipo de microservicio

{
  "balance_strategy" : 1,
  "member_type" : "ip",
  "name" : "VPC_demo",
  "port" : 22,
  "type" : 3,
  "vpc_health_config" : {
    "http_code" : "200",
    "path" : "/vpc/demo",
    "port" : 22,
    "protocol" : "http",
    "threshold_abnormal" : 5,
    "threshold_normal" : 2,
    "time_interval" : 10,
    "timeout" : 5,
    "enable_client_ssl" : false
  },
  "member_groups" : [ {
    "member_group_name" : "test",
    "member_group_weight" : 1,
    "member_group_remark" : "remark",
    "microservice_version" : "v1",
    "microservice_port" : 80
  }, {
    "member_group_name" : "default",
    "member_group_weight" : 2,
    "member_group_remark" : "remark",
    "microservice_version" : "v2",
    "microservice_port" : 80,
    "microservice_labels" : [ {
      "label_name" : "cluster_id",
      "label_value" : "c429700c-5dc4-482a-9c0e-99f6c0635113"
    } ]
  } ],
  "members" : [ {
    "host" : "192.168.0.5",
    "weight" : 1,
    "member_group_name" : "test"
  }, {
    "host" : "192.168.1.124",
    "weight" : 2,
    "member_group_name" : "default"
  } ],
  "microservice_info" : {
    "service_type" : "CCE",
    "cce_info" : {
      "cluster_id" : "ab1485b4f91b45abbcd560be591f7309",
      "namespace" : "default",
      "workload_type" : "deployment",
      "app_name" : "testapp"
    }
  }
}

Ejemplo de respuestas

Código de estado: 200

Aceptar

Ejemplo 1

{
  "name" : "VPC_demo",
  "port" : 22,
  "balance_strategy" : 2,
  "member_type" : "ip",
  "dict_code" : "",
  "create_time" : "2020-07-23T07:11:57Z",
  "id" : "18174f5f4f1a4dc29f33aeadd9788e5f",
  "status" : 1,
  "member_groups" : [ {
    "member_group_id" : "c1ce135c705c4066853a0460b318fe16",
    "member_group_name" : "test",
    "member_group_weight" : 1,
    "member_group_remark" : "remark",
    "create_time" : "2020-07-23T07:11:57.244829604Z",
    "update_time" : "2020-07-23T07:11:57.244829604Z"
  }, {
    "member_group_id" : "c1ce135c705c4066853a0460b318fe17",
    "member_group_name" : "default",
    "member_group_weight" : 2,
    "member_group_remark" : "remark",
    "create_time" : "2020-07-23T07:11:57.244829604Z",
    "update_time" : "2020-07-23T07:11:57.244829604Z"
  } ],
  "type" : 2,
  "microservice_info" : {
    "id" : "",
    "instance_id" : "",
    "service_type" : "",
    "cse_info" : {
      "cse_app_id" : "",
      "engine_id" : "",
      "engine_name" : "",
      "register_address" : "",
      "service_id" : "",
      "service_name" : ""
    },
    "cce_info" : {
      "cluster_id" : "",
      "cluster_name" : "",
      "namespace" : "",
      "workload_type" : "",
      "app_name" : ""
    },
    "create_time" : "",
    "update_time" : ""
  }
}

Ejemplo 2

{
  "name" : "VPC_demo",
  "id" : "105c6902457144a4820dff8b1ad63331",
  "balance_strategy" : 1,
  "dict_code" : "",
  "create_time" : "2020-07-23T07:11:57.244829604Z",
  "member_type" : "ip",
  "port" : 22,
  "status" : 1,
  "member_groups" : [ {
    "member_group_id" : "c1ce135c705c4066853a0460b318fe16",
    "member_group_name" : "test",
    "member_group_weight" : 1,
    "member_group_remark" : "remark",
    "create_time" : "2020-07-23T07:11:57.244829604Z",
    "update_time" : "2020-07-23T07:11:57.244829604Z",
    "microservice_version" : "v1",
    "microservice_port" : 80
  }, {
    "member_group_id" : "c1ce135c705c4066853a0460b318fe17",
    "member_group_name" : "default",
    "member_group_weight" : 2,
    "member_group_remark" : "remark",
    "create_time" : "2020-07-23T07:11:57.244829604Z",
    "update_time" : "2020-07-23T07:11:57.244829604Z",
    "microservice_version" : "v2",
    "microservice_port" : 80,
    "microservice_labels" : [ {
      "label_name" : "cluster_id",
      "label_value" : "c429700c-5dc4-482a-9c0e-99f6c0635113"
    } ]
  } ],
  "type" : 3,
  "microservice_info" : {
    "id" : "9483afa235be45158a70c19ab817ac65",
    "instance_id" : "eddc4d25480b4cd6b512f270a1b8b341",
    "service_type" : "CCE",
    "cse_info" : {
      "cse_app_id" : "",
      "engine_id" : "",
      "engine_name" : "",
      "register_address" : "",
      "service_id" : "",
      "service_name" : ""
    },
    "cce_info" : {
      "cluster_id" : "ab1485b4f91b45abbcd560be591f7309",
      "cluster_name" : "cce-test",
      "namespace" : "default",
      "workload_type" : "deployment",
      "app_name" : "testapp"
    },
    "create_time" : "2020-07-23T07:11:57.244829604Z",
    "update_time" : "2020-07-23T07:11:57.244829604Z"
  }
}

Código de estado: 400

Error en la solicitud

{
  "error_code" : "APIG.2001",
  "error_msg" : "The request parameters must be specified, parameter name:members"
}

Código de estado: 401

Sin autorización

{
  "error_code" : "APIG.1002",
  "error_msg" : "Incorrect token or token resolution failed"
}

Código de estado: 403

Prohibido

{
  "error_code" : "APIG.1005",
  "error_msg" : "No permissions to request this method"
}

Código de estado: 404

No se ha encontrado

{
  "error_code" : "APIG.3023",
  "error_msg" : "The VPC channel does not exist,id:56a7d7358e1b42459c9d730d65b14e59"
}

Código de estado: 500

Error del servidor interno

{
  "error_code" : "APIG.9999",
  "error_msg" : "System error"
}

Códigos de estado

Código de estado	Descripción
200	Aceptar
400	Error en la solicitud
401	Sin autorización
403	Prohibido
404	No se ha encontrado
500	Error del servidor interno

Códigos de error

Consulte Códigos de error.

Tema principal: Gestión de canales de VPC

Tema anterior: Creación de un canal de VPC

Tema siguiente: Eliminación de un canal de VPC

Comentarios

¿Le pareció útil esta página?

Sí No

Deje algún comentario

Muchas gracias por sus comentarios. Seguiremos trabajando para mejorar la documentación.

El sistema está ocupado. Vuelva a intentarlo más tarde.

¿Cuáles de los siguientes problemas se presentaron?

Contenido diferente a la de la IU del producto

Descripciones poco claras

Falta de ejemplos o código

Pasos incorrectos

No puedo encontrar lo que necesito

Falta de prácticas recomendadas

Comentarios (opcional)

0/500

Seleccione al menos un tipo de problema e ingrese sus comentarios o sugerencias.

Ingrese 500 caracteres como máximo.

Enviar Cancelar