说明:当前页面接口为旧版 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"
}