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/Creación de una instancia proxy
Actualización más reciente 2025-03-21 GMT+08:00
Ver PDF
Compartir

Creación de una instancia proxy

Función

Esta API se utiliza para crear una instancia proxy en modo ELB. Antes de invocar a esta API:

URI

POST /v3/{project_id}/instances/{instance_id}/proxy

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, vea Obtención de un ID de proyecto.

instance_id

Sí

String

ID de instancia, que es compatible 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 de body de solicitud

Parámetro

Obligatorio

Tipo

Descripción

flavor_ref

Sí

String

Código de especificación de proxy.

node_num

Sí

Integer

Número de nodos proxy. El valor es un número entero entre 2 y 16.

proxy_name

No

String

Nombre de instancia de proxy. Las instancias del mismo tipo pueden tener los mismos nombres bajo el mismo tenant.

El nombre debe comenzar con una letra y debe contener entre 4 y 64 caracteres. Solo se permiten letras (distinguen mayúsculas de minúsculas), dígitos, guiones (-) y guiones bajos (_).

proxy_mode

No

String

Tipo de instancia de proxy. El tipo predeterminado es readwrite.

  • readwrite: lectura y escritura
  • readonly: de solo lectura

route_mode

No

Integer

Política de enrutamiento de la instancia proxy.

Valores:

  • 0 (valor predeterminado): 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).

nodes_read_weight

No

Array of NodesWeight objects

Ponderaciones de lectura de nodos de base de datos.

Si proxy_mode se establece en readonly, solo se pueden asignar ponderaciones para réplicas de lectura.

subnet_id

No

String

ID de subred en la VPC de la base de datos.

new_node_auto_add_status

No

String

Si los nuevos nodos se asocian automáticamente con instancias 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 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.
  • Este parámetro no está disponible si route_mode no es 0 y new_node_auto_add_status es OFF.
Tabla 4 NodesWeight

Parámetro

Obligatorio

Tipo

Descripción

id

No

String

ID del nodo.

weight

No

Integer

Ponderación asignada al nodo.

  • Si route_mode es 0, el valor es de 0 a 1000.
  • Si route_mode es 1, el valor para el nodo primario es 0, y el valor para réplicas de lectura es 0 o 1.
  • Si route_mode es 2, el valor para el nodo primario es 1 y el valor para réplicas de lectura es 0 o 1.

Parámetros de respuesta

Código de estado: 201

Tabla 5 Parámetros de cuerpo de respuesta

Parámetro

Tipo

Descripción

job_id

String

ID de tarea.

Código de estado: 400

Tabla 6 Parámetros de 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 de cuerpo de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Mensaje de error.

Solicitud de ejemplo

Creación de una instancia proxy (Las especificaciones de la instancia proxy son 2 vCPU y 8 GB de memoria, y el modo proxy es de solo lectura)

POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/43e4feaab48f11e89039fa163ebaa7e4br01/proxy
{
  "flavor_ref" : "gaussdb.proxy.large.x86.2",
  "node_num" : 2,
  "proxy_name" : "gaussdb-proxy",
  "proxy_mode" : "readonly",
  "route_mode" : 0,
  "nodes_read_weight" : [ {
    "id" : "45021bf73a244312a3f2af95092feeecno07",
    "weight" : 50
  }, {
    "id" : "d78a65690cea4af5ad14585e110ff89bno07",
    "weight" : 400
  } ],
  "subnet_id" : "6991d82d-9166-4aff-a1fa-d2a8748b7084"
}

Ejemplo de respuesta

Código de estado: 201

Operación exitosa.

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

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