更新时间:2022-02-22 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
      
    • 携带一个可选参数
      1
      GET https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/flavors/detail?minDisk=3725
      
    • 携带多个可选参数
      1
      GET https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/flavors/detail?minDisk=3725&is_public=true
      

响应消息

  • 响应参数

    参数

    参数类型

    描述

    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

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

其他返回值请参考状态码

错误码

请参考错误码