调用DescribeDedicatedHostTypes查询指定地域下支持的专有宿主机规格详细参数,或者查询专有宿主机支持的ECS实例规格族。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeDedicatedHostTypes

系统规定参数。取值:DescribeDedicatedHostTypes

RegionId String cn-hangzhou

专有宿主机所在地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。

DedicatedHostType String ddh.sn1ne

专有宿主机规格。更多详情,请参见宿主机规格

SupportedInstanceTypeFamily String ecs.sn1ne

专有宿主机规格支持的ECS实例规格族。

返回数据

名称 类型 示例值 描述
RequestId String 5FE5FF06-3A33-4658-8495-6445FC54E327

请求ID。

DedicatedHostTypes Array of DedicatedHostType

返回专有宿主机规格的信息。

DedicatedHostType
Cores Integer 2

单个物理CPU的核数。

LocalStorageCategory String local

本地盘类型。

GPUSpec String gpu

GPU型号。

TotalVcpus Integer 56

虚拟CPU总核数。

CpuOverCommitRatioRange String 1-5

支持设置CPU超卖比的范围。

PhysicalGpus Integer 2

物理GPU数量。

MemorySize Float 112.0

内存容量,单位:GiB。

SupportCpuOverCommitRatio Boolean true

是否支持设置CPU超卖比。

LocalStorageCapacity Long 0

一块本地盘容量,单位:GiB。

DedicatedHostType String ddh.sn1ne

专有宿主机规格类型。

LocalStorageAmount Integer 0

专有宿主机上的本地盘数量。

TotalVgpus Integer 10

虚拟GPU总核数。

Sockets Integer 2

物理处理器(CPU)数量。

SupportedInstanceTypeFamilies Array of String ecs.sn1ne

实例规格族。

SupportedInstanceTypesList Array of String ecs.sn1ne.large

实例规格。

示例

请求示例

https://ecs.aliyuncs.com/?Action=DescribeDedicatedHostTypes
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<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/>
            <Sockets>2</Sockets>
            <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格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "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" : "",
      "SupportedInstanceTypeFamilies" : {
        "SupportedInstanceTypeFamily" : [ "ecs.ddh6s.custom" ]
      },
      "TotalVgpus" : 0,
      "CpuOverCommitRatioRange" : "1-5",
      "SupportedInstanceTypesList" : {
        "SupportedInstanceTypesList" : [ ]
      },
      "SupportCpuOverCommitRatio" : true,
      "TotalVcpus" : 520
    } ]
  }
}

错误码

访问错误中心查看更多错误码。