InsertMedia Action

POST

/redfish/v1/Systems/{ComputerSystemId}/VirtualMedia/{VirtualMediaId}/Actions/VirtualMedia.InsertMedia

This action attaches remote media to virtual media.

Important Notes:

HTTP shares with authentication are not supported for virtual media.

Using the character '@' in virtual media UserName, Password, or Image is not supported.

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.

While performing this action, if TransferProtocolType property is set to CIFS, then avoid specifying the method for the Image property in the payload.

Request

Authorization

Basic Auth

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

API Key

Add parameter in header

X-Auth-Token

Example:

X-Auth-Token: ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200成功

application/json

The response contains the results of the InsertMedia action

Bodyapplication/json

🟢201成功

🟢202成功

🟢204删除成功

🟠400请求有误

🟠403禁止访问

🔴500服务器错误

Request Example

Shell

JavaScript

Java

Swift

curl --location '/redfish/v1/Systems//VirtualMedia//Actions/VirtualMedia.InsertMedia' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '{
    "Image": "<imagefile.iso>",
    "Password": "password",
    "UserName": "username"
}'

Response Example

200 - Example 1

{
    "error": {
        "@Message.ExtendedInfo": [
            {}
        ],
        "code": "string",
        "message": "string"
    }
}

Modified at 2026-03-04 06:03:53

EjectMedia Action

MessageRegistryFileCollection instance