華為云計(jì)算 云知識(shí) 查詢規(guī)格詳情和規(guī)格擴(kuò)展信息列表ListFlavors
查詢規(guī)格詳情和規(guī)格擴(kuò)展信息列表ListFlavors
時(shí)間: 2023-07-25 15:26:35
猜你想看：
實(shí)時(shí)語(yǔ)音識(shí)別 云服務(wù)器配置 CDN是什么意思 視頻點(diǎn)播加速 什么是云桌面

 

接口說(shuō)明

查詢 云服務(wù)器 規(guī)格詳情信息和規(guī)格擴(kuò)展信息列表。

約束說(shuō)明

無(wú)

URL
GET  https://ecs.cn-north-1.myhuaweicloud.com/v1/{project_id}/cloudservers/flavors 
請(qǐng)求參數(shù)
名稱 類型 IN 必選 描述
X-Auth-Token
 
 string header 是

用戶Token。

通過(guò)調(diào)用 IAM 服務(wù)獲取用戶Token接口獲取(響應(yīng)消息頭中X-Subject-Token的值)。
project_id
 
 string path 是

項(xiàng)目ID。
availability_zone
 
 string query 否

可用區(qū),需要指定可用區(qū)(AZ)的名稱或者ID或者code。

可通過(guò)接口 查詢可用區(qū)列表接口 獲取,也可參考地區(qū)和終端節(jié)點(diǎn)獲取。
返回參數(shù)
返回碼: 200

OK

名稱 類型 必選 描述
flavors
 
 Array of Flavor objects 是

云服務(wù)器規(guī)格列表。
200 flavors
名稱 類型 必選 描述
id
 
 string 是

云服務(wù)器規(guī)格的ID。
name
 
 string 是

云服務(wù)器規(guī)格的名稱。
vcpus
 
 string 是

云服務(wù)器規(guī)格對(duì)應(yīng)的CPU核數(shù)。
ram
 
 integer 是

云服務(wù)器規(guī)格對(duì)應(yīng)的內(nèi)存大小,單位為MB。
disk
 
 string 是

云服務(wù)器規(guī)格對(duì)應(yīng)要求的系統(tǒng)盤大小。

當(dāng)前未使用該參數(shù),缺省值為0。
swap
 
 string 是

云服務(wù)器規(guī)格對(duì)應(yīng)要求的交換分區(qū)大小。

當(dāng)前未使用該參數(shù),缺省值為""。
OS-FLV-EXT-DATA:ephemeral
 
 integer 是

擴(kuò)展屬性,臨時(shí)盤大小。

當(dāng)前未使用該參數(shù),缺省值為0
OS-FLV-DISABLED:disabled
 
 boolean 是

擴(kuò)展屬性,該云服務(wù)器規(guī)格是否禁用。

當(dāng)前未使用該參數(shù),缺省值為false。
rxtx_factor
 
 float 是

云服務(wù)器可使用網(wǎng)絡(luò)帶寬與網(wǎng)絡(luò)硬件帶寬的比例。

當(dāng)前未使用該參數(shù),缺省值為1.0。
rxtx_quota
 
 string 是

云服務(wù)器可使用網(wǎng)絡(luò)帶寬的軟限制。

當(dāng)前未使用該參數(shù),缺省值為null。
rxtx_cap
 
 string 是

云服務(wù)器可使用網(wǎng)絡(luò)帶寬的硬限制。

當(dāng)前未使用該參數(shù),缺省值為null。
os-flavor-access:is_public
 
 boolean 是

擴(kuò)展屬性,flavor是否給所有租戶使用。

  • true:表示給所有租戶使用。
  • false:表示給指定租戶使用。

缺省值為true。
links
 
 Array of FlavorLink objects 是

規(guī)格相關(guān)快捷鏈接地址。
os_extra_specs
 
 FlavorExtraSpec object 是

云服務(wù)器規(guī)格的擴(kuò)展字段。
attachableQuantity
 
 ServerAttachableQuantity object 否

云服務(wù)器可掛載網(wǎng)卡和卷數(shù).
200 flavors.os_extra_specs
名稱 類型 必選 描述
ecs:performancetype
 
 string 否

