调用UpgradeDBClusterVersion接口更新PolarDB MySQL集群的内核版本。

说明 当前仅支持升级PolarDB MySQL集群的修订版本(Revision Version),如从8.0.1.1.3升级至8.0.1.1.4。

调试

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

请求参数

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

系统规定参数,取值为UpgradeDBClusterVersion

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

集群ID。

说明 您可以通过DescribeDBClusters接口查看账号下所有集群的详细信息(如集群ID)。
SwitchTimeMode String MaintainTime

选择立即执行或在可运维时间内执行升级任务,取值范围如下:

  • Immediate:立即执行升级任务(默认)
  • MaintainTime:在可运维时间内执行升级任务
    说明 您可以调用ModifyDBClusterMaintainTime接口修改集群的可运维时间。
PlannedStartTime String 2021-01-14T09:00:00Z

开始执行定时(即在目标时间段内执行)内核版本升级任务的最早时间。格式为YYYY-MM-DDThh:mm:ssZ(UTC)。

说明
  • 开始时间的取值范围为未来24小时内的任意时间点。例如当前时间为2021-01-14T09:00:00Z,此处允许填入的开始时间范围为2021-01-14T09:00:00Z~2021-01-15T09:00:00Z
  • 若该参数留空,默认立即执行内核版本升级任务。
PlannedEndTime String 2021-01-14T09:30:00Z

开始执行目标定时任务的最晚时间。格式为YYYY-MM-DDThh:mm:ssZ(UTC)。

说明
  • 最晚时间需晚于开始时间的30分钟或以上。
  • 若设置了PlannedStartTime但未指定该参数,执行目标任务的最晚时间默认为开始时间+30分钟。例如当设置PlannedStartTime2021-01-14T09:00:00Z且该参数留空时,目标任务最晚将于2021-01-14T09:30:00Z开始执行。
FromTimeService Boolean false

调用该接口时无需使用该参数。

返回数据

名称 类型 示例值 描述
RequestId String CAE6755F-B79A-4861-B227-801FE8******

请求ID。

示例

请求示例

http(s)://polardb.aliyuncs.com/?Action=UpgradeDBClusterVersion
&DBClusterId=pc-****************
&<公共请求参数>

正常返回示例

XML格式

<UpgradeDBClusterVersionResponse>
  <RequestId>CAE6755F-B79A-4861-B227-801FE8******</RequestId>
</UpgradeDBClusterVersionResponse>

JSON格式

{
	"RequestId": "CAE6755F-B79A-4861-B227-801FE8******"
}

错误码

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