Ativa o recurso de failover para um par de replicação. Se o disco primário de um par de replicação falhar, chame esta operação para conceder permissões de leitura e gravação no disco secundário e realizar o failover para esse disco.
Observações de uso
Para obter informações sobre as regiões em que a replicação assíncrona está disponível, consulte Visão geral.
O par de replicação no qual você deseja ativar o failover não pode estar no estado Invalid(invalid) ou Deleted(deleted).
Após a execução do failover, o par de replicação entra no estado Failovered(failovered).
Depuração
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Exemplo |
Descrição |
| Action | String | Sim | FailoverDiskReplicaPair | A operação a ser executada. Defina o valor como FailoverDiskReplicaPair. |
| RegionId | String | Sim | cn-shanghai | O ID da região do disco secundário no par de replicação. Chame a operação DescribeDiskReplicaPairs para consultar os IDs das regiões dos discos secundários nos pares de replicação. Nota O sub-recurso de failover deve estar ativado na região onde o disco secundário está localizado. |
| ReplicaPairId | String | Sim | pair-cn-dsa**** | O ID do par de replicação. |
| ClientToken | String | Não | 123e4567-e89b-12d3-a456-42665544**** | O token de cliente usado para garantir a idempotência da solicitação. Use o cliente para gerar o token, mas certifique-se de que ele seja exclusivo 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)://ebs.cn-shanghai.aliyuncs.com/?Action=FailoverDiskReplicaPair
&RegionId=cn-shanghai
&ReplicaPairId=pair-cn-dsa****
&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
<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 erro
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|
403 |
OperationDenied |
The operation is not allowed. |
Esta operação não é permitida. |
|
403 |
OperationDenied.InvalidStatus |
The operation is not allowed in current status. |
Não é possível executar esta operação no recurso no estado atual. |
|
403 |
OperationDenied.OperateNotAllowedForPrimary |
Operation is not allowed on the primary site. |
Esta operação não é permitida no site primário. |
|
403 |
OperationDenied.OperateNotAllowedForStandby |
Operation is not allowed on the secondary site. |
Esta operação não é permitida 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. |
Você não tem 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.