响应参数
4.4 规格管理
4.4.2 查询云服务器规格变更支持列表
}
返回值
请参考通用请求返回值。
错误码
请参考错误码。
4.4.2 查询云服务器规格变更支持列表
功能介绍
变更规格时,部分规格的云服务器之间不能互相变更。您可以通过本接口,通过指定 弹性云服务器规格,查询该规格可以变更的规格列表。
调试
您可以在API Explorer中调试该接口。
URI
GET /v1/{project_id}/cloudservers/resize_flavors?
instance_uuid={instance_uuid}&source_flavor_id={source_flavor_id}&source_flavor_
name={source_flavor_name}
参数说明请参见表4-95。
表4-95 路径参数
参数 是否必选 描述
project_id 是 项目ID。
获取方法请参见获取项目ID。
说明
instance_uuid、source_flavor_id、source_flavor_name三个参数必须要选择一个参数使用。如 果同时选择传递多个参数,则系统默认按照instance_uuid、source_flavor_id、
source_flavor_name的优先级进行处理。
当指定参数instance_uuid查询可切换规格列表时,由于镜像与规格之间有依赖关系,如果虚拟 机使用公共镜像创建,接口内部会根据虚拟机所用镜像的标签对规格列表进行过滤,仅返回支持 该镜像的规格列表。
查询参数如表4-96所示。
表4-96 查询参数
参数 是否必选 参数类型 描述
instance_uui
d 否 String 进行规格切换的云服务器ID,
UUID格式。
source_flavor
_id 否 String 进行规格切换的云服务器源规格
ID。
source_flavor
_name 否 String 进行规格切换的云服务器源规格
名称。
sort_key 否 String 排序字段。
key的取值范围:
● flavorid:表示规格ID。
sort_key的默认值为
“flavorid”。
● name:表示规格名称。
● memory_mb:表示内存大 小。
● vcpus:表示CPU大小。
● root_gb:表示系统盘大小。
sort_dir 否 String 升序/降序排序,默认值为:
asc。
取值范围:
● asc:表示升序。
● desc:表示降序。
limit 否 Integer 单页面可显示的flavor条数最大 值,默认是1000。
marker 否 String 以单页最后一条flavor的ID作为分 页标记。
请求消息
无
响应消息
响应参数如表4-97所示。
表4-97 响应参数
参数 是否必选 参数类型 描述
flavors 是 Array of objects 云服务器规格列表。
详情请参见表4-98。
表4-98 flavors 数据结构说明
参数 是否必选 参数类型 描述
id 是 String 云服务器规格ID。
name 是 String 云服务器规格名称。
vcpus 是 String 云服务器规格对应的CPU核数。
ram 是 Integer 云服务器规格对应的内存大小,
单位为MB。
disk 是 String 云服务器规格对应的系统盘大
小。
当前未使用该参数,缺省值为 0。
swap 否 String 云服务器规格对应要求的交换分
区大小。
当前未使用该参数,缺省值为
""。
OS-FLV-EXT-DATA:ephem eral
是 Integer 扩展属性,临时盘大小。
当前未使用该参数,缺省值为 0。
OS-FLV-DISABLED:dis abled
是 Boolean 扩展属性,该云服务器规格是否
禁用。
当前未使用该参数,缺省值为 false。
rxtx_factor 是 Float 云服务器可使用网络带宽与网络 硬件带宽的比例。
当前未使用该参数,缺省值为 1。
rxtx_quota 是 String 云服务器可使用网络带宽的软限 制。
当前未使用该参数,缺省值为 null。
rxtx_cap 是 String 云服务器可使用网络带宽的硬限 制。
当前未使用该参数,缺省值为 null。
参数 是否必选 参数类型 描述
os-flavor-access:is_pub lic
是 Boolean 扩展属性,flavor是否给所有租 户使用。
● true:表示给所有租户使用。
● false:表示给指定租户使用。
缺省值为true。
links 是 Array of objects 规格相关快捷链接地址。
详情请参见表4-99。
extra_specs 是 Object 云服务器规格的扩展字段。
详情请参见表4-93。
"href": "https://ecs.region.xxx.com/v1.0/743b4c0428d94531b9f2add666642e6b/flavors/
c3.15xlarge.2",
"type": null },
{
"rel": "bookmark",
"href": "https://ecs.region.xxx.com/743b4c0428d94531b9f2add666642e6b/flavors/c3.15xlarge.
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, "extra_specs": {
"ecs:virtualization_env_types": "CloudCompute", "ecs:generation": "c3",
"ecs:performancetype": "computingv3", "resource_type": "IOoptimizedC3_2"
} } ] }
返回值
请参考通用请求返回值。
错误码
请参考错误码。