1)接口功能介绍
虚机规格查询。
2)接口约束
nodeCode边缘池id需要正确,可通过查看区域集群编码列表接口获取。
3)URI
GET /v1/listType。
4)请求参数
Query参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
nodeCode | 是 | String | 边缘池id | cn-guangzhou3 | |
priceType | 否 | String | 付费类型,ANNUAL_OR_MONTHLY-包年包月,PAY_FOR_USE-按需付费 | PAY_FOR_USE | |
page | 否 | Integer | 当前页数,默认值为1 | 1 | |
perPageNum | 否 | Integer | 每页显示的记录条数,默认值为10 | 10 | |
instance | 是 | String | 查询虚机规格信息,参数为EVM有效 | EVM |
5)响应参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
requestId | 是 | String | 请求id | b84233d3-0796-xxx | |
status | 是 | Object | 应答状态 | status | |
data | 是 | Object | 返回数据 | data |
表 status
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
message | 是 | String | 状态描述 | Success | |
code | 是 | String | 状态码 | Success |
表 data
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
totalPage | 是 | Integer | 总页数 | ||
total | 是 | Integer | 记录总个数 | ||
page | 是 | Integer | 当前页数 | ||
perPageNum | 是 | Integer | 每页显示的记录条数 | ||
instanceTypeList | 是 | Object | 规格列表 | instanceTypeList |
表 instanceTypeListInfos
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
id | 否 | Integer | 规格id | 1583 | |
name | 否 | String | 规格名称 | test-xxx | |
cpuModel | 否 | String | cpu规格名称 | Intel Xeon | |
vCpu | 否 | Integer | cpu数量 | 2 | |
mem | 否 | Integer | 内存大小,单位G | 4 | |
rawDiskInfos | 否 | Object | 裸盘信息 | ||
rawDiskInfos.rawDiskNum | 否 | Integer | 裸盘数量 | 1 | |
rawDiskInfos.rawDiskType | 否 | String | 裸盘类型 | hdd | |
rawDiskInfos.rawDiskSize | 否 | String | 裸盘大小,单位G | 100 | |
sysDiskSize | 否 | String | 系统盘大小,单位G | 10 | |
gpuModel | 否 | String | gpu规格 | GPU.NVIDIA-T4 | |
gpuNum | 否 | String | gpu数量 | 1 | |
videoMemory | 否 | Integer | gpu内存大小,单位G | 16 | |
priceType | 否 | String | 计费类型 | PAY_FOR_USE |
6)请求示例
GET https://{host}/v1/listType?instance=EVM&nodeCode=yn-lincang-1&page=1&perPageNum=3
7)响应示例
{
"status": {
"message": "Success",
"code": "Success"
},
"data": {
"instanceTypeList": [
{
"sysDiskSize": "1",
"cpuModel": "Intel Xeon",
"gpuModel": "GPU.NVIDIA-T4",
"vCpu": 1,
"cloudDiskType": 0,
"mem": 1,
"gpuNum": 1,
"priceType": "PAY_FOR_USE",
"rawDiskInfos": [
{
"rawDiskNum": 1,
"rawDiskType": "hdd",
"rawDiskSize": "837"
}
],
"ipType": "",
"videoMemory": 16,
"id": 120,
"cloudDiskSize": "",
"name": "evm-ops-test"
},
{
"sysDiskSize": "10",
"cpuModel": "Intel Xeon",
"gpuModel": "GPU.NVIDIA-T4",
"vCpu": 1,
"cloudDiskType": 0,
"mem": 1,
"gpuNum": 1,
"priceType": "PAY_FOR_USE",
"rawDiskInfos": [],
"ipType": "",
"videoMemory": 16,
"id": 81,
"cloudDiskSize": "",
"name": "cpgg-chen-test-01"
},
{
"sysDiskSize": "10",
"cpuModel": "arm test",
"gpuModel": "",
"vCpu": 1,
"cloudDiskType": 0,
"mem": 1,
"gpuNum": 0,
"priceType": "ANNUAL_OR_MONTHLY",
"rawDiskInfos": [],
"ipType": "",
"videoMemory": 0,
"id": 159,
"cloudDiskSize": "",
"name": "arm-test"
}
],
"totalPage": 11,
"total": 31,
"page": 1,
"perPageNum": 3
},
"requestId": "7fb9f071-5c74-40eb-bb0e-dd2ad704fbb1"
}
8)状态码
状态码 | 描述 |
---|---|
Success | 表示请求成功。 |