Performs a precheck before the upgrade of the major engine version of an ApsaraDB RDS for PostgreSQL instance.
Operation description
Supported database engine
PostgreSQL
References
Note
Before you call this operation, carefully read the following documentation. Make sure that you fully understand the prerequisites and impacts for calling this operation.
Upgrade the major engine version of an ApsaraDB RDS for PostgreSQL instance
Debugging
Authorization information
There is currently no authorization information disclosed in the API.
Request parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| DBInstanceId | string | Yes | The ID of the instance. You can call the DescribeDBInstances operation to query the ID of the instance. | pgm-bp1c808s731l**** |
| TargetMajorVersion | string | Yes | The new major engine version of the instance. The new major engine version must be later than the original major engine version. | 12.0 |
Response parameters
Examples
Sample success responses
JSONformat
{
"DBInstanceName": "pgm-bp1c808s731l****",
"TargetMajorVersion": "12.0",
"RequestId": "99C1FEEE-FB44-5342-8EBA-DC1E1A1557A4",
"TaskId": "41698****"
}Error codes
| HTTP status code | Error code | Error message | Description |
|---|---|---|---|
| 400 | InvalidDBInstanceName.NotFound | The specified DB instance name does not exist. | The instance name does not exist. |
| 400 | InvalidDBInstanceEngineType.Format | the DB instance engine type does not support this operation. | This operation is not supported for the database engine of the instance. |
| 403 | ParamNotFound | The parameter is not found for the interface. | The parameter is not found for the interface. |
For a list of error codes, visit the Service error codes.
Change history
| Change time | Summary of changes | Operation |
|---|---|---|
| 2024-06-07 | The Error code has changed | View Change Details |
| 2021-10-25 | The Error code has changed | View Change Details |