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

修改付费模式 - ChangeVaultChargeMode

功能介绍

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

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

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

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

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

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

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

错误码

请参见错误码。

父主题：运营

相关文档