【已评审】新增设置redfish任务自动删除超时时间的redfish资源和资源协作属性

背景

redfish协议升级,支持用户设置redfish任务自动删除超时时间,需要新增redfish标准资源TaskAutoDeleteTimeoutMinutes,以及提供资源协作属性保存用户设置的redfish任务自动删除超时时间。

关联ISSUE

支持TaskService下的TaskAutoDeleteTimeoutMinutes属性

相关议题:【已评审】资源协作接口方法调用上下文新增TaskAutoDeleteTimeoutMinutes字段

整体方案

①在TaskService资源下新增标准属性TaskAutoDeleteTimeoutMinutes,供用户查询和设置redfish任务自动删除超时时间。
②在资源协作接口:bmc.kepler.Redfish.Task下新增资源协作属性TaskAutoDeleteTimeoutMinutes,用于保存用户设置的redfish任务自动删除超时时间。

评审点

1、在TaskService资源下新增标准属性TaskAutoDeleteTimeoutMinutes

2、在资源协作接口:bmc.kepler.Redfish.Task下新增资源协作属性TaskAutoDeleteTimeoutMinutes

详细描述

1、在TaskService资源下新增标准属性TaskAutoDeleteTimeoutMinutes
URI/redfish/v1/TaskService
变更类型:新增属性
操作类型:GET、PATCH

属性名称 取值类型 签名 取值范围 默认值 操作权限 是否频繁变化并需要屏蔽变化事件 接口约束
TaskAutoDeleteTimeoutMinutes integer U16 [10, 60] 10 R:ReadOnly;
W:BasicSetting
单位:分钟

标准schema描述如下

"TaskAutoDeleteTimeoutMinutes": {
	"description": "The number of minutes after which a completed task is deleted by the service.",
	"longDescription": "This property shall contain the number of minutes after which a completed task, where `TaskState` contains the value `Completed`, `Killed`, `Cancelled`, or `Exception`, is deleted by the service.",
	"minimum": 1,
	"readonly": false,
	"type": "integer",
	"versionAdded": "v1_2_0"
}

2、在资源协作接口:bmc.kepler.Redfish.Task下新增资源协作属性TaskAutoDeleteTimeoutMinutes

资源path/bmc/kepler/Redfish/Task
资源interfacebmc.kepler.Redfish.Task
变化类型:新增属性
应用场景:用于保存用户设置的redfish任务自动删除超时时间(单位为分钟)。
持久化类型: 掉电持久化
操作权限:R:ReadOnly; W:BasicSetting
系统锁定下是否支持设置: 否
详细描述

属性名称 变化类型 签名 读写权限 持久化 变化通知 接口说明 接口约束
TaskAutoDeleteTimeoutMinutes 新增属性 U16 R:ReadOnly
W:BasicSetting
掉电持久化 用于保存用户设置的redfish任务自动删除超时时间,单位为分钟;默认值为10分钟;取值为[10, 60] NA

评审结论

①同意在TaskService资源下新增标准属性TaskAutoDeleteTimeoutMinutes
URI:/redfish/v1/TaskService
操作类型:GET、PATCH

②同意资源协作接口bmc.kepler.Redfish.Task下新增TaskAutoDeleteTimeoutMinutes属性
资源path: /bmc/kepler/Redfish/Task
资源interface: bmc.kepler.Redfish.Task

具体属性描述见详细描述