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

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

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

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

调试

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

请求参数

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

系统规定参数,取值:UpgradeDBInstanceMajorVersion

DBInstanceId String pgm-bp1c808s731l****

RDS PostgreSQL实例ID。

实例必须满足以下条件:

  • 版本:PostgreSQL 12、11、10、9.4
  • 系列:高可用版、基础版
  • 网络类型:专有网络。如果网络类型为经典网络,请先切换为专有网络。关于如何查看或切换网络类型,请参见切换网络类型
  • 实例不是只读实例或专属集群实例。
  • 实例ID不是以pg-cn开头。
TargetMajorVersion String 12.0

目标实例版本,必须大于当前实例版本。

例如:当前实例版本为PostgreSQL 9.4,则目标版本可选择10.0,11.0,12.0,13.0。

返回数据

名称 类型 示例值 描述
DBInstanceName String pgm-bp1c808s731l****

实例名称。

RequestId String 99C1FEEE-FB44-5342-8EBA-DC1E1A1557A4

请求ID。

TargetMajorVersion String 12.0

目标实例版本。

TaskId String 41698****

任务ID。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=UpgradeDBInstanceMajorVersionPrecheck
&DBInstanceId=pgm-bp1c808s731l****
&TargetMajorVersion=12.0
&<公共请求参数>

正常返回示例

XML格式

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

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. 数据库实例名称不存在,请检查。

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