功能介绍

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

调试

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

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": "c3.medium",
            "links": [
                {
                    "href": "https://compute.region.xxx.com/v2.1/743b4c0428d94531b9f2add666642e6b/flavors/c3.medium",
                    "rel": "self"
                },
                {
                    "href": "https://compute.region.xxx.com/743b4c0428d94531b9f2add666642e6b/flavors/c3.medium",
                    "rel": "bookmark"
                }
            ],
            "name": "c3.medium"
        },
        {
            "id": "c3.xlarge",
            "links": [
                {
                    "href": "https://compute.region.xxx.com/v2.1/743b4c0428d94531b9f2add666642e6b/flavors/c3.xlarge",
                    "rel": "self"
                },
                {
                    "href": "https://compute.region.x.com/743b4c0428d94531b9f2add666642e6b/flavors/c3.xlarge",
                    "rel": "bookmark"
                }
            ],
            "name": "c3.xlarge"
        }
    ]
}     

返回值

请参考通用请求返回值。

父主题： 规格管理

内容没看懂？ 不太想学习？想快速解决？ 有偿解决： 联系专家