调用UpgradeDBInstanceKernelVersion接口升级RDS实例的内核小版本。
核小版本的升级涉及性能提升、新功能或问题修复等。更多信息,请参见MySQL升级内核小版本、SQL Server升级内核小版本、PostgreSQL升级内核小版本。
说明 该接口当前仅支持RDS MySQL、RDS SQL Server、RDS PostgreSQL实例。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | UpgradeDBInstanceKernelVersion |
系统规定参数,取值:UpgradeDBInstanceKernelVersion。 |
DBInstanceId | String | 是 | rm-bpxxxxx |
实例ID。仅支持RDS MySQL、RDS PostgreSQL和RDS SQL Server实例。 说明
|
UpgradeTime | String | 否 | Immediate |
升级时间,取值:
默认值:Immediate。 |
SwitchTime | String | 否 | 2020-01-15T00:00:00Z |
指定时间。格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 说明 UpgradeTime= SpecifyTime时传入此参数有效。
|
TargetMinorVersion | String | 否 | xcluster80_20210305 |
指定需要升级的数据库小版本号。格式:
不传此参数则默认升级到最新的小版本。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
DBInstanceName | String | rm-bpxxxxx |
实例ID。 |
RequestId | String | DA2ECBA0-4745-4491-9166-799FF8984AC9 |
请求ID。 |
TargetMinorVersion | String | xcluster80_20210305 |
升级的目标内核小版本。 |
TaskId | String | 226917711 |
任务ID。 |
示例
请求示例
http(s)://rds.aliyuncs.com/?Action=UpgradeDBInstanceKernelVersion
&DBInstanceId=rm-bpxxxxx
&UpgradeTime=SpecifyTime
&SwitchTime=2020-01-15T00:00:00Z
&TargetMinorVersion=xcluster80_20210305
&<公共请求参数>
正常返回示例
XML
格式
<UpgradeDBInstanceKernelVersion>
<TaskId>226917711</TaskId>
<RequestId>DA2ECBA0-4745-4491-9166-799FF8984AC9</RequestId>
<TargetMinorVersion>xcluster80_20210305</TargetMinorVersion>
<DBInstanceName>rm-bpxxxxx</DBInstanceName>
</UpgradeDBInstanceKernelVersion>
JSON
格式
{
"TaskId": "226917711",
"RequestId": "DA2ECBA0-4745-4491-9166-799FF8984AC9",
"TargetMinorVersion": "xcluster80_20210305",
"DBInstanceName": "rm-bpxxxxx"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | MissingParameter.MinorVersionTag | You must specify the parameter MinorVersionTag. | 小版本号不能为空 |
400 | EngineNotSupported | The engine does not support the operation. | 当前引擎不支持此操作。 |
404 | InvalidDBInstanceName.NotFound | The database instance does not exist. | 实例不存在。 |
400 | IncorrectDBInstanceState | The current instance state does not support this operation. | 当前实例状态不支持此操作。 |
403 | IncorrectDBInstanceLockMode | Current DB instance lock mode does not support this operation. | 当前DB实例锁模式不支持此操作。 |
400 | TaskExists | Specified task have existed. | 该任务已存在。 |
访问错误中心查看更多错误码。