All Products
Search
Document Center

Elastic Compute Service:DescribeDedicatedHostTypes

Last Updated:Mar 13, 2024

You can call this operation to query the details about dedicated host types supported in a region, or the 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.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
RegionIdstringYes

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

cn-hangzhou
DedicatedHostTypestringNo

The dedicated host type. For more information, see Dedicated host types.

ddh.sn1ne
SupportedInstanceTypeFamilystringNo

The ECS instance family supported by the dedicated host type.

ecs.sn1ne

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The ID of the request.

5FE5FF06-3A33-4658-8495-6445FC54E327
DedicatedHostTypesobject []

The information about the dedicated host type.

Coresinteger

The number of cores in a single physical CPU.

2
LocalStorageCategorystring

The category of the local disks.

local
GPUSpecstring

The GPU model.

gpu
TotalVcpusinteger

The total number of vCPUs.

56
CpuOverCommitRatioRangestring

The supported CPU overcommit ratio range.

1-5
PhysicalGpusinteger

The number of physical GPUs.

2
MemorySizefloat

The size of the memory. Unit: GiB.

112.0
SupportCpuOverCommitRatioboolean

Indicates whether the CPU overcommit ratio setting is supported.

true
LocalStorageCapacitylong

The capacity of a local disk. Unit: GiB.

0
DedicatedHostTypestring

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

ddh.sn1ne
LocalStorageAmountinteger

The number of local disks on a dedicated host.

0
TotalVgpusinteger

The total number of vGPUs.

10
Socketsinteger

The number of physical CPUs.

2
SupportedInstanceTypeFamiliesarray

The ECS instance families supported by the dedicated host.

string

The ECS instance family.

ecs.sn1ne
SupportedInstanceTypesListarray

The ECS instance types supported by the dedicated host.

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.