调用UpgradeDBInstanceKernelVersion接口升级RDS MySQL或PostgreSQL实例的内核小版本。

内核小版本的升级涉及性能提升、新功能或问题修复等。详情请参见升级MySQL内核小版本或者升级PostgreSQL内核小版本

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String UpgradeDBInstanceKernelVersion

系统规定参数,取值:UpgradeDBInstanceKernelVersion

DBInstanceId String rm-bpxxxxx

实例ID。仅支持RDS MySQL或PostgreSQL实例。

说明 PostgreSQL实例的存储类型必须为云盘。本地盘实例可以通过重启实例接口重启,以自动升级到最新的小版本。
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

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

  • PostgreSQLrds_postgres_<大版本号>00_<小版本号>。例如12版本的20200830:rds_postgres_1200_20200830
  • MySQL<实例版本>_<小版本号>。例如rds_20200229xcluster_20200229xcluster80_20200229。其中,实例版本分为如下三种:
    • rds:高可用版或基础版。
    • xcluster:MySQL 5.7三节点企业版。
    • xcluster80:MySQL 8.0三节点企业版。

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

返回数据

名称 类型 示例值 描述
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. 当前实例状态不支持此操作。

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