All Products
Search

This Product

    WUYING Workspace:ModifyDesktopSpec

    Document Center

    WUYING Workspace:ModifyDesktopSpec

    Last Updated:Apr 08, 2024

    Changes the instance type of a cloud computer and scales up the disks of the cloud computer.

    Operation description

    Changing the configurations of a cloud computer includes changing the instance type of the cloud computer and scaling up the disks of the cloud computer.

    • Before you change the configurations of a cloud computer, you must understand the instance types and disk sizes supported by cloud computers. For more information, see Cloud computer types. You can call the DescribeDesktopTypes operation to query the instance types supported by cloud computers.

    • You must change at least one of the following configurations: instance type, system disk size, and data disk size of the cloud computer. You must specify at least one of the following parameters: DesktopType, RootDiskSizeGib, and UserDiskSizeGib. Take note of the following items:

      • The instance type of a cloud computer includes the configurations of vCPUs, memory, and GPUs. You can only change an instance type to another. You cannot change only one of the configurations.
      • You cannot change a cloud computer between the General Office type and the non-General Office type. You cannot yet change a cloud computer between the Graphics type and the non-Graphics type.
      • The system disk and data disks of a cloud computer can only be scaled up and cannot be scaled down.
      • If the billing method of the cloud computer is subscription, the system calculates the price difference based on the configuration difference between the original cloud computer and the new cloud computer. You must make up for the price difference or receive a refund for the price difference.
      • We recommend that you do not change the configurations of a cloud computer twice within 5 minutes.
      • When you change the configurations of a cloud computer, the cloud computer must be in the Stopped state.

    • After you change the configurations of a cloud computer, the personal data on the cloud computer is not affected.

    Debugging

    OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

    Authorization information

    There is currently no authorization information disclosed in the API.

    Request parameters

    ParameterTypeRequiredDescriptionExample
    RegionIdstringYes

    The region ID. You can call the DescribeRegions operation to query the most recent region list.

    		cn-hangzhou
    DesktopIdstringYes

    The ID of a cloud computer.

    		ecd-4543qyik164a4****
    DesktopTypestringYes

    The destination instance type. You can call the DescribeDesktopTypes operation to query the instance types supported by cloud computers.

    		eds.general.2c8g
    RootDiskSizeGibintegerNo

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

    		80
    UserDiskSizeGibintegerNo

    The destination data disk size. Unit: GiB.

    • The data disk size of a non-graphical cloud computer ranges from 20 to 1020 GiB and must be a multiple of 10.
    • The data disk size of a graphical cloud computer ranges from 40 to 1020 GiB and must be a multiple of 10.
    		100
    AutoPaybooleanNo

    Specifies whether to enable the auto-payment feature.

    Default value: true. Valid values:

    • true: enables the auto-payment feature.

      Make sure that you have sufficient balance in your Alibaba Cloud account. Otherwise, an exception occurs on your order.

    • false: disables the auto-payment feature. In this case, an order is generated, and no payment is automatically made.

      You can log on to the WUYING Workspace console and complete the payment based on the order ID on the Orders page.

    		false
    UserDiskPerformanceLevelstringNo

    The performance level (PL) of the data disk. Default value: PL0.

    Valid values:

    • PL1

    • PL0

    • PL3

    • PL2

    		PL0
    PromotionIdstringNo

    The ID of the promotional activity.

    		500033080110596

    Response parameters

    ParameterTypeDescriptionExample
    object

    Schema of response.

    OrderIdstring

    The ID of the order.

    		123456789
    RequestIdstring

    The ID of the request.

    		1CBAFFAB-B697-4049-A9B1-67E1FC5F****

    Examples

    Sample success responses

    JSONformat

    {
  "OrderId": "123456789",
  "RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****"
}

    Error codes

    For a list of error codes, visit the Service error codes.

    Change history

    Change timeSummary of changesOperation
    2023-12-12The internal configuration of the API is changed, but the call is not affectedsee changesets
    Change itemChange content
    The internal configuration of the API is changed, but the call is not affected.
    2021-08-19The request parameters of the API has changedsee changesets
    Change itemChange content
    Input ParametersThe request parameters of the API has changed.
      Added Input Parameters: PromotionId
    2021-08-19The request parameters of the API has changedsee changesets
    Change itemChange content
    Input ParametersThe request parameters of the API has changed.
      Added Input Parameters: UserDiskPerformanceLevel