ResourceDefinition

uris

/redfish/v1/Chassis/Chassis_id/NetworkAdapters/network_adapter_id/NetworkDeviceFunctions/network_device_function_id

properties

名称	类型	是否只读	取值范围/枚举值	说明
@odata.context	string	true	-	单个网络适配器所公开的逻辑接口的OData描述信息
@odata.id	string	true	-	单个网络适配器所公开的逻辑接口的访问路径
@odata.type	string	true	-	单个网络适配器所公开的逻辑接口的类型
Id	string	true	-	网络适配器端口的编号
Name	string	true	-	网络适配器端口的编号
NetDevFuncCapabilities[ ]	array	true	-	此网络设备的一系列能力，取值范围： ● "Disabled"：已禁用 ● "Ethernet"：以太网 ● "FibreChannel"：光纤通道 ● "FibreChannelOverEthernet"：以太网光纤通道 ● "InfiniBand"：InfiniBand ● "iSCSI"：iSCSI
NetDevFuncType	string	true	-	该网络设备功能的配置能力
Ethernet {	object	true	-	该接口当前有效的MAC地址
Ethernet.MACAddress	string	true	-	端口当前有效的MAC地址
Ethernet.PermanentMACAddress	string	true	-	端口的永久MAC地址
}
FibreChannel {	object	true	-	此功能的万维网端口和节点名称
FibreChannel.PermanentWWPN	string	true	-	此功能的永久的万维网端口名称（WWPN）。通常，此值在制造过程中编程。此地址不可分配。
FibreChannel.PermanentWWNN	string	true	-	该函数的永久性万维节点名称（WWNN）。通常，该值在制造过程中被编程。此地址不可指定。
FibreChannel.WWPN	string	true	-	该函数当前有效的万维端口名称（WWPN）。不支持可分配的WWPN，则该属性为永久WWPN的只读别名。
FibreChannel.WWNN	string	true	-	此函数的有效当前万维节点名称（WWNN）。如果不支持可分配的WWNN，则此属是永久WWNN只读别名。
}
AssignablePhysicalNetworkPorts [ {	array	true	-	链接的端口属性的访问路径集合
`AssignablePhysicalNetworkPorts[].@odata.id`	string	true	-	链接单个端口属性的访问路径
} ]
Links {	object	true	-	NetworkDeviceFunctions关联的资源
Links.PhysicalNetworkPortAssignment {	object	true	-	链接所有端口属性的访问路径
`Links.PhysicalNetworkPortAssignment.@odata.id`	string	true	-	具体访问uri
}
}
RXFrames	number	true	-	网络设备功能接收到的帧总数
RXMulticastFrames	number	true	-	网络设备功能接收到的多播帧数量
RXUnicastFrames	number	true	-	网络设备功能接收到的单播帧数量
TXFrames	number	true	-	网络设备功能发送的帧总数
TXMulticastFrames	number	true	-	网络设备功能发送的多播帧数量
TXUnicastFrames	number	true	-	网络设备功能发送的单播帧数量
Metrics {	object	true	-	链接网络适配器所对应网络功能的使用情况和健康状况的统计数据的访问路径
`Metrics.@odata.id`	string	true	-	统计数据的具体访问uri
}

supported_methods

HTTP methods

GET

命令功能

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

命令格式

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

请求头:

text


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_function_id	单个网络适配器所公开的指定逻辑接口的ID	由网络适配器端口的编号组成

使用指南

无

使用实例

请求样例：

http

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

请求头：

text


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_function_id/Metrics

请求头:

text


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_function_id	单个网络适配器所公开的指定逻辑接口的ID	由网络适配器端口的编号组成

使用指南

无

使用实例

请求样例：

http

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

请求头：

text


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

ResourceDefinition ​

uris ​

properties ​

supported_methods ​

HTTP methods ​

GET ​

GET ​

ResourceDefinition

uris

properties

supported_methods

HTTP methods

GET

GET