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

Id

String

The Id property uniquely identifies this firmware.

Description

String

Description for the firmware.

LowestSupportedVersion

String

A string representing the lowest supported version of this software.

Name

String

The name of this firmware.

RelatedItem

Array

URI of the resources associated with this software inventory item.

 

RelatedItem[N]

Object

Link to the manager resource.

SoftwareId

String

A specific ID for identifying this firmware.

Manufacturer

String

A string representing the manufacturer/producer of this firmware.

ReleaseDate

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

Status

Object

Expanded.

 

HealthRollup

String

"OK".

 

Health

String

"OK"

 

State

String

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

Updateable

Boolean

Indicates whether the firmware can be updated by redfish.

Version

String

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.

WriteProtected

Boolean

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."
}