退还实例(按量计费)

最近更新时间:2017-05-03 17:16:23

1. 接口描述

本接口 (ReturnInstance) 用于主动退还实例。

接口请求域名:cvm.api.qcloud.com

  • 按量付费的实例,如不主动销毁将一直运行;在不使用该实例时,需要主动退还。
  • 只能支持主动退还按量计费类型的实例,包年包月实例如有误创建需要退还的情况还请发工单系统

2. 输入参数

以下请求参数列表仅列出了接口请求参数,其它参数见公共请求参数页面。

参数名称 是否必选 类型 描述
instanceId String 待操作的实例ID。可通过 DescribeInstances API返回值中的 unInstanceId 获取。

3. 输出参数

参数名称 类型 描述
code Int 公共错误码。0表示成功,其他值表示失败。详见错误码页面的公共错误码
message String 模块错误信息描述,与接口相关。详见错误码页面的模块错误码

4. 错误码

以下错误码表仅列出了该接口的业务逻辑错误码,更多公共错误码详见CVM错误码页面。

错误码 描述

OperationConstraints.InvaildInstanceStatus|实例状态不正确或获取实例状态失败

5. 示例

输入

  https://cvm.api.qcloud.com/v2/index.php?Action=ReturnInstance
  &instanceId=qcvm8e7bf56c115c53ce2d2a1ac2ea6e657a
  &<公共请求参数>

输出

{
    "code": 0,
    "message": "ok"
}