/ 弹性云服务器 ecs/ api参考/ 数据结构/ 数据结构(查询规格详情)
更新时间:2025-02-17 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:通用计算型
  • 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指单个磁盘容量,单位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和lvs。large表示大规格,lvs表示小规格。

    目前仅支持i系列(例如i3)的类型为large,仅支持ir系列(例如ir3)的类型为lvs。

  • num指本地盘个数。
  • size指guest使用的盘的容量大小,单位为gb。在spec值为large的情况下,此项即为host单卡大小。在spec值为lvs的情况下,此值为50的整倍数。
  • safeformat指云服务器本地磁盘是否安全格式化。

    目前仅支持i系列(例如i3)和ir系列(例如ir3)类型:true。

  • 挂载协议(可选)

    该字段仅当规格为ir系列(例如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:加速器显卡内部别名

相关文档

网站地图