Consultar o relatório de verificação de upgrade da versão principal do mecanismo de uma instância ApsaraDB RDS for PostgreSQL - : Central de Documentação do Alibaba Cloud

Antes de atualizar a versão principal do mecanismo de uma instância ApsaraDB RDS for PostgreSQL, execute uma verificação de upgrade e confirme se o resultado é Success. Use esta operação para consultar o relatório dessa verificação.

Se o resultado for Fail, corrija os erros identificados. Para mais informações sobre como resolver problemas comuns, consulte Introdução ao relatório de verificação de upgrade da versão principal do mecanismo de uma instância ApsaraDB RDS for PostgreSQL.

Depuração

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

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeUpgradeMajorVersionPrecheckTask	Operação a ser executada. Defina o valor como DescribeUpgradeMajorVersionPrecheckTask.
DBInstanceId	String	Sim	pgm-bp1c808s731l****	ID da instância.
PageSize	Integer	Não	30	Número de entradas por página no relatório de verificação de upgrade. Valores válidos: 30 (valor padrão). 50. 100.
PageNumber	Integer	Não	1	Número da página a retornar no relatório de verificação de upgrade. Valores válidos: qualquer número inteiro positivo diferente de zero. Valor padrão: 1.
TargetMajorVersion	String	Não	12.0	Nova versão principal do mecanismo da instância. Deve ser posterior à versão principal original. Por exemplo, se a versão original for PostgreSQL 10.0, a nova versão poderá ser PostgreSQL 11, 12, 13, 14 ou 15.
TaskId	Integer	Não	416980000	ID da tarefa de verificação de upgrade. Obtenha esse ID no parâmetro TaskId retornado pela operação UpgradeDBInstanceMajorVersionPrecheck.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	D1586777-41B5-5F9E-81E8-93DFDD379024	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 no relatório de verificação de upgrade.
Items	Array of Tasks		Array com os atributos do relatório de verificação de upgrade.
TargetMajorVersion	String	12.0	Nova versão principal do mecanismo da instância.
EffectiveTime	String	1635748703000	Data de expiração do relatório de verificação de upgrade. Timestamp no formato de tempo UNIX. Unidade: milissegundos.
SourceMajorVersion	String	11.0	Versão principal original do mecanismo da instância.
Result	String	Success	Resultado da verificação de upgrade. Valores válidos: Success Fail Nota Se o resultado for Fail, analise o parâmetro Detail para obter informações sobre os erros ocorridos. Após corrigir os erros, tente novamente. Para mais informações sobre como resolver problemas comuns, consulte Introdução ao relatório de verificação de upgrade da versão principal do mecanismo de uma instância ApsaraDB RDS for PostgreSQL.
TaskId	Integer	416980000	ID da tarefa de verificação de upgrade.
Detail	String	[user_check_report]User check success\n[pg_upgrade_internal.log]Performing...	Conteúdo do relatório de verificação de upgrade.
CheckTime	String	1635143903000	Horário de execução da verificação de upgrade. Timestamp no formato de tempo UNIX. Unidade: milissegundos.

Exemplos

Exemplos de solicitações

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

Exemplos de respostas de sucesso

Formato XML

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

<DescribeUpgradeMajorVersionPrecheckTask>
    <TotalRecordCount>1</TotalRecordCount>
    <PageRecordCount>30</PageRecordCount>
    <RequestId>D1586777-41B5-5F9E-81E8-93DFDD379024</RequestId>
    <PageNumber>1</PageNumber>
    <Items>
        <CheckTime>1635143903000</CheckTime>
        <SourceMajorVersion>11.0</SourceMajorVersion>
        <TaskId>416980000</TaskId>
        <EffectiveTime>1635748703000</EffectiveTime>
        <TargetMajorVersion>12.0</TargetMajorVersion>
        <Detail>[user_check_report]User check success\n[pg_upgrade_internal.log]Performing...</Detail>
        <Result>Success</Result>
    </Items>
</DescribeUpgradeMajorVersionPrecheckTask>

Formato JSON

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

{
  "TotalRecordCount" : 1,
  "PageRecordCount" : 30,
  "RequestId" : "D1586777-41B5-5F9E-81E8-93DFDD379024",
  "PageNumber" : 1,
  "Items" : {
    "CheckTime" : 1635143903000,
    "SourceMajorVersion" : 11.0,
    "TaskId" : 416980000,
    "EffectiveTime" : 1635748703000,
    "TargetMajorVersion" : 12.0,
    "Detail" : "[user_check_report]User check success\\n[pg_upgrade_internal.log]Performing...",
    "Result" : "Success"
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidDBInstanceName.NotFound	The specified DB instance name does not exist.	Nome da instância não encontrado.

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