调用 DescribeDedicatedHostTypes 接口查询专有宿主机规格信息。
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|
Action | String | 是 | DescribeDedicatedHostTypes | 要执行的操作，取值：DescribeDedicatedHostTypes。 |
Version | String | 是 | 2020-04-01 | API的版本，取值：2020-04-01。 |
DedicatedHostTypeIds.N | Array of String | 否 | DedicatedHostTypeIds.1=ecs.ddhr2s | 专有宿主机规格，最多支持100个。
|
MaxResults | Integer | 否 | 10 | 分页查询时设置的每页行数：
|
NextToken | String | 否 | -- | 分页查询凭证，用于标记分页的位置，初次调用该接口时无需设置。下次查询时，取值为上一次API调用返回的 |
SupportedInstanceTypeFamily | String | 否 | ecs.ddhr2s.define | 专有宿主机支持的ECS实例规格族，更多信息请参见规格介绍。 |
下表仅列出本接口特有的返回参数。更多信息请参见返回结构。
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
DedicatedHostTypes | Array of Object | -- | 专有宿主机规格信息。 |
NextToken | String | bHpwdXJja2RxemU1eG5sb3NzdGcW1-RCEq****** | 本次调用返回的查询凭证值，返回为空表示该页为末页。 |
GET /?Action=DescribeDedicatedHostTypes&Version=2020-04-01 HTTP/1.1 Host: open.volcengineapi.com Region: cn-beijing Service: ecstext
{
"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****"
}
}
json下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
状态码 | 错误码 | 说明 |
|---|---|---|
400 | InvalidArgument | 指定的参数不合法。 |
400 | LimitExceeded.MaximumDedicatedHostTypeIds | 指定的DedicatedHostTypeIds超过最大限制。 |
500 | InternalError | 内部错误，请重试。如果多次尝试失败，请提交工单。 |