云服務(wù)器規(guī)格的分類:

  • normal:通用型
  • entry:通用入門型
  • cpuv1:計(jì)算I型
  • cpuv2:計(jì)算II型
  • computingv3:通用計(jì)算增強(qiáng)型
  • kunpeng_computing:鯤鵬通用計(jì)算增強(qiáng)型
  • kunpeng_highmem:鯤鵬內(nèi)存優(yōu)化型
  • highmem:內(nèi)存優(yōu)化型
  • saphana:大內(nèi)存型
  • diskintensive:磁盤增強(qiáng)型
  • highio:超高I/O型
  • ultracpu:超高性能計(jì)算型
  • gpu:GPU加速型
  • fpga:FPGA加速型
  • ascend:AI加速型

說(shuō)明:

  • 早期注冊(cè)的規(guī)格該字段為hws:performancetype。
hw:numa_nodes
 
 string 否

主機(jī)的物理cpu數(shù)量。
resource_type
 
 string 否

資源類型。resource_type是為了區(qū)分云服務(wù)器的物理主機(jī)類型。
hpet_support
 
 string 否

彈性運(yùn)服務(wù)器高精度時(shí)鐘是否開(kāi)啟,開(kāi)啟為true,否則為false。(該字段是否返回根據(jù)云服務(wù)器規(guī)格而定)
instance_vnic:type
 
 string 否

網(wǎng)卡類型,值固定為“enhanced”,表示使用增強(qiáng)型網(wǎng)絡(luò)的資源創(chuàng)建云服務(wù)器。
instance_vnic:instance_bandwidth
 
 string 否

最大帶寬,單位Mbps,最大值為10000。
instance_vnic:max_count
 
 string 否

最大網(wǎng)卡個(gè)數(shù),最大為4。
quota:local_disk
 
 string 否

值格式為{type}:{count}:{size}:{safeFormat},其中:

  • type指磁盤類型,當(dāng)前只支持hdd。
  • count指本地磁盤數(shù)量,目前支持d1類型:3/6/12/24,d2類型:2/4/8/12/16/24,d3類型:2/4/8/12/16/24/28。
  • size指單個(gè)磁盤容量,單位GB,目前只支持1675(實(shí)際磁盤大小為1800,格式化后可用大小為1675)。
  • safeFormat指云服務(wù)器本地磁盤是否安全格式化,目前僅支持d1類型:FALSE,d2/d3類型:True。

說(shuō)明:

  • 磁盤增強(qiáng)型特有字段。
quota:nvme_ssd
 
 string 否

值格式為{type}:{spec}:{size}:{safeFormat},其中:

  • type指主機(jī)上配備的nvme ssd的單卡容量大小,當(dāng)前只支持1.6T/3.2T。
  • spec指nvme ssd的規(guī)格,包括large/small。large表示大規(guī)格,small表示小規(guī)格。目前僅支持i3類型:large。
  • size指guest使用的盤的容量大小,單位為GB。在spec值為large的情況下,此項(xiàng)即為host單卡大小。在spec值為small的情況下,此為1/4規(guī)格或者1/2規(guī)格。
  • safeFormat指云服務(wù)器本地磁盤是否安全格式化,目前僅支持i3類型:True。

說(shuō)明:

  • 超高I/O型特有字段。
extra_spec:io:persistent_grant
 
 string 否

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

代表云服務(wù)器訪問(wèn)存儲(chǔ)的方式為持久化授權(quán)。

說(shuō)明:

  • 密集存儲(chǔ)D1型特有字段。
ecs:generation
 
 string 否

彈性云服務(wù)器類型的代數(shù)。

  • s1:通用型I代
  • s2:通用型II代
  • s3:通用型
  • m1:內(nèi)存優(yōu)化型I代
  • m2:內(nèi)存優(yōu)化型II代
  • m3:內(nèi)存優(yōu)化型
  • h1:高性能計(jì)算型I代
  • h2:高性能計(jì)算型II代
  • h3:高性能計(jì)算型
  • hi3:超高性能計(jì)算型
  • d1:密集存儲(chǔ)型I代
  • d2:密集存儲(chǔ)型II代
  • d3:磁盤增強(qiáng)型
  • g1:GPU加速型I代
  • g2:GPU加速型II代
  • f1:FPGA高性能型
  • f2:FPGA通用型
  • c3:通用計(jì)算增強(qiáng)型
  • e3:大內(nèi)存型
  • i3:超高I/O型
ecs:virtualization_env_types
 
 string 否

