调用UpgradeDBInstanceEngineVersion接口升级实例数据库版本。

说明 升级后根据新老规格信息和存储类型信息计算差价。

如果主实例下挂载只读实例或者灾备实例，请先升级只读实例或者灾备实例的数据库版本。

调用该接口时，实例必须满足以下条件，否则将操作失败：

  • 实例状态为运行中。
  • 仅支持从MySQL 5.5升级到MySQL 5.6。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 UpgradeDBInstanceEngineVersion

系统规定参数，取值：UpgradeDBInstanceEngineVersion。

DBInstanceId String 是 rm-uf6wjk5xxxxxxx

待升级的实例ID。
EngineVersion String 是 5.6

目标数据库版本，取值：5.6。

ClientToken String 否 ETnLKlblzczshOTUbOCzxxxxxxxxxx

用于保证请求的幂等性，防止重复提交请求。由客户端生成该参数值，要保证在不同请求间唯一，最大值不超过64个ASCII字符，且该参数值中不能包含非ASCII字符。
EffectiveTime String 否 Immediate

生效时间，取值：

默认值：Immediate。

返回数据

名称 类型 示例值 描述
TaskId String 10254125

任务ID。
RequestId String 65BDA532-28AF-4122-AA39-B382721EEE64

请求ID。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=UpgradeDBInstanceEngineVersion
&DBInstanceId=rm-uf6wjk5xxxxxxx
&EngineVersion=5.6
&<公共请求参数>

正常返回示例

XML 格式 

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

JSON 格式 

{
    "RequestId": " 65BDA532-28AF-4122-AA39-B382721EEE64",
    "TaskId": "10254125"
}

错误码

访问错误中心查看更多错误码。