You can call this operation to upgrade the database version of the instance.
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.
Debugging
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:
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. |
Examples
Sample requests
http(s)://rds.aliyuncs.com/? Action=UpgradeDBInstanceEngineVersion
&DBInstanceId=rm-uf6wjk5xxxxxxx
&EngineVersion=5.6
&<Common request parameters>
Successful response examples
XML
format
<UpgradeDBInstanceEngineVersionResponse>
<RequestId> 65BDA532-28AF-4122-AA39-B382721EEE64</RequestId>
<TaskId>10254125</TaskId></UpgradeDBInstanceEngineVersionResponse>
JSON
format
{
"RequestId":" 65BDA532-28AF-4122-AA39-B382721EEE64",
"TaskId":"10254125"
}
Error codes
For a list of error codes, visit the API Error Center.