所有文档

          云服务器 BCC

          实例续费

          描述

          针对指定预付费实例的续费操作,延长过期时长。

          • 实例扩缩容期间不能进行续费操作。
          • 续费时若实例已欠费停机,续费成功后该实例将重新启动。
          • 支持关联的预付费CDS/EIP/MKT的产品一同续费,关联的后付费CDS/EIP/MKT不会一同续费。
          • 该接口是一个异步接口。
          • 专属实例不支持续费。

          请求结构

          PUT /v{version}/instance/{instanceId}?{action}&clientToken={clientToken} HTTP/1.1
          Host: bcc.bj.baidubce.com
          Authorization: authorization string
          
          {
              "billing":{
                  "reservation":{
                      "reservationLength": reservationLength,
                      "reservationTimeUnit": reservationTimeUnit
                  }
              }
          }

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          instanceId String URL参数 虚拟机实例ID
          action String Query参数 本接口中该参数取值purchaseReserved
          clientToken String Query参数 幂等性Token,是一个长度不超过64位的ASCII字符串,详见ClientToken幂等性
          relatedRenewFlag String Query参数 设置实例关联续费标识,默认为空字符串。可选标识请参照RelatedRenewFlag
          billing Billing RequestBody参数 订单详情

          返回头域

          除公共头域,无其它特殊头域。

          返回参数

          无特殊返回参数

          错误码

          错误码 错误描述 HTTP状态码 中文解释
          BadRequest Bad request parameters or illegal request. 400 请求参数无效
          NoSuchObject The specified object is not found or resource do not exist. 404 资源不存在
          OperationDenied Operation not available. 409 不可操作

          请求示例

          PUT /v2/instance/i-YufwpQAe?purchaseReserved&clientToken=be31b98c-5e41-4838-9830-9be700de5a20&relatedRenewFlag=CDS_EIP_MKT HTTP/1.1
          Host: bcc.bj.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          
          {
          	"billing":{
          	    "reservation":{
          	        "reservationLength":1,
          	        "reservationTimeUnit":"Month"
          	    }
          	}
          }

          返回示例

          HTTP/1.1 200 OK
          x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
          Date: Wed, 03 Dec 2014 06:42:19 GMT
          Content-Type: application/json;charset=UTF-8
          Server: BWS
          上一篇
          查询实例VNC地址
          下一篇
          释放实例(POST请求的释放)