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:
- Aprender cómo autorizar y autenticarla.
- Obtenga la región y el punto de conexión requeridos.
URI
PUT /v3/{project_id}/instances/{instance_id}/nodes/{node_id}/priority
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. |
node_id |
Sí |
String |
ID del nodo. |
Parámetros de solicitud
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
X-Auth-Token |
Sí |
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 |
Sí |
String |
Tipo de contenido. Valor: application/json |
X-Language |
No |
String |
Idioma. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
priority |
Sí |
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
Parámetro |
Tipo |
Descripción |
---|---|---|
job_id |
String |
ID de flujo de trabajo. |
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. |
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.