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

ResourceDefinition

uris

  • /redfish/v1/Chassis/Chassis_id/NetworkAdapters/network_adapter_id/NetworkDeviceFunctions/network_device_funtion_id

properties

名称类型是否只读取值范围/枚举值说明
@odata.contextstringtrue-单个网络适配器所公开的逻辑接口的OData描述信息
@odata.idstringtrue-单个网络适配器所公开的逻辑接口的访问路径
@odata.typestringtrue-单个网络适配器所公开的逻辑接口的类型
Idstringtrue-网络适配器端口的编号
Namestringtrue-网络适配器端口的编号
NetDevFuncCapabilitiesarraytrue-此网络设备的一系列能力,取值范围:
● "Disabled"
● "Ethernet"
● "FibreChannel"
● "FibreChannelOverEthernet"
● "InfiniBand"
● "iSCSI"
NetDevFuncTypestringtrue-该网络设备功能的配置能力
Ethernetobjecttrue-该接口当前有效的MAC地址
MACAddressstringtrue-端口当前有效的MAC地址
PermanentMACAddressstringtrue-端口的永久MAC地址
FibreChannelobjecttrue-此功能的万维网端口和节点名称
PermanentWWPNstringtrue-此功能的永久的万维网端口名称(WWPN)。通常,此值在制造过程中编程。此地址不可分配。
PermanentWWNNstringtrue-该函数的永久性万维节点名称(WWNN)。通常,该值在制造过程中被编程。此地址不可指定。
WWPNstringtrue-该函数当前有效的万维端口名称(WWPN)。不支持可分配的WWPN,则该属性为永久WWPN的只读别名。
WWNNstringtrue-此函数的有效当前万维节点名称(WWNN)。如果不支持可分配的WWNN,则此属是永久WWNN只读别名。
AssignablePhysicalNetworkPortsarraytrue-链接的端口属性的访问路径集合
AssignablePhysicalNetworkPorts[].@odata.idstringtrue-链接单个端口属性的访问路径
PhysicalNetworkPortAssignmentobjecttrue-链接所有端口属性的访问路径
PhysicalNetworkPortAssignment.@odata.idstringtrue-具体访问uri
Metricsobjecttrue-链接网络适配器所对应网络功能的使用情况和健康状况的统计数据的访问路径
Metrics.@odata.idstringtrue-统计数据的具体访问uri

supported_methods

  • GET

HTTP methods

GET

命令功能

查询单个网络适配器的指定公开逻辑接口资源信息

命令格式

URL: https://device_ip/redfish/v1/Chassis/Chassis_id/NetworkAdapters/network_adapter_id/NetworkDeviceFunctions/network_device_funtion_id

请求头:


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

请求消息体: 无

参数说明

参数参数说明取值
device_ip登录设备的IP地址IPv4或IPv6地址
chassis_id机箱资源的IDredfish/v1/ Chassis/chassis_id/Boards/ board_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创 建会话时获得
networkadapters_id网络适配器资源的ID属性Position和属性 DeviceLocator合并而成
network_device_funtio n_id单个网络适配器所公开的 指定逻辑接口的ID由网络适配器端口的编号组 成

使用指南

使用实例

请求样例:

http
GET https://device_ip/redfish/v1/Chassis/Blade15/NetworkAdapters/mainboardMEZZ2/NetworkDeviceFunctions/1

请求头:


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

请求消息体:无

响应样例:

json
{
  "@odata.context": "/redfish/v1/$metadata#NetworkDeviceFunction.NetworkDeviceFunction",
  "@odata.id": "/redfish/v1/Chassis/Blade15/NetworkAdapters/mainboardMEZZ2/NetworkDeviceFunctions/1",
  "@odata.type": "#NetworkDeviceFunction.v1_11_0.NetworkDeviceFunction",
  "Id": "1",
  "Name": "1",
  "NetDevFuncCapabilities": [
    "Ethernet"
  ],
  "NetDevFuncType": "Ethernet",
  "Ethernet": {
    "MACAddress": "AC:DC:CA:5E:11:C9",
    "PermanentMACAddress": "AC:DC:CA:5E:11:C9"
  },
  "FibreChannel": {
    "PermanentWWPN": "",
    "PermanentWWNN": "",
    "WWPN": "",
    "WWNN": ""
  },
  "AssignablePhysicalNetworkPorts": [
    {
      "@odata.id": "/redfish/v1/Chassis/Blade15/NetworkAdapters/mainboardMEZZ2/Ports/1"
    },
    {
      "@odata.id": "/redfish/v1/Chassis/Blade15/NetworkAdapters/mainboardMEZZ2/Ports/2"
    },
    {
      "@odata.id": "/redfish/v1/Chassis/Blade15/NetworkAdapters/mainboardMEZZ2/Ports/3"
    },
    {
      "@odata.id": "/redfish/v1/Chassis/Blade15/NetworkAdapters/mainboardMEZZ2/Ports/4"
    }
  ],
  "Links": {
    "PhysicalNetworkPortAssignment": {
      "@odata.id": "/redfish/v1/Chassis/Blade15/NetworkAdapters/mainboardMEZZ2/Ports/1"
    }
  },
  "Metrics": {
    "@odata.id": "/redfish/v1/Chassis/Blade15/NetworkAdapters/mainboardMEZZ2/NetworkDeviceFunctions/1/Metrics"
  }
}

响应码:200

GET

命令功能

查询单个网络适配器的指定公开逻辑接口指标信息

命令格式

URL: https://device_ip/redfish/v1/Chassis/Chassis_id/NetworkAdapters/network_adapter_id/NetworkDeviceFunctions/network_device_funtion_id/Metrics

请求头:


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

请求消息体: 无

参数说明

参数参数说明取值
device_ip登录设备的IP地址IPv4或IPv6地址
chassis_id机箱资源的IDredfish/v1/ Chassis/chassis_id/Boards/ board_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创 建会话时获得
networkadapters_id网络适配器资源的ID属性Position和属性 DeviceLocator合并而成
network_device_funtio n_id单个网络适配器所公开的 指定逻辑接口的ID由网络适配器端口的编号组 成

使用指南

使用实例

请求样例:

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

请求头:


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

请求消息体:无

响应样例:

json
{
  "@odata.context": "/redfish/v1/$metadata#NetworkDeviceFunctionMetrics.NetworkDeviceFunctionMetrics",
  "@odata.id": "/redfish/v1/Chassis/Blade15/NetworkAdapters/mainboardMEZZ2/NetworkDeviceFunctions/1/Metrics",
  "@odata.type": "#NetworkDeviceFunctionMetrics.v1_2_0.NetworkDeviceFunctionMetrics",
  "Id": "NetworkDeviceFunctionMetrics",
  "Name": "Network Device Function Metrics",
  "RXFrames": 0,
  "RXMulticastFrames": 0,
  "RXUnicastFrames": 0,
  "TXFrames": 0,
  "TXMulticastFrames": 0,
  "TXUnicastFrames": 0
}

响应码:200