跳到主要内容

PATCH – 更新下次一次性引导配置和其他属性

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

请求 URL​

PATCH https://<BMC_IPADDR>/redfish/v1/Systems/1

请求正文​

要更新的属性如下所示。

字段类型描述

Boot

对象

描述当前资源的引导信息。对此对象的更改不会改变 BIOS 持久引导顺序配置。

 

BootSourceOverrideEnabled

字符串

描述“引导源覆盖”功能的状态。

 

BootSourceOverrideMode

字符串

从 BootSourceOverrideTarget 引导源进行引导时要使用的 BIOS 引导模式（Legacy 或 UEFI）。

 

UefiTargetBootSourceOverride

字符串

当 BootSourceOverrideSupported 为 UefiTarget 时作为引导源的设备的 UEFI 设备路径。

 

BootSourceOverrideTarget

字符串

BootSourceOverrideEnabled 为 true 的情况下，下次引导时要使用的当前引导源（取代正常引导设备）。

HostWatchdogTimer

对象

此对象描述此系统的主机看守程序计时器功能。

 

FunctionEnabled

布尔

指示是否已启用主机看守程序计时器功能。激活计时器功能需要额外的基于主机的软件。

AssetTag

字符串

系统的资产标记。

IndicatorLED

对象

与此系统关联的指示灯的指示灯状态。

KeyManagement

对象

已展开

 

KMIPServers

数组

此计算机系统订阅的 KMIP 服务器的数组。

  

KMIPServers[N]

对象

已展开

  

Address

字符串

KMIP 服务器地址。

  

Port

整数

KMIP 服务器端口。

 

KMIPCertificates

链接

KMIPServers 属性引用的服务器证书集合的 URI 引用。

响应​

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

状态代码​

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

示例​

以下示例是 PATCH 正文。

{
   "Boot" : {
      "BootSourceOverrideMode" : "Legacy", 
      "BootSourceOverrideTarget" : "Hdd", 
      "BootSourceOverrideEnabled" : "Once",
      "UefiTargetBootSourceOverride" : null 
   },
   "HostWatchdogTimer" : {
      "FunctionEnabled": true
   },
   "AssetTag": "asset tag",
   "IndicatorLED": "Lit"
}

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

{
    …
    "IndicatorLED": "Lit",
    "HostWatchdogTimer": {
        "WarningAction": "None",
        "WarningAction@Redfish.AllowableValues": [
            "None"
        ],
        "Status": {
            "State": "Disabled"
        },
        "FunctionEnabled": true,
        "TimeoutAction@Redfish.AllowableValues": [
            "PowerCycle"
        ],
        "TimeoutAction": "PowerCycle"
    },
    "AssetTag": "asset tag",
    "Boot": {
        "BootSourceOverrideEnabled@Redfish.AllowableValues": [
            "Once",
            "Disabled"
        ],
        "BootSourceOverrideMode": "Legacy",
        "UefiTargetBootSourceOverride": null,
        "BootSourceOverrideEnabled": "Once",
        "BootSourceOverrideTarget@Redfish.AllowableValues": [
            "None",
            "Pxe",
            "Cd",
            "Usb",
            "Hdd",
            "BiosSetup",
            "Diags",
            "UefiTarget"
        ],
        "BootSourceOverrideTarget": "Hdd"
    },
    …
}