使用ModifyDesktopSpec变更云电脑规格或扩容磁盘-无影云电脑企业版-阿里云-无影云电脑企业版-阿里云帮助中心

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

接口说明

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

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

调试

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

调试

授权信息

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

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ecd:ModifyDesktopSpec

update

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	地域 ID。可以调用 DescribeRegions 获取无影云电脑支持的地域列表。	cn-hangzhou
DesktopId	string	否	云电脑 ID。	ecd-4543qyik164a4****
DesktopType	string	是	目标规格。您可以调用 DescribeDesktopTypes 查询云电脑支持的规格。	eds.general.2c4g
RootDiskSizeGib	integer	否	目标系统盘容量，单位为 GiB。取值范围：80~500 GiB，且必须为 10 的倍数。	80
UserDiskSizeGib	integer	否	目标数据盘容量，单位为 GiB。对于非图形型规格，取值范围为 20~1020 GiB，且必须为 10 的倍数。对于图形型规格，取值范围为 40~1020 GiB，且必须为 10 的倍数。	40
AutoPay	boolean	否	是否自动支付。枚举值： true : 自动支付。请确保账号余额充足，否则会产生异常订单 [默认值] false : 只产生订单，不支付。您可以登录控制台，在用户中心的我的订单页面，根据返回的订单号进行支付	false
UserDiskPerformanceLevel	string	否	数据盘性能等级。枚举值： PL1 : PL1 PL0 : PL0 [默认值] PL3 : PL3 PL2 : PL2	PL0
PromotionId	string	否	优惠活动 ID。	50003308011****
ResourceSpecs	array<object>	否	资源规格模板列表。
	object	否	资源规格模板。
DesktopId	string	否	云电脑 ID。	ecd-4543qyik164a4****
RootDiskSizeGib	integer	否	目标系统盘容量，单位为 GiB。取值范围：80~500 GiB，且必须为 10 的倍数。	80
UserDiskSizeGib	integer	否	目标数据盘容量，单位为 GiB。取值范围：20~2040 GiB，且必须为 10 的倍数。	20
ResourceType	string	否	资源类型。说明非按月购买云电脑可不填。枚举值： DesktopMonthPackage : 按月购买云电脑	DesktopMonthPackage
ResellerOwnerUid	integer	否

返回参数

名称	类型	描述	示例值
	object	返回信息集合。
OrderId	string	订单 ID。	123456789
RequestId	string	请求 ID。	1CBAFFAB-B697-4049-A9B1-67E1FC5F****
OrderIds	array	订单 ID 列表。
	integer	订单 ID 信息。	123456789

示例

正常返回示例

JSON格式

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

错误码

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

变更历史

更多信息，参考变更详情。