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 提供的固件。接受的设置为:
|
响应
字段 | 类型 | 描述 |
---|---|---|
Id | 字符串 | 创建的任务 ID。 |
Name | 字符串 | 任务名称。 |
Description | 字符串 | “This resource represents a task for a Redfish implementation.” |
TaskMonitor | 字符串 | 此任务的任务监控器的 URI。 |
StartTime | 字符串 | 上次启动任务的日期时间戳。 |
TaskState | 字符串 | 任务的状态。 |
Messages | 数组 | 这是与任务关联的消息数组。 |
PercentComplete | 整数 | 任务完成百分比。 |
HidePayload | 布尔 | 指示 Payload 对象为隐藏状态且不会在执行 GET 时返回。 |
状态代码
HTTP 状态代码 | 错误消息 ID |
---|---|
202 | Accepted |
400 | BadRequest、ActionParamMissing、ActionParamTypeError、ActionParamFormatError |
419 | Conflict |
500 | InternalError |