调用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分钟。例如当设置PlannedStartTime为2021-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******"
}

错误码

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