You need to enable JavaScript to run this app.
导航

DescribeDedicatedHostTypes

最近更新时间2023.09.08 16:31:01

首次发布时间2023.09.08 16:31:01

调用 DescribeDedicatedHostTypes 接口查询专有宿主机规格信息,包括专有宿主机可配置的最大CPU超分比、支持的实例规格族等。

请求参数

名称
类型是否必填
示例值
描述
ActionStringDescribeDedicatedHostTypes要执行的操作,取值:DescribeDedicatedHostTypes。
VersionString2020-04-01API的版本,取值:2020-04-01。

DedicatedHostTypeIds.N

String

DedicatedHostTypeIds.1=ecs.ddhr2s

专有宿主机规格ID,最多支持100个。

  • 参数 - N:表示专有宿主机规格的序号。

  • 多个规格之间用&分隔。

SupportedInstanceTypeFamilyStringecs.ddhr2s.define专有宿主机支持的ECS实例规格族,更多信息请参见规格介绍

NextToken

String

-

分页查询凭证,用于标记分页的位置,初次调用该接口时无需设置。下次查询时,取值为上一次API调用返回的NextToken参数值。

MaxResults

Integer

10

分页查询时设置的每页行数:

  • 最大值:100

  • 默认值:10

返回数据

名称
类型
示例值
描述
DedicatedHostTypes
Array of Struct
-
专有宿主机规格信息。
NextToken
String
eWNsYTg0b2s1Y3Yyd3Jzb2do****
本次调用返回的查询凭证值,返回为空表示该页为末页。

请求示例

GET /?Action=DescribeDedicatedHostTypes&Version=2020-04-01 HTTP/1.1
Host: open.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,
                "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****"
    }
}

错误码

HttpCode错误码错误信息描述
400InvalidArgumentThe specified argument is invalid.指定的参数不合法。
400LimitExceeded.MaximumDedicatedHostTypeIdsThe number of specified DedicatedHostTypeIds exceeds the maximum limit.指定的DedicatedHostTypeIds数量超过最大限制。

500

InternalError

An internal error has occurred.

内部错误,请重试。如果多次尝试失败,请提交工单。