调用UpgradeDBInstanceEngineVersion接口升级RDS MySQL实例大版本。

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

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

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

  • 实例状态为运行中。
  • 实例版本为RDS MySQL 5.6或RDS MySQL 5.5。

如需升级RDS PostgreSQL实例大版本,请调用UpgradeDBInstanceMajorVersion

调试

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

请求参数

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

系统规定参数。取值:UpgradeDBInstanceEngineVersion

ClientToken String ETnLKlblzczshOTUbOCzxxxxxxxxxx

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

DBInstanceId String rm-uf6wjk5xxxxxxx

待升级的实例ID。

EngineVersion String 5.7

目标数据库版本,取值:

  • 5.7
  • 5.6
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.7
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<UpgradeDBInstanceEngineVersionResponse>
	<RequestId> 65BDA532-28AF-4122-AA39-B382721EEE64</RequestId>
	<TaskId>10254125</TaskId></UpgradeDBInstanceEngineVersionResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

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