查询RDS PostgreSQL大版本升级历史任务 - 云数据库 RDS

调试

您可以在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 14.0 15.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 14.0 15.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.	数据库实例名称不存在。请确认数据名称是否正确。

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