文档中心

云数据库 MySQL 版

请输入

实例管理

UpgradeDBInstanceEngineMajorVersion - 升级实例的大版本

调用 UpgradeDBInstanceEngineMajorVersion 接口升级实例的大版本。

请求类型

异步请求。

注意事项

仅支持将 MySQL 5.7 实例升级至 MySQL 8.0，不支持将 MySQL 5.7 或 MySQL 8.0 实例升级至 MySQL 8.4。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

参数	类型	是否必选	示例值	描述
InstanceId	String	是	mysql-7510ba07****	实例 ID。
TargetMajorVersion	String	是	MySQL 8.0.43	实例升级的目标大版本。当前仅支持为 MySQL 8.0.43。
MySQLSlaveDelayThreshold	Integer	是	10	数据校验延迟阈值。取值为 1~10 的整数，单位为秒。
ObservationHours	Integer	否	24	设定实例升级后的观测时长。支持将设置为 0~72 之间的整数值，单位为小时，默认值为 24。
SwitchType	String	否	MaintainTime	执行时间，取值： Immediate：立即切换（默认）。 MaintainTime：可维护时间段内进行切换。 SpecifiedTime：指定时间段内进行切换。说明可调用 DescribeDBInstanceDetail 接口查询实例的可维护时间段。取值为 SpecifiedTime 时，需要在参数 SpecifiedSwitchStartTime 和 SpecifiedSwitchEndTime中设定时间段的起止时间。
SpecifiedSwitchStartTime	String	否	2024-12-25T14:00:00Z	任务执行的起始时间（UTC 时间）。格式为 yyyy-MM-ddTHH:mm:ssZ。说明 SwitchType 取值为 SpecifiedTime 时，该参数为必填参数。任务执行的起始时间不得晚于当前日期后的第 7 日。
SpecifiedSwitchEndTime	String	否	2024-12-25T15:59:00Z	任务执行的结束时间（UTC 时间）。格式为 yyyy-MM-ddTHH:mm:ssZ。说明 SwitchType 取值为 SpecifiedTime 时，该参数为必填参数。指定时间段的最短时长为一小时五十九分钟。不支持跨天设置时间段，即任务执行的起始时间和结束时间不超过 24 小时。
EstimateOnly	Boolean	否	false	是否发起评估。取值： true：是。 false：否。默认值。说明如果发起变配评估，则按照其他字段确定的规格配置进行评估，实际不会执行。

返回参数

参数	类型	示例值	描述
PreparedMinutes	Integer	30	准备阶段需要的时长，单位为分钟。

示例

请求示例

返回示例

错误码

更多详情，请参见错误码。

最近更新时间：2026.10.23 17:52:44

这个页面对您有帮助吗？

有用

无用