ISSUE链接
暂无
背景
支持PCIE设备信息查询
涉及WebRest接口URI: /UI/Rest/System/Boards/PCIeCard、/UI/Rest/System/Boards/OCPCard
当前返回体里DeviceBDF、RootBDF待新增。
决策点
1、/UI/Rest/System/Boards/PCIeCard 返回体新增字段DeviceBDF、RootBDF，分别表示PCIe卡的设备BDF、根端口BDF。
2、/UI/Rest/System/Boards/OCPCard 返回体新增字段DeviceBDF、RootBDF，分别表示OCP卡的设备BDF、根端口BDF。
详细描述
URI： /UI/Rest/System/Boards/PCIeCard
变化类型：新增属性
应用场景：北向WebRest接口查询PCIe设备信息返回
操作类型：GET
详细描述：
| 属性名称 | 变化类型 | 属性类型 | 说明 | 取值范围 | 约束 |
|---|---|---|---|---|---|
| DeviceBDF | 新增属性 | String | PCIe卡的设备BDF | 格式为"Segment:Bus:Device.Function"，Segment取值范围0000~ffff(十六进制小写)，Bus取值范围00~ff(十六进制小写)，Device取值范围00~1f(十六进制小写)，Function取值范围0~7。默认值为空字符串。例如"0000:96:00.0"表示Segment是0，设备BDF分别是0x96、0x00、0x00 |
正则表达式为 ^([0-9a-f]{4}):([0-9a-f]{2}):([0-1][0-9a-f]{1}\.[0-7])$ |
| RootBDF | 新增属性 | String | PCIe卡的根端口BDF | 格式为"Segment:Bus:Device.Function"，Segment取值范围0000~ffff(十六进制小写)，Bus取值范围00~ff(十六进制小写)，Device取值范围00~1f(十六进制小写)，Function取值范围0~7。默认值为空字符串。例如"0000:95:00.0"表示Segment是0，根端口BDF分别是0x95、0x00、0x00 |
正则表达式为 ^([0-9a-f]{4}):([0-9a-f]{2}):([0-1][0-9a-f]{1}\.[0-7])$ |
URI： /UI/Rest/System/Boards/OCPCard
变化类型：新增属性
应用场景：北向WebRest接口查询OCP卡设备信息返回
操作类型：GET
详细描述：
| 属性名称 | 变化类型 | 属性类型 | 说明 | 取值范围 | 约束 |
|---|---|---|---|---|---|
| DeviceBDF | 新增属性 | String | OCP卡的设备BDF | 格式为"Segment:Bus:Device.Function"，Segment取值范围0000~ffff(十六进制小写)，Bus取值范围00~ff(十六进制小写)，Device取值范围00~1f(十六进制小写)，Function取值范围0~7。默认值为空字符串。例如"0000:96:00.0"表示Segment是0，设备BDF分别是0x96、0x00、0x00 |
正则表达式为 ^([0-9a-f]{4}):([0-9a-f]{2}):([0-1][0-9a-f]{1}\.[0-7])$ |
| RootBDF | 新增属性 | String | OCP卡的根端口BDF | 格式为"Segment:Bus:Device.Function"，Segment取值范围0000~ffff(十六进制小写)，Bus取值范围00~ff(十六进制小写)，Device取值范围00~1f(十六进制小写)，Function取值范围0~7。默认值为空字符串。例如"0000:95:00.0"表示Segment是0，根端口BDF分别是0x95、0x00、0x00 |
正则表达式为 ^([0-9a-f]{4}):([0-9a-f]{2}):([0-1][0-9a-f]{1}\.[0-7])$ |
评审结论
1、同意webrest接口/UI/Rest/System/Boards/PCIeCard的GET操作响应中新增如下属性：
-
DeviceBDF：类型为String，PCIe卡的设备BDF。 格式为"
Segment:Bus:Device.Function"，Segment取值范围0000~ffff(十六进制小写)，Bus取值范围00~ff(十六进制小写)，Device取值范围00~1f(十六进制小写)，Function取值范围0~7。正则表达式为^([0-9a-f]{4}):([0-9a-f]{2}):([0-1][0-9a-f]{1}\.[0-7])$。 -
RootBDF：类型为String，PCIe卡的根端口BDF。 格式为"
Segment:Bus:Device.Function"，Segment取值范围0000~ffff(十六进制小写)，Bus取值范围00~ff(十六进制小写)，Device取值范围00~1f(十六进制小写)，Function取值范围0~7。正则表达式为^([0-9a-f]{4}):([0-9a-f]{2}):([0-1][0-9a-f]{1}\.[0-7])$。
2、同意webrest接口/UI/Rest/System/Boards/OCPCard的GET操作响应中新增如下属性：
-
DeviceBDF：类型为String，OCP卡的设备BDF。 格式为"
Segment:Bus:Device.Function"，Segment取值范围0000~ffff(十六进制小写)，Bus取值范围00~ff(十六进制小写)，Device取值范围00~1f(十六进制小写)，Function取值范围0~7。正则表达式为^([0-9a-f]{4}):([0-9a-f]{2}):([0-1][0-9a-f]{1}\.[0-7])$。 -
RootBDF：类型为String，OCP卡的根端口BDF。 格式为"
Segment:Bus:Device.Function"，Segment取值范围0000~ffff(十六进制小写)，Bus取值范围00~ff(十六进制小写)，Device取值范围00~1f(十六进制小写)，Function取值范围0~7。正则表达式为^([0-9a-f]{4}):([0-9a-f]{2}):([0-1][0-9a-f]{1}\.[0-7])$。