文档首页/ 裸金属服务器 BMS/ API参考/ API/ 裸金属服务器规格管理/ 查询规格详情和规格扩展信息列表
更新时间:2024-08-01 GMT+08:00
分享

查询规格详情和规格扩展信息列表

功能介绍

查询裸金属服务器的规格详情和规格的扩展信息。您可以调用此接口查询“baremetal:extBootType”参数取值,以确认某个规格是否支持快速发放。

调试

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

URI

GET /v1/{project_id}/baremetalservers/flavors?availability_zone={availability_zone}

参数说明请参见表1
表1 参数说明

参数

是否必选

描述

project_id

项目ID。

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

表2 查询参数

参数

是否必选

参数类型

描述

availability_zone

String

可用区,需要指定可用区(AZ)的名称。

请参考地区和终端节点获取。

请求参数

请求示例

查询可用区为cn-north-1a的裸金属服务器的规格详情和规格扩展信息列表。
1
GET https://{BMS Endpoint}/v1/c685484a8cc2416b97260938705deb65/baremetalservers/flavors?availability_zone=cn-north-1a

响应参数

参数

参数类型

描述

flavors

Array of objects

裸金属服务器规格列表,详情请参见表3

表3 flavors数据结构说明

参数

参数类型

描述

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

表4 links字段数据结构说明

参数

参数类型

描述

rel

String

快捷链接标记名称。取值为:

  • self:包含版本号的资源链接,需要立即跟踪时使用此类链接。
  • bookmark:提供了适合长期存储的资源链接。

href

String

对应快捷链接。

type

String

快捷链接类型。

表5 os_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配置状态不同,必须配置该参数。

响应示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
{
    "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

服务器已成功处理了请求。

其他返回值请参考状态码

错误码

请参考错误码

相关文档