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.
- Obtenga la región y el punto de conexión requeridos.
URI
POST /v3/{project_id}/instances/{instance_id}/nodes/enlarge
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
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:
|
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. 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.
|
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
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
Parámetro |
Tipo |
Descripción |
---|---|---|
error_code |
String |
Código de error. |
error_msg |
String |
Mensaje de error. |
Código de estado: 500
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.