接口功能介绍
查询资源池虚机规格信息
接口约束
无
URI
GET /v4/common/get-ecs-flavors
路径参数
无
Query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionID | 是 | String | 资源池ID | 562b89493b1a40e1b97ea05e50dd8170 | |
| azName | 否 | String | 多az可用区名称（4.0场景） | az2 | |
| series | 否 | String | 系列 | s |
请求参数
请求头header参数
无
请求体body参数
无
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 返回状态码(800为成功，900为失败) | 800 | |
| errorCode | String | 具体错误码标志 | ||
| message | String | 失败时的错误信息 | ||
| description | String | 失败时的错误描述 | ||
| returnObj | Object | 返回对象，成功时返回的数据 | returnObj | |
| error | String | 错误码，为product.module.code三段式码。请求成功时不返回该字段 |
表 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 | Double | 基准带宽 (Gbps) | 0.2 | |
| bandwidthMax | Double | 最大带宽 (Gbps) | 1.5 | |
| cpuArch | String | cpu架构 （x86架构、arm架构） | x86 | |
| series | String | 系列 | s | |
| azList | Array of Strings | 支持的az名称列表（4.0场景）(未传azName情况) | ['az2'] | |
| nicCount | Integer | 当前规格主机最大可挂载网卡数 (cpu类型的会返回，其他类型没有，且非必返回字段) | 1 | |
| ctLimitCount | Integer | 最大连接数 (cpu类型的会返回，其他类型没有，且非必返回字段) | 1 |
枚举参数
无
请求示例
请求url
/v4/common/get-ecs-flavors?regionID=a4e1e8ca370a11ec9d650242ac11000a&azName=az2
请求头header
无
请求体body
无
响应示例
{
"returnObj": {
"totalCount": 1,
"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",
"nicCount": null,
"ctLimitCount": 50
}
]
},
"statusCode": "800"
}
状态码
请参考 状态码
错误码
请参考 错误码
