Ativar ou desativar failovers automáticos entre primário e secundário - : Central de Documentação do Alibaba Cloud

Após a conclusão de um failover, a instância RDS primária original passa a operar como instância RDS secundária. Para mais informações, consulte Alternar cargas de trabalho entre instâncias primárias e secundárias do ApsaraDB RDS for MySQL.

Antes de usar esta operação, verifique se a instância não executa o RDS Basic Edition.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar esta operação no OpenAPI Explorer, que gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	ModifyHASwitchConfig	Operação a ser executada. Defina o valor como ModifyHASwitchConfig.
DBInstanceId	String	Sim	rm-uf6wjk5xxxxxxxxxx	ID da instância.
RegionId	String	Sim	cn-hangzhou	ID da região da instância. Use a operação DescribeRegions para consultar a lista de regiões mais recente.
HAConfig	String	Não	Manual	Status do recurso de failover automático entre primário e secundário. Valores válidos: Auto: O recurso de failover automático entre primário e secundário está ativado. Em caso de falha, o sistema transfere automaticamente as cargas de trabalho da instância para a instância secundária. Manual: O recurso de failover automático entre primário e secundário está desativado. Em caso de falha, transfira manualmente as cargas de trabalho da instância para a instância secundária. Valor padrão: Auto. Nota Se você definir este parâmetro como Manual, especifique o parâmetro ManualHATime.
ManualHATime	String	Não	2019-08-29T15:00:00Z	Horário após o qual o recurso de failover automático entre primário e secundário será reativado. O valor máximo permitido é 23:59:59 de sete dias depois. O horário segue o padrão ISO 8601 no formato aaaa-MM-ddTHH:mm:ssZ e deve estar em UTC. Nota Este parâmetro só entra em vigor quando o parâmetro HAConfig é definido como Manual.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	B6AE1448-D846-4831-B1C7-CFF3E99D5470	ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://rds.aliyuncs.com/?Action=ModifyHASwitchConfig
&RegionId=cn-hangzhou
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&HAConfig=Manual
&ManualHATime=2019-08-28T15:00:00
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<ModifyHASwitchConfigResponse>
   <RequestId>B6AE1448-D846-4831-B1C7-CFF3E99D5470</RequestId>
</ModifyHASwitchConfigResponse>

Formato JSON

{
    "RequestId": "B6AE1448-D846-4831-B1C7-CFF3E99D5470"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	HaConfig.Format	The value of HaConfig must be auto or manual	Mensagem de erro retornada porque o valor do parâmetro HAConfig é inválido. O parâmetro HAConfig deve ser definido como Auto ou Manual.
400	HaConfigIsNull	HaConfig is null.	Mensagem de erro retornada porque o valor do parâmetro HAConfig é Null.

Para obter uma lista de códigos de erro, visite o API Error Center.