背景
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
资源interface: bmc.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
具体属性描述见详细描述