PortsMetrics
更新时间: 2026/06/26
在Gitcode上查看源码

ResourceDefinition

uris

  • /redfish/v1/Chassis/chassis_id/NetworkAdapters/networkadapter_id/Ports/port_id/Metrics

properties

名称类型是否只读取值范围/枚举值说明
@odata.contextstringtrue-端口度量资源模型的OData描述信息
@odata.idstringtrue-网络适配器端口度量信息资源的访问路径
@odata.typestringtrue-网络适配器端口度量信息资源的类型标识
Idstringtrue-网络适配器端口度量信息资源的唯一标识
Namestringtrue-网络适配器端口度量信息资源的名称
Networkingobjecttrue-网络设备功能的网络相关统计指标集合
RXFramesnumbertrue-收到的帧数
TXFramesnumbertrue-发送的帧数量
RXUnicastFramesnumbertrue-收到的单播帧数量
RXMulticastFramesnumbertrue-收到的多播帧数量
RXBroadcastFramesnumbertrue-收到的广播帧数量
TXUnicastFramesnumbertrue-发送的单播帧数量
TXMulticastFramesnumbertrue-发送的多播帧数量
TXBroadcastFramesnumbertrue-发送的广播帧数量
RXFCSErrorsnumbertrue-接收到的校验错误帧数量
RXUndersizeFramesnumbertrue-接收到的超小帧数量
RXOversizeFramesnumbertrue-接收到的超长帧数量
TXSingleCollisionsnumbertrue-发送的单碰撞帧数量
TXMultipleCollisionsnumbertrue-发送的多碰撞帧数量
TXLateCollisionsnumbertrue-发送的延迟碰撞帧数量
TXExcessiveCollisionsnumbertrue-发送的超量碰撞帧数量
RXFrameAlignmentErrorsnumbertrue-接收的对齐错误的帧数量
RXPauseXOFFFramesnumbertrue-网络发出的用于暂停传输的流量控制帧的总数
RXPauseXONFramesnumbertrue-从网络发出的用于恢复传输的流量控制帧的总数
TXPauseXOFFFramesnumbertrue-发送至网络的XOFF帧的总数
TXPauseXONFramesnumbertrue-发送至网络的XON帧的总数
RXFalseCarrierErrorsnumbertrue-从物理层接收到的错误帧总数

supported_methods

  • GET

HTTP methods

GET

命令功能

查询单个网络端口度量信息

命令格式

URL: https://device_ip/redfish/v1/Chassis/chassis_id/NetworkAdapters/networkadapter_id/Ports/port_id/Metrics

请求头:


X-Auth-Token: 123456789***********************

请求消息体: 无

参数说明

参数参数说明取值
device_ip登录设备的IP地址IPv4或IPv6地址
chassis_id机箱资源的ID● 针对机架服务器,取值 为1
● 针对高密服务器,取值 为BladeN(N表示节点 槽位号),例如 “Blade1”
● 针对刀片服务器,取值 可以为BladeN(N表示 计算节点槽位号)或 SwiN(N表示交换模块 槽位号),例如 “Swi1”
● 针对X6800 V5,X6000 V5,G5500,XA320 V2 服务器,取值还可以为 Enc,表示计算节点所在 的机框资源
● 针对设备U位信息,取值 可以为UN(N表示设备U 位号),例如"U1"
● 针对机柜资源,取值为 Rack
auth_value执行该GET请求时,必须在 “Headers”中携带“X- Auth-Token”值用于鉴权可通过/redfish/v1/ SessionService/Sessions创 建会话时获得
networkadapter_id网络适配器资源的ID属性DeviceLocator和属性 Position合并而成
port_id网络端口资源的ID属性PhysicalPortNumber 值,一般从一开始

使用指南

BMC500 5.13.0 及以上版本支持。

使用实例

请求样例:

http
GET https://device_ip/redfish/v1/Chassis/1/NetworkAdapters/mainboardMEZZ2/Ports/1/Metrics

请求头:


X-Auth-Token: 123456789***********************

请求消息体:无

响应样例:

json
{
  "@odata.context": "/redfish/v1/$metadata#PortMetrics.PortMetrics",
  "@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/mainboardMEZZ2/Ports/1/Metrics",
  "@odata.type": "#PortMetrics.v1_7_0.PortMetrics",
  "Id": "Metrics",
  "Name": "Port 1 Metrics",
  "Networking": {
    "RXFrames": 0,
    "TXFrames": 0,
    "RXUnicastFrames": 2,
    "RXMulticastFrames": 3,
    "RXBroadcastFrames": 2,
    "TXUnicastFrames": 1,
    "TXMulticastFrames": 4,
    "TXBroadcastFrames": 1,
    "RXFCSErrors": 0,
    "RXUndersizeFrames": 2,
    "RXOversizeFrames": 3,
    "TXSingleCollisions": 0,
    "TXMultipleCollisions": 0,
    "TXLateCollisions": 0,
    "TXExcessiveCollisions": 0,
    "RXFrameAlignmentErrors": 0,
    "RXPauseXOFFFrames": 0,
    "RXPauseXONFrames": 0,
    "TXPauseXOFFFrames": 0,
    "TXPauseXONFrames": 0,
    "RXFalseCarrierErrors": 0
  }
}

响应码:200