DescribeDedicatedHostTypes - Elastic Compute Service - Alibaba Cloud Documentation Center

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.

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

Parameter	Type	Required	Description	Example
RegionId	string	Yes	The region ID. You can call the DescribeRegions operation to query the most recent region list.	cn-hangzhou
DedicatedHostType	string	No	The dedicated host type. For more information, see Dedicated host types.	ddh.sn1ne
SupportedInstanceTypeFamily	string	No	The ECS instance family supported by the dedicated host type.	ecs.sn1ne

Response parameters

Parameter	Type	Description	Example
	object
RequestId	string	The request ID.	5FE5FF06-3A33-4658-8495-6445FC54E327
DedicatedHostTypes	object []	Details about the dedicated host types.
Cores	integer	The number of cores per physical CPU.	2
LocalStorageCategory	string	The category of local disks.	local
GPUSpec	string	The GPU model.	gpu
TotalVcpus	integer	The total number of vCPUs.	56
CpuOverCommitRatioRange	string	The supported CPU overcommit ratio range.	1-5
PhysicalGpus	integer	The number of physical GPUs.	2
MemorySize	float	The memory size. Unit: GiB.	112.0
SupportCpuOverCommitRatio	boolean	Indicates whether the CPU overcommit ratio settings are supported.	true
LocalStorageCapacity	long	The capacity of a local disk. Unit: GiB.	0
DedicatedHostType	string	The dedicated host type.	ddh.sn1ne
LocalStorageAmount	integer	The number of local disks on a dedicated host.	0
TotalVgpus	integer	The total number of vGPUs.	10
Sockets	integer	The number of physical CPUs.	2
SupportedInstanceTypeFamilies	array	The ECS instance families supported by the dedicated host type.
	string	The ECS instance family.	ecs.sn1ne
SupportedInstanceTypesList	array	The ECS instance types supported by the dedicated host type.
	string	The ECS instance type.	ecs.sn1ne.large

Examples

Sample success responses

JSONformat

{
  "RequestId": "5FE5FF06-3A33-4658-8495-6445FC54E327",
  "DedicatedHostTypes": {
    "DedicatedHostType": [
      {
        "Cores": 2,
        "LocalStorageCategory": "local",
        "GPUSpec": "gpu",
        "TotalVcpus": 56,
        "CpuOverCommitRatioRange": "1-5",
        "PhysicalGpus": 2,
        "MemorySize": 112,
        "SupportCpuOverCommitRatio": true,
        "LocalStorageCapacity": 0,
        "DedicatedHostType": "ddh.sn1ne",
        "LocalStorageAmount": 0,
        "TotalVgpus": 10,
        "Sockets": 2,
        "SupportedInstanceTypeFamilies": {
          "SupportedInstanceTypeFamily": [
            "ecs.sn1ne"
          ]
        },
        "SupportedInstanceTypesList": {
          "SupportedInstanceTypesList": [
            "ecs.sn1ne.large"
          ]
        }
      }
    ]
  }
}

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change time	Summary of changes	Operation

No change history