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

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

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

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

  • 实例状态为运行中。
  • 实例版本为下列其中之一:
    • RDS MySQL 5.7
    • 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

目标数据库版本,取值:

  • 8.0
  • 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"
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidOrderTask.NotSupport The Current InstanceId exist Order Task in RDS. 当前实例存在未执行完成的订单任务,请稍后重试。
400 InvalidSSLstatus Current DB instance has SSL enabled, this operation is not supported. 实例已经打开SSL,不支持当前操作
400 InvalidDBInstanceConnType.Format Specified DB instance conn type is not valid. 操作失败,当前数据库实例的连接类型不支持此操作。
403 IncorrectDBInstanceState Current DB instance state does not support this operation. 操作失败,该实例状态下不支持此操作。
403 IncorrectEngineVersion The engine version does not support the operation. 操作失败,当前数据库版本不支持该操作。
403 IncorrectEngineTypeMyisam Current DB instance has MyISAM table, and it does not support this operation. mysql大版本升级,校验客户实例是否存在myisam引擎表。
403 InvalidInstanceLevel.Malformed Current DB instance level does not support this operation. 当前数据库实例级别不支持此操作。
403 IncorrectDBInstanceLockMode Current DB instance lock mode does not support this operation. 操作失败,实例处于锁定状态。
404 InvalidDBInstance.NotFound The specified instance does not exist or is not supported. 没有找到指定的实例,请检查实例的正确性。

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