说明:
1. 接口描述
本接口 (ResizeInstance) 用于调整指定实例的配置,包括 CPU、内存、数据盘。
接口请求域名:cvm.api.qcloud.com
只能对已关机的实例进行调整配置操作。
此接口目前只支持系统盘是云硬盘的实例。
不支持挂载了弹性云硬盘的实例。
本接口只能对包年包月实例进行调整,如需调整按量计费请参见 ResizeInstanceHour。
暂不支持配置降级。
2. 输入参数
参数名称 | 是否必选 | 类型 | 描述 |
instanceId | 是 | String | |
cpu | 否 | Int | |
mem | 否 | Int | |
bandwidth | 否 | Int | 带宽(Mbps)如仅需升级带宽也可以使用 UpdateInstanceBandwidth ,如果指定了此参数,需要将 bandwidthUpgradeStartTime 和 bandwidthUpgradeEndTime 一同指定。 |
bandwidthUpgradeStartTime | 否 | String | 带宽升级开始时间(例2016-08-30),当日0时生效。 |
bandwidthUpgradeEndTime | 否 | String | 带宽升级结束时间(例2018-10-02)。将于当日0时恢复为原带宽。 |
storageType | 否 | Int | 硬盘类型。硬盘类型。1:本地硬盘、2:普通云硬盘、3:本地 SSD 硬盘、4:SSD 云硬盘,默认为1。关于硬盘类型的选择请参见 云硬盘,可选硬盘类型受到创建实例时选择的实例类型(InstanceType)限制。另外允许购买的最大容量也因硬盘类型的不同而有所差异。 |
storageSize | 是 | Int | 数据盘大小(GB)。最小调整步长为10G,此参数默认值为0,表示不购买数据盘。其所分配数据盘的类型与创建实例时 storageType 所指定的一致。关于不同类型数据盘的特性与容量限制请参见 云硬盘。 |
3. 输出参数
参数名称 | 类型 | 描述 |
code | Int | 公共错误码。0表示成功,其他值表示失败。 |
message | String | 模块错误信息描述,与接口相关。 |
dealIds | Array | 生成的订单号,用于查询后续执行状况。 |
4. 错误码
错误码 | 描述 |
NotSupport.NotPrepaidUser | 请求被拒绝,接口只支持预付费用户 |
OperationFail.AllResourceOpFailed | 资源操作失败 |
NotSupport.BandwidthPackageUser | 请求失败,带宽包客户不支持使用该接口调整实例的带宽 |
InvalidParameter.Bandwidth | 售卖系统接口操作失败:bandwidth 参数不正确,请确认重试 |
NotSupport.InstanceConfig | 请求失败,共享核实例不支持调整配置 |
OperationConstraints.AccountBalanceNotEnough | 您的余额不足,请先充值 |
OperationFail.SystemBusy | 资源购买繁忙 |
5. 示例
输入
https://cvm.api.qcloud.com/v2/index.php?Action=ResizeInstance&instanceId=qcvm12345&cpu=1&mem=2
输出
{"code": 0,"message": "","dealIds": [121]}