ModifyInstanceChargeType
本接口用于修改一台或者多台ECS实例的计费方式。您可以通过此接口实现按量付费实例和包年包月实例之间的相互转换,同时支持您将实例挂载的所有按量付费云盘转换为包年包月云盘
服务地址:
华东1 金融云
输入参数
只看必填
InstanceIds实例ID
RegionId实例所属的地域ID
Period包年包月续费时长
PeriodUnit续费时长的时间单位
IncludeDataDisks是否将实例挂载的所有按量付费数据盘一起...
请选择布尔值
DryRun是否只预检此次请求
请选择布尔值
AutoPay是否自动支付
请选择布尔值
InstanceChargeType实例需要修改的目标计费方式
IsDetailFee包年包月转换为按量计费时
请选择布尔值
幂等性参数
ClientToken保证请求幂等性
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

请确保在使用该接口前,您已充分了解云服务器 ECS的计费方式和产品定价。

调用该接口时,您需要注意:

  • 目标实例的状态必须为运行中Running)或者已停止Stopped),并且无欠费的情况下才能修改计费方式。
  • 更换计费方式后,默认自动扣费。您需要确保账户余额充足,否则会生成异常订单,此时只能作废订单。如果您的账户余额不足,可以将参数AutoPay置为false,此时会生成正常的未支付订单,您可以登录 ECS 管理控制台支付。
  • 包年包月转按量付费
    • 是否支持包年包月转按量付费功能,是根据您的云服务器使用情况而定的。

    • 包年包月实例转按量实例的时候,新计费方式将覆盖实例的整个生命周期。您会收到修改前后的实例计费的价格差退款,退还到您的原付款渠道中,已使用的代金券将不退回。更多信息,请参见退款规则

    • 退款规则:您在一个月内能自由操作的退款额度有限且不累计,消耗完退款额度后,只能等待次月转换计费方式。一次转换计费消耗的退款额度公式为vCPU 数 *(退款天数*24±浮动小时数)

  • 按量付费转包年包月
    • 支持将实例挂载的所有按量付费数据盘同时转换为包年包月数据盘。
    • 如果按量付费实例已经设置了释放时间,则不能调用该接口。

请求参数

字段名称字段详情
InstanceIdsstring

实例 ID。取值可以由多台实例 ID 组成一个 JSON 数组,最多支持 20 个 ID,ID 之间用半角逗号(,)隔开。

示例值:["i-bp67acfmxazb4p****","i-bp67acfmxazb4d****"]参考取值来源:
    RunInstances
    StopInstances
    StartInstances
    RebootInstances
    DescribeInstances
    CreateInstance
    RenewReservedInstances
    ModifyReservedInstances
    GetInstanceScreenshot
    DeregisterManagedInstance
    DetachInstanceRamRole
    AttachInstanceRamRole
    PurchaseReservedInstancesOffering
RegionIdstring

实例所属的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

示例值:cn-hangzhou参考取值来源:
    DescribeRegions
Periodinteger<int32>

包年包月续费时长。如果 ECS 实例的宿主机为专有宿主机 DDH,则取值范围不能超过专有宿主机的订阅时长。取值范围:展开详情

示例值:1
PeriodUnitstring

续费时长的时间单位,即参数Period的单位。取值范围:展开详情

示例值:Month
IncludeDataDisksboolean

是否将实例挂载的所有按量付费数据盘一起转换为包年包月数据盘。展开详情

示例值:false
DryRunboolean

是否只预检此次请求。取值范围:展开详情

示例值:false
AutoPayboolean

是否自动支付。取值范围:展开详情

示例值:false
InstanceChargeTypestring

实例需要修改的目标计费方式。取值范围:展开详情

示例值:PrePaid参考取值来源:
    DescribeInstances
ClientTokenstring

保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符,且不能超过 64 个字符。更多信息,请参见如何保证幂等性

示例值:123e4567-e89b-12d3-a456-426655440000
IsDetailFeeboolean

包年包月转换为按量计费时,是否返回订单费用详情。取值范围:展开详情

示例值:false

返回参数

字段名称字段详情
OrderIdstring

生成的订单 ID。

示例值:20413515388****
RequestIdstring

请求 ID。

示例值:B61C08E5-403A-46A2-96C1-F7B1216DB10C
FeeOfInstancesobject
变更历史
变更时间变更内容概要操作
2024-09-27
变更错误码400
2023-07-21
变更错误码500
2021-07-08
变更错误码400