跳到主要内容

GET – 固件清单属性

使用 GET 方法检索每个固件信息。

请求 URL​

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

响应正文​

字段类型描述

Description

字符串

固件的描述。

Id

字符串

Id 属性用于唯一标识此固件。

Manufacturer

字符串

表示此固件的制造商/生产商的字符串。

Name

字符串

此固件的名称。

RelatedItem

数组

与此软件清单项关联的资源的 URI。

 

RelatedItem[N]

对象

管理器资源的链接。

RelatedItem@odata.count

数字

相关项的数量。

ReleaseDate

字符串

此固件的发布日期。

SoftwareId

字符串

用于标识此固件的特定 ID。

Status

对象

已展开。

 

Health

字符串

“OK”

 

State

字符串

固件清单状态，如“Enabled”、“Disabled”、“StandbySpare”。

Updateable

布尔

指示 Redfish 是否可以更新固件。

Version

字符串

固件版本号。

为了便于由管理软件进行识别，Version 属性值可以不同于 Web 或旧版 CLI 中显示的版本字符串。

WriteProtected

布尔

true

状态代码​

HTTP 状态代码错误消息 ID
500InternalError

示例​

以下示例 JSON 响应描述了 BMC（主）固件信息。

{
    "@odata.context": "/redfish/v1/$metadata#SoftwareInventory.SoftwareInventory",
    "@odata.etag": "\"2D7BADF2\"",
    "@odata.id": "/redfish/v1/UpdateService/FirmwareInventory/BMC-Backup",
    "@odata.type": "#SoftwareInventory.v1_3_0.SoftwareInventory",
    "Description": "The information of Firmware:BMC firmware.",
    "Id": "BMC-Backup",
    "Manufacturer": "Lenovo",
    "Name": "Firmware:BMC",
    "Oem": {
        ...
        }
    },
    "RelatedItem": [
        {
            "@odata.id": "/redfish/v1/Managers/1"
        }
    ],
    "RelatedItem@odata.count": 1,
    "ReleaseDate": "2024-11-28T00:00:00Z",
    "SoftwareId": "BMC-IHX4-10",
    "Status": {
        "Health": "OK",
        "State": "StandbySpare"
    },
    "Updateable": true,
    "Version": "07Y-0.80",
    "WriteProtected": true
}

以下示例 JSON 响应描述了网络适配器的固件信息。

{
    "@odata.context": "/redfish/v1/$metadata#SoftwareInventory.SoftwareInventory",
    "@odata.etag": "\"4FCB14A9\"",
    "@odata.id": "/redfish/v1/UpdateService/FirmwareInventory/PCIeDevice_slot5_0x460000.Bundle",
    "@odata.type": "#SoftwareInventory.v1_3_0.SoftwareInventory",
    "Description": "The information of Firmware:DEVICE-Broadcom NetXtreme                     PCIe 1Gb 4-Port RJ45 Ethernet Adapter firmware.",
    "Id": "PCIeDevice_slot5_0x460000.Bundle",
    "Manufacturer": "Broadcom Limited",
    "Name": "Firmware:DEVICE-Broadcom NetXtreme PCIe 1Gb 4-Port RJ45 Ethernet Adapter",
    "RelatedItem": [
        {
            "@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/slot5_0x460000"
        },
        {
            "@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/slot5_0x460000"
        }
    ],
    "RelatedItem@odata.count": 2,
    "SoftwareId": "DEVICE-14E4-1657-17AA-402D-13",
    "Status": {
        "Health": "OK",
        "State": "Enabled"
    },
    "Updateable": false,
    "Version": "230.0.3.1",
    "WriteProtected": true
}