跳到主要内容

GET – 网络适配器属性

使用 GET 方法检索 Redfish 服务的 NetworkAdapter 资源中的属性。

请求 URL

GET https://<BMC_IPADDR>/redfish/v1/Chassis/1/NetworkAdapters/{Location}

{Location}:相应 NetworkAdapter 设备的位置。{Location}=ob-X 或 slot-Y。ob 表示板载设备,slot 表示附加卡。X 是从 1 开始的板载设备序号。Y 是附加卡的插槽编号。

请求正文

响应正文

字段

类型

描述

Id

字符串

目前只有以太网、Fibre Channel、InfiniBand 设备支持拥有 NetworkAdapter 资源:

对于附加设备,此值为“slot-{slot number}”

对于板载设备,此值为“ob-{index}”

Controllers

数组

此 NetworkAdapter 包含的网络控制器 ASIC 集

 

Controllers[]

对象

已展开

  

FirmwarePackageVersion

字符串

面向用户的固件包的版本

  

PCIeInterface

对象

已展开

   

LanesInUse

数字

此设备使用的 PCIe 通道数。

   

MaxLanes

数字

此设备支持的 PCIe 通道数。

   

MaxPCIeType

字符串

此设备支持的 PCIe 规范的最高版本。

   

PCIeType

字符串

此设备使用的 PCIe 规范的版本。

  

Location

对象

网络适配器的位置。

   

PartLocation

对象

部件位置。

    

ServiceLabel

字符串

部件位置标签,如丝印名称或印刷标签。PCIe X(X 是插槽编号)。

    

LocationType

字符串

网络适配器的位置类型。固定值:Slot

    

LocationOrdinalValue

整数

表示部件位置的数字。如果 LocationType 为“slot”,而此单元位于插槽 2 中,则 LocationOrdinalValue 为 2。

   

Info

字符串

资源的位置:Slot {N}(N 是插槽编号)或“OnBoard”。

   

Infoformat

字符串

Info 属性的格式。“Slot X”或“OnBoard”。

   

Info@Redfish.Deprecated

字符串

此属性已弃用。请改用 PartLocation。

   

InfoFormat@Redfish.Deprecated

字符串

此属性已弃用。请改用 PartLocation。

  

Links

对象

此控制器的链接

   

PCIeDevices

数组

项:链接

    

PCIeDevices[]

链接

相关 PCIeDevice 的链接。

   

NetworkPorts

数组

项:链接

    

NetworkPorts[]

链接

相关 NetworkPorts 的链接。

   

NetworkDeviceFunctions

数组

项:链接

    

NetworkDeviceFunctions[]

链接

相关 NetworkDeviceFunctions 的链接。

  

ControllerCapabilities

对象

控制器的功能。

   

NetworkPortCount

数字

此适配器的物理端口数。

   

NetworkDeviceFunctionCount

数字

此适配器的逻辑端口数。

Description

字符串

“A NetworkAdapter represents the physical network adapter capable of connecting to a computer network.”

Manufacturer

字符串

此网络适配器的制造商或 OEM。

Model

字符串

此网络适配器的型号字符串。

SKU

字符串

此网络适配器的制造商 SKU。

Name

字符串

此网络适配器的卡名。

PartNumber

字符串

此网络适配器的部件号。

SerialNumber

字符串

此网络适配器的序列号。

Status

对象

展开

 

State

字符串

Enabled

 

Health

字符串

表示此资源的运行状况状态。

NetworkPorts

链接

相关 NetworkPortsCollection 的链接。

NetworkDeviceFunctions

链接

相关 NetworkDeviceFunctionsCollection 的链接。

状态代码

HTTP 状态代码错误消息 ID
500InternalError

示例

返回以下示例 JSON 响应:

{
"SerialNumber": "L2NV97J018G",
"NetworkDeviceFunctions": {
"@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/slot-13/NetworkDeviceFunctions"
},
"Id": "slot-13",
"@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/slot-13",
"NetworkPorts": {
"@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/slot-13/NetworkPorts"
},
"Status": {
"State": "Enabled",
"Health": "OK"
},
"Name": "Broadcom NetXtreme PCIe 1Gb 2-Port RJ45 Ethernet Adapter",
"Controllers": [
{
"ControllerCapabilities": {
"NetworkDeviceFunctionCount": 2,
"NetworkPortCount": 2
},
"FirmwarePackageVersion": "212.0.5.4",
"Location": {
"PartLocation": {
"LocationType": "Slot",
"ServiceLabel": "PCIe 13",
"LocationOrdinalValue": 13
},
"InfoFormat": "Slot X",
"Info": "Slot 13",
"Info@Redfish.Deprecated": "The property is deprecated. Please use PartLocation instead.",
"InfoFormat@Redfish.Deprecated": "The property is deprecated. Please use PartLocation instead."
},
"Links": {
"NetworkPorts": [
{
"@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/slot-13/NetworkPorts/1"
},
{
"@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/slot-13/NetworkPorts/2"
}
],
"NetworkDeviceFunctions": [
{
"@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/slot-13/NetworkDeviceFunctions/1.1"
},
{
"@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/slot-13/NetworkDeviceFunctions/2.1"
}
],
"PCIeDevices": [
{
"@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/slot_13"
}
]
},
"PCIeInterface": {
"LanesInUse": 2,
"MaxPCIeType": "Gen2",
"MaxLanes": 4,
"PCIeType": "Gen2"
}
}
],
"PartNumber": "SN30L21970",
"SKU": "00YK550",
"@odata.type": "#NetworkAdapter.v1_3_0.NetworkAdapter",
"Oem": {
"Lenovo": {
"@odata.type": "#LenovoDeviceInfo.v1_0_0.LenovoDeviceInfo",
"UUID": "00000000000000000000B02628C5541C"
}
},
"Manufacturer": "Broadcom Limited",
"@odata.etag": "\"9b40314193f036ad3898f8482b8a3a9a\"",
"Model": "5720",
"Description": "A NetworkAdapter represents the physical network adapter capable of connecting to a computer network."
}