调用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实例。

说明
  • PostgreSQL实例的存储类型必须为云盘。本地盘实例可以通过重启实例接口重启，以自动升级到最新的小版本。
  • SQL Server实例仅2019版本支持小版本升级。
UpgradeTime String 否 Immediate

升级时间，取值：

  • Immediate：立即生效。
  • MaintainTime：在可运维时间段内生效，修改运维时间请参见ModifyDBInstanceMaintainTime。
  • SpecifyTime：指定时间生效。

默认值：Immediate。

SwitchTime String 否 2020-01-15T00:00:00Z

指定时间。格式：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。

说明 UpgradeTime= SpecifyTime时传入此参数有效。
TargetMinorVersion String 否 xcluster80_20210305

指定需要升级的数据库小版本号。格式：

  • PostgreSQL：rds_postgres_<大版本号>00_<小版本号>。例如12版本的20200830：rds_postgres_1200_20200830。
  • MySQL：<实例版本>_<小版本号>。例如rds_20200229、xcluster_20200229或xcluster80_20200229。其中，实例版本分为如下三种：
    • rds：高可用版或基础版。
    • xcluster：MySQL 5.7三节点企业版。
    • xcluster80：MySQL 8.0三节点企业版。
  • SQLServer：<小版本号>。例如15.0.4073.23。

不传此参数则默认升级到最新的小版本。

说明 小版本号请参见：PostgreSQL小版本Release Notes、MySQL小版本Release Notes、SQL Server小版本Release Notes。

返回数据

名称 类型 示例值 描述
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. 该任务已存在。

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