跳到主要内容

POST – 固件的简单更新

此操作可以更新软件映像文件(位于 ImageURI 参数引用的 URI 中)包含的已安装软件组件。

请求 URL

POST https://<BMC_IPADDR>/redfish/v1/UpdateService/Actions/UpdateService.SimpleUpdate

请求正文

参数类型描述

ImageURI

字符串

映像文件的 URI。

Targets

字符串

待更新资源的 URI。

即当您需要更新 BMC(备用)的固件时,Targets 参数必须为 [/redfish/v1/UpdateService/FirmwareInventory/BMC-Backup]。这也是通过在 Targets 中提供值来使用 Redfish 进行固件更新的例外情况,仅适用于 BMC(备用)更新。为了更新其他类型的固件,不需要 Targets 参数或此参数接受 null 值。

TransferProtocol

字符串

此服务用于检索固件映像文件的网络协议。

Username

字符串

用于访问 sftp 服务器的用户名。当映像位于 sftp 服务器上,并且 username:password 在 ImageURI 中不可用时,此参数是必需的。

Password

字符串

用于访问 sftp 服务器的密码。当映像位于 sftp 服务器上,并且 username:password 在 ImageURI 中不可用时,此参数是必需的。

@Redfish.OperationApplyTime

字符串
指定何时开始更新 SimpleUpdate 提供的固件。接受的设置为:
  • “Immediate”

  • “OnStartUpdateRequest”

响应

字段类型描述

Id

字符串

创建的任务 ID。

Name

字符串

任务名称。

Description

字符串

“This resource represents a task for a Redfish implementation.”

TaskMonitor

字符串

此任务的任务监控器的 URI。

StartTime

字符串

上次启动任务的日期时间戳。

TaskState

字符串

任务的状态。

Messages

数组

这是与任务关联的消息数组。

PercentComplete

整数

任务完成百分比。

HidePayload

布尔

指示 Payload 对象为隐藏状态且不会在执行 GET 时返回。

状态代码

HTTP 状态代码错误消息 ID
202Accepted
400BadRequest、ActionParamMissing、ActionParamTypeError、ActionParamFormatError
419Conflict
500InternalError