ModifyDBInstanceSpec
调用ModifyDBInstanceSpec接口变更RDS实例(包括常规实例和只读实例,不包括灾备实例和临时实例)的规格或存储空间。
调用该接口时,实例必须满足以下条件,否则将操作失败:
- 实例状态为运行中。
- 实例没有正在执行的备份任务。
- 请求参数中必须至少指定实例规格(DBInstanceClass)和存储空间(DBInstanceStorage)其中一个参数。
- 若降低磁盘空间配置,输入的磁盘空间不能小于实际使用空间大小的1.1倍。
- 当前只支持对常规实例和只读实例变更配置,不支持灾备实例和临时实例。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ModifyDBInstanceSpec |
系统规定参数,取值:ModifyDBInstanceSpec。 |
DBInstanceId | String | 是 | rm-uf6wjk5xxxxxxx |
待变更配置的实例ID。 |
PayType | String | 是 | Postpaid |
实例当前的付费类型,取值:
|
DBInstanceClass | String | 否 | rds.mys2.small |
实例规格,详见实例规格表。 说明 至少指定实例规格DBInstanceClass和存储空间DBInstanceStorage其中一个参数。
|
DBInstanceStorage | Integer | 否 | 20 |
自定义存储空间,单位:GB。每5GB进行递增,详情请参见实例规格表。 说明 至少指定实例规格DBInstanceClass和存储空间DBInstanceStorage其中一个参数。
|
EffectiveTime | String | 否 | MaintainTime |
生效时间,取值:
默认值:Immediate。 |
EngineVersion | String | 否 | 5.6 |
数据库版本号,取值:
|
AccessKeyId | String | 否 | LTAIfCxxxxxxxxxx |
阿里云颁发给用户的访问服务所用的密钥ID。 |
DBInstanceStorageType | String | 否 | local_ssd |
实例储存类型,取值:
|
Direction | String | 否 | Up |
实例变配类型,取值:
默认值: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 "
}
错误码
访问错误中心查看更多错误码。
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论