设置包年/包月资源即时转按需-UpdatePeriodToOnDemandInstantly
功能介绍
客户在自建平台完成包年/包月资源即时转为按需资源计费。转按需时，会退订费用。
- 客户需要成功支付包年/包月资源订单后，才能操作资源的即时转按需。
- 在调用本接口前，您可以调用“2.1-查询客户包年/包月资源列表-ListPayPerUseCustomerResources”接口获取资源ID、资源过期时间以及资源过期后的扣费策略等信息。
- 包年/包月资源即时转按需后，包年/包月资源将自动变成按需计费。
REST API
该接口只允许使用客户AK/SK或者Token调用。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见策略授权参考。
- 如果使用身份策略授权，需具备如下身份策略权限。
授权项
描述
访问级别
资源类型（*为必须）
条件键
别名
billing:subscription:toDemand
授予即时转按需的权限。
write
-
-
-
URI
POST /v2/orders/subscriptions/resources/to-on-demand/instantly
参数说明请参见下表。
请求消息
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| resource_ids | 是 | list<string> | 参数解释： 资源ID列表。 约束限制： 只支持传入主资源ID，最多10个资源ID。 哪些资源是主资源请根据“查询客户包年/包月资源列表-ListPayPerUseCustomerResources”接口响应参数中的“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 | 参数解释： 状态码。具体请参见状态码。只有失败才返回该字段。 取值范围： 最大长度：20 |
| error_msg | String | 参数解释： 错误描述信息。只有失败才返回该字段。 取值范围： 最大长度：1000 |
| to_ondemand_service_results | List<ToOndemandServiceResult> | 参数解释： 包年/包月即时转按需结果。HTTP 200的时候返回该字段，具体参见表 ToOndemandServiceResult。 取值范围： 最大个数：100 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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": []
} 状态码
- 状态码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 | 其他错误。 |
