接口功能介绍
该接口提供用户根据指定规格族查询云主机的名称、云主机ID及规格详情
接口约束
- 当前页面接口为旧版 API，未来根据实际使用情况可能退役，推荐使用新版本接口，新版本接口更加规范，覆盖场景更全。
URI
POST /v4/ecs/list-by-typefamilies
路径参数
无
Query参数
无
请求参数
请求头header参数
无
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionID | 是 | String | 资源池ID，您可以调用查询账户启用的资源池信息查看最新的天翼云资源池列表 | bb9fdb42056f11eda1610242ac110002 | |
| azName | 否 | String | 可用区名称。您可以调用资源池可用区查询获取可用区信息，查询结果中zoneList内返回存在可用区名称（即多a可用区，本字段填写实际可用区名称），若查询结果中zoneList为空（即为单可用区，本字段填写default）。 | cn-huadong1-jsnj1A-public-ctcloud | |
| type_family | 是 | String | 规格族名称,可根据查询云主机规格族列表进行查询 | s7 | |
| pageNo | 否 | Integer | 页码，取值范围：大于等于1，默认值为1 | 1 | |
| pageSize | 否 | Integer | 每页记录数目，取值范围:[1~50]，默认值:10，单页最大记录不超过50 | 10 |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 返回状态码(800为成功，900为失败) | 800 | |
| errorCode | String | 业务细分码，为product.module.code三段式码，详见错误码说明 | ||
| message | String | 失败时的错误描述，一般为英文描述 | ||
| description | String | 失败时的错误描述，一般为中文描述 | ||
| returnObj | Object | 返回参数 | returnObj |
表 returnObj
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| currentCount | Integer | 当前页记录数目 | 1 | |
| totalCount | Integer | 总记录数 | 10 | |
| totalPage | Integer | 总页数 | 1 | |
| results | Array of Objects | 云主机列表 | results |
表 results
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| ID | String | 云主机ID | b837fbc7-c359-cd2b-7687-d8f648b12832 | |
| name | String | 云主机名称 | ecm-ccf5 | |
| flavor | Object | 云主机规格详情 | flavor |
表 flavor
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| id | String | 规格ID | 8f8ba888-88e8-ea88-ea8b-888888dded88 | |
| name | String | 规格名称 | s7.medium.2 | |
| vcpus | Integer | VCPU | 1 | |
| ram | Integer | 内存 | 2048 | |
| gpu_type | String | GPU类型，取值范围：T4、V100、V100S、A10、A100、atlas 300i pro、mlu370-s4，支持类型会随着功能升级增加 | ||
| gpu_count | Integer | GPU数目 | 1 | |
| gpu_name | String | GPU名称 | ||
| memory | Integer | GPU显存大小 | 1 | |
| series | String | 规格族 | s7 |
枚举参数
无
请求示例
请求url
无
请求头header
无
请求体body
{
"regionID": "81f7728662dd11ec810800155d307d5b",
"azName": "az1",
"type_family": "s7"
}
响应示例
{
"returnObj": [{
"flavor": {
"gpu_name": null,
"name": "s7.small.1",
"series": null,
"ram": 1024,
"gpu_type": null,
"vcpus": 1,
"memory": null,
"id": "",
"gpu_count": null
},
"ID": "b837fbc7-c359-cd2b-7687-d8f648b12832",
"name": "ecm-ccf5"
}, {
"flavor": {
"gpu_name": null,
"name": "s7.small.1",
"series": null,
"ram": 1024,
"gpu_type": null,
"vcpus": 1,
"memory": null,
"id": "5622ce59-da34-cb43-ca0d-eef2a51475b3",
"gpu_count": null
},
"ID": "8947cf02-9034-0fa0-ef74-8f63b94e1c21",
"name": "ecm-e240"
}, {
"flavor": {
"gpu_name": null,
"name": "s7.small.1",
"series": null,
"ram": 1024,
"gpu_type": null,
"vcpus": 1,
"memory": null,
"id": "5622ce59-da34-cb43-ca0d-eef2a51475b3",
"gpu_count": null
},
"ID": "7deb7f21-0de0-1180-764b-633a88b81765",
"name": "ecm-aff1"
}, {
"flavor": {
"gpu_name": null,
"name": "s7.small.1",
"series": null,
"ram": 1024,
"gpu_type": null,
"vcpus": 1,
"memory": null,
"id": null,
"gpu_count": null
},
"ID": "0d3a32d2-2191-4647-b565-5ee39c9c49a7",
"name": "ecm-7f07"
}],
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
状态码
请参考 状态码
错误码
请参考 错误码
