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

 

接口說明

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

約束說明

無

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

用戶Token。

通過調用 IAM 服務獲取用戶Token接口獲取(響應消息頭中X-Subject-Token的值)。
project_id
 
 string path 是

項目ID。
instance_uuid
 
 string query 否

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

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

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

升序/降序排序,默認值為:asc。

取值范圍:

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

排序字段。

key的取值范圍:

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

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

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

OK

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

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

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

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

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

云服務器規(guī)格對應的內存大小,單位為MB。
disk
 
 string 是

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

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

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

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

擴展屬性,臨時盤大小。

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

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

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

云服務器可使用網絡帶寬與網絡硬件帶寬的比例。

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

云服務器可使用網絡帶寬的軟限制。

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

云服務器可使用網絡帶寬的硬限制。

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

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

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

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

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

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

預留屬性。
200 flavors.extra_specs
名稱 類型 必選 描述
ecs:performancetype
 
 string 否

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

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

說明:

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

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

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

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

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

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

最大網卡個數(shù),最大為4。
quota:local_disk
 
 string 否

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

  • type指磁盤類型,當前只支持hdd。
  • count指本地磁盤數(shù)量,目前支持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}:{size}:{safeFormat},其中:

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

說明:

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

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

代表云服務器訪問存儲的方式為持久化授權。

說明:

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

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

  • s1:通用型I代
  • s2:通用型II代
  • s3:通用型
  • m1:內存優(yōu)化型I代
  • m2:內存優(yōu)化型II代
  • m3:內存優(yōu)化型
  • h1:高性能計算型I代
  • h2:高性能計算型II代
  • h3:高性能計算型
  • hi3:超高性能計算型
  • d1:密集存儲型I代
  • d2:密集存儲型II代
  • d3:磁盤增強型
  • g1:GPU加速型I代
  • g2:GPU加速型II代
  • f1:FPGA高性能型
  • f2:FPGA通用型
  • c3:通用計算增強型
  • e3:大內存型
  • i3:超高I/O型
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直通。

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

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

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

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

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

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

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

說明:

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

最大帶寬

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

基準帶寬

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

內網最大收發(fā)包能力

  • 單位個,顯示為xx萬時除以10000
cond:operation:charge
 
 string 否

計費類型

  • 計費場景,不配置時都支持
  • period,包周期
  • demand,按需
cond:operation:charge:stop
 
 string 否

關機是否收費

  • 關機是否計費,默認免費:
  • charge
  • free
cond:spot:operation:az
 
 string 否

計費類型

  • 計費場景,不配置時都支持
  • period,包周期
  • demand,按需
cond:operation:roles
 
 string 否

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

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

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

網絡約束 支持網絡特性,不配置時以UI配置為準。
cond:storage
 
 string 否

存儲約束

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

計算約束

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

計算約束

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

該規(guī)格對應的CPU架構,且僅鯤鵬實例架構規(guī)格返回該字段

  • 取值為arm64表示CPU架構為鯤鵬計算。
請求示例
示例 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
點擊 彈性云服務器 (ECS) SDK, 下載SDK或查看SDK文檔。SDK的安裝、認證方式等在SDK文檔中對應語言類型的【使用】目錄下。
錯誤碼
請參考 錯誤碼說明。

查詢云服務器規(guī)格變更支持列表ListResizeFlavors

意見反饋

0/200

提交 取消

提交成功！非常感謝您的反饋，我們會繼續(xù)努力做到更好 反饋提交失?。≌埳院笾卦?！