变更声明
背景
当前在设置全局热备盘或取消热备盘的时候，HotspareType（驱动的热备状态）和SpareforLogicalDrives（指定驱动器是局部热备盘时所属逻辑盘列表）两个属性之间是相互关联的，先前实现在传递不符合条件的属性时，北向接口会空转，不抛出错误和错误描述。
当前对HotspareType和SpareforLogicalDrives两个属性在北向增加校验，并在传值错误时返回错误信息。
受影响的版本
- openUBMC 26.0
变更描述
规格变化
不涉及
外观变化
不涉及
外部接口变化
接口：/redfish/v1/Chassis/:chassisid/Drives/:driveid
相关属性：HotspareType、SpareforLogicalDrives
操作类型：Patch
| 属性名称 | 取值类型 | 取值范围 | 描述 |
|---|---|---|---|
| HotspareType | string,null | 枚举值：“None”、“Global”、“Dedicated”、“Auto Replace” | 驱动的热备状态 |
| Oem/{OemIdentifier}/SpareforLogicalDrives | 对象数组,null | 数组中每个对象的@odata.id需要满足"/LogicalDrive[0-9]{1,5}$"这一正则表达式 | 指定驱动器是局部热备盘时所属逻辑盘列表 |
- 变更前：取值异常时patch依然返回成功，但是实际不执行
- 变更后：
1、HotspareType为"Dedicated"或"Auto Replace"时，需要传递SpareforLogicalDrives且长度不能为0
2、HotspareType为"None"、"Global"时，不能传递SpareforLogicalDrives
兼容性说明
- BMC固件兼容性：当前变更仅设计BMC的固件软件版本，不涉及兼容性
- openUBMC和BMC SDK兼容性：上述接口不依赖SDK，不涉及兼容性
- BMC与上层网管的兼容性：上层网管如果访问上述接口的相关属性，patch属性无效时会返回报错，网管软件可能未处理这种情况，需要修改网管软件进行适配
文档影响
不涉及
建议动作
确认上层网管是否会访问上述接口，如果涉及上述接口，相关属性在取值无效时会返回报错。若存在影响，需要修改网管软件进行适配，并确保兼容openUBMC旧版本的接口