Verificar a compatibilidade entre uma nova versão principal do mecanismo e uma instância do ApsaraDB RDS for PostgreSQL antes de uma atualização - : Central de Documentação do Alibaba Cloud

Chame a operação UpgradeDBInstanceMajorVersionPrecheck para verificar a compatibilidade entre uma nova versão principal do mecanismo e uma instância do ApsaraDB RDS for PostgreSQL antes de atualizar a instância para essa nova versão.

O ApsaraDB RDS for PostgreSQL oferece o recurso de atualização de versão principal do mecanismo, que permite atualizar a versão principal do mecanismo de uma instância do ApsaraDB RDS for PostgreSQL.

Antes de realizar uma atualização, execute uma verificação de compatibilidade e certifique-se de que o resultado seja Success. Chame esta operação para executar essa verificação.

Uma atualização pode causar impactos, como uma interrupção temporária de conexão de alguns minutos. Recomendamos realizar a atualização durante períodos de baixo tráfego. Antes de prosseguir, leia as descrições em Upgrade the major engine version of an ApsaraDB RDS for PostgreSQL instance.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Parâmetros de requisição

Parameter	Type	Required	Example	Description
Action	String	Yes	UpgradeDBInstanceMajorVersionPrecheck	A operação a ser executada. Defina o valor como UpgradeDBInstanceMajorVersionPrecheck.
DBInstanceId	String	Yes	pgm-bp1c808s731l****	O ID da instância. A instância deve atender aos seguintes requisitos: A instância executa PostgreSQL 14, PostgreSQL 13, PostgreSQL 12, PostgreSQL 11, PostgreSQL 10 ou PostgreSQL 9.4. A instância executa RDS High-availability Edition ou RDS Basic Edition. A instância RDS deve residir em uma VPC. Se a instância original estiver na rede clássica, migre-a para uma VPC antes de chamar esta operação. Para mais informações sobre como visualize ou alterar o tipo de rede de uma instância, consulte Alterar o tipo de rede de uma instância do ApsaraDB RDS for PostgreSQL. A instância não pode ser somente leitura nem ter sido criada em um cluster dedicado.
TargetMajorVersion	String	Yes	12.0	A nova versão principal do mecanismo da instância. Essa versão deve ser superior à versão principal original. Por exemplo, se a versão principal original for PostgreSQL 10, a nova versão pode ser PostgreSQL 11, PostgreSQL 12, PostgreSQL 13, PostgreSQL 14 ou PostgreSQL 15.

Parâmetros de resposta

Parameter	Type	Example	Description
DBInstanceName	String	pgm-bp1c808s731l****	O nome da instância.
TargetMajorVersion	String	12.0	A nova versão principal do mecanismo da instância.
RequestId	String	99C1FEEE-FB44-5342-8EBA-DC1E1A1557A4	O ID da requisição.
TaskId	String	41698****	O ID da tarefa.

Exemplos

Exemplos de requisição

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

Exemplos de resposta bem-sucedida

XML format

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

<UpgradeDBInstanceMajorVersionPrecheck>
    <TaskId>41698****</TaskId>
    <RequestId>99C1FEEE-FB44-5342-8EBA-DC1E1A1557A4</RequestId>
    <TargetMajorVersion>12.0</TargetMajorVersion>
    <DBInstanceName>pgm-bp1c808s731l****</DBInstanceName>
</UpgradeDBInstanceMajorVersionPrecheck>

JSON format

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

{
  "TaskId" : "41698****",
  "RequestId" : "99C1FEEE-FB44-5342-8EBA-DC1E1A1557A4",
  "TargetMajorVersion" : 12.0,
  "DBInstanceName" : "pgm-bp1c808s731l****"
}

Códigos de erro

HTTP status code	Error code	Error message	Description
400	InvalidDBInstanceName.NotFound	The specified DB instance name does not exist.	O erro foi retornado porque o nome da instância não foi encontrado.
400	InvalidDBInstanceEngineType.Format	the DB instance engine type does not support this operation.	O erro foi retornado porque o mecanismo de banco de dados da instância não oferece suporte a esta operação.
403	ParamNotFound	The parameter is not found for the interface.	O erro foi retornado porque o parâmetro não foi encontrado.

Para obter a lista de códigos de erro, consulte Service error codes.