调用UpgradeDBInstanceMajorVersionPrecheck接口执行RDS PostgreSQL大版本升级检查。

RDS PostgreSQL实例提供大版本升级功能,支持从低版本升级至高版本。

大版本升级前,大版本升级检查结果必须为Success,调用该接口可以执行大版本升级检查。

升级数据库大版本会造成分钟级业务闪断等影响,请在业务低峰期进行升级,升级前请仔细阅读升级数据库大版本

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String UpgradeDBInstanceMajorVersionPrecheck

系统规定参数。取值:UpgradeDBInstanceMajorVersionPrecheck

DBInstanceId String pgm-bp1c808s731l****

RDS PostgreSQL实例ID。

实例必须满足以下条件:

  • 版本:PostgreSQL 14、13、12、11、10、9.4
  • 系列:高可用版、基础版
  • 网络类型:专有网络。如果网络类型为经典网络,请先切换为专有网络。关于如何查看或切换网络类型,请参见切换网络类型
  • 实例不是只读实例或专属集群实例。
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. 找不到接口的参数

访问错误中心查看更多错误码。