You can call this operation to query the details of supported dedicated host types or the Elastic Compute Service (ECS) instance families that are supported by dedicated hosts in a specified region.

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 No DescribeDedicatedHostTypes

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

RegionId String Yes cn-hangzhou

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

DedicatedHostType String No ddh.sn1ne

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

SupportedInstanceTypeFamily String No ecs.sn1ne

The ECS instance families supported by the dedicated host types.

Response parameters

Parameter Type Example Description
RequestId String 5FE5FF06-3A33-4658-8495-6445FC54E327

The ID of the request.

DedicatedHostTypes Array

The information about the dedicated host type.

DedicatedHostType String ddh.sn1ne

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

Sockets Integer 2
TotalVcpus Integer 56

The total number of vCPUs.

TotalVgpus Integer 10
Cores Integer 2

The number of cores in a physical CPU.

PhysicalGpus Integer 2
MemorySize Float 112.0

The size of the memory. Unit: GiB.

LocalStorageCapacity Long 0

The capacity of a local disk. Unit: GiB.

LocalStorageAmount Integer 0

The number of local disks on a dedicated host.

LocalStorageCategory String local

The type of the local disks.

GPUSpec String gpu
SupportedInstanceTypeFamilies List ecs.sn1ne

The ECS instance family supported by the dedicated host type. Valid value: "SupportedInstanceTypeFamily":[ecs.sn1ne].

SupportedInstanceTypesList List ecs.sn1ne

The collection of ECS instance types supported by the dedicated host type. Valid value: "SupportedInstanceTypesList":[ecs.sn1ne].

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.