【已评审】统一生效新增webreset接口评审

Interface SIG Interface评审
1

ISSUEl

web界面查询升级状态及生效状态信息

背景

支持web统一生效接口后，web页面会显示固件生效的进度，如果web页面切出后再切回固件生效界面，需要重新查询当前的生效进度
而此前webreset接口没有相关属性承载，所以web无法查询固件生效的进度

评审点

webreset接口新增属性，返回后端固件生效任务的TaskURI ，web通过此TaskURI查询固件生效的进度

接口信息

项 取值
URI /UI/Rest/BMCSettings/UpdateService
接口类型 GET
变化类型 新增属性
属性名称 ActiveUrl
数据类型 string/null
属性权限 只读
属性说明 当前升级资源的统一生效的任务URI，如果没有生效任务则为 null

示例

URL: /UI/Rest/BMCSettings/UpdateService
操作类型：GET
请求参数：{}
响应消息体举例：
{
    "ActiveMode": "Immediately",
    "ActiveModeSupported": false,
    "FirmwareVersion": {
        "ActiveBMCVersion": "5.10.00.02",
        "AvailableBMCVersion": "5.10.00.02",
        "BackupBMCVersion": "5.10.00.02"
    },
    "UpdatingFlag": false,
    "UpgradeUrl": null,
    "UpgradeMode": "Serial",
    "ActiveUrl": null
}

评审结论

通过，同意webrest接口 /UI/Rest/BMCSettings/UpdateService 新增属性 ActiveUrl，类型为 string，表征当前升级资源中生效任务的URI，如果没有生效任务则属性值为 null

2

问题 #1：当前议题没有关联issue
问题 #2：背景描述不清楚，上来就是说支持统一生效，究竟什么原因触发的评审？
问题 #3：评审点条目不清晰，什么叫生效任务的路径？