# 查询规格详情和规格扩展信息列表 - ListBaremetalFlavorDetailExtends
#### 功能介绍
查询裸金属服务器的规格详情和规格的扩展信息。您可以调用此接口查询"baremetal:extBootType"参数取值，以确认某个规格是否支持快速发放。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/doc?api=ListBaremetalFlavorDetailExtends)中调试该接口。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-bms/bms_api_0900.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                   | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | bms:serverFlavors:get | list | -           | -   | -  | -      |
     
  
 
#### URI
GET /v1/{project_id}/baremetalservers/flavors
参数说明请参见[表1]。
 表1参数说明 
| 参数         | 是否必选 | 描述                                                                                                                 |
|:---|:---|:---|
| project_id | 是    | 项目ID。 获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-bms/bms_api_appendix_03.html)。 |
   
表2查询参数 
| 参数                | 是否必选 | 参数类型   | 描述                                                                                                            |
|:---|:---|:---|:---|
| availability_zone | 否    | String | 可用区，需要指定可用区（AZ）的名称。 请参考[地区和终端节点](https://developer.huaweicloud.com/endpoint)获取。 |
   
#### 请求参数
无
#### 请求示例
查询可用区为cn-north-1a的裸金属服务器的规格详情和规格扩展信息列表。
```
GET https://{BMS Endpoint}/v1/c685484a8cc2416b97260938705deb65/baremetalservers/flavors?availability_zone=cn-north-1a
```
#### 响应参数
| 参数      | 参数类型             | 描述                                                  |
|:---|:---|:---|
| flavors | Array of objects | 裸金属服务器规格列表，详情请参见[表3]。 |
   
 表3flavors数据结构说明 
| 参数                         | 参数类型             | 描述                                                          |
|:---|:---|:---|
| id                         | String           | 裸金属服务器规格的ID。                                                |
| name                       | String           | 裸金属服务器规格的名称。                                                |
| vcpus                      | String           | 该裸金属服务器规格对应的CPU核数。                                          |
| ram                        | Integer          | 该裸金属服务器规格对应的内存大小，单位为MB。                                     |
| disk                       | String           | 该裸金属服务器规格对应要求系统盘大小，0为不限制。                                   |
| swap                       | String           | 未使用。                                                        |
| OS-FLV-EXT-DATA:ephemeral  | Integer          | 未使用。                                                        |
| OS-FLV-DISABLED:disabled   | Boolean          | 未使用。                                                        |
| rxtx_factor                | Float            | 未使用。                                                        |
| rxtx_quota                 | String           | 未使用。                                                        |
| rxtx_cap                   | String           | 未使用。                                                        |
| os-flavor-access:is_public | Boolean          | 是否是公共规格。 false：私有规格；true：公共规格 |
| links                      | Array of objects | 规格相关快捷链接地址，详情请参见[表4]。   |
| os_extra_specs             | Object           | 裸金属服务器规格的扩展字段，详情请参见[表5]。      |
   
 表4links字段数据结构说明 
| 参数   | 参数类型   | 描述                                                                                                                                                                                                                                                                             |
|:---|:---|:---|
| rel  | String | 快捷链接标记名称。取值为： - self：包含版本号的资源链接，需要立即跟踪时使用此类链接。  - bookmark：提供了适合长期存储的资源链接。   |
| href | String | 对应快捷链接。                                                                                                                                                                                                                                                                        |
| type | String | 快捷链接类型。                                                                                                                                                                                                                                                                        |
   
 表5os_extra_specs数据结构说明 
| 参数                           | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|
| resource_type                | String | 标识该规格对应的资源类型。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| capabilities:cpu_arch        | String | 裸金属服务器的CPU架构类型，取值为： - x86_64（适用于x86机型）  - aarch64（适用于ARM机型）                                                                                                                                                                                                                                                                                                                                                                                                                             |
| baremetal:disk_detail        | String | 磁盘物理规格描述信息。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| capabilities:hypervisor_type | String | 标识ironic类型的规格。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| baremetal:__support_evs      | String | 标识当前规格是否支持挂载云硬盘。 - true  - false   如果裸金属服务器规格中没有此参数，表示不支持挂载云硬盘。                                                                                                                                                                                                                                                                                                                                                                                                                               |
| baremetal:extBootType        | String | 裸金属服务器启动源。 - LocalDisk：本地盘  - Volume：云硬盘（快速发放）                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| capabilities:board_type      | String | 裸金属服务器的规格类型。格式为规格的缩写，例如规格名称为"physical.o2.medium"，则规格类型为"o2m"。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| baremetal:net_num            | String | 实际可挂载网络数量。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| baremetal:netcard_detail     | String | 网卡物理规格描述信息。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| baremetal:cpu_detail         | String | CPU物理规格描述信息。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| baremetal:memory_detail      | String | 内存物理规格描述信息。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| cond:operation:status        | String | 裸金属服务器规格状态。不配置时等同于normal。 - normal：正常商用  - abandon：下线（即不显示）  - sellout：售罄  - obt：公测  - promotion：推荐（等同normal，也是商用）                                                                                                                                                                          |
| cond:operation:az            | String | 在某个AZ的裸金属服务器规格状态。 此参数是AZ级配置，某个AZ没有在此参数中配置时默认使用cond:operation:status参数的取值。 格式：az(xx)。()内为某个AZ下的裸金属服务器规格状态，()内必须填写状态，不填为无效配置。 例如：规格在某个区域的az0正常商用，az1售罄，az2公测，az3正常商用，其他az显示下线，可配置为： - "cond:operation:status"设置为"abandon"  - "cond:operation:az"设置为"az0(normal), az1(sellout), az2(obt), az3(promotion)"   说明： 如果规格在某个AZ下的状态与cond:operation:status配置状态不同，必须配置该参数。 |
   
表6attachableQuantity字段数据结构说明 
| 参数        | 参数类型    | 描述          |
|:---|:---|:---|
| free_scsi | Integer | 可挂载的scsi卷数。 |
| free_blk  | Integer | 可挂载的vbd卷数。  |
| free_disk | Integer | 可挂载的卷数。     |
   
#### 响应示例
```
{
    "flavors": [
         {
            "id": "physical.kl1.3xlarge",
            "name": "physical.kl1.3xlarge",
            "vcpus": "24",
            "ram": 321729,
            "disk": "6707",
            "swap": "",
            "links": [
                {
                    "rel": "self",
                    "href": "https://compute.Region.dc1.domainname.com/v2/bbf1946d374b44a0a2a95533562ba954/flavors/physical.kl1.3xlarge",
                    "type": null
                },
                {
                    "rel": "bookmark",
                    "href": "https://compute.Region.dc1.domainname.com/bbf1946d374b44a0a2a95533562ba954/flavors/physical.kl1.3xlarge",
                    "type": null
                }
            ],
            "OS-FLV-EXT-DATA:ephemeral": 0,
            "rxtx_factor": 1,
            "OS-FLV-DISABLED:disabled": false,
            "rxtx_quota": null,
            "rxtx_cap": null,
            "os-flavor-access:is_public": false,
            "os_extra_specs": {
                "capabilities:cpu_arch": "x86_64",
                "baremetal:disk_detail": "SAS SSD:2*800G Raid 1 + NVMe SSD Card1.6T",
                "capabilities:hypervisor_type": "ironic",
                "baremetal:__support_evs": "true",
                "baremetal:extBootType": "LocalDisk",
                "capabilities:board_type": "o2m",
                "baremetal:net_num": "2",
                "baremetal:netcard_detail": "2 x 2*10GE",
                "baremetal:cpu_detail": "Intel Xeon E5-2667 V4 (2*8core* 3.2 GHz)",
                "resource_type": "ironic",
                "baremetal:memory_detail": "256GB DDR4 RAM(GB)"
            }
        }
    ]
}
```
#### 返回值
正常返回值：
| 返回值 | 说明           |
|:---|:---|
| 200 | 服务器已成功处理了请求。 |
   
其他返回值请参考[状态码](https://support.huaweicloud.com/api-bms/bms_api_0801.html)。
#### 错误码
请参考[错误码](https://support.huaweicloud.com/api-bms/bms_api_0802.html)。