文档首页/ 弹性云服务器 ECS/ API参考（安卡拉区域）/ API（推荐）/ 规格管理/ 查询云服务器规格变更支持列表
更新时间：2024-04-16 GMT+08:00
查看PDF
分享

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

功能介绍

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

URI

GET /v2.1/{project_id}/resize_flavors?instance_uuid={instance_uuid}&source_flavor_id={source_flavor_id}&source_flavor_name={source_flavor_name}&sort_key={sort_key}&sort_dir={sort_dir}&limit={limit}&marker={marker}

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

参数

是否必选

描述

project_id

是

项目ID。

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

instance_uuid、source_flavor_id、source_flavor_name三个参数必须要选择一个参数使用。如果同时选择传递多个参数，则系统默认按照instance_uuid、source_flavor_id、source_flavor_name的优先级进行处理。

查询参数如表2所示。

表2 查询参数

参数

是否必选

参数类型

描述

instance_uuid

否

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作为分页标记。

请求消息

无

响应消息

响应参数如表3所示。

表3 响应参数

参数

参数类型

描述

flavors

Array of objects

云服务器规格列表。

详情请参见表4。
表4 flavors数据结构说明

参数

参数类型

描述

id

String

云服务器规格ID。

name

String

云服务器规格名称。

vcpus

Integer

云服务器规格对应要求的CPU核数。

ram

Integer

云服务器规格对应要求的内存大小，单位为MB。

disk

Integer

云服务器规格对应要求的系统盘大小。

当前未使用该参数，缺省值为0。

swap

String

云服务器规格对应要求的交换分区大小。

当前未使用该参数，缺省值为""。

OS-FLV-EXT-DATA:ephemeral

Integer

扩展属性，临时盘大小。

当前未使用该参数，缺省值为0。

OS-FLV-DISABLED:disabled

Boolean

扩展属性，指定规格是否可用。

  • true：不可用
  • false：可用
说明：

当前未使用该参数。

rxtx_factor

Float

扩展属性。

说明：

当前未使用该参数。

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

Array of objects

云服务器规格的扩展字段。

详情请参见表6。
表5 links字段数据结构说明

参数

是否必选

参数类型

描述

rel

是

String

快捷链接标记名称。

href

是

String

对应快捷链接。

type

是

String

快捷链接类型，当前接口未使用，缺省值为null。

请求示例

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://compute-ext.region.xxx.com/v1.0/743b4c0428d94531b9f2add666642e6b/flavors/c3.15xlarge.2",
                    "type": null
                },
                {
                    "rel": "bookmark",
                    "href": "https://compute-ext.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"
             }
        }
    ]
}

返回值

请参考通用请求返回值。

错误码

请参考错误码。

父主题： 规格管理