文档首页> 裸金属服务器 BMS> API参考> API(OpenStack Nova v2.1 原生)> 裸金属服务器规格查询> 查询裸金属服务器规格信息列表(OpenStack原生)
更新时间:2024-01-31 GMT+08:00
分享

查询裸金属服务器规格信息列表(OpenStack原生)

功能介绍

查询裸金属服务器规格信息列表。

约束

本接口查询出来的规格为系统中所有的规格,其中规格的名称以“physical”开头的为裸金属服务器的规格,可用于申请裸金属服务器

URI

GET /v2.1/{project_id}/flavors/detail{?minDisk={minDisk}&minRam={minRam}&sort_key={sort_key}&sort_dir={sort_dir}}

参数说明请参见表1

表1 参数说明

参数

是否必选

描述

project_id

项目ID。

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

请求参数

查询裸金属服务器规格时可选的查询检索参数如表2所示。

表2 可选的查询检索参数

参数

是否必选

参数类型

描述

minDisk

String

最小的硬盘规格,单位GB,大于等于此规格的都可以查询到。

minRam

String

最小的内存规格,单位MB,大于等于此规格的都可以查询到。

sort_key

String

排序字段,默认值为:flavorid。可以指定的其他key为name/ memory_mb/vcpus,/root_gb/flavorid。

sort_dir

String

升序/降序排序。

可以指定的参数为asc/desc,默认值为:asc

请求示例

  • 查询规格信息列表。
    1
    GET https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/flavors/detail
    
  • 查询规格信息列表且最小的磁盘规格为3725GB。
    1
    GET https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/flavors/detail?minDisk=3725
    

响应参数

参数

参数类型

描述

flavors

Array of objects

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

表3 flavors数据结构说明

参数

参数类型

描述

id

String

裸金属服务器规格ID。

name

String

裸金属服务器规格名称。

vcpus

Integer

裸金属服务器规格对应的CPU核数。

ram

Integer

裸金属服务器规格对应的内存大小,单位为MB。

disk

Integer

裸金属服务器规格对应要求的磁盘大小,单位为GB。

swap

String

未使用。

OS-FLV-EXT-DATA:ephemeral

Integer

未使用。

OS-FLV-DISABLED:disabled

Boolean

未使用。

rxtx_factor

Float

未使用。

os-flavor-access:is_public

Boolean

未使用。

links

Array of objects

规格相关快捷链接地址。详情请参见表4

表4 links字段数据结构说明

参数

参数类型

描述

rel

String

快捷链接标记名称。

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

href

String

对应快捷链接。

响应示例

{
    "flavors": [
        {
            "name": "physical.o2.medium",
            "links": [
                {
                    "href": "https://openstack.example.com/v2/c685484a8cc2416b97260938705deb65/flavors/physical.o2.medium",
                    "rel": "self"
                },
                {
                    "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/flavors/physical.o2.medium",
                    "rel": "bookmark"
                 }
            ],
            "ram": 321725,
            "OS-FLV-DISABLED:disabled": false,
            "vcpus": 56,
            "swap": "",
            "os-flavor-access:is_public": true,
            "rxtx_factor": 1,
            "OS-FLV-EXT-DATA:ephemeral": 0,
            "disk": 3725,
            "id": "physical.o2.medium"
        }
    ]
}

返回值

正常返回值:

返回值

说明

200

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

其他返回值请参考状态码

错误码

请参考错误码

分享:

    相关文档

    相关产品