更换云服务器计费模式
功能介绍
更换云服务器的计费模式。
接口约束
- 仅支持更换按需计费模式为包年/包月计费模式。
- 最大支持批量更换10个弹性云服务器计费模式。
- 更换计费模式的云服务器绑定的弹性公网IP类型必须是“独享”,“按带宽计费”。
- 挂载了共享云硬盘、DSS硬盘以及DESS硬盘的服务器不支持更改计费模式。
- 若想使用优惠券,请将prepaid_options中的字段auto_pay设置为false,参考“支付包年/包月产品订单”进行支付,或者在华为云控制台使用优惠券进行支付。
- 不支持专属主机、专属云以及边缘云下的云服务器更换计费模式。
- 不支持竞价实例更换计费模式。
URI
POST /v1/{project_id}/cloudservers/actions/change-charge-mode
请求消息
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
server_ids |
是 |
Array of String |
按需转包年/包月的云服务器ID列表。 |
charge_mode |
是 |
String |
更换后的计费模式。 prePaid: 将当前虚拟机计费方式改为包年/包月计费 |
prepaid_options |
否 |
Object |
包年/包月选项,当charge_mode为prePaid时必选。 详情请参见表3。 |
dry_run |
否 |
Boolean |
是否只预检此次请求。
默认值:false |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
include_data_disks |
否 |
Boolean |
是否连同所有的按需计费的数据盘一起转为包年/包月。 当参数为true时,包括按需非共享云硬盘。 挂载了共享云硬盘、DSS硬盘以及DESS硬盘的的服务器不支持更改计费模式。 默认值:false |
include_publicips |
否 |
Boolean |
是否连同“独享”、“按带宽计费”的弹性公网IP一起转包年/包月。 转包年/包月计费模式后,弹性公网IP转包年/包月之后可以单独解绑,删除等,与云服务器不是一个整体。 默认值:false |
period_type |
是 |
String |
订购周期类型。 取值范围:
|
period_num |
是 |
String |
订购周期的周期数。 取值范围:
|
auto_pay |
否 |
Boolean |
是否自动支付。 取值范围:
默认值:false |
auto_renew |
否 |
Boolean |
是否自动续费。 取值范围:
默认值:false |
响应消息
参数 |
参数类型 |
描述 |
---|---|---|
order_id |
String |
转包年/包月的订单ID。 |
请求示例
更换云服务器及其绑定的“独享”、“按带宽计费”的弹性公网IP的计费模式为包年/包月,订购周期1个月。
POST https://{endpoint}/v1/{project_id}/cloudservers/actions/change-charge-mode { "server_ids": [ "f631ee2c-1caf-4c4f-9cee-f3181b8e44ad" ], "charge_mode": "prePaid", "prepaid_options": { "include_publicips": true, "include_data_disks": false, "period_type": "month", "period_num": "1", "auto_pay": false, "auto_renew": false }, "dry_run": false }
响应示例
{ order_id: "CS2102041657OL0EY" }
返回值
请参考通用请求返回值。
错误码
请参考错误码。