UpgradeDBClusterVersion_云数据库 PolarDB_API文档-阿里云OpenAPI开发者门户

接口说明

说明

当前仅支持升级 PolarDB MySQL 版集群的修订版本（Revision Version），如从 8.0.1.1.3 升级至 8.0.1.1.4。

仅允许阿里云主账号执行定时（即在目标时间段内执行）内核版本升级任务，RAM 账号不支持定时内核版本升级任务。

请求速率为200/60(s)。更多流控信息，请前往配额中心查看

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

polardb:UpgradeDBClusterVersion	Update	dbcluster acs:polardb:{#regionId}:{#accountId}:dbcluster/{#dbclusterId}	无	无

字段名称	字段详情
DBClusterIdstring	集群 ID。展开详情示例值:pc-****************参考取值来源: ModifyDBCluster CreateDBCluster DescribeDBClusters RestartDBLink TransformDBClusterPayType EnableDBClusterServerless DisableDBClusterServerless
UpgradePolicystring	内核版本升级策略。取值范围如下：展开详情示例值:HOT枚举值:
UpgradeLabelstring	内核版本升级标签。取值固定为 INNOVATE。展开详情示例值:INNOVATE
PlannedStartTimestring	开始执行定时（即在目标时间段内执行）内核版本升级任务的最早时间。格式为`YYYY-MM-DDThh:mm:ssZ`（UTC）。展开详情示例值:2021-01-14T09:00:00Z
PlannedEndTimestring	开始执行目标定时任务的最晚时间。格式为`YYYY-MM-DDThh:mm:ssZ`（UTC）。展开详情示例值:2021-01-14T09:30:00Z
FromTimeServiceboolean	立即执行或定时执行内核版本升级。取值范围如下：展开详情示例值:false
UpgradeTypestring	升级类型。取值范围如下：展开详情示例值:PROXY
TargetDBRevisionVersionCodestring	DB 目标版本的 VersionCode，参数取值可从 DescribeDBClusterVersion 接口获取。示例值:20230707
TargetProxyRevisionVersionCodestring	Proxy 目标版本的 VersionCode，参数取值可从 DescribeDBClusterVersion 接口获取。示例值:20240702

字段名称	字段详情
RequestIdstring	请求 ID。示例值:CAE6755F-B79A-4861-B227-801FE8******

没有我想要的错误码, 点击反馈

HTTP 状态码	错误码	错误信息	操作

400	ScheduleTaskExist	The specified dbCluster already has a scheduled task.	诊断
400	InvalidUpgradeLabel.Malformed	The specified parameter UpgradeLabel is not valid.	诊断
400	InvalidEngine.Unsupported	The specified Engine does not support this feature.	诊断
400	InvalidEngineMinorVersion.Malformed	The specified parameter MinorVersion is not valid.	诊断
400	InvalidEngineVersion.Unsupported	The specified engineVersion is not supported.	诊断
400	InvalidUpgradePolicy.Malformed	The specified parameter UpgradePolicy is not valid.	诊断
400	InvalidSwitchTimeMode.Malformed	The specified parameter SwitchTimeMode is not valid.	诊断
403	OperationDenied.UpgradeType	The operation is not permitted due to gdn limit	诊断
403	IncorrectGdnStandbyDBVersion	Current gdn standby cluster is not the latest db version.	诊断
404	InvalidDBCluster.NotFound	The DBClusterId provided does not exist in our records.	诊断
404	InvalidDBClusterId.Malformed	The specified parameter DBClusterId is not valid.	诊断

	变更时间	变更内容概要	操作
	2024-05-28	新增请求参数TargetProxyRevisionVersionCode
	2023-09-12	变更错误码400 变更错误码404
	2023-07-25	新增请求参数TargetDBRevisionVersionCode
	2022-07-14	变更错误码400 新增错误码403
	2022-07-06	变更请求参数UpgradePolicy
	2022-07-04	新增请求参数UpgradePolicy 新增请求参数UpgradeLabel