You can call this operation to upgrade the database version of the instance.

Note The price for the upgrade is calculated based on the new and old instance types and storage types.

If the master instance is attached with a read-only or disaster recovery instance, first upgrade the database version of the attached instance.

This operation must meet the following requirements:

  • The instance is in the running state.
  • You can upgrade a database from MySQL 5.5 to MySQL 5.6.


You can use OpenAPI Explorer to perform debugging. OpenAPI Explorer allows you to perform various operations to simplify API usage. For example, you can retrieve APIs, call APIs, and dynamically generate SDK example code.

Request parameters

Parameter Type Required Example Description
Action String Yes UpgradeDBInstanceEngineVersion

The operation that you want to perform. Set this parameter to UpgradeDBInstanceEngineVersion.

DBInstanceId String Yes rm-uf6wjk5xxxxxxx

The ID of the instance.

EngineVersion String Yes 5.6

The version of the target database. Valid value: 5.6.

AccessKeyId String No LTAIfCxxxxxxxxxx

The AccessKey ID that Alibaba Cloud issues to a user for service access.

EffectiveTime String No Immediate

The time when the upgrade takes effect. Valid values:

  • Immediate: The upgrade takes effect immediately.
  • MaintainTime: The upgrade takes effect during the maintenance period. You can call the ModifyDBInstanceMaintainTime API operation to view the information about the maintenance period.

Default value: Immediate.

ClientToken String No ETnLKlblzczshOTUbOCzxxxxxxxxxx

The client token that is used to guarantee the idempotency of requests. The client token is generated by the client and is unique among different requests. It is a string of up to 64 ASCII characters.

Response parameters

Parameter Type Example Description
TaskId String 10254125

The ID of the task.

RequestId String 65BDA532-28AF-4122-AA39-B382721EEE64

The ID of the request.


Sample requests

http(s):// Action=UpgradeDBInstanceEngineVersion
&<Common request parameters>

Successful response examples

XML format

	  <RequestId> 65BDA532-28AF-4122-AA39-B382721EEE64</RequestId>

JSON format

	"RequestId":" 65BDA532-28AF-4122-AA39-B382721EEE64",

Error codes

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