GET – 端口属性

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

请求 URL

GET https://<BMC_IPADDR>/redfish/v1/Chassis/1/NetworkAdapters/Id/Ports/Id

请求正文

无

响应正文

字段			类型	描述
Id			字符串	端口 ID 由硬件提供。
LinkNetworkTechnology			字符串	此端口的链路网络技术功能。值可以是 Ethernet、InfiniBand、FibreChannel。
Ethernet			对象	已展开。（如果这是 Ethernet，则将显示下面的项）
	AssociatedMACAddresses		数组	项：字符串与此网络端口关联的已配置 MAC 地址的数组。
	FlowControlConfiguration		字符串	此端口本地配置的 802.3x 流量控制设置。
	FlowControlStatus		字符串	与此端口的链路伙伴协商的 802.3x 流量控制行为。
	LLDPEnabled		布尔	为此端口启用/禁用 LLDP。
	LLDPReceive		对象	已展开。
		ChassisId	字符串	链路层数据协议（LLDP）机箱 ID。
		ManagementAddressIPv4	字符串	通过此链路从远程合作伙伴处收到的 IPv4 管理地址。
		ManagementAddressMAC	字符串	通过此链路从远程伙伴处收到的管理 MAC 地址。
		SystemName	字符串	要从此端点传输的系统名称。
		SystemDescription	字符串	要从此端点传输的系统描述。
	LLDPTransmit		对象	已展开。
		ChassisId	字符串	链路层数据协议（LLDP）机箱 ID。
		ChassisIdSubtype	字符串	用于机箱 ID 的标识符类型。
		ManagementAddressIPv4	字符串	要从此端点传输的 IPv4 管理地址。
		ManagementAddressIPv6	字符串	要从此端点传输的 IPv6 管理地址。
		ManagementAddressMAC	字符串	要从此端点传输的管理 MAC 地址。
		ManagementAddressVlanId	数字	要从此端点传输的管理 VLAN ID。
		PortId	字符串	以冒号分隔的十六进制八位字节字符串，用于标识要从此端点传输的端口。
		PortIdSubtype	字符串	要从此端点传输的端口 ID 子类型。
	WakeOnLANEnabled		布尔	指示是否在此端口上启用了 Wake on LAN（WoL）。
Description			字符串	“A Network Port represents a discrete physical port capable of connecting to a network.”
Name			字符串	物理端口 X（X = Id 值）。
CurrentSpeedGbps			数字	此端口的当前速度。
FibreChannel			对象	已展开。（如果这是 FibreChannel，则将显示下面的项）。
	AssociatedWorldWideNames		数组	项：字符串与此网络端口关联的已配置全球名称（WWN）的数组。
FunctionMaxBandwidth			数组	项：对象与此端口关联的网络设备功能的最小带宽分配百分比数组。
	FunctionMaxBandwidth[N]		对象	已展开。
		AllocationPercent	数字	分配给相应网络设备功能实例的最大带宽分配百分比。
InfiniBand			对象	已展开。（如果这是 InfiniBand，则将显示下面的项）。
	AssociatedNodeGUIDs		数组	项：字符串与此网络端口关联的已配置节点 GUID 的数组。
	AssociatedPortGUIDs		数组	项：字符串与此网络端口关联的已配置端口 GUID 的数组。
	AssociatedSystemGUIDs		数组	项：字符串与此网络端口关联的已配置系统 GUID 的数组。
LinkState			字符串	此端口与其链路伙伴之间的链路状态。
LinkStatus			字符串	此端口与其链路伙伴之间的链路状态。
LinkConfiguration			数组	此端口与其链路伙伴之间的链路配置。
	LinkConfiguration[]		对象	相关链路配置的链接。
		AutoSpeedNegotiationCapable	布尔	指示端口是否能够自动协商速度。
		AutoSpeedNegotiationEnabled	布尔	控制是否将此端口配置为启用自动协商速度。
		CapableLinkSpeedGbps	数组	此端口的链路速度能力集。
MaxSpeedGbps			数字	当前配置的此端口的最大速度。
MaxFrameSize			数字	当前配置的此端口的最大帧大小。
MaximumMTU			数字	当前配置的此端口的最大 MTU。
PortProtocol			数字	通过此端口发送的协议。
Status			对象	已展开。
	State		字符串	Enabled
	Health		字符串	OK
	HealthRollup		字符串	表示此资源及其依赖资源的运行状况状态。
SignalDetected			布尔	指示是否在此接口上检测到信号。
SFP			对象	与此端口关联的小型可插拔（SFP）设备。
	Status		对象	已展开。
		State	字符串	Enabled
		Health	字符串	表示此资源在没有依赖资源的情况下的运行状况状态
		HealthRollup	字符串	表示此资源及其依赖资源的运行状况状态。

状态代码

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

示例

返回以下示例 JSON 响应：

{
    "@odata.context": "/redfish/v1/$metadata#Port.Port",
    "@odata.etag": "\"E67D9D87\"",
    "@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/slot3_0xb0000/Ports/1",
    "@odata.type": "#Port.v1_7_0.Port",
    "CurrentSpeedGbps": 0.0,
    "Description": "A Network Port represents a discrete physical port                     capable of connecting to a network.",
    "FibreChannel": {
        "AssociatedWorldWideNames": [
            "210034800D725642"
        ]
    },
    "Id": "1",
    "LinkNetworkTechnology": "FibreChannel",
    "LinkState": "Enabled",
    "LinkStatus": "LinkDown",
    "MaxFrameSize": 16384,
    "MaxSpeedGbps": 32,
    "MaximumMTU": 16384,
    "Name": "Physical Port 1",
    "Oem": {
        ...
        }
    },
    "PortProtocol": "FC",
    "Status": {
        "Health": "OK",
        "State": "Enabled"
    }
}

提供反馈

GET – 端口属性

请求 URL​

请求正文​

响应正文​

状态代码​

示例​

请求 URL

请求正文

响应正文

状态代码

示例