功能介绍
更换云服务器的计费模式。

接口约束
仅支持更换按需计费模式为包年/包月计费模式。
更大支持批量更换10个弹性云服务器计费模式。
更换计费模式的云服务器绑定的弹性公网IP类型必须是“独享”,“按带宽计费”。
挂载了共享云硬盘、DSS硬盘以及DESS硬盘的服务器不支持更改计费模式。
若想使用优惠券,请将prepaid_options中的字段auto_pay设置为false,参考“支付包年/包月产品订单”进行支付,或者在华为云控制台使用优惠券进行支付。
不支持专属主机、专属云以及边缘云下的云服务器更换计费模式。
不支持竞价实例更换计费模式。
调试
您可以在API Explorer中调试该接口。
URI
POST /v1/{project_id}/cloudservers/actions/change-charge-mode
参数说明请参见表1。
表1 参数说明
参数
是否必选
描述
project_id
是
项目ID。
获取方法请参见获取项目ID。
请求消息
表2 请求参数
参数
是否必选
参数类型
描述
server_ids
是
Array of String
按需转包年/包月的云服务器ID列表。
charge_mode
是
String
更换后的计费模式。
prePaid: 将当前虚拟机计费方式改为包年/包月计费
prepaid_options
否
Object
包年/包月选项,当charge_mode为prePaid时必选。
详情请参见表3。
dry_run
否
Boolean
是否只预检此次请求。
true:发送检查请求,不更改计费模式。检查项包括是否填写了必需参数、请求格式等。
如果检查不通过,则返回对应错误。
如果检查通过,则返回202状态码。
false:发送正常请求,通过检查后并且执行更改云服务器计费模式操作。
默认值:false
表3 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
是否自动续费。
取值范围:
true: 自动续费
false: 不开启自动续费
默认值:false
响应消息
表4 参数说明
参数
参数类型
描述
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"
}
返回值
请参考通用请求返回值。
错误码
请参考错误码。
华为云共建智能世界云底座[52] 华为公有云专属云主机DeH服务[51] 华为云场景化解决方案[49] 华为公有云产品[44] 华为云云主机[43] 华为云产品服务[43] 华为云服务器应用[43] 华为弹性云服务器[39] 华为公有云架构解决方案[38] 华为云提供的服务[37] 华为虚拟私有云vpc[37] 华为公有云介绍[32] 华为公有云提供哪些计算服务[30] 华为云漏洞扫描[27] 华为云软件开发服务[27] 华为公有云和私有云区别[27] 华为云域名注册[26] 华为云官网登陆[26] 华为公有云解决方案[26] 华为私有云产品有哪些[26] 华为私有云服务[25] 华为云数据库[23] 华为云安全[22] 华为公有云官网[22] 华为私有云的搭建方案[22] 华为云弹性云服务器应用[21] 华为公有云平台[20] 华为公有云行业解决方案[20] 华为私有云解决方案服务定制领导者[20] [19] 华为私有云服务器[19] 华为私有云网格结构[19] 华为公有云视讯解决方案[18] 华为云官网[17] 华为云速建站[17] 华为私有云架构[17] 华为云优势[16] 华为云服务器[16] 华为私有云部署架构[16] 华为云企业邮箱服务 (SAAS[15] 华为云邮箱[15] 华为公有云是什么[15] 华为公有云架构[15] 华为云迁移解决方案[14] 华为公有云解决方案服务定制领导者[14] 华为私有云解决方案[14] 云邮箱)[13] 华为云园区解决方案[13] 华为云服务总代理[13] 华为云速智能客服[13] 华为公有云服务[13] 华为私有云搭建方案[13] 云与计算咨询服务[12] 云与计算培训服务[11] 华为云备份[11] 华为云服务器配置[11] 华为云服务服务中心[11] 华为云服务核心分销商[11] 华为公有云[11] 华为私有云搭建[11] 云迁移与运营支撑服务[10] 公有云私有云混合云[10] 华为云服务器ECS[10] 华为云服务器成功案例[10] 华为云解决方案[10] 华为公有云通用解决方案[9] 华为智慧云课堂解决方案[9] 华为云数据解决方案[8] 华为云是什么[8] 华为私有云平台[8] 云与计算客户支持与运维使能服务[7] 华为云官网网站[7] 华为云智慧教育解决方案[7] 华为云智慧校园解决方案[7] 华为云桌面系统集成商[7] 华为云经销商[7] 华为代理公司有哪些[7] 华为私有云方案[7] 智慧教育云平台解决方案[7] 华为云服务器试用[6] 华为云网站建设服务器[6] 华为手机代理加盟[6] 华为私有云[6] 大数据使能服务[6] 智慧教育云计算解决方案[6] 华为云云主机 [5] 华为云智慧***解决方案[5] 华为云桌面总代理商[5] 云与计算客户支持服务[4] 华为云产品介绍[4] 华为云智慧制造解决方案[4] 华为云场景化解决方案[3] 华为公有云官网[3] 华为公有云通用解决方案[3] 华为弹性云服务器[3] 华为公有云产品 [3] 华为云产品服务[2] 华为云域名注册[2] 华为云数据库[2] 华为云智慧校园解决方案[2] 华为云服务器应用[2] 华为云服务器成功案例[2] 华为云软件开发服务[2] 华为公有云产品[2] 华为公有云介绍[2] 华为公有云和私有云区别[2] 华为公有云服务[2] 华为公有云架构[2] 华为公有云架构解决方案[2] 华为公有云视讯解决方案[2] 华为公有云解决方案[2] 华为私有云产品有哪些[2] 华为私有云服务[2] 华为私有云架构[2] 智慧教育云计算解决方案[2] 云规划设计与实施服务[2] 云邮箱[2] 华为云产品报价[2] 华为公有云通用解决方案 [2] 华为云服务器成功案例[1] 华为云桌面系统集成商[1] 云与计算客户支持与运维使能服务[1] 云迁移与运营支撑服务[1] 云迁移与运营支撑服务 [1] 华为云共建智能世界云底座[1] 华为云备份[1] 华为云安全[1] 华为云官网登陆[1] 华为云弹性云服务器应用[1] 华为云提供的服务[1] 华为云数据解决方案[1] 华为云智慧制造解决方案[1] 华为云服务器[1] 华为云服务核心分销商 [1] 华为云漏洞扫描[1] 华为云迁移解决方案 [1] 华为云速智能客服[1] 华为云邮箱[1] 华为公有云专属云主机DeH服务[1] 华为公有云是什么[1] 华为公有云行业解决方案[1] 华为私有云搭建[1] 华为私有云方案[1] 华为私有云服务.华为公有云专属云主机DeH服务.华为云产品报价[1] 华为私有云的搭建方案[1] 华为私有云网格结构[1] 华为私有云解决方案[1] 华为私有云部署架构[1] 为云产品服务[1] 云与计算咨询服务 [1] 云与计算客户支持与运维使能服务 [1] 云与计算客户支持与运维使能服务 云与计算客户支持服务[1] 华为云是什么 [1] 华为云软件开发服[1] 华为云速智能客服 [1] 华为代理加盟[1] 华为公有云架构解决方案 [1] 华为公有云解决方案服务定制领导者 [1] 华为弹性云[1] 华为弹性云服务器 华为云域名注册 华为云服务器应用[1] 华为私有云搭建 [1] 华为私有云搭建方案 [1] 华为私有云部署架构 [1] 大数据使能服务 [1] 撒[1]