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 |
---|---|
500 | InternalError |
示例
返回以下示例 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."
}