文档首页/ 弹性云服务器 ECS/ API参考/ 数据结构/ 数据结构(查询规格详情)
更新时间:2024-06-28 GMT+08:00
分享

数据结构(查询规格详情)

os_extra_specs(flavor)字段数据结构说明

该字段被如下接口使用:
  • 查询规格详情和规格扩展信息列表 /v1/{project_id}/cloudservers/flavors
  • 查询云服务器规格扩展字段详情 /v1/{project_id}/flavors/{flavor_id}/os-extra_specs
表1 os_extra_specs数据结构说明(仅列举常用参数)

参数

参数类型

描述

ecs:performancetype

String

云服务器规格的分类:

  • normal:通用计算型
  • entry:通用入门型
  • cpuv1:计算I型
  • cpuv2:计算II型
  • computingv3:通用计算增强型
  • kunpeng_computing:鲲鹏通用计算增强型
  • kunpeng_highmem:鲲鹏内存优化型
  • kunpeng_highio:鲲鹏超高I/O型
  • highmem:内存优化型
  • saphana:超大内存型
  • diskintensive:磁盘增强型
  • highio:超高I/O型
  • ultracpu:超高性能计算型
  • gpu:GPU加速型
  • fpga:FPGA加速型
  • ascend:AI加速型
说明:

早期注册的规格该字段为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指单个磁盘容量,单位GB,目前只支持1675(实际磁盘大小为1800,格式化后可用大小为1675)。
  • safeFormat指云服务器本地磁盘是否安全格式化,目前仅支持:
    • d1类型:FALSE
    • d2/d3类型:True。
说明:

磁盘增强型特有字段。

quota:nvme_ssd

String

值格式为{type}:{spec}:{num}:{size}:{safeFormat}:{挂载协议},其中:

  • type指主机上配备的nvme ssd的单卡容量大小,当前只支持1.6T/3.2T。
  • spec指nvme ssd的规格,包括large/small。large表示大规格,small表示小规格。

    目前仅支持i3和ir3类型:large。

  • num指磁盘划分的分区个数。
  • size指guest使用的盘的容量大小,单位为GB。在spec值为large的情况下,此项即为host单卡大小。在spec值为small的情况下,此为1/4规格或者1/2规格。
  • safeFormat指云服务器本地磁盘是否安全格式化。

    目前仅支持i3和ir3类型:True。

  • 挂载协议

    目前仅支持ir3类型:blk。

说明:

超高I/O型特有字段。

extra_spec:io:persistent_grant

String

是否支持持久化,值为true。

代表云服务器访问存储的方式为持久化授权。

说明:

密集存储D1型特有字段。

ecs:generation

String

弹性云服务器类型的代数。

示例:s3中的3表示通用型III代,详细的规格类型和代系请参考《弹性云服务器用户指南》的“实例规格清单”。

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售卖信息请使用 查询规格销售策略 接口查询。

Flavor在竞价销售模式下显示的AZ。

cond:operation:roles

String

允许的角色

匹配的用户标签(roles的op_gatexxx标签)。不设置时所有用户可见

cond:spot:operation:status

String

spot售卖信息请使用 查询规格销售策略 接口查询。

Flavor在竞价销售模式下的状态

  • 不配置时等同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:极速IO云硬盘
  • 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

该规格是否支持流量镜像。

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:加速器显卡内部别名

相关文档