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."
}