Todos os produtos
Search
Central de documentação

:Consultar configurações de failover automático primário/secundário

Última atualização: Jun 26, 2026

Consulta o status da função de failover automático primário/secundário de uma instância do ApsaraDB for RDS.

Após um failover primário/secundário, a instância primária passa a ser secundária e a instância secundária torna-se primária. Para mais informações, consulte Alternar serviços manual ou automaticamente entre as instâncias mestre e escrava do RDS MySQL.

Antes de chamar esta operação, verifique se a instância utiliza a High-availability Edition, Enterprise Edition ou Cluster Edition.

Depuração

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

Parâmetros de solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

DescribeHASwitchConfig

Operação a ser executada. Defina o valor como DescribeHASwitchConfig.

DBInstanceId

String

Sim

rm-uf6wjk5xxxxxxxxxx

ID da instância.

RegionId

String

Sim

cn-hangzhou

ID da região à qual a instância pertence. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

Parâmetros de resposta

ParâmetroTipoExemploDescrição
HAConfigStringManual

Status da função de failover automático primário/secundário. Valores válidos:

  • Auto: A função de failover automático primário/secundário está ativada. Em caso de falha, o sistema alterna automaticamente os serviços da instância primária para a secundária.
  • Manual: A função de failover automático primário/secundário está temporariamente desativada.
ManualHATimeString2019-08-29T15:00:00Z

Horário em que a função de failover automático primário/secundário será reativada. O horário deve estar no formato UTC.

RequestIdString4FDF4B79-2741-4C5F-8C76-4B953FC5C2B1

ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://rds.aliyuncs.com/? Action=DescribeHASwitchConfig
&RegionId=cn-hangzhou
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<DescribeHASwitchConfigResponse>
   <ManualHATime>2019-08-29T15:00:00Z</ManualHATime>
   <RequestId>4FDF4B79-2741-4C5F-8C76-4B953FC5C2B1</RequestId>
   <HAConfig>Manual</HAConfig>
</DescribeHASwitchConfigResponse>

Formato JSON

{
    "ManualHATime": "2019-08-29T15:00:00Z",
    "RequestId": "4FDF4B79-2741-4C5F-8C76-4B953FC5C2B1",
    "HAConfig": "Manual"
}

Códigos de erro

Para obter uma lista de códigos de erro, visite a Central de Erros da API.