获取裸金属节点硬件信息(InspectBareMetal2Chassis)
API请求
URLs
PUT zstack/v1/baremetal2/chassis/{uuid}/actionsHeaders
Authorization: OAuth the-session-uuidBody
{
"inspectBareMetal2Chassis": {},
"systemTags": [],
"userTags": []
}Note: 上述示例中systemTags、userTags字段可以省略。列出是为了表示body中可以包含这两个字段。
Curl示例
curl -H "Content-Type: application/json;charset=UTF-8" \
-H "Authorization: OAuth b86c9016b4f24953a9edefb53ca0678c" \
-X PUT -d '{"inspectBareMetal2Chassis":{}}' \
http://localhost:8080/zstack/v1/baremetal2/chassis/374cb67145683e44a18ed671a424142f/actionsAPI返回
返回示例
{
"inventory": {
"uuid": "bc5e32728aa54d3585b8f75fe4a9d7bb",
"name": "BM_CHASSIS",
"description": "This is a bare metal chassis.",
"zoneUuid": "b7b96162d5464b1cb3ba7704675d1335",
"clusterUuid": "4c8c2faa3c4a4b77947564ba8abadbc8",
"chassisOfferingUuid": "2e90012ebfa34c6881e983ce478486d4",
"type": "IPMI",
"state": "Enabled",
"status": "Available",
"powerStatus": "POWER_ON",
"createDate": "Nov 14, 2017 10:20:57 PM",
"lastOpDate": "Nov 14, 2017 10:20:57 PM"
}
}| 名字 | 类型 | 描述 | 起始版本 |
|---|---|---|---|
| success | boolean | 4.3.6 | |
| error | ErrorCode | 错误码,若不为null,则表示操作失败, 操作成功时该字段为null。 详情参考error | 4.0.0 |
| inventory | BareMetal2ChassisInventory | 详情参考inventory | 4.0.0 |
#error
| 名字 | 类型 | 描述 | 起始版本 |
|---|---|---|---|
| code | String | 错误码号,错误的全局唯一标识,例如SYS.1000, HOST.1001 | 4.0.0 |
| description | String | 错误的概要描述 | 4.0.0 |
| details | String | 错误的详细信息 | 4.0.0 |
| elaboration | String | 保留字段,默认为null | 4.0.0 |
| opaque | LinkedHashMap | 保留字段,默认为null | 4.0.0 |
| cause | ErrorCode | 根错误,引发当前错误的源错误,若无原错误,该字段为null | 4.0.0 |
#inventory
| 名字 | 类型 | 描述 | 起始版本 |
|---|---|---|---|
| uuid | String | 资源的UUID,唯一标示该资源 | 4.0.0 |
| name | String | 资源名称 | 4.0.0 |
| description | String | 资源的详细描述 | 4.0.0 |
| zoneUuid | String | 区域UUID | 4.0.0 |
| clusterUuid | String | 集群UUID | 4.0.0 |
| chassisOfferingUuid | String | 裸金属节点规格UUID | 4.0.0 |
| type | String | 类型 | 4.0.0 |
| state | String | 启用状态 | 4.0.0 |
| status | String | 分配状态 | 4.0.0 |
| powerStatus | String | 电源状态 | 4.0.0 |
| createDate | Timestamp | 创建时间 | 4.0.0 |
| lastOpDate | Timestamp | 最后一次修改时间 | 4.0.0 |
| chassisNics | List | 详情参考chassisNics | 4.0.0 |
| chassisDisks | List | 详情参考chassisDisks | 4.0.0 |
| chassisOffering | BareMetal2ChassisOfferingInventory | 详情参考chassisOffering | 4.0 |
#chassisNics
| 名字 | 类型 | 描述 | 起始版本 |
|---|---|---|---|
| uuid | String | 资源的UUID,唯一标示该资源 | 4.0.0 |
| chassisUuid | String | 裸金属节点UUID | 4.0.0 |
| mac | String | 网卡MAC | 4.0.0 |
| speed | String | 网卡速率 | 4.0.0 |
| isProvisionNic | Boolean | 是否为部署网卡 | 4.0.0 |
| createDate | Timestamp | 创建时间 | 4.0.0 |
| lastOpDate | Timestamp | 最后一次修改时间 | 4.0.0 |
#chassisDisks
| 名字 | 类型 | 描述 | 起始版本 |
|---|---|---|---|
| uuid | String | 资源的UUID,唯一标示该资源 | 4.0.0 |
| chassisUuid | String | 裸金属节点UUID | 4.0.0 |
| diskSize | Long | 磁盘空间(以字节为单位) | 4.0.0 |
| type | String | 磁盘类型 | 4.0.0 |
| createDate | Timestamp | 创建时间 | 4.0.0 |
| lastOpDate | Timestamp | 最后一次修改时间 | 4.0.0 |
#chassisOffering
| 名字 | 类型 | 描述 | 起始版本 |
|---|---|---|---|
| uuid | String | 资源的UUID,唯一标示该资源 | 4.0.0 |
| name | String | 资源名称 | 4.0.0 |
| description | String | 资源的详细描述 | 4.0.0 |
| architecture | String | CPU架构 | 4.0.0 |
| cpuModelName | String | CPU型号 | 4.0.0 |
| cpuNum | Integer | CPU核数 | 4.0.0 |
| memorySize | Long | 内存容量 | 4.0.0 |
| bootMode | String | 启动模式 | 4.0.0 |
| state | String | 状态 | 4.0.0 |
| createDate | Timestamp | 创建时间 | 4.0.0 |
| lastOpDate | Timestamp | 最后一次修改时间 | 4.0.0 |
SDK示例
Java
SDK
InspectBareMetal2ChassisAction action = new InspectBareMetal2ChassisAction();
action.uuid = "374cb67145683e44a18ed671a424142f";
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c";
InspectBareMetal2ChassisAction.Result res = action.call();Python
SDK
InspectBareMetal2ChassisAction action = InspectBareMetal2ChassisAction()
action.uuid = "374cb67145683e44a18ed671a424142f"
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c"
InspectBareMetal2ChassisAction.Result res = action.call()