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			对象	已展开注此对象在 AMD 平台中不受支持。
			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 的链接。
			Ports		数组	项：链接
				Ports[]	链接	相关 Ports 的链接。
			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				字符串	表示此资源的运行状况状态。
Ports					链接	相关 PortsCollection 的链接。
NetworkDeviceFunctions					链接	相关 NetworkDeviceFunctionsCollection 的链接。

状态代码

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

示例

返回以下示例 JSON 响应：

{
    "Manufacturer": "Broadcom Limited",
    "@odata.context": "/redfish/v1/$metadata#NetworkAdapter.NetworkAdapter",
    "SKU": "",
    "Model": "BCM5719",
    "Status": {
        "State": "Enabled",
        "Health": "OK"
    },
    "Oem": {
        …
    },
    "SerialNumber": "L0NV18D000C",
    "@odata.etag": "\"e83f6e6f3af62ff749494\"",
    "Controllers": [
        {
            "ControllerCapabilities": {
                "NetworkPortCount": 4,
                "NetworkDeviceFunctionCount": 4
            },
            "FirmwarePackageVersion": "214.0.6.1",
            "Links": {
                "PCIeDevices": [
                    {
                        "@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/slot_13"
                    }
                ],
                "Ports": [
                    {
                        "@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/slot-13/Ports/1"
                    },
                    {
                        "@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/slot-13/Ports/2"
                    },
                    {
                        "@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/slot-13/Ports/3"
                    },
                    {
                        "@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/slot-13/Ports/4"
                    }
                ],
                "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"
                    },
                    {
                        "@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/slot-13/NetworkDeviceFunctions/3.1"
                    },
                    {
                        "@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/slot-13/NetworkDeviceFunctions/4.1"
                    }
                ]
            },
            "PCIeInterface": {
                "PCIeType": "Gen1",
                "LanesInUse": 4,
                "MaxPCIeType": "Gen1",
                "MaxLanes": 4
            },
            "Location": {
                "PartLocation": {
                    "LocationType": "Slot",
                    "ServiceLabel": "PCIe 13",
                    "LocationOrdinalValue": 13
                },
                "InfoFormat@Redfish.Deprecated": "The property is deprecated. Please use PartLocation instead.",
                "Info": "Slot 13",
                "Info@Redfish.Deprecated": "The property is deprecated. Please use PartLocation instead.",
                "InfoFormat": "Slot X"
            }
        }
    ],
    "NetworkDeviceFunctions": {
        "@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/slot-13/NetworkDeviceFunctions"
    },
    "Name": "Broadcom 5719 1GbE RJ45 4-port OCP Ethernet Adapter",
    "@odata.type": "#NetworkAdapter.v1_9_0.NetworkAdapter",
    "@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/slot-13",
    "PartNumber": "SN37A28309",
    "Description": "A NetworkAdapter represents the physical network adapter capable of connecting to a computer network.",
    "Id": "slot-13",
    "Ports": {
        "@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/slot-13/Ports"
    }
}

提供反馈

GET – 网络适配器属性

请求 URL​

请求正文​

响应正文​

状态代码​

示例​

请求 URL

请求正文

响应正文

状态代码

示例