Skip to main content

GET – Firmware inventory properties

Use the GET method to retrieve each firmware info.

Request URL

GET https://<BMC_IPADDR>/redfish/v1/UpdateService/FirmwareInventory/{Id}

Response body

FieldTypeDescription
IdString

The Id property uniquely identifies this firmware.

DescriptionString

Description for the firmware.

LowestSupportedVersionString

A string representing the lowest supported version of this software.

NameString

The name of this firmware.

RelatedItemArray

URI of the resources associated with this software inventory item.

 RelatedItem[N]Object

Link to the manager resource.

SoftwareIdString

A specific ID for identifying this firmware.

ManufacturerString

A string representing the manufacturer/producer of this firmware.

ReleaseDateString

Release date of this firmware. Note: If is PMem firmware info, this object will be hidden.

StatusObject

Expanded.

 HealthRollupString

"OK".

 HealthString

"OK"

 StateString

The firmware indevtory status such as “Enabled”, “Disabled”, “StandbySpare”.

UpdateableBoolean

Indicates whether the firmware can be updated by redfish.

VersionString

The firmware version number.

In order to be identified by management software, the Version property value can be different to the Version string displayed in Web or Legacy CLI.

WriteProtectedBoolean

true

Status code

HTTP Status CodeError Message ID
500InternalError

Example

The following example JSON response describes the BMC (Primary) firmware information.

{
"SoftwareId": "BMC-CDI3-10",
"Updateable": true,
"Name": "Firmware:BMC",
"@odata.etag": "\"0d057295e35b9b29dda4595a90d7ac3f\"",
"Version": "40M-3.00",
"RelatedItem@odata.count": 1,
"LowestSupportedVersion": null,
"@odata.type": "#SoftwareInventory.v1_2_2.SoftwareInventory",
"WriteProtected": true,
"Id": "BMC-Primary",
"RelatedItem": [
{
"@odata.id": "/redfish/v1/Managers/1"
}
],
"Status": {
"Health": "OK",
"HealthRollup": "OK",
"State": "Enabled"
},
"ReleaseDate": "2019-09-25T00:00:00Z",
"@odata.id": "/redfish/v1/UpdateService/FirmwareInventory/BMC-Primary",
"Manufacturer": "Lenovo",
"Description": "The information of BMC (Primary) firmware."
}

The following example JSON response describes firmware information of a RAID adapter.

{
"SoftwareId": "DEVICE-1D490500-13",
"Updateable": true,
"Name": "Firmware:DEVICE-ThinkSystem RAID 530-8i PCIe 12Gb Adapter",
"@odata.etag": "\"dffae54e34119fe6bb7ce896633c58ae\"",
"Version": "50.5.0-1510",
"RelatedItem@odata.count": 1,
"LowestSupportedVersion": null,
"@odata.type": "#SoftwareInventory.v1_2_2.SoftwareInventory",
"Id": "Slot_7.Bundle",
"RelatedItem": [
{
"@odata.id": "/redfish/v1/Systems/1/PCIeDevices/slot_7"
}
],
"Status": {
"Health": "OK",
"HealthRollup": "OK",
"State": "Enabled"
},
"ReleaseDate": "2018-06-25T00:00:00Z",
"@odata.id": "/redfish/v1/UpdateService/FirmwareInventory/Slot_7.Bundle",
"Manufacturer": "AVAGO Technologies",
"Description": "The information of ThinkSystem RAID 530-8i PCIe 12Gb Adapter firmware."
}