调用ModifyDesktopSpec变更云桌面配置，包括修改vCPU和内存规格，以及扩容磁盘。

接口说明

变更桌面配置包括修改桌面规格和扩容磁盘。

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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ModifyDesktopSpec

系统规定参数。取值：ModifyDesktopSpec。

RegionId String 是 cn-hangzhou

地域ID。
DesktopId String 是 ecd-4543qyik164a4****

云桌面ID。
DesktopType String 否 eds.general.2c8g

目标云桌面规格。

您可以调用DescribeDesktopTypes查询云桌面支持的规格ID。

RootDiskSizeGib Integer 否 80

目标系统盘容量，单位为GiB。取值范围：80~500 GiB，且必须为10的倍数。
UserDiskSizeGib Integer 否 100

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

  • 桌面规格为非图形型时，取值范围为20~1020 GiB，且必须为10的倍数。
  • 桌面规格为图形型时，取值范围为40~1020 GiB，且必须为10的倍数。
AutoPay Boolean 否 false

是否自动支付。取值范围：

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

默认值：true。

返回数据

名称 类型 示例值 描述
OrderId String 123456789

订单ID。
RequestId String 3EB7FCEE-D731-4948-85A3-4B2C341CA983

请求ID。

示例

请求示例

https://ecd.cn-hangzhou.aliyuncs.com/?Action=ModifyDesktopSpec
&DesktopId=ecd-4543qyik164a4****
&RegionId=cn-hangzhou
&DesktopType=eds.general.2c8g
&<公共请求参数>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyDesktopSpecResponse>
    <RequestId>3EB7FCEE-D731-4948-85A3-4B2C341CA983</RequestId>
    <OrderId>123456789</OrderId>
</ModifyDesktopSpecResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "3EB7FCEE-D731-4948-85A3-4B2C341CA983",
  "OrderId" : "123456789"
}