查询云服务器规格列表

功能介绍

查询系统中可用的弹性云服务器规格列表。Nova接口到请求消息后，通过nova-api查询数据库中的规格信息。

URI

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

参数说明请参见表1。

表1 路径参数
参数	是否必选	描述
project_id	是	项目ID。获取方法请参见获取项目ID。

支持分页查询，请参见分页查询。

可以将如下作为URI参数，过滤查询结果。使用方式：/v2/{project_id}/flavors?minDisk={minDisk}&minRam={minRam}

请求参数如表2所示。

表2 查询参数
参数	是否必选	参数类型	描述
minDisk	否	Integer	最小的硬盘规格，单位GB，大于等于此规格的都可以查询到。
minRam	否	Integer	最小的内存规格，单位MB，大于等于此规格的都可以查询到。
sort_key	否	String	排序字段，默认值为：flavorid。可以指定的其他key为：name、 memory_mb、vcpus、root_gb、flavorid。
sort_dir	否	String	升序/降序排序，默认值为：asc。可以指定的参数为asc/desc。

请求消息

无

响应消息

响应参数如表4所示。

表3 响应参数
参数	参数类型	描述
flavors	Array of objects	云服务器规格列表，详情请参见表4。
flavors_links	Array of objects	分页查询时，查询下一页数据链接 ,详情请参见表5 flavors_links字段数据结构说明。

表4 flavors数据结构说明
参数	参数类型	描述
id	String	规格ID。
links	Array of objects	规格相关快捷链接地址。详情请参见表5。
name	String	规格名称。

表5 links字段数据结构说明
参数	参数类型	描述
rel	String	快捷链接标记名称。
href	String	对应快捷链接。

请求示例

查询系统中可用的云服务器规格列表。

GET https://{endpoint}/v2.1/743b4c0428d94531b9f2add666642e6b/flavors

响应示例

{
    "flavors": [
        {
            "id": "s3.xlarge.1",
            "links": [
                {
                    "href": "https://compute.region.example.com/v2.1/743b4c0428d94531b9f2add666642e6b/flavors/s3.xlarge.1",
                    "rel": "self"
                },
                {
                    "href": "https://compute.region.example.com/743b4c0428d94531b9f2add666642e6b/flavors/s3.xlarge.1",
                    "rel": "bookmark"
                }
            ],
            "name": "s3.xlarge.1"
        },
        {
            "id": "s3.xlarge.2",
            "links": [
                {
                    "href": "https://compute.region.example.com/v2.1/743b4c0428d94531b9f2add666642e6b/flavors/s3.xlarge.2",
                    "rel": "self"
                },
                {
                    "href": "https://compute.region.x.com/743b4c0428d94531b9f2add666642e6b/flavors/s3.xlarge.2",
                    "rel": "bookmark"
                }
            ],
            "name": "s3.xlarge.2"
        }
    ]
}