【已评审】变更机柜资产管理资源协作接口并新增redfish接口标准属性

Interface SIG Interface评审
1

背景

1、数据类型变更
当前机柜资产管理功能中，会根据当前机柜中可通信的节点个数，通过Redfish、Web对外展示，包括但不限于：U位高度、U位总数、已被占用的U位总数等等。
现在根据产品相关诉求，后续推出的节点的U位高度可能为：1.2U、2.4U等，这种U位高度不为整数，需要进行兼容，因此需要变更相关属性类型。

2、资产管理新增属性和方法
资产管理功能中redfish接口以及Web相关功能需要和历史通用接口文档接轨，需要对外提供：总装机柜SN、设置当前设备信息等

评审点

详细描述

评审点1：变更资源协作接口

1、接口链接：bmc.kepler.Chassis.RackOffsetSpecification

变更属性

变更类型 属性名称 签名 只读 变化通知 属性描述 | 访问权限 属性来源 持久化类型 变更影响
变更 RackOffsetCountOccupy 变更前：y
变更后：d		 true false 已被占用的U位数 Read: ReadOnly 不持久化 数据类型变更，涉及redfish接口变更

redfish新增资源

资源URI：redfish/v1/Chassis/:chassisid
资源版本：#Chassis.v1_26_0.Chassis
变化类型：Location/Placement资源下新增属性
属性说明：

属性名 取值类型 示例/取值约束 readonly 易变属性 实现PATCH 操作权限 描述
RackOffsetUnits string/null EIA_310、OpenU true 否 否 ReadOnly 设备高度单位类型
RackOffset double 1;1.2 true 否 否 ReadOnly 设备的偏移U位

2、接口链接：bmc.kepler.Chassis.RackAsset.Unit

变更属性

变更类型 属性名称 签名 只读 变化通知 属性描述 访问权限 属性来源 持久化类型 变更影响
变更 变更前：DeviceMaxHeight
变更后：
AllowableDeviceMaxHeight		 变更前：y
变更后：d		 true false 允许设备的最大高度 Read: ReadOnly 不持久化

新增属性

属性名称 签名 只读 变化通知 属性描述 访问权限 属性来源 持久化类型 易变属性
RackOffsetUnits s True false 设备高度单位类型，取值范围：
OpenU:1 OU = 48 毫米
EIA_310:1 U = 44.45 毫米		 Read: ReadOnly CSR 不持久化

3、接口链接：bmc.kepler.Chassis.RackAsset.Unit.Device

新增属性

属性名称 签名 只读 变化通知 属性描述 | 访问权限 属性来源 持久化类型 易变属性
RackOffset d True false 设备的偏移U位 Read: ReadOnly 不持久化 false

评审点2：新增资源协作接口

1、 新增属性 AssemblyRackSerialNumber

接口链接：bmc.kepler.Chassis.RackSpecification

属性名称 签名 只读 变化通知 属性描述 | 访问权限 属性来源 持久化类型 易变属性
AssemblyRackSerialNumber s True false 总装机柜SN：包含铁架子、manifold、busbar、电源框、电源砖、空机柜、管理板 Read: ReadOnly 掉电持久化 false

2、新增方法 SetDeviceSpecification

接口链接：bmc.kepler.Chassis.RackAsset.Unit.Device

方法名称 请求签名 请求参数描述 响应签名 响应参数描述 方法描述 | 访问权限
AddAssetEntry a{ss} 数据类型：Dictionary
键值对中的key为接口interface中的property（如 SerialNumber、Manufacturer，WeightKg），值为修改后的数值。		 NA 无响应参数 设置当前设备信息，并写入eeprom中。
如果键已存在，则覆盖其对应的值；
如果键不存在，则追加新数据到eeprom。		 BasicSetting

3、新增方法 SetInstalledStatus

接口链接：bmc.kepler.Chassis.RackAsset.Unit

方法名称 请求签名 请求参数描述 响应签名 响应参数描述 方法描述 | 访问权限
SetInstalledStatus b InstalledStatus(b): 上下架状态
false：未上架
true：已上架		 NA 无响应参数 设置当前U位设备上下架状态 BasicSetting

评审结论

  1. 同意bmc.kepler.Chassis.RackOffsetSpecification接口变更属性类型
    interface： bmc.kepler.Chassis.RackOffsetSpecification
    变更属性：
    RackOffsetCountOccupy 类型变有U8更为Double

  2. 同意新增如下redfish资源属性用于查询设备高度单位类型、设备的偏移U位
    资源URI：redfish/v1/Chassis/:chassisid
    变化类型：Location/Placement资源下新增属性RackOffsetUnits、RackOffset

  3. 同意bmc.kepler.Chassis.RackAsset.Unit接口变更属性并新增方法
    interface： bmc.kepler.Chassis.RackAsset.Unit
    变更属性：
    DeviceMaxHeight：属性名变更为AllowableDeviceMaxHeight，类型变更为Double
    新增属性：
    RackOffsetUnits：设备高度单位类型，签名为 s，取值范围：OpenU、EIA_310，读权限： ReadOnly，不持久化
    新增方法：

    方法名称 请求签名 请求参数描述 响应签名 响应参数描述 方法描述 | 访问权限
    SetInstalledStatus b InstalledStatus(b): 上下架状态
    false：未上架
    true：已上架    		 NA 无响应参数 设置当前U位设备上下架状态 BasicSetting

  4. 同意bmc.kepler.Chassis.RackAsset.Unit.Device接口新增属性及方法
    interface： bmc.kepler.Chassis.RackAsset.Unit.Device
    新增属性：
    RackOffset：设备的偏移U位，签名为 d，读权限： ReadOnly，不持久化
    新增方法：

方法名称 请求签名 请求参数描述 响应签名 响应参数描述 方法描述 访问权限
AddAssetEntry a{ss} 数据类型：Dictionary
键值对中的key为接口interface中的property（如 SerialNumber、Manufacturer，WeightKg），值为修改后的数值。		 NA 无响应参数 设置设备资产描述条目，
如果键已存在，则覆盖其对应的值；
如果键不存在，则追加新数据。		 BasicSetting
  1. 同意bmc.kepler.Chassis.RackSpecification接口新增属性
    interface： bmc.kepler.Chassis.RackSpecification
    AssemblyRackSerialNumber：总装机柜SN，签名为 s，长度0~48，读权限： ReadOnly，掉电持久化，默认值“”

遗留问题