首页 无影云桌面 API参考(云桌面管控) API目录 桌面 ModifyDesktopChargeType - 修改云桌面付费类型

ModifyDesktopChargeType - 修改云桌面付费类型

转换云桌面的计费方式。

接口说明

  • 调用该接口前,请确保您已充分了解云桌面的计费方式。更多信息,请参见计费概述
  • 调用该接口时,请确保目标云桌面的状态为运行中或者已关机,且当前没有产生欠费。
  • 订单支付完成后系统将开始转换云桌面的计费方式,转换期间桌面处于变配状态,此时,云桌面不支持进行其它操作,例如开机、关机、变更配置等。
  • 由包年包月转换为按量付费时,存在退款额度限制,请参见包年包月转为按量付费

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
RegionIdstring

地域ID。可以调用DescribeRegions获取无影云桌面支持的地域列表。

cn-hangzhou
ChargeTypestring

云桌面要转换的目标计费方式。

PrePaid
Periodinteger

转换成包年包月计费方式时,云桌面的购买时长。单位由PeriodUnit指定。当参数ChargeType取值为PrePaid时才生效,且为必选值。

  • 如果PeriodUnitWeek,该参数的取值范围为{1}。
  • 如果PeriodUnitMonth,该参数的取值范围为{1, 2, 3, 6}。
  • 如果PeriodUnitYear,该参数的取值范围为{1, 2, 3, 4, 5}。
1
PeriodUnitstring

转换成包年包月计费方式时,包年包月计费的时长单位。

Month
AutoPayboolean

转换成包年包月计费方式时,是否自动支付订单费用。

false
DesktopIdarray

云桌面ID。可设置1~20个。

string

云桌面ID。

["ecd-gx2x1dhsmucyy****"]
PromotionIdstring

优惠活动ID。

500038360030606

返回参数

名称类型描述示例值
object

返回信息集合。

OrderIdstring

订单ID。

123456789
RequestIdstring

请求ID。

1CBAFFAB-B697-4049-A9B1-67E1FC5F****
DesktopIdarray

云桌面ID数组。如果一次调用创建了多个云桌面,将返回多个云桌面ID。

string

云桌面ID。

["ecd-gx2x1dhsmucyy****"]

示例

正常返回示例

JSON格式

{
  "OrderId": "123456789",
  "RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****",
  "DesktopId": [
    "[\"ecd-gx2x1dhsmucyy****\"]"
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2021-09-27新增 OpenAPI
2021-09-27OpenAPI 入参发生变更
变更项变更内容
入参OpenAPI 入参发生变更
    新增入参:PromotionId
阿里云首页 无影云桌面 相关技术圈