Boards
更新时间： 2026/11/04
在AtomGit上查看源码ResourceDefinition
uris
/redfish/v1/Chassis/chassis_id/Boards/board_id
properties
| 名称 | 类型 | 是否只读 | 取值范围/枚举值 | 说明 |
|---|---|---|---|---|
| @odata.context | string | true | - | 指定扩展板卡资源模型的OData描述信息 |
| @odata.id | string | true | - | 指定扩展板卡资源的访问路径 |
| @odata.type | string | true | - | 指定扩展板卡资源的类型 |
| Id | string | true | - | 指定扩展板卡资源ID |
| Description | string | true | - | 指定扩展板卡描述信息 |
| Name | string | true | - | 指定扩展板卡资源名称 |
| CardNo | number | true | - | 指定扩展板卡编号 |
| Status { | object | true | - | 指定扩展板卡的状态包括： ● State：扩展板卡使能状态 ● Health：扩展板卡健康状态 ● Severity：扩展板卡的自定义健康状态 |
| Status.Health | string | true | - | 指定扩展板卡服务健康状态 |
| Status.Severity | string | true | Informational、Minor、Major、Critical | 指定扩展板卡的自定义健康状态 |
| Status.State | string | true | - | 指定扩展板卡的内存的在位状态 |
| } | ||||
| DeviceLocator | string | true | - | 指定扩展板卡的丝印 |
| DeviceType | string | true | - | 指定扩展板卡的类型 |
| Location | string | true | - | 指定扩展板卡的容器 |
| Manufacturer | string | true | - | 指定扩展板卡生产厂商 |
| ProductName | string | true | - | 指定扩展板卡产品名称 |
| SerialNumber | string | true | - | 指定扩展板卡序列号 |
| PartNumber | string | true | - | 指定扩展板卡部件号 |
| AssetTag | string | true | - | 指定扩展板卡资产标签 |
| CPLDVersion | string | true | - | 指定扩展板卡CPLD版本 |
| PCBVersion | string | true | - | 指定扩展板卡PCB版本 |
| BoardName | string | true | - | 指定扩展板卡单板名称 |
| BoardId | string | true | - | 指定扩展板卡单板Id |
| ComponentUniqueID | string | true | - | 指定扩展板卡的组件唯一标识 说明 openUBMC 25.12 LTS及以上版本支持 |
| ManufactureDate | string | true | - | 指定扩展板卡制造日期 |
| AssociatedResource | string | true | - | 指定扩展板卡的归属资源 |
| PositionId | string | true | - | 指定扩展板卡的位号 |
| PowerWatts | string | true | - | 指定扩展板卡的功率 说明：已屏蔽该属性值频繁变化导致的事件上报 |
| LinkWidthAbility | string | true | - | 指定扩展板卡的带宽规格 |
| LinkSpeedAbility | string | true | - | 指定扩展板卡的连接速率规格 |
| LinkWidth | string | true | - | 指定扩展板卡的当前带宽 |
| LinkSpeed | string | true | - | 指定扩展板卡的当前速率 |
| PchModel | string | true | - | 当前主板PCH型号 |
| SupportedRAIDLevels | string | true | - | Raid卡支持的raid级别 |
| FirmwareVersion | string | true | - | 指定扩展板卡的固件版本 说明：目前只有200 IOB卡支持 |
| WorkMode | string | false | - | 指定拓展板卡的工作模式，取值如下： ● AMP：独立模式 ● SMP：集成模式 说明：目前只有A800-9000，A800-9010及A300-9000的NPU卡支持 |
| M2Device1Presence | boolean | true | - | CIC卡的M.2卡槽位1在位情况 说明：目前只有S920X05的CIC卡支持 |
| M2Device2Presence | boolean | true | - | CIC卡的M.2卡槽位2在位情况 说明：目前只有S920X05的CIC卡支持 |
| RetimerVersion [ { | array | true | - | 指定扩展板卡上的Retimer芯片固件版本号： ● Version：固件版本号 ● PositionId：Retimer芯片的位号 |
| RetimerVersion[].Version | string | true | - | 固件版本号 |
| RetimerVersion[].PositionId | string | true | - | Retimer芯片的位号 |
| } ] | ||||
| Actions | null | true | - | 指定扩展板卡上的统一动作接口 |
| CSRVersion | string | true | - | 指定扩展板卡上的CSR文件版本号 说明 openUBMC 25.12 LTS及以上版本支持 |
| NpuName | string | true | - | 指定扩展板卡的NPU型号信息，只有ACU需要显示 |
| ComputeCapability | string | true | - | 指定扩展板卡的算力信息，目前只有ACU需要显示 |
| MulticLogic [ { | array | true | - | 指定扩展板卡上的逻辑器件信息： ● Version：逻辑器件版本号 ● Name：逻辑器件名称 ● PositionId：逻辑器件位号 |
| MulticLogic[].Version | string | true | - | 逻辑器件版本号 |
| MulticLogic[].PositionId | number | true | - | 逻辑器件位号 |
| MulticLogic[].Name | string | true | - | 逻辑器件名称 |
| } ] | ||||
| Links | object | true | - | 扩展板卡资源关联的资源 |
| MultiLogic[ ] | array | true | - | 指定扩展板卡上所有逻辑器件信息显示，包含cpld与fpga： Version：逻辑器件版本号 PositionId：逻辑器件位号 Name：逻辑器件名称 |
| Processors[ ] | array | true | - | 指定NPU板卡关联的NPU资源信息 |
| Oem { | object | true | - | 自定义属性 |
| } |
supported_methods
- GET
- PATCH
- POST
HTTP methods
GET
命令功能
查询指定扩展板卡资源信息
命令格式
URL: https://device_ip/redfish/v1/Chassis/chassis_id/Boards/board_id
请求头:
text
X-Auth-Token: 123456789***********************请求消息体: 无
参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| device_ip | 登录设备的IP地址 | IPv4或IPv6地址 |
| chassis_id | 机箱资源的ID | ● 针对机架服务器，取值为1 ● 针对高密服务器，取值为BladeN（N表示节点槽位号），例如 "Blade1" ● 针对刀片服务器，取值可以为BladeN（N表示计算节点槽位号）或SwiN（N表示交换模块槽位号），例如 "Swi1" ● 针对X6800 V5，X6000 V5，G5500，XA320 V2服务器，取值还可以为Enc，表示计算节点所在的机框资源 ● 针对设备U位信息，取值可以为UN(N表示设备U位号)，例如"U1" ● 针对机柜资源，取值为Rack |
| board_id | 扩展板资源的ID | 可通过扩展板卡集合资源获取。 |
| auth_value | 执行该GET请求时，必须在"Headers"中携带"X-Auth-Token"值用于鉴权 | 可通过/redfish/v1/SessionService/Sessions创建会话时获得 |
使用指南
无
使用实例
请求样例1：
http
GET <https://device_ip/redfish/v1/Chassis/1/Boards/chassisMainBoard>请求头：
text
X-Auth-Token: 123456789***********************请求消息体：无
响应样例：
json
{
"@odata.context": "/redfish/v1/$metadata#HwBoard.HwBoard",
"@odata.id": "/redfish/v1/Chassis/1/Boards/chassisMainBoard",
"@odata.type": "#HwBoard.v1_0_0.HwBoard",
"Id": "chassisMainBoard",
"Description": "MainBoard",
"Name": "chassisMainBoard",
"CardNo": 0,
"Status": {
"Health": "OK",
"Severity": "Informational",
"State": "Enabled"
},
"DeviceLocator": "MainBoard",
"DeviceType": "MainBoard",
"Location": "chassis",
"Manufacturer": "",
"ProductName": null,
"SerialNumber": "022JRVCNGB004253",
"PartNumber": "03022JRV",
"AssetTag": "%22",
"CPLDVersion": "1.11(U46)",
"PCBVersion": ".E",
"BoardName": "BC11HGSB",
"BoardId": "0x000e",
"ComponentUniqueID": null,
"ManufactureDate": "2016/11/16 Wed 20:23:00",
"AssociatedResource": null,
"PositionId": null,
"PowerWatts": null,
"LinkWidthAbility": null,
"LinkSpeedAbility": null,
"LinkWidth": null,
"LinkSpeed": null,
"PchModel": null,
"SupportedRAIDLevels": null,
"FirmwareVersion": "0.05",
"WorkMode": null,
"M2Device1Presence": null,
"M2Device2Presence": null,
"Actions": null,
"CSRVersion": null,
"NpuName": null,
"ComputeCapability": null,
"MulticLogic": [
{
"Version": "1.14",
"Name": "CPLD1",
"PositionId": 6288
},
{
"Version": "1.15",
"Name": "CPLD2",
"PositionId": 6293
}
],
"RetimerVersion": [
{
"PositionId": "U123",
"Version": "device_ip"
},
{
"PositionId": "U125",
"Version": "device_ip"
}
]
}响应码：200
请求样例2：
http
GET <https://device_ip/redfish/v1/Chassis/1/Boards/ACU1NpuBoard1>请求头：
text
X-Auth-Token: 123456789***********************请求消息体：无
响应样例：
json
{
"@odata.context": "/redfish/v1/$metadata#HwBoard.HwBoard",
"@odata.id": "/redfish/v1/Chassis/1/Boards/ACU1NpuBoard1",
"@odata.type": "#HwBoard.v1_0_0.HwBoard",
"Id": "ACU1NpuBoard1",
"Description": "NpuBoard",
"Name": "ACU1NpuBoard1",
"CardNo": 0,
"Status": {
"Health": "OK",
"Severity": "Informational",
"State": "Enabled"
},
"DeviceLocator": "MainBoard",
"DeviceType": "MainBoard",
"Location": "chassis",
"Manufacturer": "",
"ProductName": null,
"SerialNumber": "022JRVCNGB004253",
"PartNumber": "03022JRV",
"AssetTag": "%22",
"CPLDVersion": "1.11(U46)",
"PCBVersion": ".E",
"BoardName": "BC11HGSB",
"BoardId": "0x000e",
"ComponentUniqueID": null,
"ManufactureDate": "2016/11/16 Wed 20:23:00",
"AssociatedResource": null,
"PositionId": null,
"PowerWatts": null,
"LinkWidthAbility": null,
"LinkSpeedAbility": null,
"LinkWidth": null,
"LinkSpeed": null,
"PchModel": null,
"SupportedRAIDLevels": null,
"FirmwareVersion": "0.05",
"WorkMode": null,
"M2Device1Presence": null,
"M2Device2Presence": null,
"Actions": null,
"CSRVersion": null,
"NpuName": null,
"ComputeCapability": null,
"MulticLogic": [
{
"Version": "1.14",
"Name": "CPLD1",
"PositionId": 6288
},
{
"Version": "1.15",
"Name": "CPLD2",
"PositionId": 6293
}
],
"RetimerVersion": [
{
"PositionId": "U123",
"Version": "device_ip"
},
{
"PositionId": "U125",
"Version": "device_ip"
}
],
"Oem": {
"Public": {
"Actions": {
"#NpuBoard.NpuBoardReset": {
"target": "/redfish/v1/Chassis/1/Boards/ACU1NpuBoard1/Actions/NpuBoard.NpuBoardReset",
"@Redfish.ActionInfo": "/redfish/v1/Chassis/1/Boards/ACU1NpuBoard1/NpuBoardResetActionInfo"
}
}
}
}
}响应码：200
PATCH
命令功能
修改指定拓展板卡资源属性
命令格式
URL: https://device_ip/redfish/v1/Chassis/chassis_id/Boards/board_id
请求头:
text
X-Auth-Token: 123456789***********************请求消息体:
json
{
"WorkMode": mode
}URL参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| chassis_id | 机箱资源的ID | ● 针对机架服务器，取值为1 ● 针对高密服务器，取值为BladeN（N表示节点槽位号），例如 "Blade1" ● 针对刀片服务器，取值可以为BladeN（N表示计算节点槽位号）或SwiN（N表示交换模块槽位号），例如 "Swi1" ● 针对X6800 V5，X6000 V5，G5500，XA320 V2服务器，取值还可以为Enc，表示计算节点所在的机框资源 ● 针对设备U位信息，取值可以为UN(N表示设备U位号)，例如"U1" ● 针对机柜资源，取值为Rack |
| board_id | 扩展板资源的ID | 可通过扩展板卡集合资源获取。 |
请求头参数说明
参见 请求头参数说明
请求体参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| WorkMode | 指定拓展板卡的工作模式 | AMP：独立模式 SMP：集成模式 说明：目前只有A800-9000，A800-9010及A300-9000的NPU卡支持 |
使用指南
无
使用实例
请求样例：
http
PATCH <https://device_ip/redfish/v1/Chassis/1/Boards/mainboardNPUBoard1>请求头：
text
X-Auth-Token: 123456789***********************请求消息体：
json
{
"WorkMode": "AMP"
}响应样例：
json
{
"@odata.context": "/redfish/v1/$metadata#HwBoard.HwBoard",
"@odata.id": "/redfish/v1/Chassis/1/Boards/mainboardNPUBoard1",
"@odata.type": "#HwBoard.v1_0_0.HwBoard",
"Id": "mainboardNPUBoard1",
"Description": "GPUBoard",
"Name": "mainboardNPUBoard1",
"CardNo": 1,
"Status": {
"State": "Enabled",
"Severity": "Informational",
"Health": "OK"
},
"DeviceLocator": "NPUBoard1",
"DeviceType": "PCIeCardCarrierBoard",
"Location": "mainboard",
"Manufacturer": "",
"ProductName": null,
"SerialNumber": null,
"PartNumber": null,
"AssetTag": null,
"CPLDVersion": "1.00",
"PCBVersion": ".C",
"BoardName": "IT21SD4A",
"BoardId": "0x0093",
"ComponentUniqueID": null,
"ManufactureDate": "1996/01/01 Mon 00:00:00",
"AssociatedResource": null,
"PositionId": "U1152",
"PowerWatts": null,
"SupportedRAIDLevels": null,
"PchModel": null,
"LinkWidthAbility": null,
"LinkSpeedAbility": null,
"LinkWidth": null,
"LinkSpeed": null,
"WorkMode": "AMP",
"M2Device1Presence": null,
"M2Device2Presence": null,
"RetimerVersion": [
{
"PositionId": "U123",
"Version": "device_ip"
},
{
"PositionId": "U125",
"Version": "device_ip"
}
]
}响应码：200
POST (ACTION)
NpuReset
命令功能
NPU 模组复位
命令格式
URL: https://device_ip/redfish/v1/Chassis/chassis_id/Boards/board_id/Actions/NPUBoard.NPUBoardReset
请求头:
text
X-Auth-Token: 123456789***********************
Content-Type: header_type请求消息体:
json
{
"DomainId": domain_id
}请求头参数说明
参见 请求头参数说明
请求体参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| chassis_id | 机箱资源的ID | ● 针对机架服务器，取值为1 ● 针对高密服务器，取值为BladeN（N表示节点槽位号），例如 "Blade1" ● 针对刀片服务器，取值可以为BladeN（N表示计算节点槽位号）或SwiN（N表示交换模块槽位号），例如 "Swi1" ● 针对X6800 V5，X6000 V5，G5500，XA320 V2服务器，取值还可以为Enc，表示计算节点所在的机框资源 ● 针对设备U位信息，取值可以为UN(N表示设备U位号)，例如"U1" ● 针对机柜资源，取值为Rack |
| board_id | NPU板资源的ID | 可通过NPU板卡集合资源获取。 |
| domain_id | 可选字段，NPU复位域 | 缺省：按照0处理 0：复位NPU模组全域 1：复位NPU模组计算单元 说明：仅A900 A5 SuperPoD, Atlas 850/850E 服务器支持该属性 |
使用指南
无
使用实例
请求样例：
http
POST /redfish/v1/Chassis/1/Boards/ACU1NpuBoard1/Actions/NpuBoard.NpuBoardReset请求头：
text
X-Auth-Token: 123456789***********************
Content-Type: application/json请求消息体：
json
{
"DomainId": 1
}响应样例：
json
{
"error": {
"code": "Base.1.0.GeneralError",
"message": "A general error has occurred. See ExtendedInfo for more information.",
"@Message.ExtendedInfo": [
{
"@odata.type": "/redfish/v1/$metadata#MessageRegistry.1.0.0.MessageRegistry",
"MessageId": "Base.1.0.Success",
"RelatedProperties": [],
"Message": "Successfully Completed Request",
"MessageArgs": [],
"Severity": "OK",
"Resolution": "None"
}
]
}
}响应码：200