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

功能介绍

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

调试

您可以在API Explorer中调试该接口。

授权信息

账号具备所有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。
page_info	body	Object	列表分页信息。详情请参见表6。

表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 of Object	专属主机类型可用区列表。详情参见表5。

表5 dedicated_host_types.availability_zone_offerings字段数据结构说明
参数	参数类型	描述
availability_zone	String	专属主机类型可用区。
status	String	专属主机类型可用区状态。 available：可用 sellout：售罄 abandon：不可用

表6 page_info字段数据结构说明
参数	参数类型	描述
next_marker	String	从marker指定的host_type的下一条数据开始查询。

请求示例

查询专属主机类型列表。

GET https://{Endpoint}/v1.0/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"
    }
}