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

说明
  • 当前仅支持升级PolarDBMySQL引擎集群的修订版本(Revision Version),如从8.0.1.1.3升级至8.0.1.1.4。
  • 仅允许阿里云主账号执行定时(即在目标时间段内执行)内核版本升级任务,RAM账号不支持定时内核版本升级任务。

调试

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

请求参数

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

系统规定参数。取值:UpgradeDBClusterVersion

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

集群ID。

说明 您可以通过DescribeDBClusters接口查看账号下所有集群的详细信息(如集群ID)。
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

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

UpgradeType String PROXY

升级类型。取值:

  • PROXY:仅升级数据库代理(Proxy)
  • DB:仅升级内核引擎
  • ALL:同时升级数据库代理(Proxy)和内核引擎

返回数据

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

请求ID。

示例

请求示例

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

正常返回示例

XML格式

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

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

JSON格式

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

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

错误码

HttpCode 错误码 错误信息 描述
400 ScheduleTaskExist The specified dbCluster already has a scheduled task. 指定的实例已经有定时任务

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