Call the UpgradeDBInstanceEngineMinorVersion API to upgrade the minor kernel version of an instance.

Request type

Asynchronous request.

Debug

API Explorer

You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.

Go to debug

Request parameters

Parameter	Type	Is it required?	Sample value	Description
InstanceId	String	Yes	mysql-19f81673****	Instance ID.
TargetMinorVersion	String	Yes	MySQL 8.0.32_20241015	Target kernel minor version.
SwitchType	String	No	MaintainTime	Execution time. The valid values are: Immediate: switch now (default). MaintainTime: switch during the maintenance window. SpecifiedTime: switch during the specified time period. tip You can call the DescribeDBInstanceDetail API to query the instance's maintenance window. When the value is SpecifiedTime, the start and end time for the time period must be set in the SpecifiedSwitchStartTime and SpecifiedSwitchEndTime parameters.
SpecifiedSwitchStartTime	String	No	2024-12-25T14:00:00Z	The start time of the specific time period for execution(UTC time). The format is yyyy-MM-ddTHH:mm:ssZ. tip When SwitchType is set to SpecifiedTime, this parameter is required. The start time of the task cannot be later than seven days after the current date.
SpecifiedSwitchEndTime	String	No	2024-12-25T15:59:00Z	The end time of the specific time period for execution (UTC time). The format is yyyy-MM-ddTHH:mm:ssZ. tip When SwitchType is set to SpecifiedTime, this parameter is required. The minimum time period is one hour and fifty-nine minutes. Time periods cannot be set across days. The task's start and end times must be within a 24-hour window.
EstimateOnly	Boolean	No	true	Whether to start an evaluation. Values: true: yes. false: no. Default value. tip If you start a configuration change evaluation, the system evaluates the specifications determined by other fields, but the change is not actually executed.
ObservationHours	Integer	No	1	Set the observation duration after the instance upgrade. The value can be set to an integer between 0 and 72, in hours. The default value is 0.

Response parameters

Parameter	Type	Sample value	Description
PreparedMinutes	Integer	18	The duration of the preparation phase, in minutes.

Sample

Sample request 1

Execute directly without an evaluation.

Sample response 1

Sample request 2

Initiates an assessment without actual execution and returns the duration of the preparation phase.

Sample response 2

Error code

For more details, refer to Error codes.

RDS for MySQL