跳到主要内容

GET – 端口属性

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

请求 URL​

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

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

{1-N}：网络物理端口的索引。

请求正文​

无

响应正文​

响应是包含以下参数的 JSON 对象：
字段类型描述

Id

字符串索引。

LinkNetworkTechnology

字符串

此端口的链路网络技术功能。

值可以是“Ethernet”、“InfiniBand”、“FibreChannel”

Ethernet

对象已展开。（如果这是 Ethernet，则将显示下面的项）
 

AssociatedMACAddresses

数组

项：字符串

与此网络端口关联的已配置 MAC 地址的数组。

Description

字符串“A Network Port represents a discrete physical port capable of connecting to a network.”

LinkStatus

字符串此端口与其链路伙伴之间的链路状态。

CurrentSpeedGbps

数字此端口的当前速度。

Name

字符串“Physical Port X”（X = Id 值）

FunctionMaxBandwidth

数组

项：对象

与此端口关联的网络设备功能的最小带宽分配百分比数组。

 

FunctionMaxBandwidth[N]

对象已展开。
  

AllocationPercent

数字分配给相应网络设备功能实例的最大带宽分配百分比。
  

NetworkDeviceFunction

链接NetworkDeviceFunction 的链接。

MaxSpeedGbps

数字当前配置的此端口的最大速度。

Status

对象展开。
 

State

字符串Enabled
 

Health

字符串OK
 

HealthRollup

字符串表示此资源及其依赖资源的运行状况状态。

FibreChannel

对象已展开。（如果这是 FibreChannel，则将显示下面的项）。
 

AssociatedWorldWideNames

数组

项：字符串

与此网络端口关联的已配置全球名称（WWN）的数组。

InfiniBand

对象已展开。（如果这是 InfiniBand，则将显示下面的项）。
 

AssociatedPortGUIDs

数组

项：字符串

与此网络端口关联的已配置端口 GUID 的数组。

状态代码​

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

示例​

返回以下示例 JSON 响应：

{
    "Ethernet": {
        "AssociatedMACAddresses": [
            "90:2e:16:05:4d:7c"
        ]
    },
    "Oem": {
        …
    },
    "Description": "A Network Port represents a discrete physical port capable of connecting to a network.",
    "LinkNetworkTechnology": "Ethernet",
    "Status": {
        "HealthRollup": "OK",
        "Health": "OK",
        "State": "Enabled"
    },
    "Id": "2",
    "Name": "Physical Port 2",
    "@odata.context": "/redfish/v1/$metadata#Port.Port",
    "@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/ob-2/Ports/2",
    "MaxSpeedGbps": 10,
    "CurrentSpeedGbps": null,
    "@odata.type": "#Port.v1_6_0.Port",
    "@odata.etag": "\"596e35b4a3e8296ddc6\"",
    "LinkStatus": "LinkDown",
    "FunctionMaxBandwidth": [
        {
            "AllocationPercent": null,
            "NetworkDeviceFunction": {
                "@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/ob-2/NetworkDeviceFunctions/2.1"
            }
        }
    ]
}