# 查询规格详情和规格扩展信息列表 - ListFlavors #### 功能介绍 查询云服务器规格详情信息和规格扩展信息列表。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=ECS&api=ListFlavors)中调试该接口。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ecs/ecs_06_0000.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | ecs:cloudServerFlavors:get | read | - | - | - | - | #### URI GET /v1/{project_id}/cloudservers/flavors 参数说明请参见[表1]。 表1路径参数 | 参数 | 是否必选 | 描述 | |:---|:---|:---| | project_id | 是 | **参数解释：** 项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-ecs/ecs_01_0016.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | 表2查询参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | availability_zone | 否 | String | **参数解释：** 可用区，需要指定可用区（AZ）的名称，当此字段不为空时，只返回可使用（如：normal、obt、promotion等状态）的flavor列表。 请参考[地区和终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint/ECS)获取。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | flavor_id | 否 | String | **参数解释：** 云服务器规格ID。只支持传入单个flavor_id。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | limit | 否 | Integer | **参数解释：** 查询返回云服务器规格列表当前页面的数量。默认为1000。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | marker | 否 | String | **参数解释：** 从marker指定的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]。 **取值范围：** 不涉及 | | os_extra_specs | Object | **参数解释：** 云服务器规格的扩展字段，详情请参见[表6]。 **取值范围：** 不涉及 | | attachableQuantity | Object | **参数解释：** 云服务器可挂载网卡和卷数，详情参见[表7]。 **取值范围：** 不涉及 | 表5links字段数据结构说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | rel | String | **参数解释：** 快捷链接标记名称。 **取值范围：** 不涉及 | | href | String | **参数解释：** 对应快捷链接。 **取值范围：** 不涉及 | | type | String | **参数解释：** 快捷链接类型，当前接口未使用，缺省值为null。 **取值范围：** 不涉及 | 表6os_extra_specs数据结构说明（仅列举常用参数） | 参数 | 参数类型 | 描述 | |:---|:---|:---| | ecs:performancetype | String | **参数解释：** 云服务器规格的分类。 **取值范围：** - normal：通用计算型 - computingv3：通用计算增强型 - highmem：内存优化型 - cpuv1：计算I型 - cpuv2：计算II型 - highcpu：高性能计算型 - ultracpu：超高性能计算型 - diskintensive：磁盘增强型 - gpu：GPU加速型 - saphana：超大内存型 - fpga：FPGA加速型 - highio：超高I/O型 - entry：通用入门型 - ascend：AI加速型 - kunpeng_computing：鲲鹏通用计算增强型 - kunpeng_highmem：鲲鹏内存优化型 - kunpeng_highio：鲲鹏超高I/O型 - kunpeng_accelerator：鲲鹏应用加速型 - advanced_smb：通用计算型（针对Flexus X提供资源） 说明： 早期注册的规格该字段为hws:performancetype。 XEN实例不支持该参数。 当前仅列举已呈现在控制台的规格，如需查看其他类型，请联系技术支持。 | | hw:numa_nodes | String | **参数解释：** 主机的物理cpu数量。（该字段是否返回根据云服务器规格而定） **取值范围：** 不涉及 | | resource_type | String | **参数解释：** 资源类型。resource_type是为了区分云服务器的物理主机类型。 **取值范围：** 不涉及 | | hpet_support | String | **参数解释：** 云服务器高精度时钟是否开启。（该字段是否返回根据云服务器规格而定） **取值范围：** - true：开启 - false：不开启 | | instance_vnic:type | String | **参数解释：** 网卡类型。 **取值范围：** 固定为"enhanced"，表示使用增强型网络的资源创建云服务器。 | | instance_vnic:instance_bandwidth | String | **参数解释：** 最大带宽。 **取值范围：** 单位Mbps，最大值为10000。 | | instance_vnic:max_count | String | **参数解释：** 最大网卡个数。 **取值范围：** 最大为4。 | | quota:local_disk | String | **参数解释：** 磁盘增强型特有字段。 **取值范围：** 值格式为{type}:{count}:{size}:{safeFormat}，其中： - type指磁盘类型，当前只支持hdd。 - count指本地磁盘数量，目前支持： - d1类型：3/6/12/24 - d2类型：2/4/8/12/16/24 - d3类型：2/4/8/12/16/24/28。 - size指单个磁盘容量，单位GiB，目前只支持1675（实际磁盘大小为1800，格式化后可用大小为1675）。 - safeFormat指云服务器本地磁盘是否安全格式化，目前仅支持： - d1类型：FALSE - d2/d3类型：True。 | | quota:nvme_ssd | String | **参数解释：** 超高I/O型特有字段。 **取值范围：** 值格式为{type}:{spec}:{num}:{size}:{safeFormat}:{挂载协议}，其中： - type指主机上配备的nvme ssd的单卡容量大小，当前只支持1.6T/3.2T。 - spec指nvme ssd的规格，包括large和lvs。large表示大规格，lvs表示小规格。 目前仅支持I系列（例如i3）的类型为large，仅支持Ir系列（例如ir3）的类型为lvs。 - num指本地盘个数。 - size指guest使用的盘的容量大小，单位为GiB。在spec值为large的情况下，此项即为host单卡大小。在spec值为lvs的情况下，此值为50的整倍数。 - safeFormat指云服务器本地磁盘是否安全格式化。 目前仅支持I系列（例如i3）和Ir系列（例如ir3）类型：True。 - 挂载协议（可选） 该字段仅当规格为Ir系列（例如ir3）时存在，挂载协议类型当前仅支持blk。 | | extra_spec:io:persistent_grant | String | **参数解释：** 是否支持持久化，密集存储D1型特有字段。 **取值范围：** 值为true，代表云服务器访问存储的方式为持久化授权。 | | ecs:generation | String | **参数解释：** 弹性云服务器类型的代数。 示例：s3中的3表示通用型III代，详细的规格类型和代系请参考《弹性云服务器用户指南》的"[实例规格清单](https://support.huaweicloud.com/productdesc-ecs/zh-cn_topic_0159822360.html)"。 **取值范围：** 不涉及 | | ecs:virtualization_env_types | String | **参数解释：** 虚拟化类型。 **取值范围：** - 如果值为"FusionCompute"，表示弹性云服务器使用基于XEN的虚拟化技术。 - 如果值为"CloudCompute"，表示弹性云服务器使用基于KVM的虚拟化技术。 | | pci_passthrough:enable_gpu | String | **参数解释：** 显卡是否直通。 **取值范围：** 值为"true"，表示GPU直通。 | | pci_passthrough:gpu_specs | String | **参数解释：** G1型和G2型云服务器应用的技术，包括GPU虚拟化和GPU直通。 **取值范围：** - 如果该规格的云服务器使用GPU虚拟化技术，且GPU卡的型号为M60-1Q，参数值为"m60_1q:virt:1"。 - 如果该规格的云服务器使用GPU直通技术，且GPU卡的型号为M60，参数值为"m60:direct_graphics:1"。 | | pci_passthrough:alias | String | **参数解释：** PCI直通设备信息，格式为PCI设备名称:数量。多个设备信息以逗号隔开。 例如nvidia-a30:1，表示携带一张A30的GPU。 **取值范围：** 不涉及 | | cond:operation:status | String | **参数解释：** 此参数是Region级配置，某个AZ没有在cond:operation:az参数中配置时默认使用此参数的取值。不配置或无此参数时等同于"normal"。 **取值范围：** - normal：正常商用 - abandon：下线（即不显示） - sellout：售罄 - obt：公测 - obt_sellout：公测售罄 - promotion：推荐(等同normal，也是商用) | | cond:operation:az | String | **参数解释：** 此参数是AZ级配置，某个AZ没有在此参数中配置时默认使用cond:operation:status参数的取值。此参数的配置格式"az(xx)"。()内为某个AZ的flavor状态，()内必须要填有状态，不填为无效配置。状态的取值范围与cond:operation:status参数相同。 例如：flavor在某个region的az0正常商用，az1售罄，az2公测，az3正常商用，其他az显示下线，可配置为： - "cond:operation:status"设置为"abandon" - "cond:operation:az"设置为"az0(normal), az1(sellout), az2(obt), az3(normal)" 说明： 如果flavor在某个AZ下的状态与cond:operation:status配置状态不同，必须配置该参数。 **取值范围：** 不涉及 | | quota:max_rate | String | **参数解释：** 最大带宽。 **取值范围：** 单位Mbps，显示为Gbps时除以1000。 | | quota:min_rate | String | **参数解释：** 基准带宽。 **取值范围：** 单位Mbps，显示为Gbps时除以1000。 | | quota:max_pps | String | **参数解释：** 内网最大收发包能力。 **取值范围：** 单位个，显示为xx万时除以10000。 | | cond:operation:charge:stop | String | **参数解释：** 关机是否收费，默认免费。 **取值范围：** - charge：收费 - free：免费 | | cond:operation:charge | String | **参数解释：** 计费类型。不配置时，包年/包月和按需计费两种模式都支持。 **取值范围：** - period，包年/包月 - demand，按需计费 | | cond:spot:operation:az | String | **参数解释：** spot售卖信息请使用 [查询规格销售策略](https://support.huaweicloud.com/api-ecs/ecs_02_0403.html) 接口查询。 Flavor在竞价销售模式下显示的AZ。 **取值范围：** 不涉及 | | cond:operation:roles | String | **参数解释：** 允许的角色。 角色与roles的op_gatexxx参数所指定的标签相匹配。不设置时所有用户均可使用该接口。 **取值范围：** 不涉及 | | cond:spot:operation:status | String | **参数解释：** Flavor在竞价销售模式下的状态。 spot售卖信息请使用[查询规格销售策略](https://support.huaweicloud.com/api-ecs/ecs_02_0403.html)接口查询，不配置时等同abandon **取值范围：** - normal，正常商用 - abandon，下线 - sellout，售罄 - obt，公测，未申请时提示申请（暂不支持） - private，私有，只给特定用户显示（暂不支持） - test，试用/免费（暂不支持） - promotion，推荐 | | cond:network | String | **参数解释：** 网络约束。 支持网络特性，不配置时以控制台默认配置为准。 **取值范围：** 不涉及 | | cond:storage | String | **参数解释：** 存储约束。支持磁盘特性，不配置时以控制台默认配置为准。 **取值范围：** - scsi，支持scsi - localdisk，支持本地盘 - ib，支持ib | | cond:storage:type | String | **参数解释：** 支持的磁盘类型，不配置时以控制台默认配置为准。 **取值范围：** - SATA：普通IO云硬盘（已售罄） - SAS：高IO云硬盘 - GPSSD：通用型SSD云硬盘 - SSD：超高IO云硬盘 - ESSD：极速型SSD云硬盘 - GPSSD2：通用型SSD V2云硬盘 - ESSD2：极速型SSD V2云硬盘 | | cond:compute:live_resizable | String | **参数解释：** 计算约束。 **取值范围：** - true，支持在线扩容。 - false或不存在该字段，不支持在线扩容。 | | cond:compute | String | **参数解释：** 计算约束。 **取值范围：** - autorecovery，支持自动恢复。 - 不存在该字段，则不支持自动恢复。 | | ecs:instance_architecture | String | **参数解释：** 该规格对应的CPU架构，且仅鲲鹏实例架构规格返回该字段。 **取值范围：** 取值为arm64表示CPU架构为鲲鹏计算。 | | info:gpu:name | String | **参数解释：** GPU显卡数量和名称。 **取值范围：** 不涉及 | | info:cpu:name | String | **参数解释：** CPU名称。 **取值范围：** 不涉及 | | quota:gpu | String | **参数解释：** GPU显卡名称。 **取值范围：** 不涉及 | | quota:vif_max_num | String | **参数解释：** 云服务器最多支持绑定的弹性网卡个数。 **取值范围：** 不涉及 | | quota:sub_network_interface_max_num | String | **参数解释：** 云服务器最多支持绑定的辅助弹性网卡个数。 **取值范围：** 不涉及 | | network_interface:traffic_mirroring_supported | String | **参数解释：** 该规格是否支持流量镜像。 **取值范围：** 不涉及 | | info:features | String | **参数解释：** 规格支持的特性。 **取值范围：** 不涉及 | | security:enclave_supported | String | **参数解释：** 该规格是否支持QingTian Enclave。 **取值范围：** 不涉及 | | info:gpus | String | **参数解释：** 该规格的GPU卡信息。 **取值范围：** - name：GPU名称 - memory_mb：GPU显存大小 - count：GPU显卡数量 - alias_prefix：GPU显卡内部别名 | | info:asic_accelerators | String | **参数解释：** 该规格的加速器信息。 **取值范围：** - name：加速器名称 - memory_mb：加速器显存大小 - count：加速器显卡数量 - alias_prefix：加速器显卡内部别名 | 表7attachableQuantity字段数据结构说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | free_scsi | Integer | **参数解释：** 可挂载scsi卷数。 **取值范围：** 不涉及 | | free_blk | Integer | **参数解释：** 可挂载vbd卷数。 **取值范围：** 不涉及 | | free_disk | Integer | **参数解释：** 可挂载卷数。 **取值范围：** 不涉及 | | free_nic | Integer | **参数解释：** 可挂载网卡数。 **取值范围：** 不涉及 | ![](https://support.huaweicloud.com/api-ecs/public_sys-resources/note_3.0-zh-cn.png) 已上线的规格请参见《弹性云服务器产品介绍》的"[实例类型与规格](https://support.huaweicloud.com/productdesc-ecs/ecs_01_0008.html)"章节。 #### 请求示例 查询云服务器规格详情信息和规格扩展信息列表。 ``` GET https://{endpoint}/v1/{project_id}/cloudservers/flavors?availability_zone=availability_value ``` #### 响应示例 ``` { "flavors": [ { "attachableQuantity": { "free_scsi": 60, "free_blk": 24, "free_disk": 60, "free_nic": 12 }, "id": "c3.2xlarge.2", "name": "c3.2xlarge.2", "vcpus": "8", "ram": 16384, "disk": "0", "swap": "", "links": [ { "rel": "self", "href": "https://ecs.region.example.com/v1.0/743b4c0428d94531b9f2add666642e6b/flavors/c3.2xlarge.2", "type": null }, { "rel": "bookmark", "href": "https://ecs.region.example.com/743b4c0428d94531b9f2add666642e6b/flavors/c3.2xlarge.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, "os_extra_specs": { "ecs:virtualization_env_types": "CloudCompute", "ecs:generation": "c3", "ecs:instance_architecture":"arm64" , "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)。