跳到主要内容

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”

}