UpgradeDBClusterVersionZonal - 升级边缘集群内核版本_云原生数据库 PolarDB(PolarDB)-阿里云帮助中心

PolarDB 边缘云集群小版本升级

调试

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

授权信息

当前API暂无授权信息透出。

请求语法

POST  HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
DBClusterId	string	是	集群 ID。	pc-a************
UpgradePolicy	string	否	内核版本升级策略。取值范围如下： HOT：热升级 COLD：冷升级。目前仅 PolarDB MySQL 版 8.0 集群版支持该升级方式。	HOT
UpgradeLabel	string	否	内核版本升级标签。取值固定为 INNOVATE。说明该参数仅适用于 PolarDB MySQL 版 8.0.1 版本升级至 PolarDB MySQL 版 8.0.2 版本。当传入该参数时，`UpgradePolicy`必须传入 COLD。	INNOVATE
PlannedStartTime	string	否	开始执行定时（即在目标时间段内执行）内核版本升级任务的最早时间。格式为`YYYY-MM-DDThh:mm:ssZ`（UTC）。说明开始时间的取值范围为未来 24 小时内的任意时间点。例如当前时间为`2021-01-14T09:00:00Z`，此处允许填入的开始时间范围为`2021-01-14T09:00:00Z`~`2021-01-15T09:00:00Z`。若该参数留空，默认立即执行内核版本升级任务。	2022-04-28T14:00:00Z
PlannedEndTime	string	否	开始执行目标定时任务的最晚时间。格式为`YYYY-MM-DDThh:mm:ssZ`（UTC）。说明最晚时间需晚于开始时间的 30 分钟或以上。若设置了`PlannedStartTime`但未指定该参数，执行目标任务的最晚时间默认为`开始时间+30 分钟`。例如当设置`PlannedStartTime`为`2021-01-14T09:00:00Z`且该参数留空时，目标任务最晚将于`2021-01-14T09:30:00Z`开始执行。	2021-01-14T09:30:00Z
FromTimeService	boolean	否	立即执行或定时执行内核版本升级。取值范围如下： false（默认值）：定时执行 true：立即执行说明调用该接口时无需使用该参数。	false
UpgradeType	string	否	升级类型。取值范围如下： PROXY：仅升级数据库代理（Proxy） DB：仅升级内核引擎 ALL（默认值）：同时升级数据库代理（Proxy）和内核引擎	PROXY
TargetDBRevisionVersionCode	string	否	DB 目标版本的 VersionCode，参数取值可从 DescribeDBClusterVersion 接口获取。	20230707
TargetProxyRevisionVersionCode	string	否	Proxy 目标版本的 VersionCode，参数取值可从 DescribeDBClusterVersion 接口获取。	20240702
ClientToken	string	否	用于保证请求的幂等性，防止重复提交请求。由客户端生成该参数值，保证在不同请求间唯一，大小写敏感、不超过 64 个 ASCII 字符。	6000170000591aed949d0f54a343f1a4233c1e7d1c5c******

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID。	CAE6755F-B79A-4861-B227-801FE8******

示例

正常返回示例

JSON格式

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

错误码

HTTP status code	错误码	错误信息	描述
400	ScheduleTaskExist	The specified dbCluster already has a scheduled task.	指定的实例已经存在定时任务。
400	InvalidUpgradeLabel.Malformed	The specified parameter UpgradeLabel is not valid.	指定 UpgradeLabel 参数无效
400	InvalidEngine.Unsupported	The specified Engine does not support this feature.	指定的引擎不支持此功能
400	InvalidEngineMinorVersion.Malformed	The specified parameter MinorVersion is not valid.	指定的参数MinorVersion无效。
400	InvalidEngineVersion.Unsupported	The specified engineVersion is not supported.	不支持指定的engineVersion。
400	InvalidUpgradePolicy.Malformed	The specified parameter UpgradePolicy is not valid.	指定的参数UpgradePolicy无效
400	InvalidSwitchTimeMode.Malformed	The specified parameter SwitchTimeMode is not valid.	指定的参数SwitchTimeMode无效。
403	OperationDenied.UpgradeType	The operation is not permitted due to gdn limit	由于 GDN 限制，当前升级操作并不支持
403	IncorrectGdnStandbyDBVersion	Current gdn standby cluster is not the latest db version.	当前gdn备用集群不是最新的db版本
404	InvalidDBCluster.NotFound	The DBClusterId provided does not exist in our records.	当前的记录中不存在提供的DBClusterId。
404	InvalidDBClusterId.Malformed	The specified parameter DBClusterId is not valid.	指定的参数DBClusterId无效

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

变更历史

更多信息，参考变更详情。