虛擬化類型。

  • 如果值為“FusionCompute”,表示彈性云服務(wù)器使用基于XEN的虛擬化技術(shù)。
  • 如果值為“CloudCompute”,表示彈性云服務(wù)器使用基于KVM的虛擬化技術(shù)。
pci_passthrough:enable_gpu
 
 string 否

顯卡是否直通。

值為“true”,表示GPU直通。
pci_passthrough:gpu_specs
 
 string 否

G1型和G2型云服務(wù)器應(yīng)用的技術(shù),包括GPU虛擬化和GPU直通。

  • 如果該規(guī)格的云服務(wù)器使用GPU虛擬化技術(shù),且GPU卡的型號(hào)為M60-1Q,參數(shù)值可設(shè)置為“m60_1q:virt:1”。
  • 如果該規(guī)格的云服務(wù)器使用GPU直通技術(shù),且GPU卡的型號(hào)為M60,參數(shù)值可設(shè)置為“m60:direct_graphics:1”。
pci_passthrough:alias
 
 string 否

P1型v本地直通GPU的型號(hào)和數(shù)量,參數(shù)值可設(shè)置為“nvidia-p100:1”,表示使用該規(guī)格創(chuàng)建的彈性云服務(wù)器將占用1張NVIDIA P100顯卡。
cond:operation:status
 
 string 否

此參數(shù)是Region級(jí)配置,某個(gè)AZ沒(méi)有在cond:operation:az參數(shù)中配置時(shí)默認(rèn)使用此參數(shù)的取值。不配置或無(wú)此參數(shù)時(shí)等同于“normal”。取值范圍:

  • normal:正常商用
  • abandon:下線(即不顯示)
  • sellout:售罄
  • obt:公測(cè)
  • promotion:推薦(等同normal,也是商用)
cond:operation:az
 
 string 否

此參數(shù)是AZ級(jí)配置,某個(gè)AZ沒(méi)有在此參數(shù)中配置時(shí)默認(rèn)使用cond:operation:status參數(shù)的取值。此參數(shù)的配置格式“az(xx)”。()內(nèi)為某個(gè)AZ的flavor狀態(tài),()內(nèi)必須要填有狀態(tài),不填為無(wú)效配置。狀態(tài)的取值范圍與cond:operation:status參數(shù)相同。

例如:flavor在某個(gè)region的az0正常商用,az1售罄,az2公測(cè),az3正常商用,其他az顯示下線,可配置為:

  • “cond:operation:status”設(shè)置為“abandon”
  • “cond:operation:az”設(shè)置為“az0(normal), az1(sellout), az2(obt), az3(normal)”

說(shuō)明:

  • 如果flavor在某個(gè)AZ下的狀態(tài)與cond:operation:status配置狀態(tài)不同,必須配置該參數(shù)。
quota:max_rate
 
 string 否

最大帶寬

  • 單位Mbps,顯示為Gbps時(shí)除以1000
quota:min_rate
 
 string 否

基準(zhǔn)帶寬

  • 單位Mbps,顯示為Gbps時(shí)除以1000
quota:max_pps
 
 string 否

內(nèi)網(wǎng)最大收發(fā)包能力

  • 單位個(gè),顯示為xx萬(wàn)時(shí)除以10000
cond:operation:charge
 
 string 否

計(jì)費(fèi)類型

  • 計(jì)費(fèi)場(chǎng)景,不配置時(shí)都支持
  • period,包周期
  • demand,按需
cond:operation:charge:stop
 
 string 否

關(guān)機(jī)是否收費(fèi)

  • 關(guān)機(jī)是否計(jì)費(fèi),默認(rèn)免費(fèi):
  • charge
  • free
cond:spot:operation:az
 
 string 否

計(jì)費(fèi)類型

  • 計(jì)費(fèi)場(chǎng)景,不配置時(shí)都支持
  • period,包周期
  • demand,按需
cond:operation:roles
 
 string 否

允許的角色 匹配的用戶標(biāo)簽(roles的op_gatexxx標(biāo)簽)。不設(shè)置時(shí)所有用戶可見(jiàn)
cond:spot:operation:status
 
 string 否

Flavor在競(jìng)價(jià)銷售模式下的狀態(tài)

  • 不配置時(shí)等同abandon
  • normal,正常商用
  • abandon,下線
  • sellout,售罄
  • obt,公測(cè),未申請(qǐng)時(shí)提示申請(qǐng)(暫不支持)
  • private,私有,只給特定用戶顯示(暫不支持)
  • test,試用/免費(fèi)(暫不支持)
  • promotion,推薦
