调用ModifyDBInstanceSpec接口变更RDS实例(包括常规实例和只读实例,不包括灾备实例和临时实例)的规格或存储空间。

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

  • 实例状态为运行中。
  • 实例没有正在执行的备份任务。
  • 请求参数中必须至少指定实例规格(DBInstanceClass)和存储空间(DBInstanceStorage)其中一个参数。
  • 若降低磁盘空间配置,输入的磁盘空间不能小于实际使用空间大小的1.1倍。
  • 当前只支持对常规实例和只读实例变更配置,不支持灾备实例和临时实例。

调试

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

请求参数

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

系统规定参数,取值:ModifyDBInstanceSpec

DBInstanceId String rm-uf6wjk5xxxxxxx

待变更配置的实例ID。

PayType String Postpaid

实例当前的付费类型,取值:

  • Postpaid:按量付费
  • Prepaid:预付费
ZoneId String cn-hangzhou-b

可用区ID。

DBInstanceClass String rds.mys2.small

实例规格,详见实例规格表

说明 至少指定实例规格DBInstanceClass和存储空间DBInstanceStorage其中一个参数。
DBInstanceStorage Integer 20

自定义存储空间,单位:GB。每5GB进行递增,详情请参见实例规格表

说明 至少指定实例规格DBInstanceClass和存储空间DBInstanceStorage其中一个参数。
EffectiveTime String MaintainTime

生效时间,取值:

默认值:Immediate

EngineVersion String 5.6

数据库版本号,取值:

  • MySQL:5.5/5.6/5.7/8.0
  • SQLServer:2008r2/2012/2012_ent_ha/2012_std_ha/2012_web/2014_std_ha/2016_ent_ha/2016_std_ha/2016_web/2017_ent
  • PostgreSQL:9.4/10.0
  • PPAS:9.3/10.0
  • MariaDB:10.3
DBInstanceStorageType String local_ssd

实例储存类型,取值:

  • local_ssd/ephemeral_ssd:本地SSD盘
  • cloud_ssd:SSD云盘
  • cloud_essd:ESSD云盘
Direction String Up

实例变配类型,取值:

  • Up:包年包月实例的升级和按量付费实例的升级/降级。
  • Down:包年包月实例的降级。

默认值:Up

SourceBiz String 不涉及

弃用参数。

DedicatedHostGroupId String dhg-7a9xxxxxxxx

专属集群ID。

返回数据

名称 类型 示例值 描述
RequestId String 3C5CFDEE-F774-4DED-89A2-1D76EC63C575

请求ID。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=ModifyDBInstanceSpec
&DBInstanceId=rm-uf6wjk5xxxxxxx
&PayType=Postpaid
&DBInstanceClass=rds.mys2.small
&<公共请求参数>

正常返回示例

XML 格式

<ModifyDBInstanceSpecResponse>
         <RequestId>3C5CFDEE-F774-4DED-89A2-1D76EC63C575</RequestId>
</ModifyDBInstanceSpecResponse>

JSON 格式

{
  "RequestId": " 3C5CFDEE-F774-4DED-89A2-1D76EC63C575 "
}

错误码

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