跳到主要内容

GET – 虚拟介质属性

使用 GET 方法检索 Redfish 服务的虚拟介质资源中的属性。

请求 URL​

GET https://<BMC_IPADDR>/redfish/v1/Systems/1/VirtualMedia/Id

请求正文​

无

响应正文​

字段类型描述

Id

字符串

此字段显示具有索引值的存储类型。

Id 值将是（Remote1、...、Remote4）、（RDOC1、RDOC2）或（EXT1、...、EXT4）中的任意值。

Description

字符串

“This resource is used to represent a virtual media service for a Redfish implementation”

Name

字符串

已展开。

Action

对象

VirtualMedia

 

#VirtualMedia.EjectMedia

对象

弹出 RDOC 介质的操作

 

#VirtualMedia.InsertMedia

对象

插入 RDOC 介质的操作

  

Image

字符串

必需。此参数应包含要附加到虚拟介质的介质 URI。目前支持的协议：SFTP、CIFS、NFS、HTTP 和 HTTPS。目前最多支持安装 2 个 RDOC 映像，RDOC 镜像总大小为 100 MB。

注
源 URL 的值必须添加协议前缀。HTTP 协议前缀为“http://”（因此 HTTP 的完整源 URL 应类似于“http://10.10.10.10/path/to/test.iso”），SAMBA 协议前缀为“smb://”，NFS 协议前缀为“nfs://”，SFTP 协议前缀为“sftp://”，FTP 协议前缀为“ftp://”。
  

UserName

字符串

可选。此参数应包含访问 Image 参数指定的 URI 时所需的用户名。

  

Password

字符串

可选。此参数应包含访问 Image 参数指定的 URI 时所需的密码。

  

WriteProtected

布尔

可选。此参数应包含远程介质是否被视为有写保护。

  

Domain

字符串

可选。Samba 协议的域值。

ImageName

字符串

映像名称。

Image

字符串

提供所选映像的位置的 URI。

MediaTypes

数组

支持作为虚拟介质的介质类型。

MediaTypes[]

字符串

虚拟磁盘设备的类型值。

ConnectedVia

字符串

当前虚拟介质连接方法。

Inserted

布尔

指示虚拟介质是否已插入虚拟设备。

WriteProtected

布尔

指示介质是否有写保护

UserName

字符串

用户名

Password

字符串

null

TransferMethod

字符串

“Upload”或“Stream”。

TransferProtocolType

字符串

“HTTPS”、“NFS”或“CIFS”。对于 RDOC 类型，不显示此属性。

VerifyCertificate

布尔

指示是否执行证书验证。默认值为 false。

Status

对象

已展开。

 

State

字符串

  • 如果安装了虚拟机，则为“Enabled”。

  • 如果未安装，则为“Absent”。

 

Health

字符串

OK

状态代码​

HTTP 状态代码错误消息 ID
500InternalError

示例​

返回以下示例 JSON 响应：

{
    "@odata.context": "/redfish/v1/$metadata#VirtualMedia.VirtualMedia",
    "@odata.etag": "\"A442E1B6\"",
    "@odata.id": "/redfish/v1/Systems/1/VirtualMedia/EXT1",
    "@odata.type": "#VirtualMedia.v1_4_0.VirtualMedia",
    "ConnectedVia": "NotConnected",
    "Description": "This resource shall be used to represent a virtual media                     service for a Redfish implementation.",
    "Id": "EXT1",
    "Image": null,
    "ImageName": null,
    "Inserted": false,
    "MediaTypes": [
        "CD",
        "DVD",
        "USBStick"
    ],
    "Name": "Virtual Media",
    "Oem": {
        ...
        }
    },
    "Password": null,
    "Status": {
        "Health": "OK",
        "State": "Absent"
    },
    "TransferMethod": "Stream",
    "UserName": null,
    "VerifyCertificate": true,
    "WriteProtected": true
}