FirmwareInventory
更新时间： 2026/10/29
在AtomGit上查看源码ResourceDefinition
uris
/redfish/v1/UpdateService/FirmwareInventory/{softid}
properties
| 名称 | 类型 | 是否只读 | 取值范围/枚举值 | 说明 |
|---|---|---|---|---|
| @odata.context | string | true | - | 可升级固件资源模型的OData描述信息 |
| @odata.id | string | true | - | 可升级固件资源的访问路径 |
| @odata.type | string | true | - | 可升级固件资源的类型 |
| Oem { | object | true | - | 指定固件的定制信息 |
| Oem.Public { | object | true | - | 指定固件的定制信息 |
| Oem.Public.PositionId | string | true | - | 固件资源的位置号 |
| Oem.Public.Manufacturer | string | true | - | 固件资源所属厂商 |
| Oem.Public.ActiveModeSupported | boolean | true | true,false | 是否支持BMC升级生效分离 |
| Oem.Public.ActiveMode | string | true | Immediately,ResetBMC | 升级BMC固件或CSR支持的生效模式 ● Immediately：成功升级BMC固件或CSR后BMC自动复位生效。BMC重启后需要几分钟才恢复通信 ● ResetBMC：成功升级BMC固件或CSR后需要手动复位BMC生效 |
| Oem.Public.Type | string | true | BMC、Bios、CPLD | 固件类型 |
| Oem.Public.ComponentInfo | object | true | - | 热升级固件信息（仅Bios支持） |
| Oem.Public.SupportHotUpgrade | boolean | true | - | 固件是否支持热升级，当前只有BCU的CPLD固件有此属性 |
| } | ||||
| } | ||||
| Id | string | true | - | 可升级固件资源的ID |
| Name | string | true | - | 可升级固件资源的名称 |
| Status { | object | true | - | 可升级固件资源的状态 ● State：使能状态 ● Health：健康状态 ● Severity：自定义健康状态 |
| Status.Health | string | true | - | 可升级固件服务健康状态 |
| Status.Oem { | object | true | - | 自定义属性 |
| Status.Oem.Public { | object | true | - | 自定义属性 |
| Status.Oem.Public.Severity | string | false | - | 可升级固件的自定义健康状态 |
| } | ||||
| } | ||||
| Status.State | string | true | - | 可升级固件服务状态 |
| } | ||||
| Version | string | true | - | 固件版本 |
| Updateable | boolean | true | true,false | 是否可更新 |
| RelatedItem [ { | array | true | - | 导航资源：关联的部件资源 |
RelatedItem[].@odata.id | string | true | - | 关联的部件资源访问路径 |
| } ] | ||||
| ReleaseDate | string | true | - | 当前固件的发布时间 |
| SoftwareId | string | true | - | 固件ID |
| Staged | boolean | true | true,false | 固件是否暂存 ● true：当前固件是暂存固件 ● false：当前固件不是暂存固件 说明：E9000U机型不支持此功能 |
| BaseVersion | string | false | - | Bios基础版本（仅Bios支持） |
| PatchVersion | string | false | - | Bios补丁版本（仅Bios支持） |
| WriteProtected | boolean | true | - | 当前固件是否处于写保护状态 true false |
supported_methods
- GET
HTTP methods
GET
命令功能
查询指定可升级固件资源信息
命令格式
URL: https://device_ip/redfish/v1/UpdateService/FirmwareInventory/softid
请求头:
text
X-Auth-Token: 123456789***********************请求消息体: 无
参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| device_ip | 登录设备的IP地址 | IPv4或IPv6地址 |
| auth_value | 执行该GET请求时，必须在"Headers"中携带"X-Auth-Token"值用于鉴权 | 可通过/redfish/v1/SessionService/Sessions创建会话时获得 |
| softid | 可升级固件资源的ID | 可通过可升级固件集合资源获得 |
使用指南
无
使用实例
请求样例1：
http
GET <https://device_ip/redfish/v1/UpdateService/FirmwareInventory/ActiveBMC>请求头：
text
X-Auth-Token: 123456789***********************响应样例：
json
{
"@odata.context": "/redfish/v1/$metadata#UpdateService/firmwareinventory/members/$entity",
"@odata.id": "/redfish/v1/UpdateService/FirmwareInventory/ActiveBMC",
"@odata.type": "#SoftwareInventory.v1_2_0.SoftwareInventory",
"Oem": {
"Public": {
"PositionId": "U25",
"Manufacturer": "",
"ActiveModeSupported": true,
"ActiveMode": "Immediately",
"Type": "BMC"
}
},
"Id": "ActiveBMC",
"Name": "ActiveBMC",
"Status": {
"Health": "OK",
"Oem": {
"Public": {
"Severity": "Informational"
}
},
"State": "Enabled"
},
"Version": "2.32",
"Updateable": true,
"RelatedItem": [
{
"@odata.id": "/redfish/v1/Managers/1"
}
],
"ReleaseDate": "2025-09-08T20:33:51Z",
"SoftwareId": "BMC-iBMC",
"Staged": true
}响应码：200
请求样例2：
http
GET <https://device_ip/redfish/v1/UpdateService/FirmwareInventory/Bios>请求头：
text
X-Auth-Token: 123456789***********************响应样例：
json
{
"@odata.context": "/redfish/v1/$metadata#UpdateService/firmwareinventory/members/$entity",
"@odata.id": "/redfish/v1/UpdateService/FirmwareInventory/Bios",
"@odata.type": "#SoftwareInventory.v1_2_0.SoftwareInventory",
"Oem": {
"Public": {
"PositionId": "U75",
"Manufacturer": "",
"ComponentInfo": [],
"BaseVersion": "20.00",
"PatchVersion": "",
"ActiveModeSupported": true,
"ActiveMode": "Immediately",
"UpgradeEnough": "true",
"Type": "Bios"
}
},
"Id": "Bios",
"Name": "Bios",
"Status": {
"Health": "OK",
"Oem": {
"Public": {
"Severity": "Informational"
}
},
"State": "Enabled"
},
"Version": "20.00",
"Updateable": true,
"RelatedItem": [
{
"@odata.id": "/redfish/v1/Systems/1/Bios"
}
],
"ReleaseDate": "2025-09-08T20:33:51Z",
"SoftwareId": "BIOS-BIOS",
"Staged": true
}响应码：200