ModifyDesktopSpec - 变更云电脑配置

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

接口说明

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

  • 变更前,请先了解云电脑支持哪些规格和磁盘大小。详细信息,请参见云电脑规格。您可以调用 DescribeDesktopTypes 查询云电脑支持的规格。

  • 变更时,您至少要更改云电脑规格、系统盘大小和数据盘大小中的一项配置,即至少要传入DesktopTypeRootDiskSizeGibUserDiskSizeGib中的一个参数。相关注意事项如下:

    • 云电脑规格包含 vCPU、内存和 GPU 的配置,仅支持从一个规格变更到另一个规格,不能单独修改其中一个配置。
    • 变更规格时,通用办公型规格和非通用办公型规格之间不支持互相变更,图形型规格和非图形型规格之间不支持互相变更。
    • 系统盘和数据盘均支持扩容,但不支持缩容。
    • 如果云电脑的购买方式为按月购买,系统将根据变更前后的差异计算费用差价,您需要补差价或者接收差价退款。
    • 对于同一台云电脑,建议将两次操作变更配置的间隔保持在 5 分钟以上。
    • 云电脑的状态必须为已关机(Stopped)。
  • 变更后,不会影响云电脑上存储的个人数据。

调试

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

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
ecd:ModifyDesktopSpecupdate
*全部资源
*

请求参数

名称类型必填描述示例值
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

数据盘性能等级。

枚举值:
  • PL1PL1
  • PL0PL0 [默认值]
  • PL3PL3
  • PL2PL2
PL0
PromotionIdstring

优惠活动 ID。

50003308011****
ResourceSpecsarray<object>

资源规格模板列表。

object

资源规格模板。

DesktopIdstring

云电脑 ID。

ecd-4543qyik164a4****
RootDiskSizeGibinteger

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

80
UserDiskSizeGibinteger

目标数据盘容量,单位为 GiB。取值范围:20~2040 GiB,且必须为 10 的倍数。

20
ResourceTypestring

资源类型。

说明 非按月购买云电脑可不填。
DesktopMonthPackage

返回参数

名称类型描述示例值
object

返回信息集合。

OrderIdstring

订单 ID。

123456789
RequestIdstring

请求 ID。

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

订单 ID 列表。

orderIdslong

订单 ID 信息。

123456789

示例

正常返回示例

JSON格式

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

错误码

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

变更历史

变更时间变更内容概要操作
2024-06-17OpenAPI 入参发生变更、OpenAPI 返回结构发生变更查看变更详情
2023-12-12API 内部配置变更,不影响调用查看变更详情
2021-08-19OpenAPI 入参发生变更查看变更详情
2021-08-19OpenAPI 入参发生变更查看变更详情