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.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

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 elements

Element	Type	Description	Example
	object
RequestId	string	The request ID.	5FE5FF06-3A33-4658-8495-6445FC54E327
DedicatedHostTypes	object
DedicatedHostType	array<object>	Details about the dedicated host types.
	array<object>
Cores	integer	The number of cores per physical CPU.	2
LocalStorageCategory	string	The category of local disks.	local
GPUSpec	string	The GPU model.	NVIDIA P100
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	number	The memory size. Unit: GiB.	112.0
SupportCpuOverCommitRatio	boolean	Indicates whether the CPU overcommit ratio settings are supported.	true
LocalStorageCapacity	integer	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	object
SupportedInstanceTypeFamily	array	The ECS instance families supported by the dedicated host type.
	string	The ECS instance family.	ecs.sn1ne
SupportedInstanceTypesList	object
SupportedInstanceTypesList	array	The ECS instance types supported by the dedicated host type.
	string	The ECS instance type.	ecs.sn1ne.large

Examples

Success response

JSON format

{
  "RequestId": "5FE5FF06-3A33-4658-8495-6445FC54E327",
  "DedicatedHostTypes": {
    "DedicatedHostType": [
      {
        "Cores": 2,
        "LocalStorageCategory": "local",
        "GPUSpec": "NVIDIA P100",
        "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

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.