调用 DescribeDedicatedHostTypes 接口查询专有宿主机规格信息。 ## 调试 [去调试](https://api.volcengine.com/api-explorer/?action=DescribeDedicatedHostTypes&groupName=%E4%B8%93%E6%9C%89%E5%AE%BF%E4%B8%BB%E6%9C%BA&serviceCode=ecs&version=2020-04-01) ## 请求参数下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见[公共参数](https://www.volcengine.com/docs/6369/67268)。 **Action** string 必选 `示例值：DescribeDedicatedHostTypes` 要执行的操作，取值：DescribeDedicatedHostTypes。 **Version** string 必选 `示例值：2020-04-01` API的版本，取值：2020\-04\-01。 **DedicatedHostTypeIds.N** string[] `可选` `示例值：DedicatedHostTypeIds.1=ecs.ddhr2s` 专有宿主机规格，最多支持100个。 * 参数 \- N：表示专有宿主机规格的序号。 * 多个规格之间用&分隔。 **MaxResults** integer `可选` `示例值：10` 分页查询时设置的每页行数： * 最大值：100 * 默认值：10 **NextToken** string `可选` `示例值：--` 分页查询凭证，用于标记分页的位置，初次调用该接口时无需设置。下次查询时，取值为上一次API调用返回的`NextToken`参数值。 **SupportedInstanceTypeFamily** string `可选` `示例值：ecs.ddhr2s.define` 专有宿主机支持的ECS实例规格族，更多信息请参见[规格介绍](https://www.volcengine.com/docs/6396/1253643)。 ## 返回参数下方仅列出本接口特有的返回参数。更多信息请参见[返回结构](https://www.volcengine.com/docs/6369/80336)。 **DedicatedHostTypes** object[] `示例值：--` 专有宿主机规格信息。 **LocalVolumes** object[] `示例值：--` 实例对应的本地盘配置信息。 **Count** integer `示例值：4` 实例挂载的本地盘数量。 **Size** integer `示例值：200` 实例挂载的本地盘的单盘容量，单位GiB。 **VolumeType** string `示例值：LOCAL_SSD` 本地盘类型，取值： * LOCAL_SSD：SSD本地盘 * LOCAL_HDD：HDD本地盘 **Cores** integer `示例值：28` 单个物理CPU的核数。 **DedicatedHostTypeId** string `示例值：ecs.ddhr2s` 专有宿主机规格ID。 **IsSupportedCpuOvercommitRatio** boolean `示例值：true` 是否支持CPU超分比，取值： * true：支持 * false：不支持 **MaxCpuOvercommitRatio** float `示例值：4` 支持配置的最大CPU超分倍数。 **ProcessorModel** string `示例值：Intel Xeon(Ice Lake) Platinum 8336C` 专有宿主机的处理器型号。 **Sockets** integer `示例值：2` 物理CPU数量。 **SupportInstanceTypeFamilies** string[] `示例值：[ecs.ddhr2s.define]` 专有宿主机支持部署的ECS实例规格族。 **SupportInstanceTypesList** string[] `示例值：[ecs.ddhr2s.define.c2m4,ecs.ddhr2s.define.c4m8]` 专有宿主机支持部署的ECS实例规格。 **TotalMemory** integer `示例值：962560` 专有宿主机的内存容量，单位MiB。 **TotalVcpus** integer `示例值：446` 专有宿主机的虚拟CPU（vCPU）总核数。 **NextToken** string `示例值：bHpwdXJja2RxemU1eG5sb3NzdGcW1-RCEq******` 本次调用返回的查询凭证值，返回为空表示该页为末页。 ## 请求示例 ```text GET /?Action=DescribeDedicatedHostTypes&Version=2020-04-01 HTTP/1.1 Host: ecs.cn-beijing.volcengineapi.com Region: cn-beijing Service: ecs ``` ## 返回示例 ```json { "ResponseMetadata": { "RequestId": "202307141732499DDB668C53870445****", "Action": "DescribeDedicatedHostTypes", "Version": "2020-04-01", "Service": "ecs", "Region": "cn-beijing" }, "Result": { "DedicatedHostTypes": [ { "DedicatedHostTypeId": "ecs.ddhr2s", "Cores": 28, "Sockets": 2, "TotalVcpus": 448, "TotalMemory": 962560, "IsSupportedCpuOvercommitRatio": true, "MaxCpuOvercommitRatio": 4, "LocalVolumes": [ ], "SupportInstanceTypeFamilies": [ "ecs.ddhr2s.define" ], "SupportInstanceTypesList": [ "ecs.ddhr2s.define.c112m224", "ecs.ddhr2s.define.c112m448", "ecs.ddhr2s.define.c16m32", "ecs.ddhr2s.define.c16m64", "ecs.ddhr2s.define.c1m1", "ecs.ddhr2s.define.c1m2", "ecs.ddhr2s.define.c2m4", "ecs.ddhr2s.define.c2m8", "ecs.ddhr2s.define.c32m128", "ecs.ddhr2s.define.c32m64", "ecs.ddhr2s.define.c4m16", "ecs.ddhr2s.define.c4m8", "ecs.ddhr2s.define.c64m128", "ecs.ddhr2s.define.c64m256", "ecs.ddhr2s.define.c8m16", "ecs.ddhr2s.define.c8m32" ], "ProcessorModel": "Intel Xeon(Ice Lake) Platinum 8336C" } ], "NextToken": "eWNsYTg0b2s1Y3Yyd3Jzb2do****" } } ``` ## 错误码下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见[公共错误码](https://www.volcengine.com/docs/6396/70462)文档。 |状态码 |错误码 |错误信息 |说明 | |---|---|---|---| |400 |InvalidArgument |The specified argument is invalid. |指定的参数不合法。 | |400 |LimitExceeded.MaximumDedicatedHostTypeIds |The number of specified DedicatedHostTypeIds exceeds the maximum limit. |指定的DedicatedHostTypeIds超过最大限制。 | |500 |InternalError |An internal error has occurred. |内部错误，请重试。如果多次尝试失败，请提交工单。 |

云服务器