# 数据结构(查询规格详情) #### os_extra_specs（flavor）字段数据结构说明 该字段被如下接口使用： - 查询规格详情和规格扩展信息列表 /v1/{project_id}/cloudservers/flavors - 查询云服务器规格扩展字段详情 /v1/{project_id}/flavors/{flavor_id}/os-extra_specs 表1os_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：加速器显卡内部别名 |