接口功能介绍
根据实例ID查询对应套餐信息
接口约束
无
URI
GET /v4/ebm/instance-device-type
路径参数
无
Query参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
regionID | 是 | String | 区域ID | 81f7728662dd11ec810800155d307d5b | |
azName | 是 | String | 可用区名称或者 default。您可以调用 https://eop.ctyun.cn/ebp/ctapiDocument/search?sid=25&api=5855&data=87 获取资源池信息,查询结果中zoneList内返回可用区名称,若查询结果中zoneList为空,即为单可用区,本字段填写default | az1 | |
instanceUUID | 是 | String | 实例UUID | ss-qyjtenwqho0gfztts5vscc2l5efi |
请求参数
请求头header参数
无
请求体body参数
无
响应参数
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
statusCode | Integer | 返回状态码(800为成功,900为失败),默认值:800 | 800 | |
errorCode | String | 业务细分码,为product.module.code三段式码,详见错误码说明 | Ebm.DeviceType.NotValid | |
message | String | 响应结果的描述,一般为英文描述 | error request | |
description | String | 响应结果的描述,一般为中文描述 | 错误请求 | |
returnObj | Object | 返回参数,参考表returnObj | {} | returnObj |
表returnObj
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
id | Integer | 套餐ID | 1 | |
region | String | 资源池 | cn-huhehaote-t11 | |
azName | String | 可用区 | az2 | |
deviceType | String | 套餐类型 | physical.t3.large | |
nameZh | String | 物理机中文名 | 大数据服务器-1 | |
nameEn | String | 英文名 | Dell PowerEdge R740 | |
cpuSockets | Integer | 物理cpu数量 | 1 | |
numaNodeAmount | Integer | 单个cpu numa node数量 | 2 | |
cpuAmount | Integer | 单个cpu核数 | 8 | |
cpuThreadAmount | Integer | 单个cpu核超线程数量 | 2 | |
cpuManufacturer | String | cpu厂商;Intel,AMD,Hygon,HiSilicon,Loongson等 | Intel | |
cpuModel | String | cpu型号 | 6248R | |
cpuFrequency | String | cpu频率(G) | 3.0 | |
memAmount | Integer | 内存数 | 1 | |
memSize | Integer | 内存大小(G) | 32 | |
memFrequency | Integer | 内存频率(MHz) | 2666 | |
nicAmount | Integer | 网卡数 | 2 | |
nicRate | Integer | 网卡传播速率(GE) | 25 | |
systemVolumeAmount | Integer | 系统盘数量 | 2 | |
systemVolumeSize | Integer | 系统盘单盘大小(GB) | 100 | |
systemVolumeType | String | 系统盘介质类型; 包含SSD、HDD | SSD | |
systemVolumeInterface | String | 系统盘接口类型;包含SAS、SATA、NVMe | SATA | |
systemVolumeDescription | String | 系统盘描述 | 2*480GB(SSD) | |
dataVolumeAmount | Integer | 数据盘数量 | 1 | |
dataVolumeSize | Integer | 数据盘单盘大小(GB) | 0 | |
dataVolumeInterface | String | 数据盘接口;包含SAS、SATA、NVMe | SATA | |
dataVolumeType | String | 数据盘介质类型; 包含SSD、HDD | SSD | |
dataVolumeDescription | String | 数据盘描述 | 2*480GB(SSD) | |
smartNicExist | Boolean | 是否有智能网卡,true为弹性裸金属; false为标准裸金属 | true | |
nvmeVolumeAmount | Integer | NVME硬盘数量 | 1 | |
nvmeVolumeSize | Integer | NVME硬盘单盘大小(GB) | 100 | |
nvmeVolumeType | String | NVME介质类型; 包含SSD、HDD | SSD | |
nvmeVolumeInterface | String | NVME接口类型;包含SAS、SATA、NVMe | SATA | |
gpuAmount | Integer | GPU数目 | 1 | |
gpuSize | Integer | GPU显存 | 40 | |
gpuManufacturer | String | GPU厂商;Nvidia,Huawei,Cambricon等 | Nvidia | |
gpuModel | String | GPU型号 | A100 | |
computeIBAmount | Integer | 计算ib网卡大小 | 0 | |
computeIBRate | Integer | 计算ib网卡速率(GE) | 0 | |
storageIBAmount | Integer | 存储ib网卡大小 | 0 | |
storageIBRate | Integer | 存储ib网卡速率(GE) | 0 | |
computeRoCEAmount | Integer | 计算RoCE网卡大小 | 0 | |
computeRoCERate | Integer | 计算RoCE网卡速率(GE) | 0 | |
storageRoCEAmount | Integer | 存储RoCE网卡大小 | 0 | |
storageRoCERate | Integer | 存储RoCE网卡速率(GE) | 0 | |
supportCloud | Boolean | 是否支持云盘 | true | |
cloudBoot | Boolean | 是否支持云盘启动 | true | |
enableShadowVpc | Boolean | 是否支持存储高速网络;如支持存储高速网络则会占用对应可用网卡数量 | true | |
createTime | String | 创建时间(epoch 时间格式) | 2022 - 05 - 24 05: 33: 55 | |
updateTime | String | 最后更新时间(epoch 时间格式) | 2022 - 05 - 24 05: 33: 55 |
请求示例
Query
/v4/ebm/instance-device-type?regionID=81f7728662dd11ec810800155d307d5b&azName=az1&instanceUUID=ss-qyjtenwqho0gfztts5vscc2l5efi
响应示例
{
"returnObj": {
"cpuModel": "5218",
"nvmeVolumeType": "",
"nameZh": "大数据服务器-1",
"nvmeVolumeInterface": "",
"updateTime": "2023-05-24 05:33:55",
"systemVolumeSize": 480,
"systemVolumeType": "SSD",
"cpuManufacturer": "Intel",
"nameEn": "Dell PowerEdge R740",
"id": 23,
"nicAmount": 2,
"nvmeVolumeAmount": 0,
"smartNicExist": false,
"cpuFrequency": "2.3",
"cpuThreadAmount": 2,
"systemVolumeInterface": "SATA",
"gpuManufacturer": "",
"dataVolumeType": "HDD",
"gpuModel": "",
"deviceType": "physical.s4.2xlarge1.6",
"systemVolumeAmount": 2,
"dataVolumeDescription": "12*8000GB(SATA)",
"gpuSize": 0,
"memAmount": 8,
"memSize": 32,
"gpuAmount": 0,
"systemVolumeDescription": "2*480GB(SSD)",
"memFrequency": 2666,
"azName": "cn-huadong1-jsnj1A-public-ctcloud",
"nvmeVolumeSize": 0,
"cpuSockets": 2,
"cpuAmount": 16,
"createTime": "2023-05-24 05:33:55",
"supportCloud": false,
"dataVolumeAmount": 12,
"numaNodeAmount": 2,
"region": "cn-huadong1-public-ctcloud",
"dataVolumeSize": 8000,
"dataVolumeInterface": "SATA",
"nicRate": 10,
"cloudBoot": false,
"enableShadowVpc": false,
"computeIBAmount": 0,
"computeIBRate": 0,
"storageIBAmount": 0,
"storageIBRate": 0,
"computeRoCEAmount": 0,
"computeRoCERate": 0,
"storageRoCEAmount": 0,
"storageRoCERate": 0
},
"statusCode ": 800,
"errorCode": "",
"message": "SUCCESS",
"description": "成功"
}
状态码
状态码 | 描述 |
---|---|
200 | 表示请求成功 |
错误码
错误码 | 描述 |
---|---|
Ebm.DeviceType.NotValid | 请求参数非法 |
Ebm.Instance.NotFound | 物理机不存在 |
Ebm.DeviceTypeList.NotFound | 套餐不存在 |
Ebm.Common.CheckError | 内部错误,请重试 |
其他 | 参见公共错误码说明 |