调用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：预付费
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/2016_ent_ha/2016_std_ha/2016_web/2017_ent
  • PostgreSQL：9.4/10.0
  • PPAS：9.3/10.0
  • MariaDB：10.3
AccessKeyId String 否 LTAIfCxxxxxxxxxx

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

实例储存类型，取值：

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

实例变配类型，取值：

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

默认值：Up。

返回数据

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

错误码

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