接口功能介绍
根据实例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 | |
| project | String | 项目信息 | standard | |
| 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,
"project": "standard"
},
"statusCode ": 800,
"errorCode": "",
"message": "SUCCESS",
"description": "成功"
}
状态码
| 状态码 | 描述 |
|---|---|
| 200 | 表示请求成功 |
错误码
| 错误码 | 描述 |
|---|---|
| Ebm.DeviceType.NotValid | 请求参数非法 |
| Ebm.Instance.NotFound | 物理机不存在 |
| Ebm.DeviceTypeList.NotFound | 套餐不存在 |
| Ebm.Common.CheckError | 内部错误，请重试 |
| 其他 | 参见公共错误码说明 |
