云服务器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请求的释放)