# 查询云服务器规格变更支持列表 - ListResizeFlavors #### 功能介绍 变更规格时，部分规格的云服务器之间不能互相变更。您可以通过本接口，通过指定弹性云服务器规格，查询该规格可以变更的规格列表。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=ECS&api=ListResizeFlavors)中调试该接口。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ecs/ecs_06_0000.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | ecs:cloudServers:listResizeFlavors | list | - | - | ecs:cloudServers:list | - | #### URI GET /v1/{project_id}/cloudservers/resize_flavors 参数说明请参见[表1]。 表1路径参数 | 参数 | 是否必选 | 描述 | |:---|:---|:---| | project_id | 是 | **参数解释：** 项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-ecs/ecs_01_0016.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | ![](https://support.huaweicloud.com/api-ecs/public_sys-resources/note_3.0-zh-cn.png) instance_uuid、source_flavor_id、source_flavor_name三个参数必须要选择一个参数使用。如果同时选择传递多个参数，则系统默认按照instance_uuid、source_flavor_id、source_flavor_name的优先级进行处理。 当指定参数instance_uuid查询可切换规格列表时，由于镜像与规格之间有依赖关系，如果虚拟机使用公共镜像创建，接口内部会根据虚拟机所用镜像的标签对规格列表进行过滤，仅返回支持该镜像的规格列表。 查询参数如[表2]所示。 表2查询参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | instance_uuid | 否 | String | **参数解释：** 进行规格切换的云服务器ID，UUID格式。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | source_flavor_id | 否 | String | **参数解释：** 进行规格切换的云服务器源规格ID。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | source_flavor_name | 否 | String | **参数解释：** 进行规格切换的云服务器源规格名称。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | sort_key | 否 | String | **参数解释：** 排序字段。 **约束限制：** 不涉及 **取值范围：** - flavorid：表示规格ID。 - name：表示规格名称。 - memory_mb：表示内存大小。 - vcpus：表示CPU大小。 - root_gb：表示系统盘大小。 **默认取值：** flavorid | | sort_dir | 否 | String | **参数解释：** 升序/降序排序。 **约束限制：** 不涉及 **取值范围：** - asc：表示升序。 - desc：表示降序。 **默认取值：** asc | | limit | 否 | Integer | **参数解释：** 单页面可显示的flavor条数最大值。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 1000 | | marker | 否 | String | **参数解释：** 以单页最后一条flavor的ID作为分页标记。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | #### 请求消息 无 #### 响应消息 响应参数如[表3]所示。 表3响应参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | flavors | Array of objects | **参数解释：** 云服务器规格列表。 详情请参见[表4]。 **取值范围：** 不涉及 | 表4flavors数据结构说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释：** 云服务器规格ID。 **取值范围：** 不涉及 | | name | String | **参数解释：** 云服务器规格名称。 **取值范围：** 不涉及 | | vcpus | String | **参数解释：** 云服务器规格对应的CPU核数。 **取值范围：** 不涉及 | | ram | Integer | **参数解释：** 云服务器规格对应的内存大小，单位为MiB。 **取值范围：** 不涉及 | | 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：表示给所有租户使用。 - false：表示给指定租户使用。 缺省值为true。 | | links | Array of objects | **参数解释：** 规格相关快捷链接地址。 详情请参见[表5]。 **取值范围：** 不涉及 | | extra_specs | Object | **参数解释：** 云服务器规格的扩展字段。 详情请参见[表6](https://support.huaweicloud.com/api-ecs/zh-cn_topic_0020212656.html#ZH-CN_TOPIC_0020212656__table59078165)。 **取值范围：** 不涉及 | | instance_quota | Object | **参数解释：** 预留属性。 **取值范围：** 不涉及 | 表5links字段数据结构说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | rel | String | **参数解释：** 快捷链接标记名称。 **取值范围：** 不涉及 | | href | String | **参数解释：** 对应快捷链接。 **取值范围：** 不涉及 | | type | String | **参数解释：** 快捷链接类型，当前接口未使用，缺省值为null。 **取值范围：** 不涉及 | #### 请求示例 查询云服务器规格"c3.xlarge.2"支持变更的规格列表。 ``` GET https://{endpoint}/v1/{project_id}/cloudservers/resize_flavors?source_flavor_id=c3.xlarge.2 ``` #### 响应示例 ``` { "flavors": [ { "id": "c3.15xlarge.2", "name": "c3.15xlarge.2", "vcpus": "60", "ram": 131072, "disk": "0", "swap": "", "links": [ { "rel": "self", "href": "https://ecs.region.example.com/v1.0/743b4c0428d94531b9f2add666642e6b/flavors/c3.15xlarge.2", "type": null }, { "rel": "bookmark", "href": "https://ecs.region.example.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" } } ] } ``` #### 返回值 请参考[通用请求返回值](https://support.huaweicloud.com/api-ecs/ecs_07_0001.html)。 #### 错误码 请参考[错误码](https://support.huaweicloud.com/api-ecs/ecs_07_0002.html)。