Upgrade the database version of RDS instance

Last Updated: Dec 06, 2017


Upgrade the database version of an instance, for example, from MySQL 5.1 to MySQL 5.5.

If the primary instance is attached with a read-only or disaster recovery instance, please first upgrade the database version of the read-only or disaster recovery instance.The operation must meet the following conditions, otherwise the call will fail:

  • The instance is Running.

  • The entered database version must be later than the current database version of the target instance.

Request parameters

Name Type Required? Description
Action String Yes Required parameter. Value: UpgradeDBInstanceEngineVersion.
DBInstanceId String Yes Instance to be upgraded/downgraded.
EngineVersion String Yes Database version to be upgraded to.

Return parameters

Name Type Description
<Public Return Parameters> - For more information, see Public parameters.
TaskId Integer Task ID.


  • Request example

    1. https://rds.aliyuncs.com/?Action=UpgradeDBInstanceEngineVersion
    2. &DBInstanceId=rdsaiiabnaiiabn
    3. &EngineVersion=5.6
    4. &<Public Request Parameters>
  • Return example

    XML format:

    1. <UpgradeDBInstanceEngineVersionResponse>
    2. <RequestId>65BDA532-28AF-4122-AA39-B382721EEE64</RequestId>
    3. <TaskId>124378</Taskid>
    4. </UpgradeDBInstanceEngineVersionResponse>

    JSON format:

    1. {
    2. "RequestId": " 65BDA532-28AF-4122-AA39-B382721EEE64"
    3. "TaskId":”124378
    4. }
Thank you! We've received your feedback.