VirtualMedia instance

GET

/redfish/v1/Systems/{ComputerSystemId}/VirtualMedia/{VirtualMediaId}

The VirtualMedia schema contains properties related to the monitor and control of an instance of virtual media, such as a remote CD, DVD, or USB device. A manager for a system or device provides virtual media functionality.

Privilege: Login

NOTE: Virtual media is only supported on host systems, ensure that the computer system ID added is of the host system.

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

Responses

🟢200成功

application/json

The response contains a representation of the VirtualMedia resource

Bodyapplication/json

🔴500服务器错误

Request Example

Shell

JavaScript

Java

Swift

curl --location '/redfish/v1/Systems//VirtualMedia/' \
--header 'Authorization: Basic <encoded-value>'

Response Example

200 - 成功示例

{
    "@odata.context": "/redfish/v1/$metadata#VirtualMedia.VirtualMedia",
    "@odata.id": "/redfish/v1/Systems/System.Embedded.1/VirtualMedia/1",
    "@odata.type": "#VirtualMedia.v1_6_4.VirtualMedia",
    "Actions": {
        "#VirtualMedia.EjectMedia": {
            "target": "/redfish/v1/Systems/System.Embedded.1/VirtualMedia/1/Actions/VirtualMedia.EjectMedia"
        },
        "#VirtualMedia.InsertMedia": {
            "target": "/redfish/v1/Systems/System.Embedded.1/VirtualMedia/1/Actions/VirtualMedia.InsertMedia"
        }
    },
    "Certificates": {
        "@odata.id": "/redfish/v1/Systems/System.Embedded.1/VirtualMedia/1/Certificates"
    },
    "ConnectedVia": "NotConnected",
    "Description": "iDRAC Virtual Media Instance",
    "Id": "1",
    "Image": null,
    "ImageName": null,
    "Inserted": false,
    "MediaTypes": [
        "CD",
        "DVD",
        "USBStick"
    ],
    "MediaTypes@odata.count": 3,
    "Name": "VirtualMedia Instance 1",
    "Password": null,
    "TransferMethod": null,
    "TransferProtocolType": null,
    "UserName": null,
    "VerifyCertificate": false,
    "WriteProtected": null
}

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

InsertMedia Action

VirtualMedia instance