变更实例规格
1. 接口描述
调用 DownGradeInstanceSpec 或 UpGradeInstanceSpec 接口调整实例的实例规格。
- 升级实例规格，系统会预先扣除本次实例升级所需金额，请确保账户余额充足。
- 实例状态必须为已停止（STOPPED）时才能变更实例规格。
2. 请求参数
| 参数名 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| Action | String | 是 | 固定取值：DownGradeInstanceSpec 或 UpGradeInstanceSpec 注意：升级固定值为UpGradeInstanceSpec；降级固定值为DownGradeInstanceSpec |
| InstanceUUID | String | 是 | 实例ID |
| Cpu | Integer | 是 | CPU 核心数 |
| Memory | String | 是 | 内存大小，单位：GB |
| InstanceType | String | 是 | 实例类型 |
| InstanceSpec | String | 是 | 实例规格，您可以调用 DescribeProductConfig 查看您可变更的实例规格 |
| InstanceResourceUUID | String | 是 | 第三方实例ID |
| ClientToken | String | 是 | 保证请求幂等性 |
3. 返回数据
| 参数名 | 类型 | 说明 |
|---|---|---|
| RequestId | String | 请求ID。 |
4. 示例
请求示例
https://openapi.kaopuyun.com/?SignatureVersion=1.0
&Action=DownGradeInstanceSpec
&Format=JSON
&InstanceUUID=ecs-3m0000gftg8m
&SignatureNonce=fad368fd-b5e3-476b-903b-2ef34e0e9fba
&Version=2014-05-26
&AccessKeyId=hfWkfqG6a794
&Signature=IcyHYfUBWSzJauAbDaqniNSNE94=
&SignatureMethod=HMAC-SHA1
&Timestamp=2023-02-25T15:29:21Z
&Cpu=1
&Memory=2
&InstanceType=s1
&InstanceSpec=ecs.n1.small
&InstanceResourceUUID=ecs-1111
&ClientToken=125558666
正常返回示例
{
"RequestId":"742fbe80-0ea9-11eb-9b36-0208cb7f7896"
}
5. 错误码
| 错误码 | 错误信息 |
|---|---|
| MissingParameter | InstanceType 参数不能为空 |
| MissingParameter | InstanceSpec 参数不能为空 |
| MissingParameter | CPU 参数不能为空 |
| MissingParameter | Memory 参数不能为空 |
| MissingParameter | InstanceResourceUUID 参数不能为空 |
| AountNotRealNameAuth | 账户未实名认证 |
| ResourceNotFound | 资源不存在或已退款 |
| ResourceOwnerIdError | 资源所属用户错误 |
| InvalidInstanceConfigNotSupported | 实例配置不合法 |
| InvalidResourcePedding | 当前资源正在处理中 |
| ProdResourceConfigNotFound | 资源配置信息不存在 |
| InstanceExpiredUnChange | 实例已经过期，无法变更 |
| InstanceTryoutUnChange | 实例在试用中，无法变更 |
| DownGradeInstanceSpecFail | 实例变更配置失败:xxx |