Todos los productos
Search
Centro de documentos

:FailoverDiskReplicaPair

Última actualización: Sep 02, 2026

Habilite la función de failover para un par de replicación. Si el disco principal de un par de replicación presenta errores, llame a esta operación para otorgar permisos de lectura y escritura en el disco secundario y ejecutar el failover hacia dicho disco.

Notas de uso

  • Para obtener información sobre las regiones donde está disponible la replicación asíncrona, consulte Descripción general.

  • El par de replicación al que desea habilitar el failover no debe encontrarse en el estado Invalid (inválido) ni Deleted (eliminado).

  • Después de ejecutar un failover, el par de replicación entra en el estado Failovered (failover completado).

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar a esta operación desde OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro

Tipo

Obligatorio

Ejemplo

Descripción

Action String Sí FailoverDiskReplicaPair

La operación que desea ejecutar. Establezca el valor en FailoverDiskReplicaPair.

RegionId String Sí cn-shanghai

El ID de región del disco secundario en el par de replicación. Llame a la operación DescribeDiskReplicaPairs para consultar los ID de región de los discos secundarios en los pares de replicación.

Nota La subfunción de failover debe estar habilitada en la región donde se encuentra el disco secundario.
ReplicaPairId String Sí pair-cn-dsa****

El ID del par de replicación.

ClientToken String No 123e4567-e89b-12d3-a456-42665544****

El token de cliente que se usa para garantizar la idempotencia de la solicitud. Use el cliente para generar el token, pero asegúrese de que sea único entre distintas solicitudes. El token solo puede contener caracteres ASCII y no debe exceder los 64 caracteres de longitud. Para más información, consulte How to ensure idempotence.

Parámetros de respuesta

Parámetro

Tipo

Ejemplo

Descripción

RequestId

String

C123F94F-4E38-19AE-942A-A8D6F44F****

El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

http(s)://ebs.cn-shanghai.aliyuncs.com/?Action=FailoverDiskReplicaPair
&RegionId=cn-shanghai
&ReplicaPairId=pair-cn-dsa****
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<FailoverDiskReplicaPairResponse>
    <RequestId>C123F94F-4E38-19AE-942A-A8D6F44F****</RequestId>
</FailoverDiskReplicaPairResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "C123F94F-4E38-19AE-942A-A8D6F44F****"
}

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

403

OperationDenied

The operation is not allowed.

No puede ejecutar esta operación.

403

OperationDenied.InvalidStatus

The operation is not allowed in current status.

No puede ejecutar esta operación en el recurso cuando se encuentra en el estado actual.

403

OperationDenied.OperateNotAllowedForPrimary

Operation is not allowed on the primary site.

No puede ejecutar esta operación en el sitio principal.

403

OperationDenied.OperateNotAllowedForStandby

Operation is not allowed on the secondary site.

No puede ejecutar esta operación en el sitio secundario.

403

Forbidden

User is not authorized to operate.

No tiene los permisos necesarios para ejecutar esta operación en el recurso. Compruebe los permisos de su cuenta o póngase en contacto con el administrador de su cuenta de Alibaba Cloud.

403

Forbidden.Action

User is not authorized to operate this action.

No tiene acceso a esta operación. Compruebe los permisos de su cuenta o póngase en contacto con el administrador de su cuenta de Alibaba Cloud.

404

NoSuchResource

The specified resource does not exist.

No se encontró el recurso especificado.

500

InternalError

The request processing has failed due to some unknown error, exception or failure.

Ocurrió un error interno.

504

RequestTimeout

The request is timeout, please try again later.

La solicitud ha expirado. Inténtelo de nuevo más tarde.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.