更换云服务器计费模式
功能介绍
更换云服务器的计费模式。
接口约束
- 仅支持更换按需计费模式为包年/包月计费模式。
 - 最大支持批量更换10个弹性云服务器计费模式。
 - 更换计费模式的云服务器绑定的弹性公网IP类型必须是“独享”,“按带宽计费”。
 - 挂载了共享云硬盘、DSS硬盘以及DESS硬盘的服务器不支持更改计费模式。
 - 若想使用优惠券,请将prepaid_options中的字段auto_pay设置为false,参考“支付包年/包月产品订单”进行支付,或者在华为云控制台使用优惠券进行支付。
 - 不支持专属主机、专属云以及边缘云下的云服务器更换计费模式。
 - 不支持竞价实例更换计费模式。
 
调试
您可以在API Explorer中调试该接口。
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  | 
      
        参数解释: 是否连同所有的按需计费的数据盘一起转为包年/包月。 约束限制: 挂载了共享云硬盘、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"
}
 返回值
请参考通用请求返回值。
错误码
请参考错误码。