# 查询专属主机类型列表 - ListDedicatedHostAllTypes
#### 功能介绍
查询专属主机的类型列表。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/DeH/doc?api=ListDedicatedHostAllTypes)中调试该接口。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-deh/deh_08_0001.html)。
#### URI
GET /v1.0/{project_id}/dedicated-host-types
参数说明请参见[表1]。
 表1参数说明 
| 参数         | 参数类型   | 是否必选 | 描述                                                                                                          |
|:---|:---|:---|:---|
| project_id | String | 是    | 项目ID。 获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-deh/deh_02_0010.html)。 |
   
#### 请求消息
表2查询参数 
| 参数                | 位置    | 参数类型   | 是否必选 | 描述                                                                                                                           |
|:---|:---|:---|:---|:---|
| flavor            | query | String | 否    | 专属主机规格ID。                                                                                                                    |
| availability_zone | query | String | 否    | 专属主机可用区。                                                                                                                     |
| host_type         | query | String | 否    | 专属主机类型。 支持的专属主机类型请参见[规格族概述](https://support.huaweicloud.com/productdesc-deh/deh_01_0005.html)。 |
| limit             | query | String | 否    | 每个页面上显示的条目数。                                                                                                                 |
| marker            | query | String | 否    | 该值是上一页最后一条记录的ID。如果"marker"取值无效，将会返回"400"错误码。                                                                                 |
   
#### 响应消息
表3响应参数 
| 参数                   | 位置   | 参数类型             | 描述                                                   |
|:---|:---|:---|:---|
| dedicated_host_types | body | Array of objects | 专属主机类型对象。详情参见[表4]。 |
| page_info            | body | Object           | 列表分页信息。详情请参见[表6]。   |
   
 表4dedicated_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]。             |
   
 表5dedicated_host_types.availability_zone_offerings字段数据结构说明 
| 参数                | 参数类型   | 描述                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|
| availability_zone | String | 专属主机类型可用区。                                                                                                                                                                                                                                                                                                      |
| status            | String | 专属主机类型可用区状态。 - available：可用  - sellout：售罄  - abandon：不可用   |
   
 表6page_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"
    }
}
```
#### 返回值
请参见[状态码](https://support.huaweicloud.com/api-deh/deh_02_0016.html)。