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

API Key

Add parameter in header

X-Auth-Token

Example:

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

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 *****************

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 'X-Auth-Token: <api-key>' \
--header 'Authorization: Basic <encoded-value>'

Response Example

200 - 成功示例

{
    "@odata.context": "/redfish/v1/$metadata#VirtualMedia.VirtualMedia",
    "@odata.etag": "W/\"gen-2\"",
    "@odata.id": "/redfish/v1/Systems/System.Embedded.1/VirtualMedia/2",
    "@odata.type": "#VirtualMedia.v1_6_5.VirtualMedia",
    "Actions": {
        "#VirtualMedia.EjectMedia": {
            "target": "/redfish/v1/Systems/System.Embedded.1/VirtualMedia/2/Actions/VirtualMedia.EjectMedia"
        },
        "#VirtualMedia.InsertMedia": {
            "TransferMethod@Redfish.AllowableValues": [
                "Stream"
            ],
            "TransferProtocolType@Redfish.AllowableValues": [
                "CIFS",
                "HTTP",
                "HTTPS",
                "NFS"
            ],
            "target": "/redfish/v1/Systems/System.Embedded.1/VirtualMedia/2/Actions/VirtualMedia.InsertMedia"
        }
    },
    "Certificates": {
        "@odata.id": "/redfish/v1/Systems/System.Embedded.1/VirtualMedia/2/Certificates"
    },
    "ConnectedVia": "NotConnected",
    "Description": "iDRAC Virtual Media Instance. This instance will be mapped as 'Virtual Network File 2' in System Bios Bootoptions",
    "Id": "2",
    "Image": null,
    "ImageName": null,
    "Inserted": false,
    "MediaTypes": [
        "CD",
        "DVD",
        "USBStick"
    ],
    "MediaTypes@odata.count": 3,
    "Name": "VirtualMedia Instance 2",
    "Password": null,
    "TransferMethod": null,
    "TransferProtocolType": null,
    "UserName": null,
    "VerifyCertificate": false,
    "WriteProtected": null
}

Modified at 2026-03-04 06:02:26

Volume instance

VirtualMedia instance