HostInterfaces
更新时间： 2026/09/24
在AtomGit上查看源码ResourceDefinition
uris
/redfish/v1/Managers/manager_id/HostInterfaces/hostinterfaceid
properties
| 名称 | 类型 | 是否只读 | 取值范围/枚举值 | 说明 |
|---|---|---|---|---|
| @odata.context | string | true | - | BMC和host侧网络接口资源模型的OData描述信息 |
| @odata.id | string | true | - | 该接口的访问路径 |
| @odata.type | string | true | - | 该接口的资源类型 |
| Id | string | true | - | 该接口的ID |
| Name | string | true | - | 该接口的名称 |
| HostInterfaceType | string | true | - | 该接口的主机接口类型 |
| Description | string | true | - | 该接口的描述 |
| AuthenticationModes | array | true | - | 该接口的认证模式 |
| ExternallyAccessible | boolean | true | - | 指示外部实体是否可以访问该接口 |
| HostEthernetInterfaces { | object | true | - | 与此主机接口通信的网络接口控制器或网卡集合 |
| HostEthernetInterfaces.@odata.id | string | true | - | - |
| } | ||||
| InterfaceEnabled | boolean | true | - | 该接口是否已启用 |
| ManagerEthernetInterface { | object | true | - | 管理器通过此主机接口进行网络通信 |
| ManagerEthernetInterface.@odata.id | string | true | - | - |
| } |
supported_methods
- GET
HTTP methods
GET
命令功能
查询服务器指定BMC和host侧的网络接口资源链接。
命令格式
URL: https://device_ip/redfish/v1/Managers/manager_id/HostInterfaces/hostinterfaceid
请求头:
X-Auth-Token: 123456789***********************请求消息体: 无
参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| device_ip | 登录设备的IP地址 | IPv4或IPv6地址 |
| manager_id | 管理资源ID | ● 针对机架服务器，取值为1 ● 针对高密服务器，取值为BladeN（N表示节点槽位号），例如“Blade1” ● 针对刀片服务器，取值可以为BladeN（N表示计算节点槽位号）或SwiN（N表示交换模块槽位号），例如“Swi1” ● 针对X6800 V5，X6000 V5，G5500，XA320 V2服务器，取值还可以为Enc，表示计算节点所在的机框资源 ● 针对设备U位信息，取值可以为UN(N表示设备U位号)，例如"U1" ● 针对机柜资源，取值为Rack |
| hostinterfaceid | 表示和host侧的网络接口资源ID | 1 |
| auth_value | 执行该GET请求时，必须在“Headers”中携带“X-Auth-Token”值用于鉴权。 | 可通过/redfish/v1/SessionService/Sessions创建会话时获得 |
使用指南
无
使用实例
请求样例：
http
GET https://device_ip/redfish/v1/Managers/1/HostInterfaces/1请求头：
X-Auth-Token: 123456789***********************请求消息体：无
响应样例：
json
{
"@odata.context": "/redfish/v1/$metadata#HostInterface.HostInterface",
"@odata.id": "/redfish/v1/Managers/1/HostInterfaces/1",
"@odata.type": "#HostInterface.v1_3_3.HostInterface",
"Id": "1",
"Name": "Host Interface",
"HostInterfaceType": "NetworkHostInterface",
"Description": "Management Host Interface",
"AuthenticationModes": [
"BasicAuth",
"RedfishSessionAuth"
],
"ExternallyAccessible": false,
"HostEthernetInterfaces": {
"@odata.id": "/redfish/v1/Systems/1/EthernetInterfaces"
},
"InterfaceEnabled": true,
"ManagerEthernetInterface": {
"@odata.id": "/redfish/v1/Managers/1/EthernetInterfaces"
}
}响应码：200