📋 文档信息

项目	内容
文档标题	NetworkPort类配置字典
版本	v1.0
创建日期	2026-05-27
最后更新	2026-05-27
维护状态	待完善

📋 变更历史记录

文档变更记录

版本	发布日期	变更类型	变更内容	影响范围	维护人员
v1.0	2026-05-27	初始版本	创建NetworkPort类配置字典	全新文档	待定

🎯 类概览

NetworkPort 类

属性	值
类名称	`NetworkPort`
功能描述	网口管理对象，提供网口基本信息、链路状态、MAC地址、统计数据和LLDP信息管理
所属SIG组	hardware
所属组件	network_adapter
责任人	网卡管理组
最后更新	2026-05-27
状态	🟢 正常运行

📊 属性定义详表

必选属性

属性名	类型	默认值	取值范围	动态关联	描述	使用场景	举例	来源	分类
`PortID`	U8	-	U8	-	网口ID	BMC接口展示	0	CSR配置	软件
`NetworkAdapterId`	String	-	String	-	对应的网卡ID属性	BMC接口展示	"EthernetAdapterBoard"	CSR配置	软件

可选属性

属性名	类型	默认值	取值范围	动态关联	描述	使用场景	举例	来源	分类
`SystemID`	String	-	String	-	系统ID	BMC接口展示	1	CSR配置	软件
`Name`	String	-	String	-	网口名称	BMC接口展示	`"Port1"`	硬件提供	硬件
`Type`	String	-	String	-	网口类型	BMC接口展示	3	硬件提供	硬件
`PermanentMACAddress`	String	`00:00:00:00:00:00`	String	-	永久MAC地址	BMC接口展示	"10:32:1D:13:08:88"	硬件提供	硬件
`MACAddress`	String	`00:00:00:00:00:00`	String	-	MAC地址	BMC接口展示	"N/A"	CSR配置	软件
`LinkStatus`	String	-	String	-	链路状态	BMC接口展示	"Disconnected"	硬件提供	硬件
`OSLinkStatus`	String	-	String	-	BMA上报的网口连接状态	BMC接口展示	`"Up"`	BMC内部设置	软件
`LinkStatusNumeric`	U8	255	U8	-	链路状态	BMC接口展示	255	BMC内部设置	软件
`IPv6DefaultGateway`	String	-	String	-	IPv6默认网关	BMC接口展示	`"::1"`	CSR配置	软件
`WorkMode`	String	`NonLoop`	String	-	工作模式	BMC接口展示	"NonLoop"	CSR配置	软件
`FunctionType`	String	`Physical`	String	-	网口类型:物理,虚拟	BMC接口展示	"Virtual"	硬件提供	硬件
`BDF`	String	""	String	-	网口BDF	BMC接口展示	`"0000:01:00.0"`	硬件提供	硬件
`AutoConnectOnBoot`	Boolean	-	Boolean	-	开机是否自动启用网络连接	BMC接口展示	`true`	CSR配置	软件
`NetDevFuncType`	U8	1	U8	-	网络设备功能类型，0:Disabled 1:Ethernet 2:FC 4:iSCSI 8:FCoE 16:OPA 32:IB	BMC接口展示	32	硬件提供	硬件
`MediumType`	String	`Copper`	String	-	网口介质类型	BMC接口展示	"FiberOptic"	硬件提供	硬件
`SpeedMbps`	U32	4294967295	U32	-	链路速率	BMC接口展示	4294967295	硬件提供	硬件
`FullDuplex`	U8	255	U8	-	全双工状态，0：关闭，1：开启，255：未正常获取到状态（默认值）	BMC接口展示	`255`	硬件提供	硬件
`AutoSpeedNegotiation`	U8	255	U8	-	自协商状态，0：关闭，1：开启，255：未正常获取到状态（默认值）	BMC接口展示	`255`	硬件提供	硬件
`FirmwareVersion`	String	-	String	-	固件版本	BMC接口展示	`"1.0.0"`	硬件提供	硬件
`DriverName`	String	-	String	-	驱动名称	BMC接口展示	`"hinic"`	BMC内部设置	软件
`DriverVersion`	String	-	String	-	驱动版本	BMC接口展示	`"1.0.0"`	BMC内部设置	软件
`LLDPEnabled`	Boolean	-	Boolean	-	网口LLDP使能 false:关闭使能 true:打开使能	BMC接口展示	`true`	CSR配置	软件
`SupportedLinkCapability`	String	-	String	-	支持的传输速率	BMC接口展示	"100G"	硬件提供	硬件
`LinkMonitorPeriodMS`	U32	-	U32	-	网口链路监测周期，单位毫秒	BMC接口展示	0	CSR配置	软件
`UUID`	String	-	String	-	网口全球唯一标识，用于IB卡。只读属性，默认为空。	BMC接口展示	`"UUID123"`	硬件提供	硬件
`WorkloadType`	U8	0	U8	-	工作负载类型，0：负载服务器os；1：负载智能网卡的os；2：服务器os及智能网卡os均卸载	BMC接口展示	0	硬件提供	硬件
`MTUSize`	U32	-	U32	-	此接口当前配置的最大传输单元	BMC接口展示	1500	CSR配置	软件
`AutoSpeedNegotiationCapable`	U8	255	U8	-	网口是否具备自协商能力，0：不具备，1：具备，255：未正常获取到状态（默认值）	BMC接口展示	1	硬件提供	硬件
`InterfaceEnabled`	U8	255	U8	-	网口是否启用，0：未启用，1：启用，255：未正常获取到状态（默认值）	BMC接口展示	1	CSR配置	软件
`LinkState`	String	-	String	-	接口所需的链路状态，默认为空	BMC接口展示	"Enabled"	CSR配置	软件

