调用DescribeUpgradeMajorVersionTasks查询RDS PostgreSQL实例大版本升级的历史任务。

调试

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

请求参数

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

系统规定参数。取值:DescribeUpgradeMajorVersionTasks

DBInstanceId String pgm-bp1gm3yh0ht1****

RDS PostgreSQL实例ID。

PageSize Integer 30

每页记录数。

取值:30~100

默认值:30

PageNumber Integer 1

页码。

取值:大于0且不超过Integer的最大值。

默认值:1

TargetMajorVersion String 12.0

升级后的大版本号。取值:

  • 10.0
  • 11.0
  • 12.0
  • 13.0
TaskId Integer 417450000

预留参数,无需配置。

返回数据

名称 类型 示例值 描述
RequestId String 152E0C6D-B9C3-4468-9F2C-FEF9D9E8417B

请求ID。

PageNumber Integer 1

页码。

PageRecordCount Integer 30

每页可显示的记录数。

TotalRecordCount Integer 1

总记录数。

Items Array of Tasks

大版本升级任务详细信息。

TargetMajorVersion String 12.0

升级后的大版本号。返回值:

  • 10.0
  • 11.0
  • 12.0
  • 13.0
Result String Success

展示任务最终是否成功。

  • Success:成功。
  • Failed:失败。
  • Running:迁移中。
EndTime String 1614237779000

大版本升级结束时间。

以Unix时间戳表示。单位:毫秒。

StartTime String 1614236007000

大版本升级开始时间。

以Unix时间戳表示。单位:毫秒。

SourceMajorVersion String 11.0

升级前原实例的版本号。

UpgradeMode String switch

升级模式。

取值范围:

  • clone:不割接
  • switch:割接
CollectStatMode String After

统计信息收集模式。

取值范围:

  • After:割接后升级。
  • Before:割接前升级。
SourceInsName String pgm-bp1i3kkq7321****

升级前原实例的ID。

TaskId Integer 342900000

任务ID。

TargetInsName String pgm-bp1c0v6d8092****

升级后新实例的ID。

SwitchTime String 1614237539000

业务从原实例切换至新实例的时间。

以Unix时间戳表示。单位:毫秒。

Detail String 2021-10-27 15:03:05 --- do upgrade precheck on slave succcess.\n2021-10-27 15:03:11 --- begin to upgrade major version, source instance will locked in readonly mode.\n2021-10-27 15:03:21 --- upgrade master success.\n2021-10-27 15:06:10 --- exchange source and target instance dns success.\n

任务的详细信息。

示例

请求示例

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

正常返回示例

XML格式

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

<DescribeUpgradeMajorVersionTasks>
    <TotalRecordCount>1</TotalRecordCount>
    <PageRecordCount>30</PageRecordCount>
    <RequestId>152E0C6D-B9C3-4468-9F2C-FEF9D9E8417B</RequestId>
    <PageNumber>1</PageNumber>
    <Items>
        <SourceInsName>pgm-bp1i3kkq7321****</SourceInsName>
        <SourceMajorVersion>11.0</SourceMajorVersion>
        <TaskId>342900000</TaskId>
        <CollectStatMode/>
        <EndTime>1614237779000</EndTime>
        <TargetMajorVersion>12.0</TargetMajorVersion>
        <TargetInsName>pgm-bp1c0v6d8092****</TargetInsName>
        <StartTime>1614236007000</StartTime>
        <UpgradeMode>switch</UpgradeMode>
        <Detail>2021-10-27 15:03:05 --- do upgrade precheck on slave succcess.\n2021-10-27 15:03:11 --- begin to upgrade major version, source instance will locked in readonly mode.\n2021-10-27 15:03:21 --- upgrade master success.\n2021-10-27 15:06:10 --- exchange source and target instance dns success.\n</Detail>
        <SwitchTime>1614237539000</SwitchTime>
        <Result>Success</Result>
    </Items>
</DescribeUpgradeMajorVersionTasks>

JSON格式

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

{
  "TotalRecordCount" : 1,
  "PageRecordCount" : 30,
  "RequestId" : "152E0C6D-B9C3-4468-9F2C-FEF9D9E8417B",
  "PageNumber" : 1,
  "Items" : {
    "SourceInsName" : "pgm-bp1i3kkq7321****",
    "SourceMajorVersion" : 11.0,
    "TaskId" : 342900000,
    "CollectStatMode" : "",
    "EndTime" : 1614237779000,
    "TargetMajorVersion" : 12.0,
    "TargetInsName" : "pgm-bp1c0v6d8092****",
    "StartTime" : 1614236007000,
    "UpgradeMode" : "switch",
    "Detail" : "2021-10-27 15:03:05 --- do upgrade precheck on slave succcess.\\n2021-10-27 15:03:11 --- begin to upgrade major version, source instance will locked in readonly mode.\\n2021-10-27 15:03:21 --- upgrade master success.\\n2021-10-27 15:06:10 --- exchange source and target instance dns success.\\n",
    "SwitchTime" : 1614237539000,
    "Result" : "Success"
  }
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidDBInstanceName.NotFound The database instance does not exist. 数据库实例名称不存在。请确认数据名称是否正确。

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