退订实例
1. 接口描述
调用 RefundInstance 接口退订一台未到期的实例,退订后实例及关联资源状态变更为已过期(EXPIRED)。
注意:实例状态必须是已停止(STOPPED)。
2. 请求参数
参数名 | 类型 | 是否必选 | 描述 |
---|---|---|---|
Action | String | 是 | 固定取值:RefundInstance |
InstanceUUID | String | 是 | 实例ID |
DataDiskUUIDList | String | 否 | 随主机退订的数据盘标识集合,Json字符串 |
EipUUIDList | String | 否 | 随主机退订的公网IP标识集合,Json字符串 |
ClientToken | String | 是 | 用于保证请求的幂等性 |
2. 返回数据
参数名 | 类型 | 说明 |
---|---|---|
RequestId | String | 请求ID |
3. 示例
请求示例
https://openapi.kaopuyun.com/AccessKeyId=sz0000ei53aw
&Action=RefundInstance
&DataDiskUUIDList=%5B%22disk-aaaaa%22%2C%22disk-bbbbbbbbb%22%5D
&Format=JSON
&InstanceUUID=ecs-vf0000f34e82
&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. 错误码
错误码 | 错误信息 |
---|---|
ResourceInstanceAndDiskRelationError | 实例和所关联的磁盘的关系不正确 |
ResourceNotFound | 待退款的产品不存在或已退款 |
RequestProcessingTryAgainLaterOrContactAdmin | 请求处理中,请稍后再试或联系管理员 |
ResourceNotAllowToUnsubscribe | 该资源不符合退订资格 |
ResourceUnsubscribeHasSubmitted | 该资源退订已提交退订申请 |
AccountNotRealNameAuth | 账户未实名认证 |
RefundInstanceFail | 退订实例失败:xxx |