查询规格详情和规格扩展信息列表
功能介绍
查询云服务器规格详情信息和规格扩展信息列表。
URI
GET /v1/{project_id}/cloudservers/flavors?availability_zone={availability_zone}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
availability_zone |
否 |
String |
可用区,需要指定可用区(AZ)的名称,当此字段不为空时,只返回可使用(如:normal、obt、promotion等状态)的flavor列表。 |
请求消息
无
响应消息
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
云服务器规格的ID。 |
|
name |
String |
云服务器规格的名称。 |
|
vcpus |
String |
云服务器规格对应的CPU核数。 |
|
ram |
Integer |
云服务器规格对应的内存大小,单位为MB。 |
|
disk |
String |
云服务器规格对应要求系统盘大小。 当前未使用该参数,缺省值为0。 |
|
swap |
String |
云服务器规格对应要求的交换分区大小。 当前未使用该参数,缺省值为""。 |
|
OS-FLV-EXT-DATA:ephemeral |
Integer |
扩展属性,临时盘大小。 当前未使用该参数,缺省值为0。 |
|
OS-FLV-DISABLED:disabled |
Boolean |
扩展属性,该云服务器规格是否禁用。 当前未使用该参数,缺省值为false。 |
|
rxtx_factor |
Float |
云服务器可使用网络带宽与网络硬件带宽的比例。 当前未使用该参数,缺省值为1.0。 |
|
rxtx_quota |
String |
云服务器可使用网络带宽的软限制。 当前未使用该参数,缺省值为null。 |
|
rxtx_cap |
String |
云服务器可使用网络带宽的硬限制。 当前未使用该参数,缺省值为null。 |
|
os-flavor-access:is_public |
Boolean |
扩展属性,flavor是否给所有租户使用。
缺省值为true。 |
|
links |
Array of objects |
规格相关快捷链接地址,详情请参见表5。 |
|
os_extra_specs |
Object |
云服务器规格的扩展字段,详情请参见表6。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
rel |
String |
快捷链接标记名称。 |
|
href |
String |
对应快捷链接。 |
|
type |
String |
快捷链接类型,当前接口未使用,缺省值为null。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
ecs:performancetype |
String |
云服务器规格的分类:
|
|
resource_type |
String |
资源类型。resource_type是为了区分云服务器的物理主机类型。 |
|
quota:local_disk |
String |
值格式为{type}:{count}:{size}:{safeFormat},其中:
说明:
磁盘增强型特有字段。 |
|
quota:nvme_ssd |
String |
值格式为{type}:{spec}:{num}:{size}:{safeFormat},其中:
说明:
超高I/O型特有字段。 |
|
ecs:generation |
String |
弹性云服务器类型的代数。 示例:s3中的3表示通用型III代,详细的规格类型和代系请参考《弹性云服务器用户指南》的“实例规格”。 |
|
ecs:virtualization_env_types |
String |
虚拟化类型。
说明:
可选字段。 |
|
cond:operation:status |
String |
此参数是Region级配置,某个AZ没有在cond:operation:az参数中配置时默认使用此参数的取值。不配置或无此参数时等同于“normal”。取值范围:
|
|
cond:operation:az |
String |
此参数是AZ级配置,某个AZ没有在此参数中配置时默认使用cond:operation:status参数的取值。此参数的配置格式“az(xx)”。()内为某个AZ的flavor状态,()内必须要填有状态,不填为无效配置。状态的取值范围与cond:operation:status参数相同。 例如:flavor在某个region的az0正常商用,az1售罄,az2公测,az3正常商用,其他az显示下线,可配置为:
说明:
如果flavor在某个AZ下的状态与cond:operation:status配置状态不同,必须配置该参数。 |
|
quota:max_rate |
String |
最大带宽
|
|
quota:min_rate |
String |
基准带宽
|
|
quota:max_pps |
String |
内网最大收发包能力
|
|
cond:operation:charge |
String |
计费类型
|
|
cond:compute |
String |
计算约束
|
弹性云服务器规格一览表,请参见《弹性云服务器用户指南》的“实例规格”章节。
请求示例
查询云服务器规格详情信息和规格扩展信息列表。
GET https://{endpoint}/v1/{project_id}/cloudservers/flavors?availability_zone=availability_value
响应示例
{
"flavors": [
{
"id": "c3.2xlarge.2",
"name": "c3.2xlarge.2",
"vcpus": "8",
"ram": 16384,
"disk": "0",
"swap": "",
"links": [
{
"rel": "self",
"href": "https://ecs.region.xxx.com/v1.0/743b4c0428d94531b9f2add666642e6b/flavors/c3.2xlarge.2",
"type": null
},
{
"rel": "bookmark",
"href": "https://ecs.region.xxx.com/743b4c0428d94531b9f2add666642e6b/flavors/c3.2xlarge.2",
"type": null
}
],
"OS-FLV-EXT-DATA:ephemeral": 0,
"rxtx_factor": 1,
"OS-FLV-DISABLED:disabled": false,
"rxtx_quota": null,
"rxtx_cap": null,
"os-flavor-access:is_public": true,
"os_extra_specs": {
"ecs:virtualization_env_types": "CloudCompute",
"ecs:generation": "c3",
"ecs:performancetype": "computingv3",
"resource_type": "IOoptimizedC3_2"
}
}
]
}
返回值
请参考通用请求返回值。
错误码
请参考错误码。