内部属性

属性名	类型	默认值	取值范围	动态关联	描述	使用场景	举例	来源	分类
`LinkStatusValue`	U8	-	U8	-	链路状态值(只读)	BMC内部使用	`1`	硬件提供	硬件
`NpuID`	U8	-	U8	-	NPU ID(只读)	BMC内部使用	`0`	硬件提供	硬件
`PowerOn`	U8	-	U8	-	上电状态(只读)	BMC内部使用	`1`	BMC内部设置	软件
`AgentID`	String	""	String	-	Agent ID	BMC内部使用	`""`	BMC内部设置	软件
`NetworkAdapterObjectName`	String	""	String	-	网卡对象名称	BMC内部使用	`""`	BMC内部设置	软件
`CreatedByDeviceObject`	Boolean	false	Boolean	-	是否由设备对象创建	BMC内部使用	`false`	BMC内部设置	软件
`PhysicalId`	U8	255	U8	-	物理ID(只读)	BMC内部使用	`255`	硬件提供	硬件
`UdieId`	U8	255	U8	-	Udie ID(只读)	BMC内部使用	`255`	硬件提供	硬件
`PfId`	U8	255	U8	-	PF ID(只读)	BMC内部使用	`255`	硬件提供	硬件
`NpuBoardSilkNumber`	U8	255	U8	-	NPU板丝印号(只读)	BMC内部使用	`255`	硬件提供	硬件

📐 接口属性

bmc.kepler.Systems.NetworkPort.Metrics 接口属性

属性名	类型	默认值	取值范围	动态关联	描述	使用场景	举例	来源	分类
`RXFrames`	U64	-	U64	-	接收帧数	BMC接口展示	`1000`	硬件提供	硬件
`TXFrames`	U64	-	U64	-	发送帧数	BMC接口展示	`1000`	硬件提供	硬件
`PacketsDropped`	U64	-	U64	-	丢包数	BMC接口展示	`0`	硬件提供	硬件
`RXUnicastFrames`	U64	-	U64	-	接收单播帧数	BMC接口展示	`800`	硬件提供	硬件
`RXMulticastFrames`	U64	-	U64	-	接收多播帧数	BMC接口展示	`100`	硬件提供	硬件
`RXBroadcastFrames`	U64	-	U64	-	接收广播帧数	BMC接口展示	`100`	硬件提供	硬件
`TXUnicastFrames`	U64	-	U64	-	发送单播帧数	BMC接口展示	`800`	硬件提供	硬件
`TXMulticastFrames`	U64	-	U64	-	发送多播帧数	BMC接口展示	`100`	硬件提供	硬件
`TXBroadcastFrames`	U64	-	U64	-	发送广播帧数	BMC接口展示	`100`	硬件提供	硬件
`RXFCSErrors`	U64	-	U64	-	接收FCS错误	BMC接口展示	`0`	硬件提供	硬件
`RXUndersizeFrames`	U64	-	U64	-	接收过小帧数	BMC接口展示	`0`	硬件提供	硬件
`RXOversizeFrames`	U64	-	U64	-	接收过大帧数	BMC接口展示	`0`	硬件提供	硬件
`TXSingleCollisions`	U64	-	U64	-	发送单次冲突	BMC接口展示	`0`	硬件提供	硬件
`TXMultipleCollisions`	U64	-	U64	-	发送多次冲突	BMC接口展示	`0`	硬件提供	硬件
`TXLateCollisions`	U64	-	U64	-	发送延迟冲突	BMC接口展示	`0`	硬件提供	硬件
`TXExcessiveCollisions`	U64	-	U64	-	发送过度冲突	BMC接口展示	`0`	硬件提供	硬件
`RXFrameAlignmentErrors`	U64	-	U64	-	接收帧对齐错误	BMC接口展示	`0`	硬件提供	硬件
`RXPauseXOFFFrames`	U64	-	U64	-	接收暂停XOFF帧	BMC接口展示	`0`	硬件提供	硬件
`RXPauseXONFrames`	U64	-	U64	-	接收暂停XON帧	BMC接口展示	`0`	硬件提供	硬件
`TXPauseXOFFFrames`	U64	-	U64	-	发送暂停XOFF帧	BMC接口展示	`0`	硬件提供	硬件
`TXPauseXONFrames`	U64	-	U64	-	发送暂停XON帧	BMC接口展示	`0`	硬件提供	硬件
`RXFalseCarrierErrors`	U64	-	U64	-	接收虚假载波错误	BMC接口展示	`0`	硬件提供	硬件
`BandwidthUsagePercent`	U8	-	U8	-	带宽使用百分比	BMC接口展示	`50`	BMC内部设置	软件

