You can call this operation to query the dedicated host types supported in a region, or the ECS instance families that are supported by a specific dedicated host type.

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 DescribeDedicatedHostTypes

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

RegionId String Yes cn-hangzhou

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

DedicatedHostType String No ddh.sn1ne

The dedicated host type. For more information, see Dedicated host types.

SupportedInstanceTypeFamily String No ecs.sn1ne

The ECS instance families supported by the dedicated host type.

Response parameters

Parameter Type Example Description
DedicatedHostTypes Array

The information about dedicated host types.

DedicatedHostType
Cores Integer 2

The number of cores in a physical CPU.

DedicatedHostType String ddh.sn1ne

The dedicated host type. You can submit a ticket to request more dedicated host types.

GPUSpec String gpu
LocalStorageAmount Integer 0

The number of local disks on a dedicated host.

LocalStorageCapacity Long 0

The capacity of a local disk. Unit: GiB.

LocalStorageCategory String local

The category of the local disks.

MemorySize Float 112.0

The size of the memory. Unit: GiB.

PhysicalGpus Integer 2
Sockets Integer 2
SupportedInstanceTypeFamilies List ecs.sn1ne

The list of ECS instance families supported by the dedicated host type.

SupportedInstanceTypesList List ecs.sn1ne.large

The list of ECS instance types supported by the dedicated host type.

TotalVcpus Integer 56

The total number of vCPUs.

TotalVgpus Integer 10
RequestId String 5FE5FF06-3A33-4658-8495-6445FC54E327

The ID of the request.

Examples

Sample requests

https://ecs.aliyuncs.com/?Action=DescribeDedicatedHostTypes
&RegionId=cn-hangzhou
&<Common request parameters>

Sample success responses

XML format

<DescribeDedicatedHostTypesResponse>
    <DedicatedHostTypes>
        <DedicatedHostType>
            <LocalStorageAmount>0</LocalStorageAmount>
            <Sockets>2</Sockets>
            <DedicatedHostType>ddh.sn1ne</DedicatedHostType>
            <LocalStorageCapacity>0</LocalStorageCapacity>
            <SupportedInstanceTypeFamilies>
                <SupportedInstanceTypeFamily>ecs.sn1ne</SupportedInstanceTypeFamily>
            </SupportedInstanceTypeFamilies>
            <MemorySize>112.0</MemorySize>
            <Cores>32</Cores>
            <TotalVcpus>56</TotalVcpus>
            <LocalStorageCategory></LocalStorageCategory>
        </DedicatedHostType>
        <DedicatedHostType>
            <LocalStorageAmount>0</LocalStorageAmount>
            <Sockets>2</Sockets>
            <DedicatedHostType>ddh.sn2ne</DedicatedHostType>
            <LocalStorageCapacity>0</LocalStorageCapacity>
            <SupportedInstanceTypeFamilies>
                <SupportedInstanceTypeFamily>ecs.sn2ne</SupportedInstanceTypeFamily>
            </SupportedInstanceTypeFamilies>
            <MemorySize>224.0</MemorySize>
            <Cores>32</Cores>
            <TotalVcpus>56</TotalVcpus>
            <LocalStorageCategory></LocalStorageCategory>
        </DedicatedHostType>
    </DedicatedHostTypes>
    <RequestId>5FE5FF06-3A33-4658-8495-6445FC54E327</RequestId>
</DescribeDedicatedHostTypesResponse>

JSON format

{
    "DedicatedHostTypes":{
        "DedicatedHostType":[
            {
                "LocalStorageAmount":0,
                "Sockets":2,
                "DedicatedHostType":"ddh.sn1ne",
                "LocalStorageCapacity":0,
                "SupportedInstanceTypeFamilies":{
                    "SupportedInstanceTypeFamily":[
                        "ecs.sn1ne"
                    ]
                },
                "MemorySize":112,
                "Cores":32,
                "TotalVcpus":56,
                "LocalStorageCategory":""
            },
            {
                "LocalStorageAmount":0,
                "Sockets":2,
                "DedicatedHostType":"dh.c60m83.n1",
                "LocalStorageCapacity":0,
                "SupportedInstanceTypeFamilies":{
                    "SupportedInstanceTypeFamily":[
                        "ecs.n1"
                    ]
                },
                "MemorySize":84,
                "Cores":32,
                "TotalVcpus":40,
                "LocalStorageCategory":""
            }
        ]
    },
    "RequestId":"9A0FE8A2-720C-45AE-B2D9-813060FCBBF5"
}

Error codes

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