• 沒有找到結果。

查询云服务器规格变更支持列表

响应参数

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"

} } ] }

返回值

请参考通用请求返回值。

错误码

请参考错误码。