PortsMetrics
更新时间: 2026/06/26
在Gitcode上查看源码ResourceDefinition
uris
/redfish/v1/Chassis/chassis_id/NetworkAdapters/networkadapter_id/Ports/port_id/Metrics
properties
| 名称 | 类型 | 是否只读 | 取值范围/枚举值 | 说明 |
|---|---|---|---|---|
| @odata.context | string | true | - | 端口度量资源模型的OData描述信息 |
| @odata.id | string | true | - | 网络适配器端口度量信息资源的访问路径 |
| @odata.type | string | true | - | 网络适配器端口度量信息资源的类型标识 |
| Id | string | true | - | 网络适配器端口度量信息资源的唯一标识 |
| Name | string | true | - | 网络适配器端口度量信息资源的名称 |
| Networking | object | true | - | 网络设备功能的网络相关统计指标集合 |
| RXFrames | number | true | - | 收到的帧数 |
| TXFrames | number | true | - | 发送的帧数量 |
| RXUnicastFrames | number | true | - | 收到的单播帧数量 |
| RXMulticastFrames | number | true | - | 收到的多播帧数量 |
| RXBroadcastFrames | number | true | - | 收到的广播帧数量 |
| TXUnicastFrames | number | true | - | 发送的单播帧数量 |
| TXMulticastFrames | number | true | - | 发送的多播帧数量 |
| TXBroadcastFrames | number | true | - | 发送的广播帧数量 |
| RXFCSErrors | number | true | - | 接收到的校验错误帧数量 |
| RXUndersizeFrames | number | true | - | 接收到的超小帧数量 |
| RXOversizeFrames | number | true | - | 接收到的超长帧数量 |
| TXSingleCollisions | number | true | - | 发送的单碰撞帧数量 |
| TXMultipleCollisions | number | true | - | 发送的多碰撞帧数量 |
| TXLateCollisions | number | true | - | 发送的延迟碰撞帧数量 |
| TXExcessiveCollisions | number | true | - | 发送的超量碰撞帧数量 |
| RXFrameAlignmentErrors | number | true | - | 接收的对齐错误的帧数量 |
| RXPauseXOFFFrames | number | true | - | 网络发出的用于暂停传输的流量控制帧的总数 |
| RXPauseXONFrames | number | true | - | 从网络发出的用于恢复传输的流量控制帧的总数 |
| TXPauseXOFFFrames | number | true | - | 发送至网络的XOFF帧的总数 |
| TXPauseXONFrames | number | true | - | 发送至网络的XON帧的总数 |
| RXFalseCarrierErrors | number | true | - | 从物理层接收到的错误帧总数 |
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