查询虚机(云主机)规格
接口功能介绍
查询资源池虚机规格信息
接口约束
无
请求参数
URI
GET /v4/common/get-ecs-flavors
路径参数
Query参数
参数 |
是否必填 |
参数类型 |
说明 |
示例 |
regionID |
是 |
String |
资源池ID |
562b89493b1a40e1b97ea05e50dd8170 |
azName |
否 |
String |
多az可用区名称(4.0场景) |
az2 |
series |
否 |
String |
系列 |
s |
响应参数
参数 |
参数类型 |
说明 |
示例 |
下级对象 |
statusCode |
Integer |
返回状态码(800为成功,900为失败) |
800 |
|
errorCode |
String |
具体错误码标志 |
|
|
message |
String |
失败时的错误信息 |
|
|
description |
String |
失败时的错误描述 |
|
|
returnObj |
Object |
返回对象,成功时返回的数据 |
|
returnObj |
returnObj
参数 |
参数类型 |
说明 |
示例 |
下级对象 |
totalCount |
Integer |
总条数 |
10 |
|
results |
Array of Objects |
规格列表 |
|
results |
results
参数 |
参数类型 |
说明 |
示例 |
flavorID |
String |
规格id |
4bd72d46-ff9f-xxx-f467-26e2adf37xxx |
specName |
String |
规格名称 |
s2.8xlarge.4 |
flavorType |
String |
规格类型 |
CPU |
flavorName |
String |
规格类型名称 |
通用型 |
cpuNum |
Integer |
cpu核数 |
32 |
memSize |
Integer |
内存大小 |
128 |
multiQueue |
Integer |
网卡多队列数 |
1 |
pps |
Integer |
网络最大收发包能力 (万PPS) |
10 |
bandwidthBase |
Float |
基准带宽 (Gbps) |
0.2 |
bandwidthMax |
Float |
最大带宽 (Gbps) |
1.5 |
cpuArch |
String |
cpu架构 (x86架构、arm架构) |
x86 |
series |
String |
系列 |
s |
azList |
Array of String |
支持的az名称列表(4.0场景)(未传azName情况) |
['az2'] |
请求示例
请求头header
无
请求体body参数
{
"regionID": "a4e1e8ca370a11ec9d650242ac11000a",
"azName": "az2",
"series": "s"
}
响应示例
{
"returnObj": {
"totalCount": 3,
"results": [{
"flavorID": "4bd72d46-ff9f-xxx-f467-26e2adf37xxx",
"specName": "s2.8xlarge.4",
"flavorType": "CPU",
"flavorName": "通用型",
"cpuNum": 32,
"memSize": 128,
"multiQueue": 2,
"pps": 40,
"bandwidthBase": "1.2",
"bandwidthMax": "2",
"cpuArch": "x86",
"series": "s"
}]
},
"statusCode": "800"
}
状态码
错误码
errorCode |
含义 |
Unknown.Parameter.Invaliderror |
请求参数错误: 缺少regionID字段 |
Unknown.Region.RegionIDError |
没找到该资源池,请检查资源池ID是否正确 |
系列枚举
值 |
说明 |
s |
通用型 |
c |
计算增强型 |
m |
内存优化型 |
hs |
海光通用型 |
hc |
海光计算增强型 |
hm |
海光内存优化型 |
fs |
飞腾通用型 |
fc |
飞腾计算增强型 |
fm |
飞腾内存优化型 |
kc |
鲲鹏计算增强型 |
km |
鲲鹏内存优化型 |
ks |
鲲鹏通用型 |
g |
GPU图像加速基础型 |
p |
GPU计算加速型 |
ip3 |
超高IO型 |
规格类型
值 |
series系列 |
cpu架构 |
CPU |
s/m (s2,m2) |
x86 |
CPU_S3 |
s |
x86 |
CPU_C3 |
c |
x86 |
CPU_M3 |
m |
x86 |
CPU_S6 |
s |
x86 |
CPU_C6 |
c |
x86 |
CPU_M6 |
m |
x86 |
CPU_S7 |
s |
x86 |
CPU_C7 |
c |
x86 |
CPU_M7 |
m |
x86 |
CPU_KS1 |
ks |
arm |
CPU_KC1 |
kc |
arm |
CPU_KM1 |
km |
arm |
CPU_HS1 |
hs |
x86 |
CPU_HC1 |
hc |
x86 |
CPU_HM1 |
hm |
x86 |
CPU_FS1 |
fs |
arm |
CPU_FC1 |
fc |
arm |
CPU_FM1 |
fm |
arm |
CPU_KS2 |
ks |
arm |
CPU_KC2 |
kc |
arm |
CPU_KM2 |
km |
arm |
含有GPU字符串 |
"FlavorType含有V为g系列(虚拟化),否则为p系列(直通)" |
|