调用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

目标系统盘大小。

UserDiskSizeGib Integer 100

目标数据盘大小。

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"
}