Ativa o recurso de failover para pares de replicação em um grupo consistente de pares de replicação. Se os discos primários de determinados pares de replicação em um grupo consistente falharem, chame esta operação para ativar as permissões de leitura e gravação nos discos secundários.
Observações de uso
Para obter informações sobre as regiões onde o recurso de grupo consistente de pares de replicação está disponível, consulte Visão geral.
O grupo consistente de pares de replicação deve estar no 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) ou Failovered (failovered).
Após a execução do failover, o grupo consistente de pares de replicação passa para o estado Failovered (failovered).
Antes de executar o failover, certifique-se de que a primeira sincronização completa de dados entre o site primário e o site secundário foi concluída.
Depuração
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Exemplo |
Descrição |
|
Action |
String |
Sim |
FailoverDiskReplicaGroup |
A operação a ser executada. Defina o valor como FailoverDiskReplicaGroup. |
|
RegionId |
String |
Sim |
cn-shanghai |
O ID da região do site secundário do grupo consistente de pares de replicação. |
|
ReplicaGroupId |
String |
Sim |
group-myreplica**** |
O ID do grupo consistente de pares de replicação. |
|
ClientToken |
String |
Não |
123e4567-e89b-12d3-a456-42665544**** |
Token de cliente usado para garantir a idempotência da solicitação. Use o cliente para gerar o token, mas garanta que ele seja único entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não deve exceder 64 caracteres. Para mais informações, consulte Como garantir a idempotência. |
Parâmetros de resposta
|
Parâmetro |
Tipo |
Exemplo |
Descrição |
|
RequestId |
String |
C123F94F-4E38-19AE-942A-A8D6F44F**** |
O ID da solicitação. |
Exemplos
Exemplos de solicitações
http(s)://ecs.aliyuncs.com/?Action=FailoverDiskReplicaGroup
&RegionId=cn-shanghai
&ReplicaGroupId=group-myreplica****
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&<Common request parameters>Exemplos de respostas de sucesso
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 erro
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|
403 |
OperationDenied |
The operation is not allowed. |
Não é possível executar esta operação. |
|
403 |
OperationDenied.InvalidStatus |
The operation is not allowed in current status. |
Esta operação não é permitida para o recurso no estado atual. |
|
403 |
OperationDenied.NoPairInGroup |
The operation is not allowed because no pair in the group. |
Operação não suportada porque nenhum par de replicação pertence ao grupo consistente de pares de replicação especificado. |
|
403 |
OperationDenied.PairGroupStatusConflict |
The operation is not allowed due to pair and group status are not consistent. |
Operação não suportada porque o estado do par de replicação difere do estado do grupo consistente de pares de replicação. |
|
403 |
OperationDenied.PairGroupAZoneConflict |
The operation is not allowed due to pair and group having different RegionId or ZoneId. |
Operação não suportada porque o grupo consistente de pares de replicação e o par de replicação não pertencem à mesma região e zona. |
|
403 |
OperationDenied.PairInAnotherGroup |
The operation is not allowed because pair is already in another group. |
Operação não suportada porque o par de replicação já foi adicionado a outro grupo consistente de pares de replicação. |
|
403 |
OperationDenied.OperateNotAllowedForPrimary |
Operation is not allowed on the primary site. |
Não é possível executar esta operação no site primário. |
|
403 |
OperationDenied.OperateNotAllowedForStandby |
Operation is not allowed on the secondary site. |
Não é possível executar esta operação no site secundário. |
|
403 |
Forbidden |
User is not authorized to operate. |
Você não tem permissão para executar esta operação no recurso. Verifique as permissões da sua conta ou entre em contato com o administrador da sua conta Alibaba Cloud. |
|
403 |
Forbidden.Action |
User is not authorized to operate this action. |
Sem acesso a esta operação. Verifique as permissões da sua conta ou entre em contato com o administrador da sua conta Alibaba Cloud. |
|
404 |
NoSuchResource |
The specified resource does not exist. |
O recurso especificado não foi encontrado. |
|
500 |
InternalError |
The request processing has failed due to some unknown error, exception or failure. |
Ocorreu um erro interno. |
|
504 |
RequestTimeout |
The request is timeout, please try again later. |
A solicitação atingiu o tempo limite. Tente novamente mais tarde. |
Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.