GET – Virtual media properties
Use the GET method to retrieve properties in virtual media resource for Redfish service.
Request URL
GET https://<BMC_IPADDR>/redfish/v1/Managers/1/VirtualMedia/{Id}
Request body
None
Response body
| Field | Type | Description | |||
|---|---|---|---|---|---|
Id | String | This field shows the storage type with index value. The Id value will be any of (Remote1, …, Remote4), (RDOC1, RDOC2) or (EXT1, …, EXT4). | |||
Description | String | This resource is used to represent a virtual media service for a Redfish implementation | |||
Name | String | “VirtualMedia” | |||
ImageName | String | Image name | |||
Image | String | A URI providing the location of the selected image. | |||
MediaTypes | Array | The media types supported as virtual media | |||
MediaTypes[] | String | The type values for virtual disk devices. | |||
ConnectedVia | String | Current virtual media connection methods. | |||
Inserted | Boolean | Indicates the virtual media is inserted in the virtual device or not. | |||
WriteProtected | Boolean | Indicate the media is write protected | |||
UserName | String | User name | |||
Password | String | Null | |||
TransferMethod | String | “Upload” or “Stream”. | |||
TransferProtocolType | String | “HTTPS” or “NFS” or “CIFS”. For RDOC type, this property doesn’t show. | |||
Status code
| HTTP Status Code | Error Message ID |
|---|---|
| 500 | InternalError |
Example
The following example JSON response is returned:
{
"ConnectedVia": "NotConnected",
"Id": "RDOC1",
"@odata.etag": "\"3da38b2209e828a948b\"",
"MediaTypes": [
"CD",
"DVD",
"Floppy",
"USBStick"
],
"Image": null,
"@odata.id": "/redfish/v1/Managers/1/VirtualMedia/RDOC1",
"Name": "VirtualMedia",
"Password": null,
"@odata.type": "#VirtualMedia.v1_3_2.VirtualMedia",
"WriteProtected": true,
"Description": "This resource shall be used to represent a virtual media service for a Redfish implementation.",
"Inserted": false,
"ImageName": null,
"UserName": null,
"TransferMethod": null,
"TransferProtocolType": null
}