DescribeDedicatedHostTypes -

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.

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 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.
GPUSpec	String	NVIDIA P100	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>NVIDIA P100</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": "NVIDIA P100",
                "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.