EthernetInterfaces
更新时间： 2026/07/01
在Gitcode上查看源码ResourceDefinition
uris
/redfish/v1/Managers/manager_id/EthernetInterfaces/ethernetinterface_id
properties
| 名称 | 类型 | 是否只读 | 取值范围/枚举值 | 说明 |
|---|---|---|---|---|
| @odata.context | string | true | 指定BMC网口源模型的OData描述信息 | |
| @odata.id | string | true | 指定BMC网口资源节点的访问路径 | |
| @odata.type | string | true | 指定BMC网口资源类型 | |
| Id | string | true | 指定BMC网口资源的ID | |
| Name | string | true | 指定BMC网口资源的名称 | |
| PermanentMACAddress | string | true | 指定BMC网口的MAC地址 | |
| HostName | string | false | 指定BMC的主机名 | |
| FQDN | string | false | 指定BMC的全称域名 | |
| VLANEnable | boolean | true | 指定BMC网口VLAN功能的使能状态，包括： ● true ● false | |
| VLANId | number | true | 指定BMC网口所属VLAN的ID | |
| Address | string | true | 指定BMC网口的IPv4地址 | |
| SubnetMask | string | true | 指定BMC网口的IPv4地址对应的子网掩码 | |
| Gateway | string | true | 指定BMC网口的IPv4网关地址 | |
| AddressOrigin | string | true | 指定BMC网口的IPv4地址模式，包括： ● Static ● DHCP | |
| PrefixLength | number | true | 指定BMC网口的IPv6地址对应的前缀长度 | |
| IPv6DefaultGateway | string | false | 指定BMC网口的IPv6网关地址 | |
| NameServers | array | false | 当前使用的DNS服务器地址。 格式为： [ "首选DNS服务器IPv4或IPv6地址", "备选DNS服务器1 IPv4或IPv6地址", "备选DNS服务器2 IPv4或IPv6地址" ] | |
| StaticNameServers | array | false | 指定的静态DNS服务器地址。 格式为： [ "首选DNS服务器IPv4或IPv6地址", "备选DNS服务器1 IPv4或IPv6地址", "备选DNS服务器2 IPv4或IPv6地址" ] 说明指定动态模式获取DNS服务器信息时，显示为当前使用的DNS服务器地址。 | |
| IPVersion | string | false | IPv4/IPv6协议使能 | |
| NetworkPortMode | string | false | 网口模式 | |
| ManagementNetworkPort | string | false | 指定管理网口 | |
| PortNumber | number | true | 丝印号说明如果是专用网口，只代表序号，不代表丝印号 | |
| ManagementNetworkPortMembers | array | false | 当前网络接口下管理的网口成员说明BMC300 5.12.0及以上版本支持 | |
| Type | string | true | 网口类型 | |
| LinkStatus | string | true | 网口链路状态 ● Connected ● Disconnected | |
| AdaptiveFlag | boolean | true | 自适应标志 | |
| DNSAddressOrigin | string | false | DNS服务器信息获取模式 ● Static ● IPv4 ● IPv6 | |
| SwitchManagementIP | string | true | 交换机管理IP | |
| SwitchConnectionPortIDs | array | true | 交换机端口号 | |
| ChassisLanSubNet | string | false | 指定机框内部网络网段说明仅支持CIDR表示法，且子网掩码固定为16位地址如果没有内网网口，则显示为"" | |
| DHCPEnabled | boolean | false | 是否使能DHCPv4 | |
| UseNTPServers | boolean | false | 是否DHCP分配NTP服务器地址 | |
| OperatingMode | string | false | 当前DHCPv6的操作模式， 取值Disabled/Enabled | |
| IPv6Enabled | boolean | false | 当前网口是否使能了IPV6 | |
| Chassis | object | true | 当前网口资源所在的机箱资源的访问路径 | |
| SpeedMbps | 整型 | true | 指定BMC的网口速率，单位是MBit/s说明只有当SpeedDuplexEnable属性为false时，该属性才是可写的。 |
supported_methods
- GET
- PATCH
HTTP methods
GET
命令功能
查询指定 BMC 网口资源信息
命令格式
URL: https://device_ip/redfish/v1/Managers/manager_id/EthernetInterfaces/ethernetinterface_id
请求头:
X-Auth-Token: auth_value请求消息体: 无
参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| device_ip | 登录设备的IP地址 | IPv4或IPv6地址 |
| auth_value | 请求消息的鉴权参数 | 可通过/redfish/v1/SessionService/Sessions创建会话时获得 |
使用指南
无
使用实例
请求样例： GET https://device_ip/redfish/v1/Managers/manager_id/EthernetInterfaces/ethernetinterface_id
X-Auth-Token: auth_value 请求消息体：无
响应样例：
json
{
"@odata.context": "/redfish/v1/$metadata#Managers/Members/1/EthernetInterfaces/Members/$entity",
"@odata.id": "/redfish/v1/Managers/1/EthernetInterfaces/004207072288",
"@odata.type": "#EthernetInterface.v1_1_0.EthernetInterface",
"Id": "004207072288",
"Name": "Manager Ethernet Interface",
"LinkStatus": "LinkUp",
"PermanentMACAddress": null,
"HostName": "iBMC",
"FQDN": "iBMC",
"VLAN": {
"VLANEnable": true,
"VLANId": 60
},
"DHCPv4": {
"DHCPEnabled": true,
"UseNTPServers": false
},
"DHCPv6": {
"OperatingMode": "Enabled"
},
"IPv6Enabled": true,
"IPv4Addresses": [
{
"Address": "device_ip",
"SubnetMask": "255.255.0.0",
"Gateway": "10.10.10.1",
"AddressOrigin": "Static"
}
],
"IPv6Addresses": [
{
"Address": "fc00:0db8:3c4d:0015:0000:0000:1a2f:1a20",
"PrefixLength": 64,
"AddressOrigin": "Static"
},
{
"Address": "fe80::242:7ff:fe07:2288",
"PrefixLength": 64,
"AddressOrigin": "LinkLocal"
}
],
"IPv6StaticAddresses": [
{
"Address": "fc00:0db8:3c4d:0015:0000:0000:1a2f:1a20",
"PrefixLength": 64
}
],
"IPv6DefaultGateway": "::",
"NameServers": [
"10.10.10.254",
"10.10.10.253",
"10.10.10.252"
],
"StaticNameServers": [
"10.10.10.254",
"10.10.10.253",
"10.10.10.252"
],
"Oem": {
"Public": {
"IPVersion": "IPv4AndIPv6",
"NetworkPortMode": "Automatic",
"ManagementNetworkPort": {
"Type": "Dedicated",
"PortNumber": 1
},
"ManagementNetworkPortMembers": [
{
"Type": "Dedicated",
"PortNumber": 1
},
{
"Type": "Dedicated",
"PortNumber": 2
}
],
"ManagementNetworkPort@Redfish.AllowableValues": [
{
"Type": "Dedicated",
"PortNumber": 1,
"LinkStatus": "Connected"
},
{
"Type": "LOM",
"PortNumber": 1,
"LinkStatus": "Connected"
},
{
"Type": "LOM",
"PortNumber": 2,
"LinkStatus": "Disconnected"
},
{
"Type": "LOM",
"PortNumber": 3,
"LinkStatus": "Disconnected"
},
{
"Type": "LOM",
"PortNumber": 4,
"LinkStatus": "Disconnected"
}
],
"AdaptivePort": [
{
"Type": "Dedicated",
"PortNumber": 1,
"AdaptiveFlag": true
},
{
"Type": "LOM",
"PortNumber": 1,
"AdaptiveFlag": false
},
{
"Type": "LOM",
"PortNumber": 2,
"AdaptiveFlag": false
},
{
"Type": "LOM",
"PortNumber": 3,
"AdaptiveFlag": false
},
{
"Type": "LOM",
"PortNumber": 4,
"AdaptiveFlag": false
}
],
"DNSAddressOrigin": "Static",
"SwitchConnections": [],
"ChassisLanSubNet": "192.168.0.0/16"
}
},
"Link": {
"Oem": {
"Public": {
"EthernetInterface": {
"@odata.id": "/redfish/v1/Systems/1/EthernetInterfaces"
}
}
}
},
"Links": {
"Chassis": {
"@odata.id": "/redfish/v1/Chassis/1"
}
}
}响应码：200
PATCH
命令功能
查询指定 BMC 网口资源信息
命令格式
URL: https://device_ip/redfish/v1/Managers/manager_id/EthernetInterfaces/ethernetinterface_id
请求头:
X-Auth-Token: auth_value
Content-Type: header_type
If-Match: ifmatch_value请求消息体:
json
{
"HostName": HostName,
"FQDN": fqdn,
"VLAN": vlan,
"IPv4Addresses": [
ipv4addr
],
"IPv6Addresses": [
ipv6addr
],
"IPv6StaticAddresses": [
ipv6staticaddr
],
"IPv6DefaultGateway": gateway6,
"NameServers": [
servers
],
"StaticNameServers": [
staticnameservers
],
"DHCPv4": {
"DHCPEnabled": [
dhcpenabled
],
"UseNTPServers": [
userntpservers
]
},
"DHCPv6": {
"OperatingMode": [
operatingmode
]
},
"IPv6Enabled": [
ipv6enabled
],
"Oem": {
"Public": {
"IPVersion": IPVersion_value,
"NetworkPortMode": NetworkPortMode_value,
"ManagementNetworkPort": ManagementNetworkPort_value,
"ManagementNetworkPortMembers": [
ManagementNetworkPortMembers_value
],
"AdaptivePort": [
AdaptivePort_value
],
"DNSAddressOrigin": DNSAddressOrigin_value,
"ChassisLanSubNet": ChassisLanSubNet_value
}
}
}请求头参数说明
参见 请求头参数说明
请求体参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| ifmatch_value | 请求消息的匹配参数 | 可通过对相应资源发起GET操作，从响应头中获取（对应于“ETag”参数） |
| HostName | BMC的主机名 | 取值范围：1 ～ 64位的字符串取值原则：可由数字、英文字母和连字符（-）组成，且连字符不能出现在开头和结尾 |
| fqdn | BMC的全称域名。 | 格式为：主机名.域名 |
| vlan | BMC网口的VLAN信息格式为： { "VLANEnable": state, "VLANId": vlanid } | ● state：VLAN的使能状态，可设置为“true” 和“false” ● vlanid：1~4094说明 ● vlanid只支持整数，当输入值为小数时，会上报属性格式错误 ● 仅“固定设置”模式下选择“专用网口”时， 不支持VLAN设置。其他模式下，支持使能和配置VLAN ID ● 若选择“专用网口”作为BMC管理网口，当前配置的VLAN信息不生效；若选择了除“专用网口”外的其他网口作为BMC管理网口，则当前配置的VLAN信息有效 |
| ipv4addr | BMC网口的IPv4地址信息格式为： { "Address":"Address", "SubnetMask":"SubnetM ask", "AddressOrigin":"Address Origin", "Gateway":"Gateway" } | ● Address：IPv4地址 ● SubnetMask：IPv4地址的子网掩码 ● AddressOrigin：IPv4地址获取模式，可设置为“Static”或 “DHCP” ● Gateway：IPv4网关地址说明 ● 当前获取模式为DHCP时，单独设置IP地址属性有效 ● 当同时设置获取模式和其他网络属性（IP地址、 网关、掩码）时，获取模式为DHCP时会报错 |
| ipv6addr | BMC网口的IPv6地址信息格式为： { "Address":"Address", "PrefixLength":"PrefixLen gth", "AddressOrigin":"Address Origin" } | ● Address：IPv6地址 ● PrefixLength：IPv6地址的前缀长度 ● AddressOrigin：IPv6地址获取模式，可设置为“Static”或 “DHCPv6” 说明 ● 当前获取模式为DHCPv6时，单独设置IPv6地址属性有效 ● 当同时设置获取模式和其他网络属性（IP地址、 前缀长度）时，获取模式为DHCPv6时会报错 ● IPv6地址的前缀长度只支持整数，当输入值为小数时，会报属性格式错误 |
| ipv6staticaddr | BMC网口的IPv6静态地址信息格式为： { "Address":"Address", "PrefixLength":"PrefixLen gth" } | ● Address：IPv6地址 ● PrefixLength：IPv6地址的前缀长度说明 ● 当IPv6的地址模式为DHCPv6时，允许设置IPv6地址、不允许设置前缀长度 ● IPv6地址的前缀长度只支持整数，当输入值为小数时，会报属性格式错误 |
| gateway6 | BMC网口的IPv6网关地址 | 数据类型为IPv6，表示形式为xxxx:xxxx:xxxx:xxxx:xxxx:x xxx:xxxx:xxxx当多个xxxx连续为0时，表现形式可缩写为xxxx::xxxx说明当IPv6的获取地址模式为DHCPv6时，不允许设置网关 |
| servers | 指定当前使用的DNS服务器地址，格式为： "首选DNS服务器IP地址"， "备选DNS服务器1 IP地址"， "备选DNS服务器2 IP地址" | 服务器的IP地址可以为IPv4或IPv6说明1. 仅DNS服务器信息获取模式为手动配置时可以修改；2. 与StaticNameServers同时配置时，配置值需要保持一致；3. 推荐以StaticNameServers属性配置首选、备选DNS服务器地址。 |
| staticnameservers | 指定静态DNS服务器地址，格式为： "首选DNS服务器IP地址"， "备选DNS服务器1 IP地址"， "备选DNS服务器2 IP地址" | 服务器的IP地址可以为IPv4或IPv6说明1. 仅DNS服务器信息获取模式为手动配置时可以修改；2. 与NameServers同时配置时，配置值需要保持一致。 |
| IPVersion_value | IPv4/IPv6协议使能 | ● IPv4：只使能IPv4 ● IPv6：只使能IPv6 ● IPv4AndIPv6：IPv4和IPv6都使能 |
| NetworkPortMode_value | 网口模式 | ● Fixed：固定模式 ● Automatic：自动模式 |
| ManagementNetworkPort_value | 指定管理网口格式为 { "Type": Type, "PortNumber":PortNumb er } | ● Type：网口类型，可设置为Dedicated（专用），Aggregation （汇聚），LOM（板载），ExternalPCIe （PCIE扩展网口），LOM2（板载网卡2），OCP(OCP扩展网口) ● PortNumber：丝印说明如果是专用网口，只代表序号，不代表丝印号 |
| ManagementNetworkPortMembers_value | 每一个管理网口成员格式为 { "Type": Type, "PortNumber":PortNumb er } | ● Type：网口类型，可设置为Dedicated（专用），Aggregation （汇聚），LOM（板载），ExternalPCIe （PCIE扩展网口），LOM2（板载网卡2），OCP(OCP扩展网口) ● PortNumber：丝印说明如果是专用网口，只代表序号，不代表丝印号BMC300 5.12.0及以上版本支持 |
| AdaptivePort_value | 每一个网口的自适应信息格式为： { "Type": Type, "PortNumber": PortNumber, "AdaptiveFlag": AdaptiveFlag } | ● Type：网口类型，可设置为Dedicated（专用），Aggregation （汇聚），LOM（板载），ExternalPCIe （PCIE扩展网口），LOM2（板载网卡2），OCP(OCP扩展网口) ● PortNumber：丝印号 ● AdaptiveFlag：自适应标识，可取true或false说明如果是专用网口，只代表序号，不代表丝印号 |
| DNSAddressOrigin_value | DNS服务器信息获取模式 | ● IPv4：从IPv4协议栈自动获取 ● Static：手动配置 ● IPv6：从IPv6协议栈自动获取 |
| ChassisLanSubNet_value | 指定机框内部网络网段 | 使用CIDR表示法的IPv4地址字符串，且子网掩码固定为16位地址格式为："xxx.xxx.0.0/16" 说明如果没有内网网口，则不支持修改如果配置内网网段，网段范围不能和已有的IP地址冲突 |
| dhcpenabled | 布尔 | 是否使能DHCPv4 |
| userntpservers | 布尔 | 是否DHCP分配NTP服务器地址 |
| operatingmode | 字符串 | 当前DHCPv6的操作模式， 取值Disabled/Enabled |
| ipv6enabled | 布尔 | 当前网口是否使能了IPV6 |
使用指南
无
使用实例
请求样例： PATCH https://device_ip/redfish/v1/Managers/manager_id/EthernetInterfaces/ethernetinterface_id
X-Auth-Token: auth_value Content-Type: header_type If-Match: ifmatch_value 请求消息体：
json
{
"HostName": HostName,
"FQDN": fqdn,
"VLAN": vlan,
"IPv4Addresses": [
ipv4addr
],
"IPv6Addresses": [
ipv6addr
],
"IPv6StaticAddresses": [
ipv6staticaddr
],
"IPv6DefaultGateway": gateway6,
"NameServers": [
servers
],
"StaticNameServers": [
staticnameservers
],
"DHCPv4": {
"DHCPEnabled": [
dhcpenabled
],
"UseNTPServers": [
userntpservers
]
},
"DHCPv6": {
"OperatingMode": [
operatingmode
]
},
"IPv6Enabled": [
ipv6enabled
],
"Oem": {
"Public": {
"IPVersion": IPVersion_value,
"NetworkPortMode": NetworkPortMode_value,
"ManagementNetworkPort": ManagementNetworkPort_value,
"ManagementNetworkPortMembers": [
ManagementNetworkPortMembers_value
],
"AdaptivePort": [
AdaptivePort_value
],
"DNSAddressOrigin": DNSAddressOrigin_value,
"ChassisLanSubNet": ChassisLanSubNet_value
}
}
}响应样例：
json
{
"@odata.context": "/redfish/v1/$metadata#Managers/Members/1/EthernetInterfaces/Members/$entity",
"@odata.id": "/redfish/v1/Managers/1/EthernetInterfaces/004207072288",
"@odata.type": "#EthernetInterface.v1_1_0.EthernetInterface",
"Id": "004207072288",
"Name": "Manager Ethernet Interface",
"PermanentMACAddress": null,
"HostName": "iBMC",
"LinkStatus": "LinkUp",
"FQDN": "iBMC",
"SpeedMbps": 1000,
"VLAN": {
"VLANEnable": true,
"VLANId": 60
},
"DHCPv4": {
"DHCPEnabled": true,
"UseNTPServers": false
},
"DHCPv6": {
"OperatingMode": "Enabled"
},
"IPv6Enabled": true,
"IPv4Addresses": [
{
"Address": "device_ip",
"SubnetMask": "255.255.0.0",
"Gateway": "10.10.10.1",
"AddressOrigin": "Static"
}
],
"IPv6Addresses": [
{
"Address": "fd00:60b:e3:a05:aed1:63de:c500:731a",
"PrefixLength": 64,
"AddressOrigin": "Static"
},
{
"Address": "fe80::242:7ff:fe07:2288",
"PrefixLength": 64,
"AddressOrigin": "LinkLocal"
}
],
"IPv6StaticAddresses": [
{
"Address": "fd00:60b:e3:a05:aed1:63de:c500:731a",
"PrefixLength": 64
}
],
"IPv6DefaultGateway": "::",
"NameServers": [
"10.10.10.254",
"10.10.10.253",
"10.10.10.252"
],
"StaticNameServers": [
"10.10.10.254",
"10.10.10.253",
"10.10.10.252"
],
"Oem": {
"Public": {
"IPVersion": "IPv4AndIPv6",
"NetworkPortMode": "Automatic",
"ManagementNetworkPort": {
"Type": "Dedicated",
"PortNumber": 1
},
"ManagementNetworkPortMembers": [
{
"Type": "Dedicated",
"PortNumber": 1
},
{
"Type": "Dedicated",
"PortNumber": 2
}
],
"ManagementNetworkPort@Redfish.AllowableValues": [
{
"Type": "Dedicated",
"PortNumber": 1,
"LinkStatus": "Connected"
},
{
"Type": "LOM",
"PortNumber": 1,
"LinkStatus": "Connected"
},
{
"Type": "LOM",
"PortNumber": 2,
"LinkStatus": "Disconnected"
},
{
"Type": "LOM",
"PortNumber": 3,
"LinkStatus": "Disconnected"
},
{
"Type": "LOM",
"PortNumber": 4,
"LinkStatus": "Disconnected"
}
],
"AdaptivePort": [
{
"Type": "Dedicated",
"PortNumber": 1,
"AdaptiveFlag": true
},
{
"Type": "LOM",
"PortNumber": 1,
"AdaptiveFlag": false
},
{
"Type": "LOM",
"PortNumber": 2,
"AdaptiveFlag": false
},
{
"Type": "LOM",
"PortNumber": 3,
"AdaptiveFlag": false
},
{
"Type": "LOM",
"PortNumber": 4,
"AdaptiveFlag": false
}
],
"DNSAddressOrigin": "Static",
"SwitchConnections": []
}
},
"Link": {
"Oem": {
"Public": {
"EthernetInterface": {
"@odata.id": "/redfish/v1/Systems/1/EthernetInterfaces"
}
}
}
}
}响应码：200