POST – Simple update for firmware
This action can perform an update of installed software component(s) as contained within a software image file located at a URI referenced by the ImageURI parameter.
Request URL
POST https://<BMC_IPADDR>/redfish/v1/UpdateService/Actions/UpdateService.SimpleUpdate
Request body
| Parameter | Type | Description |
|---|---|---|
ImageURI | String | URI for the image file. |
Targets | String | URIs of the resource that is expected to update. That is, when you intend to update firmware for BMC (Backup), the Targets parameter must be [/redfish/v1/UpdateService/FirmwareInventory/BMC-Backup]. This is also the exclusive case to provide a value in Targets to update firmware with Redfish, and only applicable for BMC (Backup) update. In order to update other kind of firmware, the Targets is not needed or accepts null value. |
TransferProtocol | String | Network protocol used by the Service to retrieve the firmware image file. |
Username | String | User name to access an sftp server. It’s required when the image is located on an sftp server, and username:password is not available in ImageURI. |
Password | String | Password to access an sftp server. It’s required when the image is located on an sftp server, and username:password is not available in ImageURI. |
@Redfish.OperationApplyTime | String | Specify when to start to update SimpleUpdate-provided firmware. Accepted settings are
|
Response
| Field | Type | Description |
|---|---|---|
Id | String | The created task ID. |
Name | String | Task name. |
Description | String | This resource represents a task for a Redfish implementation. |
TaskMonitor | String | The URI of the Task Monitor for this task. |
StartTime | String | The date-time stamp that the task was last started. |
TaskState | String | The state of the task. |
Messages | Array | This is an array of messages associated with the task. |
PercentComplete | Integer | Task completion in percent. |
HidePayload | Boolean | Indicates Payload object is hidden and not returned on GET. |
Status code
| HTTP Status Code | Error Message ID |
|---|---|
| 202 | Accepted |
| 400 | BadRequest, ActionParamMissing , ActionParamTypeError , ActionParamFormatError |
| 419 | Conflict |
| 500 | InternalError |