# 设置包年/包月资源即时转按需-UpdatePeriodToOnDemandInstantly
#### **功能介绍**
客户在自建平台完成包年/包月资源即时转为按需资源计费。转按需时，会退订费用。
![](https://support.huaweicloud.com/api-oce/public_sys-resources/note_3.0-zh-cn.png)
- 客户需要成功支付包年/包月资源订单后，才能操作资源的即时转按需。
- 在调用本接口前，您可以调用"[2.1-查询客户包年/包月资源列表-ListPayPerUseCustomerResources](https://support.huaweicloud.com/api-oce/api_order_00021.html)"接口获取资源ID、资源过期时间以及资源过期后的扣费策略等信息。
- 包年/包月资源即时转按需后，包年/包月资源将自动变成按需计费。
 
#### **REST API**
该接口只允许使用客户AK/SK或者Token调用。
#### **调试**
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=BSS&api=UpdatePeriodToOnDemandInstantly)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### **授权信息**
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[策略授权参考](https://support.huaweicloud.com/api-oce/jac_000053.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                           | 描述          | 访问级别  | 资源类型（\*为必须） | 条件键 | 别名 |
  |:---|:---|:---|:---|:---|:---|
  | billing:subscription:toDemand | 授予即时转按需的权限。 | write | -           | -   | -  |
     
  
 
#### **URI**
POST /v2/orders/subscriptions/resources/to-on-demand/instantly
参数说明请参见下表。
#### **请求消息**
**请求参数**
| 参数           | 是否必选 | 参数类型           | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|:---|
| resource_ids | 是    | list\<string\> | **参数解释：** 资源ID列表。 **约束限制**： 只支持传入主资源ID，最多10个资源ID。 哪些资源是主资源请根据"[查询客户包年/包月资源列表-ListPayPerUseCustomerResources](https://support.huaweicloud.com/api-oce/api_order_00021.html)"接口响应参数中的"is_main_resource"来标识。 **取值范围：** \[1,10\] **默认取值：** 不涉及 |
   
**请求示例**
```
POST bss.myhuaweicloud.com/v2/orders/subscriptions/resources/to-on-demand/instantly HTTP/1.1
Content-Type: application/json
X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
{
"resource_ids":["0c3248018ed54b1e8e3ecbab1b0989ce"]
}
```
#### **响应消息**
**响应参数**
| 参数                          | 参数类型                            | 描述                                                                                                                                                                                                                                                       |
|:---|:---|:---|
| error_code                  | String                          | **参数解释：** 状态码。具体请参见[状态码](https://clouddevops.huawei.com/domains/20472/wiki/3/WIKI2026050801211#section633335222618)。只有失败才返回该字段。 **取值范围：** 最大长度：20 |
| error_msg                   | String                          | **参数解释：** 错误描述信息。只有失败才返回该字段。 **取值范围：** 最大长度：1000                                                                                                        |
| to_ondemand_service_results | List\<ToOndemandServiceResult\> | **参数解释：** 包年/包月即时转按需结果。HTTP 200的时候返回该字段，具体参见[表 ToOndemandServiceResult]。 **取值范围：** 最大个数：100                     |
   
 表1ToOndemandServiceResult 
| 参数                                              | 参数类型   | 描述                                                                                                                                                                                                                                          |
|:---|:---|:---|
| resource_id                                     | String | **参数解释：** 资源ID。 **取值范围：** 最大长度：64                                                                                                    |
| result                                          | String | **参数解释：** 转按需结果。 **取值范围** **：** SUCCESS：成功。 AUDIT：审核中。 FAIL：转按需失败。 |
| error_code                                      | String | **参数解释：** 状态码。具体请参见[状态码]。 **取值范围** **：** 最大长度：20                                               |
| error_msg  | String | **参数解释：** 错误描述信息。 **取值范围** **：** 最大长度：1000                                                                                               |
| order_id                                        | String | **参数解释：** 订单ID。 result= SUCCESS、 AUDIT时，有值 **取值范围** **：** 最大长度：64                                     |
   
**响应示例**
```
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time
{
    "to_ondemand_service_results": []
}
```
 #### 状态码
![](https://support.huaweicloud.com/api-oce/public_sys-resources/note_3.0-zh-cn.png)
- 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。
- 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。
 
| HTTP状态码 | 错误码          | 描述                                     |
|:---|:---|:---|
| 400     | CBC.0100     | 参数错误。                                  |
| 400     | CBC.30000078 | 请求的包含子资源ID，不能进行转按需操作。                  |
| 400     | CBC.30000079 | 请求的包含无效资源ID，不能进行转按需操作。                 |
| 400     | CBC.99000098 | 请求的资源包含按需资源，不能进行转按需操作。                 |
| 400     | CBC.99003626 | 账号已经被冻结，不允许设置转按需。                      |
| 200     | CBC.30010062 | 该产品不支持包年包月即时转按需。                       |
| 200     | CBC.30010055 | 已冻结资源不允许转按需。                           |
| 200     | CBC.30010056 | 已过期实例不允许转按需。                           |
| 200     | CBC.30000077 | 请求的其他资源转按需失败导致资源无法转按需，建议去掉其他失败的资源重新发起。 |
| 403     | CBC.0151     | 访问拒绝。                                  |
| 500     | CBC.0999     | 其他错误。                                  |