调用DescribePendingMaintenanceAction接口查询待处理事件的详情。

调试

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

请求参数

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

系统规定参数值,取值为DescribePendingMaintenanceAction

Region String all

待处理事件所在地域的地域ID,您可以调用DescribeRegions接口查看PolarDB支持的地域和可用区。

说明
  • 您可以输入all查看您账户下所有的待处理事件。
  • Region设置为all时,TaskType也必须设置为all
RegionId String cn-hangzhou

地域ID。

TaskType String all

待处理事件的任务类型,取值范围如下:

  • DatabaseSoftwareUpgrading:数据库软件升级
  • DatabaseHardwareMaintenance:硬件维护与升级
  • DatabaseStorageUpgrading:数据库存储升级
  • DatabaseProxyUpgrading:代理小版本升级
  • all:表示查询上述所有类型的待处理事件详情
说明Region设置为all时,TaskType也必须设置为all
IsHistory Integer 0

是否返回历史任务,取值范围如下:

  • 0:返回当前任务
  • 1:返回历史任务

默认取值为0

PageSize Integer 30

每页记录数,取值为3050100

默认值为30

PageNumber Integer 1

页码,取值为大于0且不超过Integer数据类型的最大值,默认值为1

返回数据

名称 类型 示例值 描述
Items Array of Items

任务列表。

CreatedTime String 2020-06-09T22:00:42Z

创建任务的时间点,格式为yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

DBClusterId String pc-************

集群ID。

DBType String MySQL

数据库引擎类型,取值范围如下:

  • MySQL
  • PostgreSQL
  • Oracle
DBVersion String 8.0

数据库引擎版本号。

  • MySQL版本号取值范围如下:
    • 5.6
    • 5.7
    • 8.0
  • PostgreSQL版本号取值为11
  • Oracle版本号取值为11
Deadline String 2020-06-11T15:59:59Z

任务执行时间可调整范围的最晚期限,格式为yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

Id Integer 111111

目标任务ID。

ModifiedTime String 2020-06-09T22:00:42Z

修改时间,格式为yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

PrepareInterval String 04:00:00

待处理事件切换之前所需的准备时间,格式为HH:mm:ss

Region String cn-hangzhou

任务所在地域的地域ID。

ResultInfo String manualCancel

任务执行结果,取值范围如下:

  • manualCancel:手动取消任务
  • paramCheckNotPass:参数检查未通过
说明 仅当Status(任务状态)取值为6(任务结束但执行失败)或7(任务已取消)时,返回该参数。
StartTime String 2020-06-09T18:00:00Z

后台执行该任务的时间点,格式为yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

Status Integer 3

任务状态。

  • 若您设置IsHistory0,则返回待处理任务状态的详情,取值范围如下:
    • 2:等待用户设置任务开始时间
    • 3:等待处理
    • 4:任务正在处理中(不支持在该状态下修改任务执行时间)
  • 若您设置IsHistory1,则返回历史任务状态的详情,取值范围如下:
    • 5:任务结束且执行成功
    • 6:任务结束但执行失败
    • 7:任务已取消
SwitchTime String 2020-06-09T22:00:00Z

待处理事件预计的切换时间,格式为yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

TaskType String DatabaseSoftwareUpgrading

待处理事件的任务类型。

PageNumber Integer 1

页码。

PageSize Integer 30

每页记录数。

RequestId String 2F029645-FED9-4FE8-A6D3-488954******

请求ID。

TotalRecordCount Integer 1

总记录数。

示例

请求示例

http(s)://polardb.aliyuncs.com/?Action=DescribePendingMaintenanceAction
&Region=all
&TaskType=all
&<公共请求参数>

正常返回示例

XML 格式

<DescribePendingMaintenanceActionResponse>
  <TotalRecordCount>1</TotalRecordCount>
  <PageSize>30</PageSize>
  <RequestId>2F029645-FED9-4FE8-A6D3-488954******</RequestId>
  <PageNumber>1</PageNumber>
  <Items>
        <Status>3</Status>
        <CreatedTime>2020-06-09T22:00:42Z</CreatedTime>
        <Deadline>2020-06-11T15:59:59Z</Deadline>
        <StartTime>2020-06-09T18:00:00Z</StartTime>
        <DBClusterId>pc-************</DBClusterId>
        <DBType>MySQL</DBType>
        <DBVersion>8.0</DBVersion>
        <ModifiedTime>2020-06-09T22:00:42Z</ModifiedTime>
        <TaskType>DatabaseSoftwareUpgrading</TaskType>
        <Region>cn-hangzhou</Region>
        <PrepareInterval>04:00:00</PrepareInterval>
        <Id>111111</Id>
        <SwitchTime>2020-06-09T22:00:00Z</SwitchTime>
  </Items>
</DescribePendingMaintenanceActionResponse>

JSON 格式

{
	"TotalRecordCount": "1",
	"PageSize": "30",
	"RequestId": "2F029645-FED9-4FE8-A6D3-488954******",
	"PageNumber": "1",
	"Items": [{
		"Status": "3",
		"CreatedTime": "2020-06-09T22:00:42Z",
		"Deadline": "2020-06-11T15:59:59Z",
		"StartTime": "2020-06-09T18:00:00Z",
		"DBClusterId": "pc-************",
		"DBType": "MySQL",
		"DBVersion": "8.0",
		"ModifiedTime": "2020-06-09T22:00:42Z",
		"TaskType": "DatabaseSoftwareUpgrading",
		"Region": "cn-hangzhou",
		"PrepareInterval": "04:00:00",
		"Id": "111111",
		"SwitchTime": "2020-06-09T22:00:00Z"
	}]
}

错误码

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