更换云服务器计费模式ChangeServerChargeMode
接口说明
更换 云服务器 的计费模式
约束说明
URL
POST https://ecs.cn-north-1.myhuaweicloud.com/v1/{project_id}/cloudservers/actions/change-charge-mode
请求参数
| 名称 | 类型 | IN | 必选 | 描述 |
|---|---|---|---|---|
|
X-Auth-Token
|
string | header | 是 |
用户Token。 通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
|
project_id
|
string | path | 是 |
项目ID。 |
Body参数
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
server_ids
|
Array of strings | 是 |
云服务器ID列表 |
|
charge_mode
|
string | 是 |
更换后的计费模式:prePaid包周期计费模式 |
|
prepaid_options
|
ChangeServerChargeModePrepaidOption object | 否 |
包周期选项 |
|
dry_run
|
boolean | 否 |
是否预先校验此次请求。 true: 发送检查请求,不触发真正的计费转换操作 false: 发送正常请求,触发计费转换操作。 默认值为false |
参数：
prepaid_options
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
include_data_disks
|
boolean | 否 |
是否连同支持的按需数据盘一起转为包周期。 当参数为true,包括按需非共享的数据盘,不包括共享云硬盘,DSS和DESS硬盘 默认值为false |
|
include_publicips
|
boolean | 否 |
是否连同弹性 公网IP 一起转为包周期 只有“独享”、“按带宽计费”的弹性公网IP才可以转换为包周期计费模式 默认值为false |
|
period_type
|
string | 是 |
订购周期类型,取值范围: month-月 year-年 |
|
period_num
|
string | 是 |
订购周期的周期数。 取值范围: period_type=month时,取值范围为[1,9]。 period_type=year时,取值范围为[1,3]。 |
|
auto_pay
|
boolean | 否 |
是否自动支付。 true:自动支付,需要确保账户余额充足,如果余额不足则会生成异常订单,只能作废此订单 false:只生成订单不扣费 默认值为false |
|
auto_renew
|
boolean | 否 |
是否自动续费。默认值:false |
返回参数
返回码: 200
OK
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
order_id
|
string | 是 |
按需转包提交后返回的订单ID,用户可以使用该ID对订单结果进行查询。 |
请求示例
示例 1
"POST https://{endpoint}/v1/{project_id}/cloudservers/actions/change-charge-mode"
{ "server_ids": [ "6acbe5aa-2e41-4d41-9d1e-59957e1b79f3" ], "charge_mode": "prePaid", "prepaid_options": { "include_publicips": "false", "include_data_disks": "false", "period_type": "month", "period_num": "1", "auto_pay": "true", "auto_renew": "false" }, "dry_run": "false" }
返回示例
返回码：200
OK
示例 1
{
"order_id": "CS2209141549862WI"
}
"order_id": "CS2209141549862WI"
}
SDK
点击 弹性云服务器 (ECS) SDK, 下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。
错误码
请参考 错误码说明。
