FailoverDiskReplicaGroup - - Centro de documentación de Alibaba Cloud

Habilita la función de conmutación por error para los pares de replicación en un grupo consistente de pares de replicación. Si los discos principales de ciertos pares de replicación dentro de un grupo consistente presentan fallas, llame a esta operación para habilitar los permisos de lectura y escritura en los discos secundarios.

Notas de uso

Para obtener información sobre las regiones donde está disponible la función de grupo consistente de pares de replicación, consulte Descripción general.
El grupo consistente de pares de replicación debe encontrarse en el estado One-time Syncing (manual_syncing), Syncing (syncing), Normal (normal), Stopping (stopping), Stop Failed (stop_failed), Stopped (stopped), In Failover (failovering), Failover Failed (failover_failed) o Failovered (failovered).
Después de realizar una conmutación por error, el grupo consistente de pares de replicación pasa al estado Failovered (failovered).
Antes de ejecutar una conmutación por error, asegúrese de que la primera sincronización completa de datos entre el sitio principal y el sitio secundario haya finalizado.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, se recomienda 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í	FailoverDiskReplicaGroup	La operación que desea ejecutar. Establezca el valor como FailoverDiskReplicaGroup.
RegionId	String	Sí	cn-shanghai	El ID de región del sitio secundario del grupo consistente de pares de replicación.
ReplicaGroupId	String	Sí	group-myreplica****	El ID del grupo consistente de pares de replicación.
ClientToken	String	No	123e4567-e89b-12d3-a456-42665544****	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede usar el cliente para generar el token, pero debe asegurarse 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)://ecs.aliyuncs.com/?Action=FailoverDiskReplicaGroup
&RegionId=cn-shanghai
&ReplicaGroupId=group-myreplica****
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

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

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

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.NoPairInGroup	The operation is not allowed because no pair in the group.	La operación no es compatible porque no hay pares de replicación pertenecientes al grupo consistente de pares de replicación especificado.
403	OperationDenied.PairGroupStatusConflict	The operation is not allowed due to pair and group status are not consistent.	La operación no es compatible porque el estado del par de replicación difiere del estado del grupo consistente de pares de replicación.
403	OperationDenied.PairGroupAZoneConflict	The operation is not allowed due to pair and group having different RegionId or ZoneId.	La operación no es compatible porque el grupo consistente de pares de replicación y el par de replicación no pertenecen a la misma región y zona.
403	OperationDenied.PairInAnotherGroup	The operation is not allowed because pair is already in another group.	La operación no es compatible porque el par de replicación ya se agregó a otro grupo consistente de pares de replicación.
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 caducado. Inténtelo de nuevo más tarde.

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