Updates the minor version of an RDS MySQL or PostgreSQL instance.

You can upgrade the minor kernel version to increase performance, use new features, and fix known issues.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes UpgradeDBInstanceKernelVersion

The operation that you want to perform. Set the value to UpgradeDBInstanceKernelVersion.

DBInstanceId String Yes rm-bpxxxxx

The ID of the RDS instance.
UpgradeTime String No Immediate

The method to update the kernel version. Valid values:

  • Immediate: The kernel version is updated immediately.
  • MaintainTime: The kernel version is updated during the maintenance window. For more information about how to change the maintenance window, see ModifyDBInstanceMaintainTime.
  • SpecifyTime: The kernel version is updated at the point in time you specify.

Default value: Immediate.

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

The time to update the kernel version. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.

Note This parameter only takes effect when the UpgradeTime parameter is set to SpecifyTime.

Response parameters

Parameter Type Example Description
RequestId String DA2ECBA0-4745-4491-9166-799FF8984AC9

The ID of the request.
DBInstanceName String rm-bpxxxxx

The ID of the RDS instance.
TaskId String 226917711

The ID of the task.
TargetMinorVersion String rds_20191225

The target kernel version updated for the RDS instance.

Examples

Sample requests

http(s)://rds.aliyuncs.com/? Action=UpgradeDBInstanceKernelVersion
&DBInstanceId=rm-bpxxxxx
&UpgradeTime=SpecifyTime
&SwitchTime=2020-01-15T00:00:00Z
&<Common request parameters>

Sample success responses

XML format 

<UpgradeDBInstanceKernelVersionResponse>
  <RequestId>DA2ECBA0-4745-4491-9166-799FF8984AC9</RequestId>
  <TaskId>226917711</TaskId>
  <TargetMinorVersion>rds_20191225</TargetMinorVersion>
  <DBInstanceName>rm-bpxxxxx</DBInstanceName>
</UpgradeDBInstanceKernelVersionResponse>

JSON format 

{
    "RequestId": "DA2ECBA0-4745-4491-9166-799FF8984AC9",
    "TaskId": "226917711",
    "TargetMinorVersion": "rds_20191225",
    "DBInstanceName": "rm-bpxxxxx"
}

Error codes

For a list of error codes, visit the API Error Center.