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

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

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

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

  • 实例状态为运行中;
  • 目前支持从MySQL 5.5升级到MySQL 5.6,以及从SQL Server 2008 R2升级到SQL Server 2012/2016企业版、SQL Server 2016标准版。

调试

前往【API Explorer】在线调试,API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力,能显著降低使用云 API 的难度,强烈推荐使用。

请求参数

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

系统规定参数,取值:UpgradeDBInstanceEngineVersion

DBInstanceId String rm-uf6wjk5xxxxxxx

待升级的实例ID。

EngineVersion String 5.6

目标数据库版本,取值:

  • MySQL:5.6
  • SQL Server:2016_web/2012_std_ha/2016_std_ha/2012_ent_ha/2016_ent_ha
AccessKeyId String LTAIfCxxxxxxxxxx

阿里云颁发给用户的访问服务所用的密钥ID。

EffectiveTime String Immediate

生效时间,取值:

默认值:Immediate

DBInstanceClass String mssql.x4.medium.s2

目标实例规格,详见实例规格表。MySQL可以为空,SQL Server需要传入。

DBInstanceStorageType String cloud_ssd

目标存储类型,MySQL可以为空,SQL Server需要传入。取值:

  • local_ssd/ephemeral_ssd:本地SSD盘;
  • cloud_ssd:SSD云盘;
  • cloud_essd:ESSD云盘。
ZoneId String cn-hangzhou-b

目标可用区ID,默认和实例当前可用区一致。

InstanceNetworkType String VPC

目标网络类型,MySQL可以为空,SQL Server需要传入。取值:

  • VPC:专有网络;
  • Classic:经典网络。
VpcId String vpc-xxxxxxxxxxxx

目标VPC ID,MySQL可以为空,SQL Server需要传入。

VSwitchId String vsw-xxxxxxxxxxx

目标交换机ID,MySQL可以为空,SQL Server需要传入。

返回参数

名称 类型 示例值 描述
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"
}

错误码

查看本产品错误码