【已评审】支持Redfish下Managers下NtpService资源

Interface SIG Interface评审
1

背景

支持Redfish下Managers下NtpService资源，当前的Managers下的NtpService资源下没有NTP组的密钥状态信息，需要新增

关联ISSUE

暂无

整体方案

Redfish下的Managers下新增NTP组的密钥状态的展示，通过获取系统中的密钥状态，转换成相应的字符串对外展示

评审点

评审点1：Redfish NtpService资源下新增属性 NTPKeyStatus

  • URI：/redfish/v1/Managers/managet_id /NtpService
  • 变化类型：新增属性
  • 操作类型：GET
  • 应用场景：查询Managers下NtpService资源
  • 详细描述
属性名称 属性类型 说明 取值 约束
NTPKeyStatus 字符串 NTP组密钥的导入状态 取值如下：
Uploaded：已上传
NotUploaded：未上传		 无其他约束

评审点2：UIRest NTP 接口新增属性 KeyStatus

  • URI：/UI/Rest/BMCSettings/NTP
  • 变化类型：新增属性
  • 操作类型：GET
  • 应用场景：查询NTP资源
  • 详细描述：NTP组秘钥导入状态
属性名称 属性类型 说明 取值 约束
KeyStatus integer NTP组密钥的状态 取值如下：
0：NTP组秘钥未上传
1：表示NTP组秘钥已上传		 无其他约束

评审点3：UIRest NTP 接口新增Action ImportKey

  • URI：/UI/Rest/BMCSettings/NTP/ImportKey
  • 变化类型：新增 Action
  • 操作类型：POST
  • 权限：BasicSetting
  • 应用场景：上传NTP组秘钥
  • 详细描述：对接WEB页面上的上传NTP的组秘钥
  • 请求消息体：
    {
    "Content": value
}
  • 响应码：200

评审结论

通过，具体结论如下：

  1. 同意 Redfish 接口 /redfish/v1/Managers/{ManagerId}/NtpService 接口GET操作响应中新增属性 NTPKeyStatus ，类型为 string ，标识NTP组秘钥的导入状态，取值为Uploaded / NotUploaded
  2. 同意 webrest 接口 /UI/Rest/BMCSettings/NTP 接口GET操作响应中增加属性 KeyStatus ，类型为 integer ，标识NTP组秘钥的导入状态，取值范围：[0,1](0表示NTP组秘钥未上传，1表示NTP组秘钥已上传)
  3. 同意 webrest 接口新增Action，URL： /UI/Rest/BMCSettings/NTP/ImportKey，操作类型为 POST，该Action用于导入NTP组秘钥，权限为 BasicSetting；请求参数为 Content，类型为 string，必选参数，表示上传NTP组秘钥的文件路径；响应为 200
2

一、同意在redfish接口 /redfish/v1/Managers/managet_id/NtpService 接口中响应中新增属性 NTPKeyStatus ，类型为 String ，标识NTP组秘钥的导入状态，取值为Uploaded / NotUploaded ；
二、同意在webrest接口 /UI/Rest/BMCSettings/NTP 接口中响应中增加属性 KeyStatus ，类型为 Integer ，标识NTP组秘钥的导入状态；取值：0/1(0表示NTP组秘钥未上传，1表示NTP组秘钥已上传) ；

三、同意新增webrest接口/UI/Rest/BMCSettings/NTP/ImportKey用于导入NTP组秘钥，权限为BasicSetting，可选参数：Content，参数为form-data格式，类型为file，表示上传NTP组秘钥的内容；