文档首页/ 弹性云服务器 ECS/ API参考/ API/ 规格管理/ 查询云服务器规格变更支持列表
更新时间：2025-08-18 GMT+08:00
查看PDF
分享

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

功能介绍

变更规格时，部分规格的云服务器之间不能互相变更。您可以通过本接口，通过指定弹性云服务器规格，查询该规格可以变更的规格列表。

URI

GET /v1/{project_id}/cloudservers/resize_flavors

参数说明请参见表1。
表1 路径参数

参数

是否必选

描述

project_id

是

项目ID。

获取方法请参见获取项目ID。

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。

取值范围：

不涉及
表4 flavors数据结构说明

参数

参数类型

描述

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。

取值范围：

不涉及

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。

取值范围：

不涉及

instance_quota

Object

参数解释：

预留属性。

取值范围：

不涉及
表5 links字段数据结构说明

参数

参数类型

描述

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"
             }
        }
    ]
}

返回值

请参考通用请求返回值。

错误码

请参考错误码。

父主题： 规格管理