节点规格查询
接口功能介绍
列举云骁智算平台支持的节点规格信息
接口约束
无
URI
GET /v4/cwai/node/device-type
路径参数
无
Query参数
名称 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
regionID | 是 | String | 区域唯一ID | 81f7728662dd11ec810800155d307d5b | |
azName | 是 | String | 可用区名称 | az1 | |
gpuManufacturer | 是 | String | GPU厂家,取值范围:Nvidia,Huawei | x86 | |
onDemand | 是 | Boolean | 是否按需订购 | true | |
pageNo | 否 | Integer | 页号 | 1 | |
pageSize | 否 | Integer | 每一页的大小 | 10 |
请求参数
请求头header参数
参数 | 是否必填 | 参数类型 | 说明 | 示例值 | 下级对象 |
---|---|---|---|---|---|
regionID | 是 | String | 区域的唯一ID | xxx-xxx-yyyzzz |
请求体body参数
无
响应参数
名称 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
statusCode | 是 | Integer | 请求成功(800)或者失败(900) | 800 | |
errorCode | 否 | String | 错误代码 | Cwai.Api.xxxx | |
message | 否 | String | 错误信息的英文描述 | Invalid Request | |
returnObj | 否 | Object | 返回的集群信息 | returnObj |
表returnObj
名称 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
totalCount | 是 | Integer | 符合条件的资源组总数 | 10 | |
totalPage | 是 | Integer | 总页数 | 1 | |
currentCount | 是 | Integer | 本次查询返回的资源组个数 | 10 | |
result | 是 | Array of Objects | 返回的资源组详情 | result |
表result
名称 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
type | 是 | String | 资源类型, EBM=物理机裸金属,ECS=GPU云主机 | ECS | |
memSum | 是 | Integer | 总内存大小 | 256 | |
cpuTotalAmount | 是 | Integer | CPU总量 | 64 | |
deviceType | 是 | String | 设备类型 | pi7.16xlarge.4 | |
flavorType | 是 | String | 规格类型 | GPU_N_PI7 | |
flavorID | 是 | String | 规格ID | e9d8d5ae-2532-5af1-0d52-1567e3e6a6ed | |
cpuSockets | 否 | Integer | CPU插槽数 | 4 | |
numaNodeAmount | 否 | Integer | CPU路数 | 4 | |
cpuAmount | 是 | Integer | 单CPU核数 | 64 | |
cpuThreadAmount | 否 | Integer | CPU线程数 | 32 | |
smartNicExist | 是 | Boolean | 是否有弹性网卡 | false | |
systemVolumeDescription | 是 | String | 系统盘描述 | 100G(SSD) | |
dataVolumeDescription | 是 | String | 数据盘描述 | 500G(SSD) | |
gpuAmount | 是 | Integer | GPU数量 | 4 | |
gpuManufacturer | 是 | String | GPU厂商 | NVIDIA | |
gpuModel | 是 | String | GPU型号 | A10 | |
gpuSize | 是 | Integer | GPU大小 | 96 | |
available | 是 | Boolean | 是否可购买 | true |
请求示例
GET https://cwai-global.ctapi.ctyun.cn/v4/cwai/node/device-type?regionID=81f7728662dd11ec810800155d307d5b&azName=az2&architecture=x86&pageSize=2&pageNo=1&onDemand=false
Content-Type:application/json
regionID:81f7728662dd11ec810800155d307d5b
请求体body
无
响应示例
HTTP/1.1 200 OK
Content-Type:application/json
{
"statusCode": 800,
"returnObj": {
"currentCount": 2,
"totalCount": 10,
"totalPage": 5,
"result": [
{
"type": "EBM",
"memSum": 1024,
"cpuTotalAmount": 112,
"deviceType": "physical.t27.large",
"flavorType": "EBM",
"flavorID": "",
"cpuSockets": 2,
"numaNodeAmount": 2,
"cpuAmount": 28,
"cpuThreadAmount": 2,
"smartNicExist": false,
"systemVolumeDescription": "2*480GB(SSD)",
"dataVolumeDescription": "2*3200GB(NVMe SSD)",
"gpuAmount": 8,
"gpuManufacturer": "Nvidia",
"gpuModel": "A100",
"gpuSize": 40,
"available": true
},
{
"type": "ECS",
"memSum": 64,
"cpuTotalAmount": 16,
"deviceType": "pch1.4xlarge.4",
"flavorType": "GPU_C_PCH1",
"flavorID": "6ce65bbd-7996-3b74-7eb7-9ba3cc2d7681",
"cpuSockets": 0,
"numaNodeAmount": 0,
"cpuAmount": 16,
"cpuThreadAmount": 0,
"smartNicExist": false,
"systemVolumeDescription": "100G(SATA)",
"dataVolumeDescription": "",
"gpuAmount": 1,
"gpuManufacturer": "Cambricon",
"gpuModel": "MLU370 s4",
"gpuSize": 24,
"available": true
}
]
}
}
错误参数返回示例
HTTP/1.1 200 OK
Content-Type:application/json
{
"statusCode": 900,
"errorCode": "Cwai.Api.BadRequest",
"message": "***",
}
内部服务错误返回示例
TTP/1.1 200 OK
Content-Type:application/json
{
"statusCode": 900,
"errorCode": "Cwai.Api.InternalServerError",
"message": "***",
}
状态码
状态码 | 描述 |
---|---|
200 | 表示请求成功 |
错误码
错误码 | 描述 |
---|---|
Cwai.Api.BadRequest | 错误请求 |
Cwai.Api.NotFound | 资源不存在 |
Cwai.Api.StatusUnauthorized | 状态未授权 |
Cwai.Api.InternalServerError | 内部错误 |