文档平台 API中心 云服务器 API 调整实例配置(按量计费)

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

最近更新时间:2018-09-10 21:32:04

当前页面接口为旧版 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与内存具体的配比限制参见CVM实例配置
mem Int 升级后的实例内存大小(GB)。CPU与内存具体的配比限制参见CVM实例配置
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"
}