華為云計(jì)算 云知識(shí) 查詢?cè)品?wù)器規(guī)格變更支持列表ListResizeFlavors
查詢?cè)品?wù)器規(guī)格變更支持列表ListResizeFlavors
時(shí)間: 2023-07-25 15:29:26
猜你想看：
實(shí)時(shí)語音識(shí)別 云服務(wù)器配置 CDN是什么意思 視頻點(diǎn)播加速 什么是云桌面

 

接口說明

變更規(guī)格時(shí),部分規(guī)格的 云服務(wù)器 之間不能互相變更。您可以通過本接口,通過指定彈性云服務(wù)器規(guī)格,查詢?cè)撘?guī)格可以變更的規(guī)格列表。

約束說明

無

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

用戶Token。

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

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

進(jìn)行規(guī)格切換的云服務(wù)器ID,UUID格式。(instance_uuid,source_flavor_id and source_flavor_name 不能都為空)
limit
 
 integer query 否

單頁面可顯示的flavor條數(shù)最大值,默認(rèn)是1000。
marker
 
 string query 否

以單頁最后一條flavor的ID作為分頁標(biāo)記。
sort_dir
 
 string query 否

升序/降序排序,默認(rèn)值為:asc。

取值范圍:

  • asc:表示升序。
  • desc:表示降序
sort_key
 
 string query 否

排序字段。

key的取值范圍:

  • flavorid:表示規(guī)格ID。
  • sort_key的默認(rèn)值為“flavorid”。
  • name:表示規(guī)格名稱。
  • memory_mb:表示內(nèi)存大小。
  • vcpus:表示CPU大小。
  • root_gb:表示系統(tǒng)盤大小。
source_flavor_id
 
 string query 否

進(jìn)行規(guī)格切換的云服務(wù)器源規(guī)格ID。(instance_uuid,source_flavor_id and source_flavor_name 不能都為空)
source_flavor_name
 
 string query 否

進(jìn)行規(guī)格切換的云服務(wù)器源規(guī)格名稱。(instance_uuid,source_flavor_id and source_flavor_name 不能都為空)
返回參數(shù)
返回碼: 200

OK

名稱 類型 必選 描述
flavors
 
 Array of ListResizeFlavorsResult 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)快捷鏈接地址。
extra_specs
 
 FlavorExtraSpec object 是

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

預(yù)留屬性。
200 flavors.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加速型

說明:

  • 早期注冊(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í)鐘是否開啟,開啟為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。

說明:

  • 磁盤增強(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。

說明:

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

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

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

說明:

  • 密集存儲(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沒有在cond:operation:az參數(shù)中配置時(shí)默認(rèn)使用此參數(shù)的取值。不配置或無此參數(shù)時(shí)等同于“normal”。取值范圍:

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

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

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

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

說明:

  • 如果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萬時(shí)除以10000
cond:operation:charge
 
 string 否

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

  • 計(jì)費(fèi)場景,不配置時(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)場景,不配置時(shí)都支持
  • period,包周期
  • demand,按需
cond:operation:roles
 
 string 否

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

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

  • 不配置時(shí)等同abandon
  • normal,正常商用
  • abandon,下線
  • sellout,售罄
  • obt,公測,未申請(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ì)算。
請(qǐng)求示例
示例 1
 
"GET https://{endpoint}/v1/{project_id}/cloudservers/resize_flavors?source_flavor_id=c3.xlarge.2"
返回示例
返回碼：200

OK

示例 1
 
{
"flavors": [
{
"OS-FLV-DISABLED:disabled": false,
"disk": 1,
"OS-FLV-EXT-DATA:ephemeral": 0,
"os-flavor-access:is_public": true,
"id": "1",
"links": [
{
"href": "http://openstack.example.com/v2/6f70656e737461636b20342065766572/flavors/1",
"rel": "self"
},
{
"href": "http://openstack.example.com/6f70656e737461636b20342065766572/flavors/1",
"rel": "bookmark"
}
],
"name": "m1.tiny",
"ram": 512,
"swap": "",
"vcpus": 1,
"rxtx_factor": 1,
"extra_specs": {
"keys1": "value1",
"keys2": "value2"
}
},
{
"OS-FLV-DISABLED:disabled": false,
"disk": 20,
"OS-FLV-EXT-DATA:ephemeral": 0,
"os-flavor-access:is_public": true,
"id": "2",
"links": [
{
"href": "http://openstack.example.com/v2/6f70656e737461636b20342065766572/flavors/2",
"rel": "self"
},
{
"href": "http://openstack.example.com/6f70656e737461636b20342065766572/flavors/2",
"rel": "bookmark"
}
],
"name": "m1.small",
"ram": 2048,
"swap": "",
"vcpus": 1,
"rxtx_factor": 1,
"extra_specs": {
"keys1": "value1",
"keys2": "value2"
}
}
]
}
SDK
點(diǎn)擊 彈性云服務(wù)器 (ECS) SDK, 下載SDK或查看SDK文檔。SDK的安裝、認(rèn)證方式等在SDK文檔中對(duì)應(yīng)語言類型的【使用】目錄下。
錯(cuò)誤碼
請(qǐng)參考 錯(cuò)誤碼說明。

查詢?cè)品?wù)器規(guī)格變更支持列表ListResizeFlavors

意見反饋

0/200

提交 取消

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