文档首页/ 云备份 CBR/ API参考/ API/ 运营/ 修改付费模式
更新时间：2025-08-24 GMT+08:00
查看PDF
分享

修改付费模式

功能介绍

修改资源的付费模式，暂时只支持按需资源转包周期资源。

该接口目前属于公测阶段，部分region暂时无法使用。

URI

POST /v3/{project_id}/vaults/change-charge-mode

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

charging_mode

否

String

功能说明：计费模式。当前仅可选择：pre_paid，表示包年包月。

period_type

是

String

功能说明：订购周期单位。charging_mode参数为pre_paid时该参数会生效，并且该参数为必选。

取值范围：

  • month：月

  • year：年

period_num

是

Integer

功能说明：订购周期数，charging_mode为pre_paid时该参数会生效，并且该参数为为必选。

取值范围：[1-9]

is_auto_renew

否

Boolean

功能说明：到期后是否自动续期，默认为false

取值范围：

  • true：到期后自动续期

  • false：到期后不自动续期

is_auto_pay

否

Boolean

功能说明：是否是否自动付费，默认为false

取值范围：

  • true：下单后自动付费

  • false：下单后不自动付费

console_url

否

String

云服务console_url。 订购订单支付完成后，客户可以通过此URL跳转到云服务Console页面查看信息。（仅手动支付时涉及）。

vault_ids

是

Array of strings

资源列表

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

orderId

String

订单ID

retCode

String

变更状态码

retMsg

String

变更信息

请求示例

按需存储库转包周期

https://{endpoint}/v3/{project_id}/orders/change-to-period

{
  "vault_ids" : [ "9dd8f8db-a926-440b-9af5-81b643618898" ],
  "charging_mode" : "pre_paid",
  "period_type" : "year",
  "period_num" : 2,
  "is_auto_renew" : true,
  "is_auto_pay" : true,
  "console_url" : "https://www.{endpoint}/v3/"
}

响应示例

状态码：200

OK

{
  "orderId" : "CS2305291628MSG5A",
  "retCode" : 0,
  "retMsg" : "success"
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题： 运营