云数据库 MySQL 版
云数据库 MySQL 版
云数据库 MySQL 版
文档指南
请输入
产品动态
内核功能
功能
用户指南
实例管理
连接管理
管理连接终端
备份恢复
服务可用性
日志管理
数据安全管理
参数管理
跨地域备份管理
API 参考
V2（2022-01-01）
实例管理
连接管理
账号管理
数据库管理
安全加密
备份与恢复
参数管理
资源包管理
附录
开发者工具
最佳实践
相关协议
- 文档首页
云数据库 MySQL 版API 参考V2（2022-01-01）实例管理UpgradeDBInstanceEngineMinorVersion - 升级实例的内核小版本
复制全文
下载 pdfUpgradeDBInstanceEngineMinorVersion - 升级实例的内核小版本
文档反馈
问问助手调用 UpgradeDBInstanceEngineMinorVersion 接口升级实例的内核小版本。
请求类型
异步请求。
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
参数 | 类型 | 是否必选 | 示例值 | 描述 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
InstanceId | String | 是 | mysql-19f81673**** | 实例 ID。 |
TargetMinorVersion | String | 是 | MySQL 8.0.32_20241015 | 目标内核小版本。 |
SwitchType | String | 否 | MaintainTime | 执行时间，取值：
说明
|
SpecifiedSwitchStartTime | String | 否 | 2024-12-25T14:00:00Z | 指定时间段执行时，时间段的起始时间（UTC 时间）。格式为 yyyy-MM-ddTHH:mm:ssZ。 说明
|
SpecifiedSwitchEndTime | String | 否 | 2024-12-25T15:59:00Z | 指定时间段执行时，时间段的结束时间（UTC 时间）。格式为 yyyy-MM-ddTHH:mm:ssZ。 说明
|
EstimateOnly | Boolean | 否 | true | 是否发起评估。取值：
说明 如果发起变配评估，则按照其他字段确定的规格配置进行评估，实际不会执行。 |
ObservationHours | Integer | 否 | 1 | 设定实例升级后的观测时长。支持将设置为 0~72 之间的整数值，单位为小时。默认值为 0。 |
返回参数
参数 | 类型 | 示例值 | 描述 |
参数 | 类型 | 示例值 | 描述 |
PreparedMinutes | Integer | 18 | 准备阶段需要的时长，单位为分钟。 |
示例
请求示例 1
不发起评估，直接执行。
POST /?Action=UpgradeDBInstanceEngineMinorVersion&Version=2022-01-01 HTTP/1.1
Content-Type: application/json
Host: rds-mysql.cn-beijing.volcengineapi.com
X-Date: 20211202T101010Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/rds_mysql/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c6458****
{
"InstanceId": "mysql-19f81673****",
"TargetMinorVersion": "MySQL 5.7.32_20241015",
"SwitchType": "SpecifiedTime",
"SpecifiedSwitchStartTime": "2024-12-25T14:00:00Z",
"SpecifiedSwitchEndTime": "2024-12-25T16:00:00Z"
}
返回示例 1
{
"ResponseMetadata": {
"RequestId": "20241219210327DD68F5A1B8E261523184-a8158f",
"Action": "UpgradeDBInstanceEngineMinorVersion",
"Version": "2022-01-01",
"Service": "rds_mysql",
"Region": "cn-beijing"
},
"Result": null
}
请求示例 2
发起评估，实际不执行，返回准备阶段的时长。
POST /?Action=UpgradeDBInstanceEngineMinorVersion&Version=2022-01-01 HTTP/1.1
Content-Type: application/json
Host: rds-mysql.cn-beijing.volcengineapi.com
X-Date: 20211202T101010Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/rds_mysql/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c6458****
{
"InstanceId": "mysql-19f81673****",
"TargetMinorVersion": "MySQL 5.7.32_20241015",
"SwitchType": "SpecifiedTime",
"SpecifiedSwitchStartTime": "2024-12-25T14:00:00Z",
"SpecifiedSwitchEndTime": "2024-12-25T16:00:00Z",
"EstimateOnly": true
}
返回示例 2
{
"ResponseMetadata": {
"RequestId": "2024122011191734C36BC883C95F08F2BB-184ccd",
"Action": "UpgradeDBInstanceEngineMinorVersion",
"Version": "2022-01-01",
"Service": "rds_mysql",
"Region": "cn-beijing"
},
"Result": {
"PreparedMinutes": 18
}
}
错误码
最近更新时间：2026.06.10 10:58:16
这个页面对您有帮助吗？
有用
有用
无用
无用