文档首页/ 专属主机 DeH/ API参考/ API/ 查询专属主机类型列表 - ListDedicatedHostAllTypes
更新时间:2025-11-14 GMT+08:00

查询专属主机类型列表 - ListDedicatedHostAllTypes

功能介绍

查询专属主机的类型列表。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项

URI

GET /v1.0/{project_id}/dedicated-host-types

参数说明请参见表1

表1 参数说明

参数

参数类型

是否必选

描述

project_id

String

项目ID。

获取方式请参见获取项目ID

请求消息

表2 请求参数

参数

位置

参数类型

是否必选

描述

flavor

query

String

专属主机规格ID。

availability_zone

query

String

专属主机可用区。

host_type

query

String

专属主机类型。

支持的专属主机类型请参见规格族概述

limit

query

String

每个页面上显示的条目数。

marker

query

String

该值是上一页最后一条记录的ID。如果“marker”取值无效,将会返回“400”错误码。

响应消息

表3 响应参数

参数

位置

参数类型

描述

dedicated_host_types

body

Array of objects

专属主机类型对象。详情参见表4

表4 dedicated_host_types字段数据结构说明

参数

参数类型

描述

host_type

String

专属主机类型。

长度限制在255个字符以内,并且不能以空格开头或结尾。

vcpus

Integer

专属主机类型vCPUs个数。

cores

Integer

专属主机类型物理核心个数。

sockets

Integer

专属主机类型物理套接字个数。

memory

Integer

专属主机类型物理内存个数。

category

String

专属主机类型类别。

supported_flavors

Array

专属主机类型支持的规格列表。

availability_zone_offerings

Array

专属主机类型可用区列表。详情参见表5

page_info

Object

列表分页信息。详情请参见表7

表5 availability_zone_offerings字段数据结构说明

参数

参数类型

描述

availability_zone_offering

Object

专属主机类型可用区对象。详情参见表6

表6 availability_zone_offering字段数据结构说明

参数

参数类型

描述

availability_zone

String

专属主机类型可用区。

status

String

专属主机类型可用区状态。

  • available:可用
  • sellout:售罄
  • abandon:不可用
表7 page_info字段数据结构说明

参数

参数类型

描述

next_marker

String

从marker指定的host_type的下一条数据开始查询。

请求示例

查询规格为ac9.48xlarge.2的专属主机类型。

GET https://{Endpoint}/v1/9c53a566cb3443ab910cf0daebca90c4/dedicated-host-types?limit=1

响应示例

{
    "dedicated_host_types": [
        {
            "host_type": "t7",
            "vcpus": 1080,
            "cores": 52,
            "sockets": 4,
            "memory": 1431552,
            "category": "dedicated_general_purpose",
            "supported_flavors": [
                "t7.xlarge.1",
                "t7.large.2",
                "t7.large.05",
                "t7.large.4",
                "t7.large.025",
                "t7.large.1"
            ],
            "availability_zone_offerings": []
        }
    ],
    "page_info": {
        "next_marker": "t7"
    }
}

返回值

请参见状态码