跳到主要内容

PATCH – 启用/禁用主机接口

使用 PATCH 方法更新 Redfish 服务的 HostInterface 资源中的属性。

请求 URL​

PATCH https://<BMC_IPADDR>/redfish/v1/Managers/1/HostInterfaces/1

请求正文​

要更新的属性如下所示。

字段类型错误消息 ID

InterfaceEnabled

布尔指示是否启用此接口。

CredentialBootstrapping

对象已展开
 

Enabled

布尔

当值为 false 时，IPMI 命令 2C 01 和 2C 02 将被拒绝，并返回完成代码 0x80。

当存在现有的引导程序帐户时，此值应始终为“disabled”。

 

EnableAfterReset

布尔如果值为 true，则在 XCC/主机重新启动后，属性“Enabled”将自动更改为 true，因为引导程序帐户已过期并被删除。

响应正文​

响应返回的内容与 GET 操作相同，但更新了属性。

状态代码​

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

响应示例​

以下示例是 PATCH 正文。

{
   "InterfaceEnabled" : true,
   "CredentialBootstrapping": {
        "Enabled": true,
        "EnableAfterReset": false
    }
}

成功运行 PATCH 操作后，主机接口资源查询将返回以下示例 JSON 响应：

{
    "ExternallyAccessible": false,
    "NetworkProtocol": {
        "@odata.id": "/redfish/v1/Managers/1/NetworkProtocol"
    },
    "HostInterfaceType": "NetworkHostInterface",
    "Description": "This resource shall be used to represent Host Interface resources as part of the Redfish specification.",
    "Id": "1",
    "Name": "Host Interface",
    "@odata.type": "#HostInterface.v1_3_0.HostInterface",
    "@odata.id": "/redfish/v1/Managers/1/HostInterfaces/1",
    "ManagerEthernetInterface": {
        "@odata.id": "/redfish/v1/Managers/1/EthernetInterfaces/ToHost"
    },
    "@odata.context": "/redfish/v1/$metadata#HostInterface.HostInterface",
    "@odata.etag": "\"621e8062feb328ae395\"",
    "HostEthernetInterfaces": {
        "@odata.id": "/redfish/v1/Managers/1/HostInterfaces/1/HostEthernetInterfaces"
    },
    "CredentialBootstrapping": {
        "Enabled": true,
        "RoleId": "Administrator",
        "EnableAfterReset": false
    },
    "InterfaceEnabled": true,
    "Links": {
        "ComputerSystems": [
            {
                "@odata.id": "/redfish/v1/Systems/1"
            }
        ]
    }
}