【已评审】Redfish并行升级接口支持指定固件升级

Interface SIG Interface评审
1

背景

业务场景中，存在先升级指定固件作为前置验证，再根据升级结果对剩余设备进行批量升级的诉求，因此需要升级接口提供能力支持指定固件升级

关联ISSUE

暂无

整体方案

Redfish并行升级接口在请求体中新增参数Targets用于表示指定的固件

评审点 Redfish并行升级接口请求体新增参数Targets用于表示指定的固件

详细描述

资源URI：/redfish/v1/UpdateService/Actions/Oem/{{OemIdentifier}}/UpdateService.ParallelUpdate
资源版本 ：openubmcupdateservice.v1.0.0
操作类型：Post
变化类型：Packages请求体对象元素新增参数Targets
应用场景：支持升级指定的固件

属性名称 类型 示例/默认值/取值约束 默认值 操作权限 描述
Targets array (string) 示例：Targets:[“/redfish/v1/Chassis/{id}/Drives/{driveid}]” 默认值无（可选参数） 无（可选参数） BasicSetting 指定本次固件更新操作所指定的可更新资源的完整 Redfish 资源 URI。

示例

{
    "Packages": [
            {
                 "ImageURI": "/tmp/xxx.hpm",
                 "Targets":["/redfish/v1/Chassis/Drives/HDDPlaneDisk0"]
            }
     ]
}

Schema定义 ：

"Targets": {
    "description": "The array of URIs indicating where the update image is to be applied.",
    "format": "uri-reference",
    "items": {
        "type": "string"
    },
    "longDescription": "This array property shall contain zero or more URIs indicating where the update image is to be applied. These targets should correspond to SoftwareInventory instances or their RelatedItems. If this property is not present or contains zero targets, the Service shall apply the software image to all applicable targets (as determined by the Service).",
    "type": "array"
}

评审结论

同意Redfish并行升级接口/redfish/v1/UpdateService/Actions/Oem/{{OemIdentifier}}/UpdateService.ParallelUpdate请求体入参Packages对象元素新增参数Targets，类型array (string)，用于指定目标固件升级