Skip to main content

PATCH – Insert/Eject a virtual media

Use the PATCH method to insert or eject a virtual media.

Note
In current implementation:
  • Insert/Eject “Remote{N}” mediais not supported .

  • Insert “RDOC{N}” media is not supported.

  • Only support insert “EXT{N}” media via protocol HTTP, HTTPS, NFS or CIFS.

Request URL

PATCH https://<BMC_IPADDR>/redfish/v1/Systems/1/VirtualMedia/{id}

Request body

Properties to be updated are shown as bellow, all of these properties can be changed individually.

FieldTypeDescription

Image

String

A URI providing the location of the selected image. Set to null to eject the virtual media.

Inserted

Boolean

Indicate if virtual media is inserted in the virtual device. Set to false to eject the virtual media.

WriteProtected

Boolean

Indicate the media is write protected.

UserName

String

User name.

Password

String

null

VerifyCertificate

Boolean

If false, the service will not check certificate from remote HTTPS server.

Response

The response returns same content as GET operation with updated properties.

Status code

HTTP Status CodeError Message ID
400InsufficientPrivilege, Conflict, PropertyValueTypeError, PropertyMissing, PropertyNotWritable, SourceDoesNotSupportProtocol
500InternalError