FirmwareInventory
更新时间： 2026/06/26
在Gitcode上查看源码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.SupportHotUpgrade | boolean | true | - | 固件是否支持热升级，当前只有BCU的CPLD固件有此属性 |
| 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生效 |
| Id | string | true | - | 可升级固件资源的ID |
| Name | string | true | - | 可升级固件资源的名称 |
| Status | object | true | - | 可升级固件资源的状态 ● State：使能状态 ● Health：健康状态 ● Severity：自定义健康状态 |
| Version | string | true | - | 固件版本 |
| Updateable | boolean | true | true,false | 是否可更新 |
| RelatedItem | array | true | - | 导航资源：关联的部件资源 |
| RelatedItem[].@odata.id | string | true | - | 关联的部件资源访问路径 |
| ReleaseDate | string | true | - | 当前固件的发布时间 |
| SoftwareId | string | true | - | 固件ID |
| Oem.Public.ComponentInfo | object | true | - | 热升级固件信息（仅Bios支持） |
| Oem.Public.BaseVersion | string | true | - | Bios基础版本（仅Bios支持） |
| Oem.Public.PatchVersion | string | true | - | Bios补丁版本（仅Bios支持） |
| Staged | boolean | true | true,false | 固件是否暂存 ● true：当前固件是暂存固件 ● false：当前固件不是暂存固件 |
supported_methods
- GET
HTTP methods
GET
命令功能
查询指定可升级固件资源信息
命令格式
URL: https://device_ip/redfish/v1/UpdateService/FirmwareInventory/softid
请求头:
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请求头：
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"
}
},
"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请求头：
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"
}
},
"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