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/ GaussDB(for MySQL)/ Referencia de la API/ Las API (recomendadas)/ Gestión de instancias de base de datos/ Creación de una réplica de lectura

Actualización más reciente 2023-12-14 GMT+08:00

Ver PDF

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:

Aprender cómo autorizar y autenticarla.
Obtener los región y punto de conexión requeridos.

URI

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

**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.

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.
X-Language	No	String	Idioma.

**Tabla 3** Parámetros de body de solicitud
Parámetro	Obligatorio	Tipo	Descripción
priorities	Sí	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.
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.

Parámetros de respuesta

Código de estado: 201

**Tabla 4** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
instance_id	String	ID de instancia.
node_names	Array of strings	Lista de nombres de nodo
job_id	String	ID de tarea de creación de réplicas de lectura. Este parámetro sólo 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 body 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 body 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

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

Ejemplo de respuesta

Código de estado: 201

Success.

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