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/ Relational Database Service/ Referencia de la API/ API v3 (recomendado)/ Gestión de instancias de BD/ Conmutación manual de instancias de base de datos primarias/en espera

Actualización más reciente 2024-06-06 GMT+08:00

Ver PDF

Conmutación manual de instancias de base de datos primarias/en espera

Función

Esta API se utiliza para cambiar manualmente instancias de base de datos primarias/en espera según sea necesario.

Antes de invocar a una API, debe entender la API de Autenticación.

Restricciones

Esta API solo está disponible para RDS for MySQL y RDS for PostgreSQL.
Esta API solo es compatible con instancias de base de datos primarias/en espera.
Esta operación no se puede realizar si la instancia de base de datos se encuentra en cualquiera de los siguientes estados: creación, reinicio, actualización, cambio de clase de instancia, restauración, cambio de puerto, eliminación de cuenta de base de datos o creación de cuenta de base de datos.
La conmutación principal/en espera no cambia la dirección IP flotante de la instancia.

URI

Formato de URI
PUT /v3/{project_id}/instances/{instance_id}/failover

Descripción de parámetro

**Tabla 1** Descripción de parámetro
Nombre	Obligatorio	Descripción
project_id	Sí	Especifica el ID de proyecto de un tenant en una región. Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de un ID de proyecto.
instance_id	Sí	Especifica el ID de instancia de base de datos.

Solicitud

Descripción de parámetro

**Tabla 2** Descripción de parámetro
Nombre	Obligatorio	Tipo	Descripción
force	No	Boolean	Si se debe realizar una conmutación primaria/en espera forzada. Por defecto, este parámetro se deja en blanco, lo que indica que la conmutación no se realiza por la fuerza. true: Se realiza una conmutación forzada. false: No se realiza ninguna conmutación forzada. NOTA: Este parámetro es válido solo para el motor de base de datos de PostgreSQL.

Solicitud de ejemplo

Realización de una conmutación primaria/standby no forzada

PUT https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/failover

{}

Realización de una conmutación forzada primaria/en espera
```
{
"force":true
}
```

Respuesta

Respuesta normal

Nombre	Descripción
workflowId	Indica el ID del flujo de trabajo.
instanceId	Indica el ID de instancia de base de datos.
nodeId	Indica el ID de nodo.

Ejemplo de respuesta normal

{
    "workflowId":"072beb09-0573-40bf-bfe8-4be5cec9e85a",
    "instanceId":"794c38e5309344818f4b33b86ebce9b4in03",
    "nodeId":"b94ba815747040f1b0d641cd13364a06no03"
}