文档首页 > > API参考> API> 裸金属服务器规格管理> 查询规格详情和规格扩展信息列表

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

分享
更新时间: 2019/12/31 GMT+08:00

功能介绍

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

URI

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

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

参数

是否必选

描述

project_id

项目ID。

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

请求消息

  • 请求参数

    以下列表为查询规格列表时可选的查询检索参数:

    参数

    是否必选

    参数类型

    描述

    availability_zone

    String

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

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

  • 请求样例
    1
    GET https://{BMS Endpoint}/v1/c685484a8cc2416b97260938705deb65/baremetalservers/flavors?availability_zone=cn-north-1a
    

响应消息

  • 响应参数

    参数

    参数类型

    描述

    flavors

    Array of objects

    裸金属服务器规格列表,详情请参见表2 flavors数据结构说明

    表2 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

    Integer

    未使用。

    rxtx_quota

    String

    未使用。

    rxtx_cap

    String

    未使用。

    os-flavor-access:is_public

    Boolean

    是否是公共规格。

    false:私有规格;true:公共规格

    links

    Array of objects

    规格相关快捷链接地址,详情请参见表3 links字段数据结构说明

    os_extra_specs

    Object

    裸金属服务器规格的扩展字段,详情请参见表4 os_extra_specs数据结构说明

    表3 links字段数据结构说明

    参数

    参数类型

    描述

    rel

    String

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

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

    href

    String

    对应快捷链接。

    type

    String

    快捷链接类型。

    表4 os_extra_specs数据结构说明

    参数

    参数类型

    描述

    resource_type

    String

    标识该规格对应的资源类型,取值范围为“ironic”。

    capabilities:cpu_arch

    String

    裸金属服务器的CPU架构类型,取值为:

    • x86_64(适用于x86机型)
    • aarch64(适用于ARM机型)

    baremetal:disk_detail

    String

    磁盘物理规格描述信息。

    capabilities:hypervisor_type

    String

    标示ironic类型的规格。

    baremetal:__support_evs

    String

    标识当前的规格是否支持挂载EVS卷。

    • 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

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

其他返回值请参考状态码

错误码

请参考错误码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区