续费实例
1. 接口描述
调用 RenewInstance 接口续费一台包年包月实例。
- 只支持操作包年包月实例。
- 续费前请确保账户余额充足。
2. 请求参数
| 参数名 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| Action | String | 是 | 固定取值：RenewInstance |
| InstanceUUID | String | 是 | 实例ID |
| InstanceResourceUUID | String | 是 | 第三方实例ID。 |
| Period | Integer | 是 | 续费时长 Period取值：1、2、3、4、5、6、7、8、9、12、24、36、48 |
| BillingCycle | String | 是 | 计费周期。取值范围: MONTH 月 |
| AutoRenewStatus | String | 否 | 是否自动续费，取值范围: NONE 不开启自动续费 |
| DataDiskUUIDList | String | 否 | 随主机续费的数据盘ID集合，Json字符串 |
| EipUUIDList | String | 否 | 随主机续费的公网IP标识集合，Json字符串 |
| ClientToken | String | 是 | 保证请求幂等性 |
3. 返回数据
| 参数名 | 类型 | 说明 |
|---|---|---|
| RequestId | String | 请求ID。 |
4. 示例
请求示例
https://openapi.kaopuyun.com/AccessKeyId=sz0000ei53aw
&Action=RenewInstance
&BillingCycle=MONTH
&DataDiskUUIDList=%5B%22disk-aaaaa%22%2C%22disk-bbbbbbbbb%22%5D
&Format=JSON
&InstanceResourceUUID=ecs-vf0000f34e82
&InstanceUUID=ecs-vf0000f34e82
&Period=1
&SignatureMethod=HMAC-SHA1
&SignatureNonce=36186a63-bd5f-4983-8ef6-8db94fc33eb2
&SignatureVersion=1.0
&Timestamp=2023-03-09T06%3A06%3A13Z
&Version=2014-05-26
&Signature=BBVM01xMSfxYCSZuyRDXUEOWnew%3D
&ClientToken=1s5s4s5s525
正常返回示例
{
"RequestId":"742fbe80-0ea9-11eb-9b36-0208cb7f7896"
}
5. 错误码
| 错误码 | 错误信息 |
|---|---|
| MissingParameter | InstanceResourceUUID 参数不能为空 |
| MissingParameter | Period 参数不能为空 |
| MissingParameter | BillingCycle 参数不能为空 |
| ValueNotSupported | BillingCycle 参数不合法 |
| ValueNotSupported | AutoRenew 参数不合法 |
| ProdResourceConfigNotFound | 资源配置信息不存在 |
| ResourceOwnerIdError | 资源所属用户错误 |
| AccountBalnceNotEnough | 账户余额不足 |
| AccountNotRealnameAuth | 账户未实名认证 |
| RenewInstanceFail | 续费实例失败:xxx |