【已评审】redfish查询ntp信息接口新增当前ntp轮询间隔资源

Interface SIG Interface评审
1

ISSUE

【需求】支持Redfish接口查询NTP Server信息 rackmount #207

评审背景

需求

支持Redfish接口查询 NTPService 信息，Redfish接口/redfish/v1/Managers/1/NtpService

差距

  • Redfish NTPService 资源中对于 当前轮询时间 属性不支持

评审点

URI： /redfish/v1/Managers/1/NtpService
操作类型： GET
变化类型： 新增属性
应用场景： redifsh查询当前NTP信息，NTP信息中要包括 当前轮询时间

新增属性信息如下：

属性名称 属性说明 取值类型 约束
CurrentPollingIntervalInSeconds 当前NTP轮询间隔，单位为秒 integer
null		 NTP开启时如果获取成功，则取值为当前的轮询间隔秒数，如果获取失败则取值为null
NTP关闭时取值为0

响应体实例

{
    "@odata.context": "/redfish/v1/$metadata#Managers/Members/1/NtpService/$entity",
    "@odata.id": "/redfish/v1/Managers/1/NtpService",
    "@odata.type": "#HwNtpService.v1_0_0.HwNtpService",
    "Description": "NtpService Settings",
    "ServiceEnabled": false,
    ...
    ...
    "CurrentPollingIntervalInSeconds": 60, # 当前的轮询间隔为60秒
    ...
    ...
    }
}

Schema说明

{
   "CurrentPollingIntervalInSeconds": {
   "type": "integer",
   "readonly": true,
   "description": "This is the current interval in seconds of NTP synchronization.",
   "longDescription": "The value of this property shall be the current interval in seconds. The current value is within the range of the MaxPollingInterval and MinPollingInterval in seconds."
   }
}

评审结论

通过，同意 Redfish NtpService 资源新增属性 CurrentPollingIntervalInSeconds，属性取值类型为 integer，只读属性，表征当前NTP的轮询间隔秒数。

2

预审：

  1. 需求的背景和当前的差距，评审点写清楚
  2. Redifsh的类型没有 y，要明确清楚对应的数据类型
  3. 响应体实例中减少实例不相关的属性，补充 schema 部分属性
3
  1. 属性名称上增加单位
    答复：已经修改为 CurrentPollingIntervalInSeconds，名称上带有单位秒数
  2. 约束中增加当前NTP轮询时间间隔的取值范围，以及更新schema
    答复：已修改
4

Add：包括 MinPollingIInterval / MinPollingIInterval