查询云服务器规格列表NovaListFlavors
接口说明
查询系统中可用的弹性 云服务器 规格列表。
约束说明
无
URL
GET https://ecs.cn-north-1.myhuaweicloud.com/v2.1/{project_id}/flavors
请求参数
| 名称 | 类型 | IN | 必选 | 描述 |
|---|---|---|---|---|
|
X-Auth-Token
|
string | header | 是 |
用户Token。 通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
|
project_id
|
string | path | 是 |
项目ID。 |
|
minDisk
|
integer | query | 否 |
最小的硬盘规格,单位GB,大于等于此规格的都可以查询到。 |
|
minRam
|
integer | query | 否 |
最小的内存规格,单位MB,大于等于此规格的都可以查询到。 |
|
sort_dir
|
string | query | 否 |
升序/降序排序,默认值为:asc。可以指定的参数为asc/desc。 |
|
sort_key
|
string | query | 否 |
排序字段,默认值为:flavorid。 可以指定的其他key为:name、 memory_mb、vcpus、root_gb、flavorid。 |
返回参数
返回码: 200
OK
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
flavors
|
Array of NovaSimpleFlavor objects | 是 |
云服务 器规格列表。 |
|
flavors_links
|
Array of PageLink objects | 否 |
分页查询时,查询下一页数据链接。 |
200 flavors
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
id
|
string | 是 |
规格ID。 |
|
links
|
Array of NovaLink objects | 是 |
规格相关快捷链接地址。 |
|
name
|
string | 是 |
规格名称。 |
200 flavors.links
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
href
|
string | 是 |
相应资源的链接。 |
|
rel
|
string | 是 |
有三种取值。self:自助链接包含版本链接的资源。立即链接后使用这些链接。bookmark:书签链接提供了一个永久资源的永久链接,该链接适合于长期存储。alternate:备用链接可以包含资源的替换表示形式。例如,OpenStack计算映像可能在OpenStack映像服务中有一个替代表示。 |
200 flavors_links
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
href
|
string | 是 |
相应资源的链接。 |
|
rel
|
string | 是 |
对应快捷链接。 |
请求示例
示例 1
"GET https://{endpoint}/v2.1/743b4c0428d94531b9f2add666642e6b/flavors"
返回示例
返回码：200
OK
示例 1
{
"flavors": [
{
"descrition": null,
"id": "4",
"links": [
{
"href": "http://192.168.82.222:8774/v2/9c53a566cb3443ab910cf0daebca90c4/flavors/4",
"rel": "self"
},
{
"href": "http://192.168.82.222:8774/9c53a566cb3443ab910cf0daebca90c4/flavors/4",
"rel": "bookmark"
}
],
"name": "m1.large"
},
{
"id": "5",
"links": [
{
"href": "http://192.168.82.222:8774/v2/9c53a566cb3443ab910cf0daebca90c4/flavors/5",
"rel": "self"
},
{
"href": "http://192.168.82.222:8774/9c53a566cb3443ab910cf0daebca90c4/flavors/5",
"rel": "bookmark"
}
],
"name": "m1.xlarge"
}
]
}
"flavors": [
{
"descrition": null,
"id": "4",
"links": [
{
"href": "http://192.168.82.222:8774/v2/9c53a566cb3443ab910cf0daebca90c4/flavors/4",
"rel": "self"
},
{
"href": "http://192.168.82.222:8774/9c53a566cb3443ab910cf0daebca90c4/flavors/4",
"rel": "bookmark"
}
],
"name": "m1.large"
},
{
"id": "5",
"links": [
{
"href": "http://192.168.82.222:8774/v2/9c53a566cb3443ab910cf0daebca90c4/flavors/5",
"rel": "self"
},
{
"href": "http://192.168.82.222:8774/9c53a566cb3443ab910cf0daebca90c4/flavors/5",
"rel": "bookmark"
}
],
"name": "m1.xlarge"
}
]
}
错误码
请参考 错误码说明。
