更新时间：2024-09-04 GMT+08:00
设置自动扩容策略
功能介绍
设置实例存储空间自动扩容策略，按扩容量扣除存储费用。
可用存储空间小于等于设置值或者为10GB时，自动扩容当前存储空间的20%（如果是非10倍数则向上取整）。如果自定义了扩容步长，则按自定义的步长扩容。
接口约束
- 该接口公测中，如需使用请联系客服申请。
- 账户余额必须大于等于0美元，余额不足会导致自动扩容失败。
- 该接口仅支持磁盘大小为40GB及以上的云盘实例（即存储类型为SSD云盘）。
- 实例在进行升级至RDS、内核小版本升级、重启时，不能进行自动扩容。
- 包周期实例存在未完成订单时，不会自动扩容。
- 实例状态为“正常”和“存储空间满”时可以进行扩容。最大可自动扩容至4000GB。
URI
- 参数说明
表1 参数说明 名称
是否必选
参数类型
说明
project_id
是
String
参数解释：
租户在某一Region下的项目ID。
获取方法请参见获取项目ID。
约束限制：
不涉及。
取值范围：
不涉及。
默认取值：
不涉及。
instance_id
是
String
参数解释：
实例ID。
约束限制：
不涉及。
取值范围：
不涉及。
默认取值：
不涉及。
请求消息
|
名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
|
switch_option |
是 |
Boolean |
参数解释： 是否开启自动扩容。 约束限制： 不涉及。 取值范围：
默认取值： 不涉及。 |
|
limit_size |
否 |
Integer |
参数解释： 扩容上限，单位GB。 约束限制： “switch_option”为true时，该参数必填。 取值范围： 40GB~4000GB，需要大于等于实例当前存储空间总大小。 默认取值： 不涉及。 |
|
trigger_threshold |
否 |
Integer |
参数解释： 可用存储空间百分比，小于等于此值或者为10GB时触发扩容。 约束限制： “switch_option”为true时，该参数必填。 取值范围： 枚举值：
默认取值： 不涉及。 |
|
step_percent |
否 |
Integer |
参数解释： 每次自动扩容的步长，单位为百分比，即每次自动扩容当前存储空间的百分比。 约束限制： “switch_option”为true，且开启了自定义扩容步长功能时，该参数可选，不填时默认为20%。 取值范围： 5%~50% 默认取值： 20% |
请求示例
设置实例可用存储空间小于等于总空间10%或者为10GB时触发自动扩容，扩容上限为4000GB，每次自动扩容当前存储空间的20%。
{
"switch_option" : true,
"limit_size" : 4000,
"trigger_threshold" : 10,
"step_percent" : 20
}
响应消息
- 正常响应样例
- 异常响应
请参见异常请求结果。
状态码
- 正常
- 异常
请参见状态码。
父主题： 实例管理
