续费预留实例券
所有文档
menu

云服务器 BCC

续费预留实例券

产品详情自助选购

该接口用于续费预留实例券。

请求结构

POST /v{version}/instance/reserved/renew HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string
{
    "reservedInstanceIds": [
       reservedInstanceId
    ],
    "reservedInstanceTime": reservedInstanceTime,
    "reservedInstanceTimeUnit": reservedInstanceTimeUnit,
    "autoRenewTimeUnit":autoRenewTimeUnit,
    "autoRenewTime":autoRenewTime,
    "autoRenew":autoRenew
}

请求头域

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

请求参数

参数名称 类型 是否必需 参数位置 描述
version String URL参数 API版本号
reservedInstanceIds Array requestBody参数 实例券id集合
reservedInstanceTime String requestBody参数 预留实例券续费时长,支持3,6,9,12,24,36个月,必须与购买时长保持一致
reservedInstanceTimeUnit String requestBody参数 预留实例券购买时长单位,默认为month,不可变更
autoRenew Boolean requestBody参数 自动续费开关,默认为false
autoRenewTimeUnit String requestBody参数 预留实例券自动续费时长单位,默认为month,不可变更
autoRenewTime String requestBody参数 预留实例券自动续费时长,支持3,6,9,12,24,36个月,autoRenew为true时,必选且必须与reservedInstanceTime一致

返回头域

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

返回参数

参数名称 类型 描述
orderId String 创建预留实例券的订单号
reservedInstanceIds Array 预留实例券的id集合

错误码

错误码 错误描述 HTTP状态码 中文解释
BadRequest request is invalid 400 请求参数无效

请求示例

POST http://bcc.bj.baidubce.com/v2/instance/reserved/renew
Host: bcc.bj.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

{
  "reservedInstanceIds": [
      "r-test"
  ],
  "reservedInstanceTime": 12,
  "reservedInstanceTimeUnit": "month",
  "autoRenewTimeUnit": "month",
  "autoRenewTime": 12,
  "autoRenew": true
}

返回示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Wed, 08 Jul 2023 03:28:11 GMT
x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS

{
    "reservedInstanceIds": [
       "test_f0c549b9614f"
    ],
    "orderId": "orderId"
}
上一篇
调整预留实例券
下一篇
预留实例券转出列表