将云电脑的付费类型转为包年包月或按量付费。
接口说明
调用该接口前,请确保您已充分了解云电脑的计费方式。更多信息,请参见计费概述。
调用该接口时,请确保目标云电脑的状态为运行中或者已关机,且当前没有产生欠费。
订单支付完成后系统将开始转换云电脑的计费方式,转换期间云电脑处于变配状态,此时,云电脑不支持进行其他操作,例如开机、关机、变更配置等。
由包年包月转换为按量付费时,存在退款额度限制,请参见包年包月转为按量付费。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
ecd:ModifyDesktopChargeType |
update |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| RegionId |
string |
是 |
地域 ID。可以调用 DescribeRegions 获取无影云电脑支持的地域列表。 |
cn-hangzhou |
| ChargeType |
string |
否 |
要转换的目标计费方式。 枚举值:
|
PrePaid |
| Period |
integer |
否 |
转换成包年包月计费方式时,云电脑的购买时长。单位由
|
1 |
| PeriodUnit |
string |
否 |
转换成包年包月计费方式时,包年包月计费的时长单位。 枚举值:
|
Month |
| AutoPay |
boolean |
否 |
转换成包年包月计费方式时,是否自动支付订单费用。 枚举值:
|
false |
| DesktopId |
array |
是 |
云电脑 ID 列表。可设置 1~20 个。 |
ecd-gx2x1dhsmucyy**** |
|
string |
否 |
云电脑 ID。 |
["ecd-gx2x1dhsmucyy****"] |
|
| PromotionId |
string |
否 |
优惠活动 ID。 |
50003836003**** |
| UseDuration |
integer |
否 |
说明
处于定向邀测中,暂不对外开放。 |
sample |
| ResellerOwnerUid |
integer |
否 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
返回信息集合。 |
||
| OrderId |
string |
订单 ID。 |
123456789 |
| RequestId |
string |
请求 ID。 |
1CBAFFAB-B697-4049-A9B1-67E1FC5F**** |
| DesktopId |
array |
云电脑 ID 列表。如果一次调用创建了多个云电脑,将返回多个云电脑 ID。 |
|
|
string |
云电脑 ID。 |
["ecd-gx2x1dhsmucyy****"] |
|
| TaskId |
string |
示例
正常返回示例
JSON格式
{
"OrderId": "123456789",
"RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****",
"DesktopId": [
"[\"ecd-gx2x1dhsmucyy****\"]"
],
"TaskId": ""
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。