ModifyDesktopChargeType - 修改云电脑付费类型

将云电脑的付费类型转为包年包月或按量付费。

接口说明

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

由包年包月转换为按量付费时,存在退款额度限制,请参见包年包月转为按量付费

调试

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

授权信息

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

请求参数

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

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

cn-hangzhou
ChargeTypestring

要转换的目标计费方式。

枚举值:
  • PostPaid由包年包月转换为按量付费
  • PrePaid由按量付费转换为包年包月
PrePaid
Periodinteger

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

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

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

枚举值:
  • Month月 [默认值]
  • Year
  • Week
Month
AutoPayboolean

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

枚举值:
  • true自动支付。请确保账户余额充足,否则会产生异常订单。 [默认值]
  • false只产生订单,不支付。您可以登录控制台,在用户中心的我的订单页面,根据返回的订单号进行支付。
false
DesktopIdarray

云电脑 ID 列表。可设置 1~20 个。

string

云电脑 ID。

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

优惠活动 ID。

50003836003****
UseDurationinteger
说明 处于定向邀测中,暂不对外开放。
sample

返回参数

名称类型描述示例值
object

返回信息集合。

OrderIdstring

订单 ID。

123456789
RequestIdstring

请求 ID。

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

云电脑 ID 列表。如果一次调用创建了多个云电脑,将返回多个云电脑 ID。

DesktopIdsstring

云电脑 ID。

["ecd-gx2x1dhsmucyy****"]

示例

正常返回示例

JSON格式

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

错误码

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

变更历史

变更时间变更内容概要操作
2023-07-19OpenAPI 入参发生变更查看变更详情
2021-09-27新增 OpenAPI查看变更详情
2021-09-27OpenAPI 入参发生变更查看变更详情