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 
RegionId String Yes cn-hangzhou

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

Action String No DescribeDedicatedHostTypes

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

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 family supported by the dedicated host types.

Response parameters

Parameter Type Example Description
DedicatedHostTypes

The information about the dedicated host types.

Cores Integer 2

The number of cores in a physical CPU.

DedicatedHostType String ddh.sn1ne

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

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 type of the local disks.

MemorySize Float 112.0

The size of the memory. Unit: GiB.

SupportedInstanceTypeFamilies ecs.sn1ne

The ECS instance families supported by the dedicated host type.

SupportedInstanceTypesList ecs.sn1ne

The ECS instance types supported by the dedicated host type.

TotalVcpus Integer 56

The total number of vCPUs.

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

Error codes

For more information about error codes, see API Error Center.