Queries the details of dedicated host types supported in a region, or the Elastic Compute Service (ECS) instance families supported by a specific dedicated host type.

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

Response parameters

Parameter Type Example Description
DedicatedHostTypes Array of DedicatedHostType

Details about the dedicated host types.

DedicatedHostType
Cores Integer 2

The number of cores in a single physical CPU.

CpuOverCommitRatioRange String 1-5

The supported CPU overcommit ratio range.

DedicatedHostType String ddh.sn1ne

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

GPUSpec String gpu

The GPU model.

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 memory size. Unit: GiB.

PhysicalGpus Integer 2

The number of physical GPUs.

Sockets Integer 2

The number of physical CPUs.

SupportCpuOverCommitRatio Boolean true

Indicates whether the CPU overcommit ratio settings are supported.

SupportedInstanceTypeFamilies List ecs.sn1ne

The ECS instance families supported by the dedicated host type.

SupportedInstanceTypesList List ecs.sn1ne.large

The ECS instance types supported by the dedicated host type.

TotalVcpus Integer 56

The total number of vCPUs.

TotalVgpus Integer 10

The total number of vGPUs.

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>
      <RequestId>E7676157-C48A-445A-BFCB-6669EDE8DA3D</RequestId>
      <DedicatedHostTypes>
            <DedicatedHostType>
                  <PhysicalGpus>0</PhysicalGpus>
                  <MemorySize>180</MemorySize>
                  <LocalStorageCapacity>0</LocalStorageCapacity>
                  <DedicatedHostType>ddh.c6s</DedicatedHostType>
                  <LocalStorageAmount>0</LocalStorageAmount>
                  <Cores>52</Cores>
                  <LocalStorageCategory></LocalStorageCategory>
                  <Sockets>2</Sockets>
                  <GPUSpec></GPUSpec>
                  <SupportedInstanceTypeFamilies>
                        <SupportedInstanceTypeFamily>ecs.ddh6s.custom</SupportedInstanceTypeFamily>
                  </SupportedInstanceTypeFamilies>
                  <TotalVgpus>0</TotalVgpus>
                  <CpuOverCommitRatioRange>1-5</CpuOverCommitRatioRange>
                  <SupportedInstanceTypesList>
            </SupportedInstanceTypesList>
                  <SupportCpuOverCommitRatio>true</SupportCpuOverCommitRatio>
                  <TotalVcpus>520</TotalVcpus>
            </DedicatedHostType>
      </DedicatedHostTypes>
</DescribeDedicatedHostTypesResponse>

JSON format 

{
	"RequestId": "E7676157-C48A-445A-BFCB-6669EDE8DA3D",
	"DedicatedHostTypes": {
		"DedicatedHostType": [
			{
				"PhysicalGpus": 0,
				"MemorySize": 180,
				"LocalStorageCapacity": 0,
				"DedicatedHostType": "ddh.c6s",
				"LocalStorageAmount": 0,
				"Cores": 52,
				"LocalStorageCategory": "",
				"Sockets": 2,
				"GPUSpec": "",
				"SupportedInstanceTypeFamilies": {
					"SupportedInstanceTypeFamily": [
						"ecs.ddh6s.custom"
					]
				},
				"TotalVgpus": 0,
				"CpuOverCommitRatioRange": "1-5",
				"SupportedInstanceTypesList": {
					"SupportedInstanceTypesList": []
				},
				"SupportCpuOverCommitRatio": true,
				"TotalVcpus": 520
			}
		]
	}
}

Error codes

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