iDRAC9 Redfish API Guide Firmware version: 4.20.20.20

Supported Action — InsertMedia

Description

This action is used to attach remote media to virtual media.

URL

/redfish/v1/Managers/<Manager-Id>/VirtualMedia/<VirtualMedia-Id>/Actions/VirtualMedia.InsertMedia

Supported HTTP Method and Privileges

This table provides details about the supported HTTP methods and privileges for the resource.
HTTP method	Required privilege
GET	Login
POST	ConfigureManager, Login

Supported Parameters

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

NOTE From iDRAC firmware version 4.20.20.20 release onwards, Redfish supports inserting Username, Password, and Share name as separate fields in the payload while performing the action. Firmware backward compatibility allows you to continue using the previous supported method that is by inserting the credentials in the payload in the format <username>:<Password>@<share name>. In the latest version of iDRAC, if both these methods are used then the information that is provided in separate fields take precedence over the previous supported method.


Parameter	Type	Description
Image*	String	The URI of the remote media to attach to the virtual media.
Inserted	Boolean	Indicates if the image is to be treated as inserted upon completion of the action.
WriteProtected	Boolean	Indicates if the remote media is supposed to be treated as write protected.

Supported Status codes

This table provides details about the HTTP status codes returned by the resource and extended information about the codes.
HTTP Status Code	Extended information	Error code
200	Base.1.5.Success
400	Base.1.5 MalformedJSON, Base.1.5. PropertyValueFormatError, Base.1.5. PropertyMissing	SYS405, SYS453, SYS458, RAC0720, RAC0904
403	Base.1.5.InsufficientPrivilege	RAC0506, LIC501
500	Base.1.5.InternalError	VRM0012

Welcome

Welcome to Dell