You can call this operation to query the specification details of cloud desktops.

Description

When no values are specified for the InstanceTypeFamily and DesktopTypeId parameters for a cloud desktop, all specifications of the cloud desktop are queried.

Debugging

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

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeDesktopTypes

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

RegionId String Yes cn-hangzhou

The ID of the region.

DesktopTypeId String No ecd.graphics.xlarge

The ID of the specification. Valid values:

  • ecd.graphics.xlarge
  • ecd.graphics.2xlarge
  • ecd.performance.2xlarge
  • ecd.advanced.xlarge
  • ecd.advanced.large
  • ecd.basic.large
  • ecd.basic.small
InstanceTypeFamily String No ecd.graphics

The name of the specification family. Valid values:

  • ecd.graphics
  • ecd.performance
  • ecd.advanced
  • ecd.basic

Response parameters

Parameter Type Example Description
DesktopTypes Array of DesktopType

Details of the specifications.

CpuCount String 2

The number of CPUs.

DataDiskSize String 150

The size of a data disk. Unit: GiB.

DesktopTypeId String ecd.graphics.xlarge

The ID of the specification.

GPUCount String 0.25

The number of GPUs.

InstanceTypeFamily String ecd.graphics

The specification family.

MemorySize String 23552

The size of the memory. Unit: MiB.

SystemDiskSize String 150

The size of the system disk. Unit: GiB.

RequestId String 8F851208-C0EA-4CDD-9074-DBE70CB430DA

The ID of the request.

Examples

Sample requests

https://ecd.cn-hangzhou.aliyuncs.com/?Action=DescribeDesktopTypes
&DesktopTypeId=ecd.graphics.xlarge
&InstanceTypeFamily=ecd.graphics
&<Common request parameters>

Sample success responses

XML format

<DescribeDesktopTypesResponse>
      <RequestId>8F851208-C0EA-4CDD-9074-DBE70CB430DA</RequestId>
      <DesktopTypes>
            <MemorySize>23552</MemorySize>
            <CpuCount>4</CpuCount>
            <DesktopTypeId>ecd.graphics.xlarge</DesktopTypeId>
            <GPUCount>0.25</GPUCount>
            <SystemDiskSize>150</SystemDiskSize>
            <InstanceTypeFamily>ecd.graphics</InstanceTypeFamily>
            <DataDiskSize>150</DataDiskSize>
      </DesktopTypes>
</DescribeDesktopTypesResponse>

JSON format

{
    "RequestId":"8F851208-C0EA-4CDD-9074-DBE70CB430DA",
    "DesktopTypes":[
        {
            "MemorySize":23552,
            "CpuCount":4,
            "DesktopTypeId":"ecd.graphics.xlarge",
            "GPUCount":0.25,
            "SystemDiskSize":150,
            "InstanceTypeFamily":"ecd.graphics",
            "DataDiskSize":150
        }]
}

Error codes

For a list of error codes, visit the API Error Center.