All Products
Search

This Product

    Elastic Desktop Service:DescribeDesktopTypes

    Document Center

    Elastic Desktop Service:DescribeDesktopTypes

    Last Updated:Aug 17, 2026

    Queries the details of cloud computer specifications.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

    • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

    • API: The API that you can call to perform the action.

    • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

    • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

      • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

      • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

    • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

    • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    ecd:DescribeDesktopTypes

    list

    *All Resource

    *

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    BusinessChannel

    string

    No

    The business channel. Valid values: Enterprise: Enterprise Edition. Business: Business Edition.

    Valid values:

    • Enterprise :

      Enterprise Edition.

    • AGENTIC_CLOUD_COMPUTER :

      agentic cloud computer.

    • Business :

      Business Edition.

    • Lincore_team :

      Lincore Team Edition.

    Enterprise
    RegionId

    string

    Yes

    The region ID. You can call DescribeRegions to query the regions supported by WUYING Workspace.

    cn-hangzhou
    DesktopTypeId

    string

    No

    The specification ID.

    Note

    If both InstanceTypeFamily and DesktopTypeId are left empty, information about all cloud computer specifications is returned.

    Valid values:

    • eds.enterprise_office.4c8g :

      eds.enterprise_office.4c8g

    • eds.hf.4c8g :

      eds.hf.4c8g

    • ecd.basic.large :

      ecd.basic.large

    • ecd.advanced.large :

      ecd.advanced.large

    • eds.enterprise_office.8c16g :

      eds.enterprise_office.8c16g

    • ecd.basic.small :

      ecd.basic.small

    • ecd.graphics.2xlarge :

      ecd.graphics.2xlarge

    • eds.hf.8c16g :

      eds.hf.8c16g

    • eds.hf.12c24g :

      eds.hf.12c24g

    • eds.general.8c16g :

      eds.general.8c16g

    • eds.general.16c32g :

      eds.general.16c32g

    • ecd.advanced.xlarge :

      ecd.advanced.xlarge

    • eds.graphics.16c1t4 :

      eds.graphics.16c1t4

    • ecd.graphics.xlarge :

      ecd.graphics.xlarge

    • ecd.performance.2xlarge :

      ecd.performance.2xlarge

    • eds.general.8c32g :

      eds.general.8c32g

    • eds.general.2c2g :

      eds.general.2c2g

    • eds.general.2c4g :

      eds.general.2c4g

    • eds.graphics.24c1t4 :

      eds.graphics.24c1t4

    • eds.general.4c8g :

      eds.general.4c8g

    • eds.enterprise_office.2c4g :

      eds.enterprise_office.2c4g

    • eds.general.4c16g :

      eds.general.4c16g

    • eds.general.2c8g :

      eds.general.2c8g

    ecd.graphics.xlarge
    InstanceTypeFamily

    string

    No

    The instance family name.

    Note

    If both InstanceTypeFamily and DesktopTypeId are left empty, information about all cloud computer specifications is returned.

    Valid values:

    • ecd.advanced :

      ecd.advanced

    • eds.graphics :

      eds.graphics

    • ecd.basic :

      ecd.basic

    • eds.enterprise_office :

      eds.enterprise_office

    • eds.hf :

      eds.hf

    • ecd.graphics :

      ecd.graphics

    • eds.general :

      eds.general

    • ecd.performance :

      ecd.performance

    ecd.graphics
    CpuCount

    integer

    No

    The number of vCPUs.

    2
    MemorySize

    integer

    No

    The memory size. Unit: MiB.

    4096
    GpuCount

    number

    No

    The number of GPU cores.

    1
    DesktopIdForModify

    string

    No

    The ID of the cloud computer for which you want to change the specification. If this parameter is specified, the response includes compatibility information between the specification and the cloud computer.

    ecd-gx2x1dhsmucyy****
    OrderType

    string

    No

    The order type.

    Valid values:

    • DOWNGRADE :

      downgrade.

    • UPGRADE :

      upgrade.

    DOWNGRADE
    AppliedScope

    string

    No

    The applicable scope of the specification. Default value: Public.

    Valid values:

    • Public :

      Public

    • SavingPlan :

      SavingPlan

    Public
    DesktopGroupIdForModify

    string

    No

    The ID of the shared cloud computer for which you want to change the specification. If this parameter is specified, the response includes compatibility information between the specification and the shared cloud computer.

    dg-abcdefg****
    GpuDriverType

    string

    No

    The GPU driver type.

    Valid values:

    • T4 :

      T4

    • A10 :

      A10

    • G28 :

      G28

    • G39 :

      G39

    A10
    OrderBy

    string

    No

    The field by which to sort the results. If this parameter is not specified, results are sorted by creation time in descending order.

    Valid values:

    • Memory :

      sort by memory size.

    • Cpu :

      sort by the number of CPU cores.

    Memory
    SortType

    string

    No

    The sort order.

    Valid values:

    • ASC :

      ascending order [default value]

    • DESC :

      descending order.

    ASC
    Scope

    string

    No

    The billing method of the specification.

    Valid values:

    • MonthPackage :

      monthly subscription.

    • FastBuy :

      quick purchase.

    FastBuy
    DesktopTypeIdList

    array

    No

    The list of specification IDs.

    string

    No

    The specification ID.

    eds.enterprise.4c8g
    SupportMinSessionCount

    integer

    No

    The minimum number of multi-sessions supported by the specification.

    2
    ZoneId

    string

    No

    Note

    This parameter is not publicly available.

    cn-hangzhou-j
    GpuMemory

    integer

    No

    The GPU memory size. This parameter is meaningful only for GPU-accelerated cloud computers. Unit: MB.

    2048
    ScopeSet

    array

    No

    The list of applicable scopes.

    string

    No

    The list of applicable scopes.

    PUBLIC
    OfficeSiteId

    string

    No

    The ID of the office network to which the shared cloud computer belongs.

    cn-hangzhou+os-c5cy7q578s8jc****
    DesktopScenario

    string

    No

    The scenarios of the cloud computer.

    office

    Response elements

    Element

    Type

    Description

    Example

    object

    The response parameters.

    RequestId

    string

    The request ID.

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

    array<object>

    The details of the specifications.

    object

    The details of the specifications.

    SystemDiskSize

    string

    The system cloud disk size. Unit: GiB.

    150
    DesktopTypeId

    string

    The specification ID.

    ecd.graphics.xlarge
    DataDiskSize

    string

    The data cloud disk size. Unit: GiB.

    150
    CpuCount

    string

    The number of vCPUs.

    2
    GpuCount

    number

    The number of GPU cores.

    1
    GpuSpec

    string

    The GPU memory.

    16 GiB
    InstanceTypeFamily

    string

    The instance family.

    ecd.graphics
    MemorySize

    string

    The memory size. Unit: MiB.

    23552
    DesktopTypeStatus

    string

    The specification status. A value of SUFFICIENT indicates that the specification resources are sufficient.

    SUFFICIENT
    Scopes

    array

    The list of billing methods for the specification.

    string

    The billing method of the specification.

    Valid values:

    • MonthPackage :

      monthly subscription.

    • FastBuy :

      quick purchase.

    FastBuy
    StockState

    string

    The stock status.

    Valid values:

    • Insufficient :

      out of stock.

    • Sufficient :

      in stock.

    Sufficient
    GpuMemory

    integer

    The GPU memory size. This parameter is meaningful only for GPU-accelerated cloud computers. Unit: MB.

    2048
    MaxSessionCount

    integer

    The number of multi-sessions supported by the current specification.

    4
    Description

    string

    The description of the NAS file system.

    newDescription
    EnvType

    string

    The environment type. This parameter is not publicly available.

    Private
    EnvId

    string

    The environment ID. This parameter is not publicly available.

    adifa****
    SaleTypes

    array

    The supported desktop type sale categories.

    string

    The sale type.

    prePaid

    Examples

    Success response

    JSON format

    {
  "RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****",
  "DesktopTypes": [
    {
      "SystemDiskSize": "150",
      "DesktopTypeId": "ecd.graphics.xlarge",
      "DataDiskSize": "150",
      "CpuCount": "2",
      "GpuCount": 1,
      "GpuSpec": "16 GiB",
      "InstanceTypeFamily": "ecd.graphics",
      "MemorySize": "23552",
      "DesktopTypeStatus": "SUFFICIENT",
      "Scopes": [
        "FastBuy"
      ],
      "StockState": "Sufficient",
      "GpuMemory": 2048,
      "MaxSessionCount": 4,
      "Description": "newDescription",
      "EnvType": "Private",
      "EnvId": "adifa****",
      "SaleTypes": [
        "prePaid"
      ]
    }
  ]
}

    Error codes

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.