Changes the cloud desktop configurations. You can change the specifications of vCPUs and memory, and resize disks.

Description

Before you call this operation to change the configurations of a cloud desktop, take note of the desktop types provided by Elastic Desktop Service (EDS) and the disk sizes. For more information, see Cloud desktop types.

When you call this operation, take note of the following items:

  • Desktop types include vCPU, memory, and GPU configurations. You cannot change the configurations of individual resources. You can only change the desktop type of the cloud desktop.
  • You cannot change a cloud desktop from a general-purpose desktop type to a non-general-purpose one. You cannot change a cloud desktop from a graphics desktop type to a non-graphics one.
  • Both system and data disks can be resized to extend disk capacity. However, you cannot shrink disks.
  • If the cloud desktop uses the subscription billing method, the price difference is calculated based on the price before and after the change. You may receive a refund or have to make up the price difference.
  • We recommend that you wait at least five minutes between consecutive desktop type change operations on the same cloud desktop.
  • The cloud desktop for which you want to change the desktop type must be in the Stopped state.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes ModifyDesktopSpec

The operation that you want to perform. Set the value to ModifyDesktopSpec.

DesktopId String Yes ecd-4543qyik164a4****

The ID of the cloud desktop.

RegionId String Yes cn-hangzhou

The ID of the region.

DesktopType String No eds.general.2c8g

The new desktop type.

You can call the DescribeDesktopTypes operation to query the IDs of available cloud desktops whose desktop types can be modified.

RootDiskSizeGib Integer No 80

The size of the new system disk.

UserDiskSizeGib Integer No 100

The size of the new data disk.

AutoPay Boolean No false

Specifies whether to enable automatic payment. Valid values:

  • true: enables automatic payment. Make sure that you have sufficient balance in your account. Otherwise, abnormal orders are generated.
  • false: An order is generated, but no payment is made. You can log on to the EDS console and complete the payment based on the order ID on the Orders page.

Default value: true.

Response parameters

Parameter Type Example Description
OrderId String 123456789

The ID of the order.

RequestId String 3EB7FCEE-D731-4948-85A3-4B2C341CA983

The ID of the request.

Examples

Sample requests

https://ecd.cn-hangzhou.aliyuncs.com/?Action=ModifyDesktopSpec
&DesktopId=ecd-4543qyik164a4****
&RegionId=cn-hangzhou
&DesktopType=eds.general.2c8g
&<Common request parameters>

Sample success responses

XML format

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

JSON format

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