开发者社区 问答 正文

API参考 - API参考 - 实例管理 - ModifyDBInstanceSpec



描述


该接口用于对按时付费实例的规格或者存储空间变更配置,使用该接口时必须满足如下条件,否则实例规格会变更失败:

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


请求参数

[tr=rgb(51, 205, 229)][td]名称 类型是否必须描述ActionString是系统规定参数,取值为ModifyDBInstanceSpec。DBInstanceIdString是待升降级的实例。PayTypeString是计费方式,取值为Postpaid,按时付费。DBInstanceClassString否实例规格,详见实例规格表。DBInstanceStorageInteger否自定义存储空间,取值范围如下且取值必须为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 "}

展开
收起
梨好橙 2018-09-11 23:27:51 1172 分享 版权
阿里云 AI 助理回答

要使用接口变更按时付费实例的规格或存储空间,确保操作成功需遵循以下条件与步骤:

必须满足的条件

  1. 实例状态:实例必须处于运行中状态。
  2. 备份任务:当前无正在进行的备份任务。
  3. 请求参数:至少指定实例规格(DBInstanceClass)存储空间(DBInstanceStorage) 中的一项。若打算降低磁盘空间,新配置的磁盘空间不得小于当前实际使用空间的1.1倍。
  4. 实例类型支持:仅支持对常规实例只读实例进行配置变更,不适用于灾备实例或临时实例。

请求参数说明

  • 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调用的最佳实践,包括身份验证、错误处理及重试机制。

通过遵循上述指导和注意事项,您可以有效地利用该接口完成按时付费实例的规格或存储空间变更。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答