调用UpgradeDBInstanceMajorVersionPrecheck接口执行RDS PostgreSQL大版本升级检查。
RDS PostgreSQL实例提供大版本升级功能,支持从低版本升级至高版本。
大版本升级前,大版本升级检查结果必须为Success,调用该接口可以执行大版本升级检查。
升级数据库大版本会造成分钟级业务闪断等影响,请在业务低峰期进行升级,升级前请仔细阅读升级数据库大版本。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | UpgradeDBInstanceMajorVersionPrecheck | 系统规定参数。取值:UpgradeDBInstanceMajorVersionPrecheck。 |
DBInstanceId | String | 是 | pgm-bp1c808s731l**** | RDS PostgreSQL实例ID。 实例必须满足以下条件:
|
TargetMajorVersion | String | 是 | 12.0 | 目标实例版本,必须大于当前实例版本。 例如:当前实例版本为PostgreSQL 10.0,则目标版本可选择11.0、12.0、13.0、14.0或15.0。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
DBInstanceName | String | pgm-bp1c808s731l**** | 实例名称。 |
TargetMajorVersion | String | 12.0 | 目标实例版本。 |
RequestId | String | 99C1FEEE-FB44-5342-8EBA-DC1E1A1557A4 | 请求ID。 |
TaskId | String | 41698**** | 任务ID。 |
示例
请求示例
http(s)://rds.aliyuncs.com/?Action=UpgradeDBInstanceMajorVersionPrecheck
&DBInstanceId=pgm-bp1c808s731l****
&TargetMajorVersion=12.0
&<公共请求参数>
正常返回示例
XML
格式
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
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"TaskId" : "41698****",
"RequestId" : "99C1FEEE-FB44-5342-8EBA-DC1E1A1557A4",
"TargetMajorVersion" : 12.0,
"DBInstanceName" : "pgm-bp1c808s731l****"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidDBInstanceName.NotFound | The specified DB instance name does not exist. | 数据库实例名称不存在,请检查。 |
400 | InvalidDBInstanceEngineType.Format | the DB instance engine type does not support this operation. | DB实例引擎类型不支持此操作。 |
403 | ParamNotFound | The parameter is not found for the interface. | 找不到接口的参数 |
访问错误中心查看更多错误码。