All Products
Search
Document Center

Elastic Compute Service:DescribeDedicatedHostTypes

Last Updated:Oct 09, 2024

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.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
RegionIdstringYes

The region ID. 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 request ID.

5FE5FF06-3A33-4658-8495-6445FC54E327
DedicatedHostTypesarray<object>

Details about the dedicated host types.

DedicatedHostTypeobject
Coresinteger

The number of cores per physical CPU.

2
LocalStorageCategorystring

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

112.0
SupportCpuOverCommitRatioboolean

Indicates whether the CPU overcommit ratio settings are supported.

true
LocalStorageCapacitylong

The capacity of a local disk. Unit: GiB.

0
DedicatedHostTypestring

The dedicated host type.

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 type.

SupportedInstanceTypeFamilystring

The ECS instance family.

ecs.sn1ne
SupportedInstanceTypesListarray

The ECS instance types supported by the dedicated host type.

SupportedInstanceTypesListstring

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 timeSummary of changesOperation
No change history