bmc.kepler.Systems.NetworkPort.LLDPReceive 接口属性

属性名	类型	默认值	取值范围	动态关联	描述	使用场景	举例	来源	分类
`ChassisId`	String	-	String	-	机箱ID	BMC接口展示	`"Chassis1"`	网络邻居	网络
`ChassisIdSubtype`	String	-	String	-	机箱ID子类型	BMC接口展示	`"MACAddress"`	网络邻居	网络
`LLDPReceivePortId`	String	-	String	-	端口ID	BMC接口展示	`"Port1"`	网络邻居	网络
`PortIdSubtype`	String	-	String	-	端口ID子类型	BMC接口展示	`"MACAddress"`	网络邻居	网络
`SystemName`	String	-	String	-	系统名称	BMC接口展示	`"System1"`	网络邻居	网络
`ManagementVlanId`	U16	-	U16	-	管理VLAN ID	BMC接口展示	`100`	网络邻居	网络

bmc.kepler.Systems.NetworkPort.FibreChannel 接口属性

属性名	类型	默认值	取值范围	动态关联	描述	使用场景	举例	来源	分类
`FCId`	String	-	String	-	FC ID	BMC接口展示	`"FC1"`	硬件提供	硬件
`WWNN`	String	-	String	-	WWNN	BMC接口展示	`"WWNN123"`	硬件提供	硬件
`PermanentWWNN`	String	-	String	-	永久WWNN	BMC接口展示	`"WWNN123"`	硬件提供	硬件
`WWPN`	String	-	String	-	WWPN	BMC接口展示	`"WWPN123"`	硬件提供	硬件
`PermanentWWPN`	String	-	String	-	永久WWPN	BMC接口展示	`"WWPN123"`	硬件提供	硬件
`SpeedGbps`	U32	-	U32	-	速度(Gbps)	BMC接口展示	`16`	硬件提供	硬件

bmc.kepler.Systems.NetworkPort.Fault 接口属性

属性名	类型	默认值	取值范围	动态关联	描述	使用场景	举例	来源	分类
`LinkDown`	Boolean	-	Boolean	-	链路断开	BMC接口展示	`false`	BMC内部设置	软件

bmc.kepler.Systems.NetworkPort.RelatedItems 接口属性

属性名	类型	默认值	取值范围	动态关联	描述	使用场景	举例	来源	分类
`TransceiverLanes`	Array	-	Struct[]	-	光模块通道列表	BMC接口展示	-	BMC内部设置	软件
`ProcessorPorts`	Array	-	Struct[]	-	处理器端口列表	BMC接口展示	-	BMC内部设置	软件

📦 对象方法

方法名	权限	请求参数	响应参数	描述
`Configure`	-	-	-	配置网口

📝 配置示例

json

{
            "@Parent": "NetworkAdapter_1",
            "SystemID": 1,
            "PortID": 0,
            "NetDevFuncType": 32,
            "MediumType": "FiberOptic",
            "SupportedLinkCapability": "100G"
        }

📋 文档信息 ​

📋 变更历史记录 ​

文档变更记录 ​

🎯 类概览 ​

NetworkPort 类 ​

📊 属性定义详表 ​

必选属性 ​

可选属性 ​

内部属性 ​

📐 接口属性 ​

bmc.kepler.Systems.NetworkPort.Metrics 接口属性 ​

bmc.kepler.Systems.NetworkPort.LLDPReceive 接口属性 ​

bmc.kepler.Systems.NetworkPort.FibreChannel 接口属性 ​

bmc.kepler.Systems.NetworkPort.Fault 接口属性 ​

bmc.kepler.Systems.NetworkPort.RelatedItems 接口属性 ​

📦 对象方法 ​

📝 配置示例 ​

📋 文档信息

📋 变更历史记录

文档变更记录

🎯 类概览

NetworkPort 类

📊 属性定义详表

必选属性

可选属性

内部属性

📐 接口属性

bmc.kepler.Systems.NetworkPort.Metrics 接口属性

bmc.kepler.Systems.NetworkPort.LLDPReceive 接口属性

bmc.kepler.Systems.NetworkPort.FibreChannel 接口属性

bmc.kepler.Systems.NetworkPort.Fault 接口属性

bmc.kepler.Systems.NetworkPort.RelatedItems 接口属性

📦 对象方法

📝 配置示例