You need to enable JavaScript to run this app.
导航
ModifyVolumeChargeType
最近更新时间:2024.11.01 18:49:26首次发布时间:2022.04.01 17:25:43

调用ModifyVolumeChargeType接口转换云盘的计费方式。

调试

注意事项

类别注意事项

按量计费转包年包月

  • 只有挂载在包年包月ECS实例上的按量计费数据盘可以单独转换成包年包月数据盘,数据盘到期时间与ECS实例到期时间一致。

  • 按量计费系统盘如果需要转换为包年包月,只能与挂载的ECS实例同时转换,具体步骤,请参见按量计费转包年包月

包年包月转按量计费

  • 包年包月系统盘如果需要转换为按量计费,只能与挂载的ECS实例同时转换,具体步骤,请参见包年包月转按量计费。包年包月数据盘支持单独转换为按量计费,也支持随实例一起转换。

  • 包年包月云盘转换为按量计费后,平台将扣除已使用金额,退还剩余订单实付金额(以现金方式支付的订单金额,不包含代金券抵扣的部分)至您的火山引擎账户余额中,已使用的代金券不支持退还。退款金额详细计算规则,请参见退订说明

请求参数

名称类型是否必填示例值描述

Action

String

ModifyVolumeChargeType

要执行的操作,取值:ModifyVolumeChargeType

VersionString2020-04-01API的版本,取值:2020-04-01。

VolumeIds.N

String

VolumeIds.1=vol-3tiz8tg97u3vj0x0**** VolumeIds.2=vol-3tj20xxpd63vj0wy****

需要转换计费方式的云盘ID列表。

注意

支持批量转换,只有挂载在同一实例上的数据盘才能批量转换。

DiskChargeType

String

PrePaid

云盘计费方式。取值说明如下:

  • PrePaid:按量计费数据盘转换为包年包月数据盘。
  • PostPaid:包年包月数据盘转换为按量计费数据盘。

InstanceId

String

i-bp1i778bq705cvx1****

云盘挂载的实例ID。

注意

只有挂载在包年包月实例上的按量计费数据盘才能转换为包年包月。

AutoPay

Boolean

true

是否自动支付。取值说明如下:

  • true(默认):自动支付。您需要确保账户余额充足,如果账户余额不足会生成异常订单,只能作废订单。
  • false:只生成订单不扣费。如果您的账户余额不足,会生成正常的未支付订单,此订单可登录ECS控制台支付。

返回数据

名称类型示例值说明
NumberStringOrder708151602546642****返回的订单号。

请求示例

GET /?Action=ModifyVolumeChargeType&DiskChargeType=PrePaid&VolumeIds.1=vol-3tiz8tg97u3vj0x0****&VolumeIds.2=vol-3tj20xxpd63vj0wy****&InstanceId=i-l2soxrgan390t1dk**** HTTP/1.1
Host: open.volcengineapi.com
Region: cn-beijing
X-TT-Logid:  202106232008120102251331430A0D7B20

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2022040115591901022524315306A6****",
        "Action": "ModifyVolumeChargeType",
        "Version": "2020-04-01",
        "Service": "storage_ebs",
        "Region": "cn-beijing"
    },
    "Result": {
        "Number": "Order708151602546642****"
    }
}

错误码

HttpCode
错误码
错误信息描述
400MissingParameter.InstanceIdNotSupportedInstanceId should not be null.参数InstanceId不能为空。
400InvalidInstanceId.ReleasedThe specified Instance is not exist.指定的实例不存在,请您检查实例ID是否正确。
400InvalidInstance.UnPaidOrderThe specified Instance has unpaid order.指定的实例有未支付的订单,请您先支付再进行操作。
400Account.ArrearageYour account has been in arrears.账户余额不足,请先充值再操作。
400InvalidInstanceType.ValueUnauthorizedThe specified InstanceType is not Supported.您没有操作此实例规格的权限。
400OrderCreationFailedCreate Order failed, please check your parameters and try it later.创建订单失败,请检查您的参数,然后再试。