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/ TaurusDB/ Referencia de la API/ Las API (recomendadas)/ Proxy de base de datos/ Cambio de la política de enrutamiento de una instancia de proxy
Actualización más reciente 2025-03-21 GMT+08:00
Ver PDF
Compartir

Cambio de la política de enrutamiento de una instancia de proxy

Función

Esta API se utiliza para cambiar la política de enrutamiento de una instancia proxy. Antes de invocar a esta API:

Restricciones

Esta API está en la fase de prueba beta abierta (OBT). Para usar esta API, envíe un ticket de servicio.

URI

PUT /v3/{project_id}/instances/{instance_id}/proxy/{proxy_id}/route-mode

Tabla 1 Parámetros de URI

Parámetro

Obligatorio

Tipo

Descripción

project_id

Sí

String

ID de proyecto de un tenant en una región.

Para obtener este valor, consulte Obtención de un ID de proyecto.

instance_id

Sí

String

ID de instancia, que es compatible con el formato UUID.

proxy_id

Sí

String

ID de instancia de proxy, que cumple con el formato UUID.

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.

Para obtener este valor, invoque a la API de IAM para obtener un token de usuario.

El valor de X-Subject-Token en el encabezado de respuesta es el valor del token.

X-Language

No

String

Tipo de idioma de solicitud. El valor predeterminado es en-us.

Valores:

  • en-us
  • zh-cn
Tabla 3 Parámetros del cuerpo de solicitud

Parámetro

Obligatorio

Tipo

Descripción

route_mode

Sí

Integer

Política de enrutamiento de la instancia proxy.

Valores:

  • 0: ponderado
  • 1: balanceo de carga (el nodo primario no procesa las solicitudes de lectura)
  • 2: balanceo de carga (el nodo primario procesa las solicitudes de lectura)

master_weight

No

Integer

Ponderación del nodo primario.

  • Si la política de enrutamiento es 0, el valor es de 0 a 1000.
  • Si la política de enrutamiento es 1, el valor es 0.
  • Si la política de enrutamiento es 2, el valor es 1.

readonly_nodes

No

Array of ModifyProxyRouteModeWeightReadonlyNode objects

Información de ponderación de las réplicas de lectura.

new_node_auto_add_status

No

String

Si los nuevos nodos se asocian automáticamente con instancias de proxy. Para configurar este parámetro, póngase en contacto con el servicio de atención al cliente.

Valores:

  • ON: los nuevos nodos se asocian automáticamente con las instancias de proxy.
  • OFF: los nuevos nodos no se asocian automáticamente con instancias proxy.

new_node_weight

No

Integer

Ponderación de lectura del nuevo nodo.

  • Si route_mode es 0 y new_node_auto_add_status es ON, el valor de este parámetro oscila entre 0 y 1000.
  • Si route_mode no es 0 y new_node_auto_add_status es OFF, este parámetro no está disponible.
Tabla 4 ModifyProxyRouteModeWeightReadonlyNode

Parámetro

Obligatorio

Tipo

Descripción

id

Sí

String

ID de réplica de lectura.

weight

Sí

Integer

Ponderación de la réplica de lectura.

  • Si la política de enrutamiento es 0, el valor es de 0 a 1000.
  • Si la política de enrutamiento es 1 o 2, el valor es 0 o 1.

Parámetros de respuesta

Código de estado: 200

Tabla 5 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

job_id

String

ID de la tarea.

Código de estado: 400

Tabla 6 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 7 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 la solicitud

  • Cambio de la política de enrutamiento de una instancia de proxy a 0 
    PUT https://{endpoint}/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/e73893ef73754465a8bd2e0857bbf13ein07/proxy/e87088f0b6a345e79db19d57c41fde15po01/route-mode
{
  "route_mode" : 0,
  "master_weight" : 100,
  "readonly_nodes" : {
    "id" : "d23535333138462880bfa1838fdfced2no07",
    "weight" : 200
  }
}
  • Cambio de la política de enrutamiento de una instancia de proxy a 1 
    PUT https://{endpoint}/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/e73893ef73754465a8bd2e0857bbf13ein07/proxy/e87088f0b6a345e79db19d57c41fde15po01/route-mode

{
  "route_mode" : 1,
  "master_weight" : 0,
  "readonly_nodes" : {
    "id" : "d23535333138462880bfa1838fdfced2no07",
    "weight" : 1
  }
}
  • Cambio de la política de enrutamiento de una instancia de proxy a 2 
    PUT https://{endpoint}/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/e73893ef73754465a8bd2e0857bbf13ein07/proxy/e87088f0b6a345e79db19d57c41fde15po01/route-mode

{
  "route_mode" : 2,
  "master_weight" : 1,
  "readonly_nodes" : {
    "id" : "d23535333138462880bfa1838fdfced2no07",
    "weight" : 0
  }
}

Ejemplo de la respuesta

Código de estado: 200

Operación exitosa.

{
  "job_id" : "04efe8e2-9255-44ae-a98b-d87c11411890"
}

Código de estado

Para más detalles, véase Códigos de estado.

Código de error

Para más detalles, véase Códigos de error.

Tema principal: Proxy de base de datos