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

接口说明

调用本接口变更云桌面配置前,请先了解云桌面支持哪些规格和磁盘大小。更多信息,请参见桌面规格概述

变更桌面配置的相关注意事项如下:

  • 桌面规格包含vCPU、内存和GPU的配置,变更时,需要同时变更,即:仅支持从一个规格变更到另一个规格,不能单独修改其中一个配置。
  • 变更规格时,通用办公型规格和非通用办公型规格之间不支持互相变更,图形型规格和非图形型规格之间不支持互相变更。
  • 系统盘和数据盘均支持扩容,但不支持缩容。
  • 如果云桌面的计费方式为包年包月,系统将根据变更前后的差异计算费用差价,您需要补差价或者接收差价退款。
  • 对于同一台云桌面,两次操作变更配置的时间建议间隔5分钟以上。

调试

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

请求参数

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

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

DesktopId String ecd-4543qyik164a4****

云桌面ID。

RegionId String cn-hangzhou

地域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格式

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

JSON格式

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