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.
Actualización más reciente 2025-03-21 GMT+08:00

Creación de una réplica de lectura

Función

Esta API se utiliza para crear una réplica de lectura. Antes de invocar a esta API:

URI

POST /v3/{project_id}/instances/{instance_id}/nodes/enlarge

Tabla 1 Parámetros de URI

Parámetro

Obligatorio

Tipo

Descripción

project_id

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

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

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

priorities

Array of integers

Prioridad de conmutación por error de una réplica de lectura.

La prioridad de conmutación por error varía de 1 para la primera prioridad a 16 para la última prioridad. Esta prioridad determina el orden en el que se promueven las réplicas de lectura al recuperarse de un error de nodo primario. Las réplicas leídas con la misma prioridad tienen la misma probabilidad de ser promovidas al nuevo nodo primario. Puede configurar una prioridad de conmutación por error para hasta 9 réplicas de lectura, y la prioridad predeterminada para las réplicas de lectura restantes es de -1, lo que indica que estas réplicas de lectura no se pueden promover a primaria. Puede cambiar la prioridad de conmutación por error de una réplica de lectura.

is_auto_pay

No

String

Si el pedido se pagará automáticamente después de que se creen instancias anuales/mensuales. Este parámetro no afecta al método de pago de la renovación automática.

  • true: indica que el pedido se pagará automáticamente desde su cuenta. El valor predeterminado es true.
  • false: indica que el pedido se pagará manualmente.

availability_zones

No

Array of strings

Zona de disponibilidad. Puede especificar una zona de disponibilidad para crear una réplica de lectura. Si no se especifica este parámetro, se asigna automáticamente una zona de disponibilidad de forma predeterminada.

La función se encuentra en la fase de prueba beta abierta (OBT). Para usarlo, envíe un ticket de servicio.

Para obtener el valor, vea la clave availability_zone en az_status de Consulta de especificaciones de base de datos.

Nota: La creación de una réplica de lectura en una zona de disponibilidad especificada puede fallar debido a recursos insuficientes.

Parámetros de respuesta

Código de estado: 201

Tabla 4 Parámetros de cuerpo de respuesta

Parámetro

Tipo

Descripción

instance_id

String

ID de instancia.

node_names

Array of strings

Nombres de nodos.

job_id

String

ID de la tarea para crear una réplica de lectura.

Este parámetro solo se devuelve cuando se crea una réplica de lectura de pago por uso.

order_id

String

ID de pedido. Este parámetro se devuelve cuando se crean réplicas de lectura anuales/mensuales.

Código de estado: 400

Tabla 5 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 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.

Solicitud de ejemplo

Creación de una réplica de lectura para una instancia de BD

POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/ba62a0b83a1b42bfab275829d86ac0fdin07/nodes/enlarge
{
  "priorities" : [ 1, 2 ]
}

Ejemplo de respuesta

Código de estado: 201

Operación exitosa.

{
  "instance_id" : "ba62a0b83a1b42bfab275829d86ac0fdin07",
  "node_names" : [ "gauss-ccf5_node03" ],
  "job_id" : "dff1d289-4d03-4942-8b9f-463ea07c000d"
}

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.