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)/ Gestión de instancias/ Cambio de la prioridad de conmutación por falla de una réplica de lectura
Actualización más reciente 2025-03-21 GMT+08:00

Cambio de la prioridad de conmutación por falla de una réplica de lectura

Función

Esta API se utiliza para cambiar la prioridad de conmutación por error de una réplica de lectura. Antes de invocar a esta API:

URI

PUT /v3/{project_id}/instances/{instance_id}/nodes/{node_id}/priority

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

instance_id

String

ID de instancia.

node_id

String

ID del nodo.

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 el valor, invoque a la API para obtener un token de usuario.

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

Content-Type

String

Tipo de contenido.

Valor: application/json

X-Language

No

String

Idioma.

Tabla 3 Parámetro del cuerpo de la solicitud

Parámetro

Obligatorio

Tipo

Descripción

priority

String

Prioridad de conmutación por error.

El valor puede ser -1 o cualquier número comprendido entre 1 y 16. Si el valor es un número positivo, un valor menor indica una prioridad más alta. 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 de lectura con la misma prioridad tienen la misma probabilidad de ser promovidas al nuevo nodo primario. Si el valor es -1, la réplica de lectura no participa en un conmutación por falla. Después de establecer la prioridad de una réplica de lectura en -1, asegúrese de que una instancia de AZ única todavía tenga al menos una réplica de lectura o que los nodos restantes de una instancia de AZ cruzada estén en diferentes AZ.

Parámetros de respuesta

Código de estado: 200

Tabla 4 Parámetro del cuerpo de respuesta

Parámetro

Tipo

Descripción

job_id

String

ID de flujo de trabajo.

Código de estado: 400

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

Ejemplo de la solicitud

Cambio de la prioridad de conmutación por falla de réplica de lectura a 2

PUT https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/61a4ea66210545909d74a05c27a7179ein07//nodes/ss62c18799854a919bab633874c159dfno01/priority

{
  "priority" : 2
}

Ejemplo de la respuesta

Código de estado: 200

Operación exitosa.

{
  "job_id" : "b054f3e1-64f8-4219-ad48-f9ac494c6983"
}

Código de estado

Código de estado

Descripción

200

Operación exitosa.

400

Error de cliente.

500

Error de servidor.

Código de error

Para obtener más información, véase Códigos de error.