# 修改付费模式 - ChangeVaultChargeMode
#### 功能介绍
修改资源的付费模式，暂时只支持按需资源转包周期资源。
![](https://support.huaweicloud.com/api-cbr/public_sys-resources/note_3.0-zh-cn.png)
该接口目前属于公测阶段，部分Region暂时无法使用。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cbr/cbr_04_0017.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
POST /v3/{project_id}/vaults/change-charge-mode
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释：** 项目ID，获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-cbr/cbr_04_0022.html) **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
   
#### 请求参数
表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](https://support.huaweicloud.com/api-cbr/ListVault.html) **约束限制：** 不涉及 **取值范围：** 单个存储库ID为UUID，最多可包含60个存储库ID **默认取值：** 不涉及                                                                                                                                                                                                                                                                                                                                    |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数      | 参数类型   | 描述                                                                                                                                                              |
|:---|:---|:---|
| orderId | String | **参数解释：** 资源修改的订单ID **取值范围：** 不涉及    |
| retCode | Number | **参数解释：** 变更资源规格的状态响应码 **取值范围：** 不涉及 |
| retMsg  | String | **参数解释：** 变更的信息 **取值范围：** 不涉及        |
   
#### 请求示例
按需存储库转包周期
```
POST https://{endpoint}/v3/{project_id}/vaults/change-charge-mode
{
  "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**
```
{
  "orderId" : "CS2305291628MSG5A",
  "retCode" : 0,
  "retMsg" : "success"
}
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 200 | OK |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-cbr/ErrorCode.html)。