【已评审】新增升级前预检查redfish接口

Interface SIG Interface评审
1

前置评审

背景

现网运维在升级前会进行很多准备工作，且运维的升级管控严格。如果因为升级条件不具备、升级通道故障等导致升级失败，会导致现网运维升级前准备工作浪费，影响较大
现网运维对BMC有诉求提供升级前测试接口，在升级准备工作前就可以做一下升级提前量测试，测试有失败时，优先处理失败，这样就可以有效减少实际升级失败的影响。

关联ISSUE

暂无

整体方案

新增POST接口（/redfish/v1/UpdateService/Actions/Oem/Huawei/UpdateService.PrepareUpdate），用以触发升级前预检查（如通道检查、资源检查等）

评审点 新增升级前预检查Redfish接口

URI: /redfish/v1/UpdateService/Actions/Oem/{{OemIdentifier}}/UpdateService.PrepareUpdate
操作类型：POST
请求参数：{}
权限：BasicSetting
响应：任务通用响应

详细描述

接口样例：

image
image1350×743 78.6 KB

响应消息体举例：

{ 
    "@odata.context": "/redfish/v1/$metadata#TaskService/Tasks/Members/$entity", 
    "@odata.type": "#Task.v1_0_2.Task", 
    "@odata.id": "/redfish/v1/TaskService/Tasks/1", 
    "Id": "1", 
    "Name": “Prepare Update Task"
    "TaskState": "Running", 
    "StartTime": "2016-11-28T10:36+00:00", 
    "Messages": [], 
    "Oem": { 
           "Huawei": { 
            "TaskPercentage": null
        }
    }
}

检查结果查询效果：
通过FirmwareInventory资源下的Serverity属性（历史已支持）标识检查的结果

评审结论

通过，同意新增Redfish Action /redfish/v1/UpdateService/Actions/Oem/{{OemIdentifier}}/UpdateService.PrepareUpdate，用于升级前检测，主要是进行升级需要的资源以及使用的升级通道检查；Action 操作类型为 POST，权限为 BasicSetting，无请求参数，响应为 Redfish Task；当前 Action 的检测结果会在检测的对应固件的 FirmwareInventory资源下的Serverity属性进行承载，取值有：Informational（正常）、Critical（异常）

遗留问题

无