调用ModifyInstanceChargeType更换一台或者多台ENS实例的计费方式。支持在实例级后付费实例和包年包月实例间相互转换,同时针对实例级后付费实例可以将随实例创建的后付费云盘转换为包年包月云盘。
接口说明
请确保在使用该接口前,已充分了解 ENS 产品的收费方式和价格。
目标实例的状态必须为运行中或者已停止,并且无欠费的情况下才能修改计费方式。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
InstanceIds | array | 是 | 实例 ID 列表。 | |
string | 是 | 实例 ID。 | i-5xlrc9wdeo3xxxxxx | |
InstanceChargeType | string | 是 | 实例需要修改的目标计费方式。取值: PrePaid:将实例级后付费实例转换为包年包月实例。 PostPaid:将包年包月实例转换为实例级后付费实例(默认值)。 | PostPaid |
AutoRenew | boolean | 否 | 实例级后付费转为包年包月的时候是否开启自动续费。取值: true:自动续费。 false:不自动续费(默认值)。 | false |
Period | string | 否 | 实例级后付费转为包年包月的时候的包年包月时长,如果是此场景下该字段必填。取值: 如果 PeriodUnit 取值为 Day 时,则 Period 仅可设置为 3。 如果 PeriodUnit 取值为 Month 时,则 Period 可设置为 1-9,12。 | 1 |
PeriodUnit | string | 否 | 实例级后付费转为包年包月的时候的购买资源的时长单位,如果是此场景下该字段必填。取值: Month:按月购买。 Day:按天购买。 | Month |
IncludeDataDisks | boolean | 否 | 实例级后付费转为包年包月的时候是否将随实例创建的所有按量付费数据盘一起转换为包年包月数据盘。取值: true:是。 false:否(默认值)。 | true |
AutoPay | boolean | 否 | 实例级后付费转为包年包月的时候是否自动支付。取值: true:自动支付,您需要确保账户余额充足。 false:只生成订单不扣费(默认值)。 | false |
返回参数
示例
正常返回示例
JSON
格式
{
"RequestId": "E2CE5821-7A18-5F7B-A18A-1C751B933D2A",
"InstanceIds": [
"i-5xu1chy7ckxxxx"
],
"OrderId": 0
}
错误码
HTTP status code | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | NoPermission | Permission denied. | 没有足够的权限,请联系云账号管理员授予您相应权限。 |
400 | InvalidParameter.%s | The specified field %s invalid. Please check it again. | - |
访问错误中心查看更多错误码。