cond:network
 
 string 否

網(wǎng)絡(luò)約束 支持網(wǎng)絡(luò)特性,不配置時(shí)以UI配置為準(zhǔn)。
cond:storage
 
 string 否

存儲(chǔ)約束

  • 支持磁盤特性,不配置時(shí)以UI配置為準(zhǔn)。
  • scsi,支持scsi
  • localdisk,支持本地盤
  • ib,支持ib
cond:compute:live_resizable
 
 string 否

計(jì)算約束

  • true,支持在線擴(kuò)容。
  • false或不存在該字段,不支持在線擴(kuò)容。
cond:compute
 
 string 否

計(jì)算約束

  • autorecovery,自動(dòng)恢復(fù)特性。
  • 不存在該字段,不支持自動(dòng)恢復(fù)。
info:gpu:name
 
 string 否  
info:cpu:name
 
 string 否  
quota:gpu
 
 string 否  
ecs:instance_architecture
 
 string 否

該規(guī)格對(duì)應(yīng)的CPU架構(gòu),且僅鯤鵬實(shí)例架構(gòu)規(guī)格返回該字段

  • 取值為arm64表示CPU架構(gòu)為鯤鵬計(jì)算。
200 flavors.attachableQuantity
名稱 類型 必選 描述
free_scsi
 
 integer 是

可掛載scsi卷數(shù)。
free_blk
 
 integer 是

可掛載vbd卷數(shù)。
free_disk
 
 integer 是

可掛載卷數(shù)。
free_nic
 
 integer 是

可掛載網(wǎng)卡數(shù)。
請(qǐng)求示例
示例 1
 
"GET https://{endpoint}/v1/{project_id}/cloudservers/flavors?availability_zone={availability_value}"
返回示例
返回碼：200

OK

示例 1
 
{
"flavors": [
{
"id": "ai1.2xlarge.4",
"name": "ai1.2xlarge.4",
"vcpus": "8",
"ram": 32768,
"disk": "0",
"swap": "",
"links": [
{
"rel": "self",
"href": "https://compute-ext.region.eu-de.otc-tsi.de/v1.0/86a5a7d7a14c4cd19fec1acaa6666173/flavors/ai1.2xlarge.4",
"type": null
},
{
"rel": "bookmark",
"href": "https://compute-ext.region.eu-de.otc-tsi.de/86a5a7d7a14c4cd19fec1acaa6666173/flavors/ai1.2xlarge.4",
"type": null
}
],
"attachableQuantity": {
"free_scsi": 20,
"free_blk": 12,
"free_disk": 20,
"free_nic": 4
},
"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": {
"hw:cpu_policy": "dedicated",
"ecs:virtualization_env_types": "CloudCompute",
"info:ascend:name": "4 * HUAWEI Ascend 310/4* 8G",
"hw:mem_page_size": "1048576",
"quota:physics_max_rate": "33000",
"hw:cpu_sockets": "1",
"quota:vif_multiqueue_num": "4",
"ecs:performancetype": "ascend",
"hw:cpu_threads": "2",
"quota:vif_max_num": "4",
"quota:min_rate": "4000",
"quota:max_pps": "500000",
"cond:image": "__support_kvm_ascend_310=true",
"hw:numa_nodes": "1",
"quota:conn_limit_total": "1000000",
"hw:cpu_cores": "4",
"hw:cpu_thread_policy": "require",
"pci_passthrough:alias": "huawei-atlas600:4",
"quota:max_rate": "10000",
"resource_type": "AI1-ASCEND-310",
"quota:gpu": "huawei-atlas600"
}
}
]
}
SDK
點(diǎn)擊 彈性云服務(wù)器 (ECS) SDK, 下載SDK或查看SDK文檔。SDK的安裝、認(rèn)證方式等在SDK文檔中對(duì)應(yīng)語(yǔ)言類型的【使用】目錄下。
錯(cuò)誤碼
請(qǐng)參考 錯(cuò)誤碼說(shuō)明。

查詢規(guī)格詳情和規(guī)格擴(kuò)展信息列表ListFlavors

意見(jiàn)反饋

0/200

提交 取消

提交成功！非常感謝您的反饋，我們會(huì)繼續(xù)努力做到更好 反饋提交失??！請(qǐng)稍后重試！