文档

ModifyDesktopSpec - 变更云电脑配置

更新时间:

变更云电脑的规格和扩容磁盘。

接口说明

变更云电脑配置包括修改规格和扩容磁盘。

  • 变更前,请先了解云电脑支持哪些规格和磁盘大小。详细信息,请参见云电脑规格。您可以调用 DescribeDesktopTypes 查询云电脑支持的规格。
  • 变更时,您至少要更改云电脑规格、系统盘大小和数据盘大小中的一项配置,即至少要传入DesktopTypeRootDiskSizeGibUserDiskSizeGib中的一个参数。相关注意事项如下:
    • 云电脑规格包含 vCPU、内存和 GPU 的配置,仅支持从一个规格变更到另一个规格,不能单独修改其中一个配置。
    • 变更规格时,通用办公型规格和非通用办公型规格之间不支持互相变更,图形型规格和非图形型规格之间不支持互相变更。
    • 系统盘和数据盘均支持扩容,但不支持缩容。
    • 如果云电脑的计费方式为包年包月,系统将根据变更前后的差异计算费用差价,您需要补差价或者接收差价退款。
    • 对于同一台云电脑,建议将两次操作变更配置的间隔保持在 5 分钟以上。
    • 云电脑的状态必须为已关机(Stopped)。
  • 变更后,不会影响云电脑上存储的个人数据。

调试

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

授权信息

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

请求参数

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

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

cn-hangzhou
DesktopIdstring

云电脑 ID。

ecd-4543qyik164a4****
DesktopTypestring

目标规格。您可以调用 DescribeDesktopTypes 查询云电脑支持的规格。

eds.general.2c4g
RootDiskSizeGibinteger

目标系统盘容量,单位为 GiB。取值范围:80~500 GiB,且必须为 10 的倍数。

80
UserDiskSizeGibinteger

目标数据盘容量,单位为 GiB。

  • 对于非图形型规格,取值范围为 20~1020 GiB,且必须为 10 的倍数。
  • 对于图形型规格,取值范围为 40~1020 GiB,且必须为 10 的倍数。
40
AutoPayboolean

是否自动支付。

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

数据盘性能等级。默认值:PL0。

枚举值:
  • PL1PL1
  • PL0PL0
  • PL3PL3
  • PL2PL2
PL0
PromotionIdstring

优惠活动 ID。

50003308011****

返回参数

名称类型描述示例值
object

返回信息集合。

OrderIdstring

订单 ID。

123456789
RequestIdstring

请求 ID。

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

示例

正常返回示例

JSON格式

{
  "OrderId": "123456789",
  "RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****"
}

错误码

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

变更历史

变更时间变更内容概要操作
2023-12-12API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
2021-08-19OpenAPI 入参发生变更看变更集
变更项变更内容
入参OpenAPI 入参发生变更
    新增入参:PromotionId
2021-08-19OpenAPI 入参发生变更看变更集
变更项变更内容
入参OpenAPI 入参发生变更
    新增入参:UserDiskPerformanceLevel
  • 本页导读 (0)
文档反馈