Consultar tarefas de upgrade da versão principal do mecanismo - : Central de Documentação do Alibaba Cloud

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeUpgradeMajorVersionTasks	Operação a ser executada. Defina o valor como DescribeUpgradeMajorVersionTasks.
DBInstanceId	String	Sim	pgm-bp1gm3yh0ht1****	ID da instância original.
PageSize	Integer	Não	30	Número de entradas retornadas por página. Valores válidos: de 30 a 100. Valor padrão: 30.
PageNumber	Integer	Não	1	Número da página retornada. Valores válidos: qualquer número inteiro positivo diferente de zero. Valor padrão: 1.
TargetMajorVersion	String	Não	12,0	Versão principal do mecanismo da nova instância. Valores válidos: 10,0 11,0 12,0 13,0 14,0 15,0
TaskId	Integer	Não	417450000	Parâmetro reservado. Não é necessário especificar este parâmetro.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	152E0C6D-B9C3-4468-9F2C-FEF9D9E8417B	ID da solicitação.
PageNumber	Integer	1	Número da página retornada.
PageRecordCount	Integer	30	Quantidade de entradas retornadas por página.
TotalRecordCount	Integer	1	Total de entradas retornadas.
Items	Array of Tasks		Array com informações sobre a tarefa retornada.
TargetMajorVersion	String	12,0	Versão principal do mecanismo da nova instância. Valores válidos: 10,0 11,0 12,0 13,0 14,0 15,0
Result	String	Success	Status da tarefa. Success: Tarefa concluída com êxito. Failed: Falha na tarefa. Running: Fase de migração de dados para a nova instância em andamento.
EndTime	String	1614237779000	Horário de término da tarefa. Valor em timestamp UNIX que representa os milissegundos decorridos desde a época (1º de janeiro de 1970, 00:00:00 UTC). Unidade: milissegundos.
StartTime	String	1614236007000	Horário de início da tarefa. Valor em timestamp UNIX que representa os milissegundos decorridos desde a época (1º de janeiro de 1970, 00:00:00 UTC). Unidade: milissegundos.
SourceMajorVersion	String	11,0	Versão principal do mecanismo da instância original.
UpgradeMode	String	switch	Indica se o ApsaraDB RDS migra os dados para a nova instância e transfere as cargas de trabalho para ela. Valores válidos: clone: O ApsaraDB RDS não migra os dados nem transfere as cargas de trabalho para a nova instância. switch: O ApsaraDB RDS migra os dados e transfere as cargas de trabalho para a nova instância.
CollectStatMode	String	After	Momento em que o ApsaraDB RDS coleta as estatísticas da nova instância. Valores válidos: After: Coleta de estatísticas após o switchover. Before: Coleta de estatísticas antes do switchover.
SourceInsName	String	pgm-bp1i3kkq7321****	ID da instância original.
TaskId	Integer	342900000	ID da tarefa.
TargetInsName	String	pgm-bp1c0v6d8092****	ID da nova instância.
SwitchTime	String	1614237539000	Horário de transferência das cargas de trabalho da instância original para a nova instância. Valor em timestamp UNIX que representa os milissegundos decorridos desde a época (1º de janeiro de 1970, 00:00:00 UTC). Unidade: milissegundos.
Detail	String	2021-10-27 15:03:05 --- do upgrade precheck on slave succcess.\n2021-10-27 15:03:11 --- begin to upgrade major version, source instance will locked in readonly mode.\n2021-10-27 15:03:21 --- upgrade master success.\n2021-10-27 15:06:10 --- exchange source and target instance dns success.\n	Detalhes da tarefa.

Exemplos

Solicitações de exemplo

http(s)://rds.aliyuncs.com/?Action=DescribeUpgradeMajorVersionTasks
&DBInstanceId=pgm-bp1gm3yh0ht1****
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

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

<DescribeUpgradeMajorVersionTasks>
    <TotalRecordCount>1</TotalRecordCount>
    <PageRecordCount>30</PageRecordCount>
    <RequestId>152E0C6D-B9C3-4468-9F2C-FEF9D9E8417B</RequestId>
    <PageNumber>1</PageNumber>
    <Items>
        <SourceInsName>pgm-bp1i3kkq7321****</SourceInsName>
        <SourceMajorVersion>11.0</SourceMajorVersion>
        <TaskId>342900000</TaskId>
        <CollectStatMode/>
        <EndTime>1614237779000</EndTime>
        <TargetMajorVersion>12.0</TargetMajorVersion>
        <TargetInsName>pgm-bp1c0v6d8092****</TargetInsName>
        <StartTime>1614236007000</StartTime>
        <UpgradeMode>switch</UpgradeMode>
        <Detail>2021-10-27 15:03:05 --- do upgrade precheck on slave succcess.\n2021-10-27 15:03:11 --- begin to upgrade major version, source instance will locked in readonly mode.\n2021-10-27 15:03:21 --- upgrade master success.\n2021-10-27 15:06:10 --- exchange source and target instance dns success.\n</Detail>
        <SwitchTime>1614237539000</SwitchTime>
        <Result>Success</Result>
    </Items>
</DescribeUpgradeMajorVersionTasks>

Formato JSON

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

{
  "TotalRecordCount" : 1,
  "PageRecordCount" : 30,
  "RequestId" : "152E0C6D-B9C3-4468-9F2C-FEF9D9E8417B",
  "PageNumber" : 1,
  "Items" : {
    "SourceInsName" : "pgm-bp1i3kkq7321****",
    "SourceMajorVersion" : 11.0,
    "TaskId" : 342900000,
    "CollectStatMode" : "",
    "EndTime" : 1614237779000,
    "TargetMajorVersion" : 12.0,
    "TargetInsName" : "pgm-bp1c0v6d8092****",
    "StartTime" : 1614236007000,
    "UpgradeMode" : "switch",
    "Detail" : "2021-10-27 15:03:05 --- do upgrade precheck on slave succcess.\\n2021-10-27 15:03:11 --- begin to upgrade major version, source instance will locked in readonly mode.\\n2021-10-27 15:03:21 --- upgrade master success.\\n2021-10-27 15:06:10 --- exchange source and target instance dns success.\\n",
    "SwitchTime" : 1614237539000,
    "Result" : "Success"
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
404	InvalidDBInstanceName.NotFound	The database instance does not exist.	Nome da instância não encontrado. Verifique o nome da instância e tente novamente.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.