文档首页/ 云备份 CBR/ API参考/ API/ 运营/ 修改付费模式 - ChangeVaultChargeMode
更新时间：2026-07-21 GMT+08:00
在线调试
CLI示例
查看PDF
分享

修改付费模式 - ChangeVaultChargeMode

功能介绍

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

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，当前API调用无需身份策略权限。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

项目ID，获取方法请参见获取项目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

参数解释：

到期后是否自动续期

约束限制：

不涉及

取值范围：

  • true：自动续期

  • false：不自动续期

默认取值：

false

is_auto_pay

否

Boolean

参数解释：

是否自动付费

约束限制：

不涉及

取值范围：

  • true：下单后自动付费

  • false：下单后不自动付费

默认取值：

false

console_url

否

String

参数解释：

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

约束限制：

仅手动支付时涉及。

取值范围：

不涉及

默认取值：

不涉及

vault_ids

是

Array of strings

参数解释：

存储库资源列表，获取存储库ID请参考获取存储库ID

约束限制：

不涉及

取值范围：

单个存储库ID为UUID，可包含1-60个存储库ID

默认取值：

不涉及

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

orderId

String

参数解释：

资源修改的订单ID

取值范围：

不涉及

retCode

Number

参数解释：

变更资源规格的状态响应码

取值范围：

不涉及

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

错误码

请参见错误码。

父主题： 运营

相关文档