Changes the configurations of a cloud desktop, including the vCPUs, memory size, and disk size.

Description

You can call this operation to change the configurations, such as the desktop type and disk size, of a cloud desktop.

  • Before you call this operation, take note of the cloud desktop types and the disk sizes for each type of cloud desktop that Elastic Desktop Service (EDS) provides. For more information, see Cloud desktop types.
  • When you change the configurations of a cloud desktop, you can change the desktop type or the size of the system disk or data disk. You must configure at least one of the following parameters: DesktopType, RootDiskSizeGib, and UserDiskSizeGib. Take note of the following items:
    • Each desktop type contains different desktop specifications, such as vCPUs, memory size, and GPUs. You cannot change only one of these specifications. If you want to change the desktop specifications, you must change the desktop type.
    • You cannot change a cloud desktop from the General Office type to a non-General Office type, or from a non-General Office type to the General Office type. You cannot change a cloud desktop from the Graphics type to a non-Graphics type, or from a non-Graphics type to the Graphics type.
    • You can only increase the sizes of system and data 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 can receive a refund, or must pay for the price difference.
    • If you want to change the type of cloud desktop for multiple times, we recommend that you wait at least 5 minutes before you change the desktop type if you want to change it again.
    • The cloud desktop for which you want to change configurations must be in the Stopped state.
  • The changes do not affect your personal data on the cloud desktop.

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.

RegionId String Yes cn-hangzhou

The ID of the region.

DesktopId String Yes ecd-4543qyik164a4****

The ID of the cloud desktop.

DesktopType String No eds.general.2c8g

The new cloud desktop type.

You can call the DescribeDesktopTypes operation to query the IDs of supported cloud desktop types.

RootDiskSizeGib Integer No 80

The size of the new system disk. Unit: GiB. Valid values: 80 to 500 GiB. The value must be a multiple of 10.

UserDiskSizeGib Integer No 100

The size of the new data disk. Unit: GiB.

  • The data disk size of a non-Graphics cloud desktop can be within the range of 20 to 1020 GiB and must be a multiple of 10.
  • The data disk size of the Graphics cloud desktop can be within the range of 40 to 1020 GiB and must be a multiple of 10.
AutoPay Boolean No false

Specifies whether to enable automatic payment. Valid values:

  • true: enables automatic payment. Make sure that your account has sufficient balance. Otherwise, abnormal orders are generated.
  • false: disables automatic payment. In this case, an order is generated and no billing is implemented. You can log on to the EDS console and complete payments 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

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

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

JSON format

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

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