功能介绍
查询云服务器规格信息列表。
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查询参数参数
是否必选
参数类型
描述
minDisk
否
String
最小的硬盘规格,单位GB,大于等于此规格的都可以查询到。
minRam
否
String
最小的内存规格,单位MB,大于等于此规格的都可以查询到。
sort_key
否
String
排序字段,默认值为:flavorid。可以指定的其他key为name/ memory_mb/vcpus/root_gb/flavorid。
sort_dir
否
String
升序/降序排序,默认值为:asc。可以指定的参数为asc/desc。
请求消息
无
响应消息
响应参数如表3所示。
表3响应参数参数
参数类型
描述
flavors
Array of objects
云服务器规格列表,详情请参见表4。
flavors_links
Array of objects
分页查询时,查询下一页数据链接 , 详情请参见表5 flavors_links字段数据结构说明。
表4flavors数据结构说明参数
参数类型
描述
id
String
云服务器规格ID。
name
String
云服务器规格名称。
vcpus
Integer
云服务器规格对应的CPU核数。
ram
Integer
云服务器规格对应的内存大小,单位为MB。
disk
Integer
云服务器规格对应要求系统盘大小。
当前未使用该参数,缺省值为0。
swap
String
云服务器规格对应要求的交换分区大小。
当前未使用该参数,缺省值为""。
OS-FLV-EXT-DATA:ephemeral
Integer
扩展属性,临时盘大小。
当前未使用该参数,缺省值为0。
OS-FLV-DISABLED:disabled
Boolean
扩展属性,该云服务器规格是否禁用。
当前未使用该参数,缺省值为false。
rxtx_factor
Float
云服务器可使用网络带宽与网络硬件带宽的比例。
当前未使用该参数,缺省值为1.0。
os-flavor-access:is_public
Boolean
扩展属性,flavor是否给所有租户使用。
true:表示给所有租户使用。
false:表示给指定租户使用。
缺省值为true。
links
Array of objects
规格相关快捷链接地址,详情请参见表5。
表5links字段数据结构说明参数
参数类型
描述
rel
String
快捷链接标记名称。
href
String
对应快捷链接。
请求示例GET https://{endpoint}/v2.1/743b4c0428d94531b9f2add666642e6b/flavors/detail
响应示例{
"flavors": [
{
"name": "c3.2xlarge.2",
"links": [
{
"href": "https://compute.region.xxx.com/v2.1/743b4c0428d94531b9f2add666642e6b/flavors/c3.2xlarge.2",
"rel": "self"
},
{
"href": "https://compute.region.xxx.com/743b4c0428d94531b9f2add666642e6b/flavors/c3.2xlarge.2",
"rel": "bookmark"
}
],
"ram": 16384,
"OS-FLV-DISABLED:disabled": false,
"vcpus": 8,
"swap": "",
"os-flavor-access:is_public": true,
"rxtx_factor": 1,
"OS-FLV-EXT-DATA:ephemeral": 0,
"disk": 0,
"id": "c3.2xlarge.2"
},
{
"name": "c3.2xlarge.4",
"links": [
{
"href": "https://compute.region.xxx.com/v2.1/743b4c0428d94531b9f2add666642e6b/flavors/c3.2xlarge.4",
"rel": "self"
},
{
"href": "https://compute.region.xxx.com/743b4c0428d94531b9f2add666642e6b/flavors/c3.2xlarge.4",
"rel": "bookmark"
}
],
"ram": 32768,
"OS-FLV-DISABLED:disabled": false,
"vcpus": 8,
"swap": "",
"os-flavor-access:is_public": true,
"rxtx_factor": 1,
"OS-FLV-EXT-DATA:ephemeral": 0,
"disk": 0,
"id": "c3.2xlarge.4"
}
]
}
返回值