调整实例配置(按量计费)

最近更新时间:2024-11-22 17:20:30

我的收藏
说明:
当前页面接口为旧版 API,未来可能停止维护,目前不展示在左侧导航。云服务器 API 3.0 版本接口定义更加规范,访问时延下降显著,建议使用 云服务器 API 3.0

1. 接口描述

本接口 (ResizeInstanceHour) 用于调整指定实例的配置,包括 CPU、内存、数据盘。 接口请求域名:cvm.api.qcloud.com
只能对预付费用户的按量计费实例进行调整,如需调整包年包月实例可以使用 ResizeInstance API。
只能对已关机的实例进行配置升级操作。
只支持拥有云硬盘系统的实例升级。
不支持正在挂载弹性云硬盘的实例。
暂不支持降级。

2. 输入参数

以下请求参数列表仅列出了接口请求参数,其它参数见 公共请求参数 页面。
参数名称
是否必选
类型
描述
instanceId
String
待操作的实例 ID。可通过 DescribeInstances API 返回值中的 unInstanceId 获取。
cpu
Int
升级后的实例核数。CPU 与内存具体的配比限制参见 实例规格
mem
Int
升级后的实例内存大小(GB)。CPU 与内存具体的配比限制参见 实例规格
storageSize
Int
数据盘大小(GB)。最小调整步长为10G,此参数默认值为0,表示不购买数据盘。其所分配数据盘的类型与创建实例时 storageType 所指定的一致,无法更改。关于不同类型数据盘的特性与容量限制请参见 云硬盘

3. 输出参数

参数名称
类型
描述
code
Int
公共错误码。0表示成功,其他值表示失败。详见错误码页面的公共错误码
message
String
模块错误信息描述,与接口相关。

4. 示例

输入
https://cvm.api.qcloud.com/v2/index.php?Action=ResizeInstanceHour
&instanceId=qcvm8e7bf56c115c53ce2d2a1ac2ea6e657a
&mem=2
输出
{
"code": 0,
"message": "ok"
}