跳到主要内容

PATCH – 插入/弹出虚拟介质

使用 PATCH 方法插入或弹出虚拟介质。

注
在当前实现中：

  • 不支持插入/弹出“Remote{N}”介质。

  • 不支持插入“RDOC{N}”介质。

  • 仅支持通过协议 HTTP 或无需凭证的 NFS 插入“EXT{N}”介质。

请求 URL​

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

请求正文​

要更新的属性如下所示，所有这些属性都可以单独更改。

字段类型错误消息 ID

Image

字符串

提供所选映像的位置的 URI。设置为 null 将弹出虚拟介质。

Inserted

布尔

指示虚拟设备中是否插入虚拟介质。设置为 false 将弹出虚拟介质。

WriteProtected

布尔

指示介质是否有写保护。

UserName

字符串

用户名

Password

字符串

Null

响应​

响应返回的内容与 GET 操作相同，但更新了属性。

状态代码​

HTTP 状态代码错误消息 ID
400InsufficientPrivilege、Conflict、PropertyValueTypeError、PropertyMissing、PropertyNotWritable、SourceDoesNotSupportProtocol
500InternalError

示例​

以下示例是 PATCH 正文。

{
    "Image": "http://192.168.1.2/Core-current.iso",
    "Inserted": true,
    "WriteProtected": true,
    "UserName":"test",
    "Password":"PASSW0RD"
}

成功运行 PATCH 操作后，机箱资源查询将返回以下示例

{
    "ConnectedVia": "URI",
    "Id": "EXT1",
    "MediaTypes": [
        "CD",
        "DVD"
    ],
    "Image": "http://192.168.1.2/Core-current.iso",
    "@odata.context": "/redfish/v1/$metadata#VirtualMedia.VirtualMedia",
    "@odata.id": "/redfish/v1/Managers/1/VirtualMedia/EXT1",
    "ImageName": "Core-current.iso",
    "@odata.type": "#VirtualMedia.v1_3_0.VirtualMedia",
    "WriteProtected": true,
    "@odata.etag": "\"5fb9f3ba323469f34cf349a889ff49cf\"",
    "Inserted": true,
    "Name": "VirtualMedia",
      "Password": null,
    "Description": "This resource shall be used to represent a virtual media service for a Redfish implementation."
    "Inserted": false,
      "UserName": "test",
    "TransferMethod": “Stream”,
    "TransferProtocolType": “HTTP”

}