You need to enable JavaScript to run this app.
文档中心
云服务器

云服务器

复制全文
下载 pdf
专有宿主机
DescribeDedicatedHostTypes - 查询专有宿主机规格信息
复制全文
下载 pdf
DescribeDedicatedHostTypes - 查询专有宿主机规格信息
调用 DescribeDedicatedHostTypes 接口查询专有宿主机规格信息。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
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实例规格族,更多信息请参见规格介绍。​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
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******​
本次调用返回的查询凭证值,返回为空表示该页为末页。​
​
​
​
请求示例​
​
GET /?Action=DescribeDedicatedHostTypes&Version=2020-04-01 HTTP/1.1​
Host: ecs.cn-beijing.volcengineapi.com​
Region: cn-beijing​
Service: ecs​
​
返回示例​
​
{​
"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****"​
}​
}​
​
错误码​
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。​
​
状态码​
错误码​
错误信息​
说明​
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.​
内部错误,请重试。如果多次尝试失败,请提交工单。​
​
​
最近更新时间:2026.07.10 15:41:40
这个页面对您有帮助吗?
有用
有用
无用
无用