描述
该接口用于对按时付费实例的规格或者存储空间变更配置,使用该接口时必须满足如下条件,否则实例规格会变更失败:
- 实例状态为运行中
- 实例当前无正在运行的备份
- 请求参数中必须至少指定实例规格(DBInstanceClass)或存储空间(DBInstanceStorage)。
- 若降低磁盘空间配置,输入的磁盘空间不能小于实际使用空间大小的1.1倍。
- 当前只支持对常规实例和只读实例变更配置,不支持灾备实例和临时实例。
请求参数
[tr=rgb(51, 205, 229)][td]名称
类型 | 是否必须 | 描述 |
Action | String | 是 | 系统规定参数,取值为ModifyDBInstanceSpec。 |
DBInstanceId | String | 是 | 待升降级的实例。 |
PayType | String | 是 | 计费方式,取值为Postpaid,按时付费。 |
DBInstanceClass | String | 否 | 实例规格,详见实例规格表。 |
DBInstanceStorage | Integer | 否 | 自定义存储空间,取值范围如下且取值必须为5的整数倍:
- MySQL为[5,2000]
- SQL Server为[10,2000]
- PostgreSQL和PPAS为[5,2000]
|
返回参数
请求示例
https:
//rds.aliyuncs.com/?Action=ModifyDBInstanceSpec&DBInstanceId=rdsaiiabnaiiabn&PayType=Postpaid&DBInstanceStorage=10&<公共请求参数>
返回示例
XML格式<
ModifyDBInstanceSpecResponse><
RequestId>3C5CFDEE-F774-4DED-89A2-1D76EC63C575</
RequestId></
ModifyDBInstanceSpecResponse>
JSON格式{"RequestId":
" 3C5CFDEE-F774-4DED-89A2-1D76EC63C575 "}
阿里云 AI 助理回答
要使用接口变更按时付费实例的规格或存储空间,确保操作成功需遵循以下条件与步骤:
必须满足的条件
- 实例状态:实例必须处于运行中状态。
- 备份任务:当前无正在进行的备份任务。
- 请求参数:至少指定实例规格(DBInstanceClass) 或 存储空间(DBInstanceStorage) 中的一项。若打算降低磁盘空间,新配置的磁盘空间不得小于当前实际使用空间的1.1倍。
- 实例类型支持:仅支持对常规实例和只读实例进行配置变更,不适用于灾备实例或临时实例。
请求参数说明
- Action: 必填,固定值为
ModifyDBInstanceSpec
。
- DBInstanceId: 必填,待变更规格或存储的实例ID。
- PayType: 必填,计费方式,对于此场景应为
Postpaid
(按时付费)。
- DBInstanceClass: 可选,目标实例规格,需参考各数据库引擎的规格表。
- DBInstanceStorage: 可选,自定义存储空间,取值范围依数据库类型而异(如MySQL、SQL Server、PostgreSQL和PPAS),且必须是5的整数倍。
返回参数
返回参数详情请参照API文档公共部分说明,通常会包括请求ID等用于追踪操作状态的信息。
示例请求
https://rds.aliyuncs.com/
?Action=ModifyDBInstanceSpec
&DBInstanceId=示例实例ID
&PayType=Postpaid
&DBInstanceClass=目标实例规格(如需变更)
&DBInstanceStorage=新的存储空间大小(如需变更,且符合规则)
注意事项
- 在执行规格变更前,请确保已了解目标规格对业务的影响,以及可能产生的费用变化。
- 降低磁盘空间时,务必确认新配置不会导致数据丢失。
- 实施变更操作建议在业务低峰期进行,以减少对服务的影响。
- 确保遵循API调用的最佳实践,包括身份验证、错误处理及重试机制。
通过遵循上述指导和注意事项,您可以有效地利用该接口完成按时付费实例的规格或存储空间变更。