【已评审】NetworkPort接口增加属性OSLinkStatus

ISSUE链接(必填,此议题关联的issue):

https://gitcode.com/openUBMC/mdb_interface/issues/108

背景(必填,文字描述议题背景,如需求来源、问题场景):

早期网口连接状态实际逻辑不一致,没有带内(BMA)方式获取的网口连接状态,本需求进行重构
插了IB卡的情况下,识别IB卡信息,连接状态不显示,显示为‘- -’,影响功能性。
原因为BMA上报了Disabled,但是BMC认为Disabled不是标准状态,所以显示‘- -’ 。
BMA上报IB卡状态包括:Sleep、Polling、Disabled、PortConfigurationTraining、LinkUp、LinkErrorRecovery、Phy_Test、。
当前BMC内部识别的IB卡状态为非NoLink、LinkUp、LinkDown外的状态都当做NA,与BMA上报状态不匹配。

决策点(必填,一句话描述待决策点):

bmc.kepler.Systems.NetworkPort新增OSLinkStatus字段

详细描述(必填,描述待评审接口的详细内容):

资源path: /bmc/kepler/Systems/:SystemId/NetworkAdapters
资源Interface:bmc.kepler.Systems.NetworkPort
变化类型:新增属性 OSLinkStatus
应用场景:支持带内(BMA)方式获取的网口连接状态
持久化类型:不持久化
取值类型:string,默认值空字符串
操作权限:ReadOnly

详细描述:

方法名称 变化类型 签名 读写&权限 持久化 变化通知 接口说明 接口约束
OSLinkStatus 新增属性 s 只读: ReadOnly 不持久化 网口连接状态 取值来源于OS侧的agent

评审结论:

同意在资源协作接口路径:
path:/bmc/kepler/Systems/:SystemId/NetworkAdapters
interface:bmc.kepler.Systems.NetworkPort
变化类型:新增属性,具体如下
OSLinkStatus:OS侧网口连接状态,签名为s,只读,权限ReadOnly,不发送变化通知事件