背景
客户希望在Message中展示特定字段:升级固件当前版本、升级固件目标版本、升级固件的生效方式。
在并行升级过程中,存在同类型固件同时升级 的场景。当前通过 GetUpdateProgress 方法获取升级进度时,无法区分同类型固件的不同升级任务
在一次固件升级任务中,可能同时升级多个target实体对象,客户希望能获取每一个目标实体对象的升级结果
关联ISSUE
暂无
整体方案
在GetUpdateProgress 方法的响应中增加字段 TaskId ,用于唯一标识一个固件的升级进度。
在GetUpdateProgress 方法的响应中增加字段 SuccessTargets FailedTargets ,用于唯一标识一个固件的升级进度。
评审点 GetUpdateProgress方法响应参数内增加字段
详细描述
方法详情如下:
| 变更类型 | 方法名称 | 请求签名 | 请求参数描述 | 响应签名 | 响应参数描述 | 方法描述 | 访问权限 | 变更影响 |
|---|---|---|---|---|---|---|---|---|
| 响应参数内新增字段 | GetUpdateProgress | 无 | 无 | sa(a{ss}) | UpgradeMode:类型为 string,表征当前升级管理的升级模式UpgradeTasks:类型为 array<dict>,表征当前升级管理的升级任务的进度信息,其中数组的每个元素 UpdateProgress 都是一个正在升级的任务信息。 |
获取所有升级任务的进度信息 | ReadOnly | 响应参数UpgradeTasks内增加字段,无影响 |
当前 UpdateProgress 已经有的属性如下:
| 属性名称 | 属性签名 | 属性类型 | 属性说明 |
|---|---|---|---|
| TaskName | s | string | 表征升级任务的名称 |
| Firmware | s | string | 表征升级固件的描述 |
| FirmwareInstance | s | string | 表征升级的固件实例 |
| FileName | s | string | 表征升级的固件包名 |
| Percentage | s | string | 表征升级任务当前的状态 |
| TaskState | s | string | 表征升级状态 |
| ErrorCode | s | string | 表征升级任务的错误码(注意:对于需要映射错误码时可以转换为数字) |
| CurrentVersion | s | string | 表征升级固件当前版本号 |
| TargetVersion | s | string | 表征升级固件目标版本号 |
| ActivateMode | s | string | 表征固件生效方式 |
本次评审需要在 UpdateProgress 下新增属性如下:
| 属性名称 | 属性签名 | 属性类型 | 属性说明 |
|---|---|---|---|
| TaskId | s | string | 表征升级任务Id |
| SuccessTargets | s | string | 表征升级成功的目标实例详情 |
| FailedTargets | s | string | 表征升级失败的目标实例详情 |
是否准备好AI预审
是
评审结论
同意资源协作接口方法GetUpdateProgress响应参数内增加字段TaskId,属性类型string,表征升级任务Id;SuccessTargets,属性类型string,表征升级成功的目标实例详情;FailedTargets,属性类型string,表征升级失败的目标实例详情