iDRAC9 Redfish API Guide Firmware version: 4.20.20.20

PDF

Supported action — SimpleUpdate

Description

This resource is used to represent extension of the UpdateService schema of Redfish.

You can use the this action to update only one component at a time. If you attempt to update multiple components at once, error SYS442 is returned. To update multiple components, perform the updates one at a time.

If you use this action to update iDRAC, the update is applied immediately and the system reboots. For other components, the update is applied at the next reboot.

URL

/redfish/v1/UpdateService/Actions/UpdateService.SimpleUpdate

HTTP methods and privileges

Table 1. HTTP methods and privileges for SimpleUpdate This table provides details about the supported HTTP methods and privileges for the action.
HTTP method	Required privilege
POST	.d9 file type — ConfigureComponents, Login .pm file type — ConfigureComponents, Login .exe file type — ConfigureComponents, Login

Supported Parameters

NOTE A star (*) indicates a required parameter, else the parameter is optional.


Parameter	Type	Description
ImageURI*	String	The URI of the software image to install.
Password	String	The password to access the URI specified by the ImageURI parameter.
Targets	String	An array of URIs that indicate where to apply the update image.
TransferProtocol	String	The network protocol that the Update Service uses to retrieve the software image file located at the URI provided in ImageURI, if the URI does not contain a scheme.
Username	String	The user name to access the URI specified by the ImageURI parameter.

Status codes

Table 2. Status codes for SimpleUpdateThis table provides details about the HTTP status codes returned by the action and extended information about the codes.
HTTP status code	Extended information	Error Message Code
202		SYS408
400		SYS406 OSD35 RAC0604 SYS434 SUP019 SUP024 SYS442
400	Base.1.2.InternalError Base.1.2.PropertyMissing Base.1.2.PropertyValueTypeError Base.1.2.PropertyValueNotInList	SYS446
400	Base.1.2.MalformedJSON	SYS405
403	InsufficientPrivilege	RAC0506
403		LIC501
404	Base.1.2. ResourceMissingAtURI	SYS403
405		SYS402
500	Base.1.2.InternalError	SYS446 SUP1907
503		SUP0108