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> Distributed Cache Service> Referencia de la API> API V2> Gestión de instancias> Conmutación de tipo principal/en Standby

Actualización más reciente 2022-11-09 GMT+08:00

Ver PDF

Conmutación de tipo principal/en Standby

Función

Esta API se utiliza para realizar una conmutación de tipo principal/en standby. Sólo las instancias maestras/en espera admiten esta operación.

URI

POST /v2/{project_id}/instances/{instance_id}/swap

**Tabla 1** Parámetros de path
Parámetro	Obligatorio	Tipo	Descripción
instance_id	Sí	String	ID de instancia.
project_id	Sí	String	ID del proyecto.

Parámetros de solicitud

Ninguno

Parámetros de respuesta

Código de estado: 400

**Tabla 2** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
error_msg	String	Mensaje de error. Máximo: 1024
error_code	String	Código de error. Máximo: 9
error_ext_msg	String	Información de error extendida. Este parámetro no se utiliza actualmente y se establece en null. Máximo: 1024

Código de estado: 401

**Tabla 3** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
error_msg	String	Mensaje de error. Máximo: 1024
error_code	String	Código de error. Máximo: 9
error_ext_msg	String	Información de error extendida. Este parámetro no se utiliza actualmente y se establece en null. Máximo: 1024

Código de estado: 403

**Tabla 4** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
error_msg	String	Mensaje de error. Máximo: 1024
error_code	String	Código de error. Máximo: 9
error_ext_msg	String	Información de error extendida. Este parámetro no se utiliza actualmente y se establece en null. Máximo: 1024

Código de estado: 404

**Tabla 5** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
error_msg	String	Mensaje de error. Máximo: 1024
error_code	String	Código de error. Máximo: 9
error_ext_msg	String	Información de error extendida. Este parámetro no se utiliza actualmente y se establece en null. Máximo: 1024

Código de estado: 500

**Tabla 6** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
error_msg	String	Mensaje de error. Máximo: 1024
error_code	String	Código de error. Máximo: 9
error_ext_msg	String	Información de error extendida. Este parámetro no se utiliza actualmente y se establece en null. Máximo: 1024

Solicitudes de ejemplo

POST https://{dcs_endpoint}/v2/a4d31cb6-3d72-4fdc-8ec9-6e3a41e47f71/instances/5560df16-cebf-4473-95c4-d1b573c16e79/swap

Ejemplo de respuestas

Código de estado: 400

Solicitud no válida.

{
  "error_msg" : "Master standby swap is not supported.",
  "error_code" : "DCS.4855",
  "error_ext_msg" : null
}

Códigos de estado

Código de estado	Descripción
204	Conmutación de tipo principal/en standby se realiza con éxito.
400	Solicitud no válida.
401	Información de autenticación no válida.
403	La solicitud se rechaza.
404	La página solicitada no se encuentra.
500	Error interno del servicio.