You need to enable JavaScript to run this app.
导航
云服务器
  • 文档首页
    • /
  • 云服务器

DescribeDedicatedHostTypes

最近更新时间：2024.04.22 11:34:50

首次发布时间：2024.04.22 11:34:50

我的收藏

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

请求参数

名称
类型是否必填
示例值
描述
ActionString是DescribeDedicatedHostTypes要执行的操作，取值：DescribeDedicatedHostTypes。
VersionString是2020-04-01API的版本，取值：2020-04-01。

DedicatedHostTypeIds.N

String

否

DedicatedHostTypeIds.1=ecs.ddhr2s

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

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

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

SupportedInstanceTypeFamilyString否ecs.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.

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