6.260.2. 更新 PUT

更新有关此 CDROM 设备的信息。

它可以通过更改 file 属性的值来更改或弹出磁盘。例如，要插入或更改磁盘发送如下请求：

PUT /ovirt-engine/api/vms/123/cdroms/00000000-0000-0000-0000-000000000000

正文应包含 file 属性的新值：

<cdrom>
  <file id="mycd.iso"/>
</cdrom>

本示例中 id 属性 mycd.iso 的值应当与附加 ISO 存储域中可用的文件对应。

要弹出磁盘，请使用带有空 id 的文件 ：

<cdrom>
  <file id=""/>
</cdrom>

默认情况下，上述操作会在下一次启动后永久更改虚拟机可见的磁盘，但它们对当前运行的虚拟机没有任何影响。如果要更改当前正在运行的虚拟机可见的磁盘，请添加 current=true 参数。例如，要弹出当前磁盘发送如下请求：

PUT /ovirt-engine/api/vms/123/cdroms/00000000-0000-0000-0000-000000000000?current=true

这样的请求正文：

<cdrom>
  <file id=""/>
</cdrom>

重要

使用 current=true 参数所做的更改永远不会保留，因此在虚拟机重启后它们不会有任何影响。

表 6.809. 参数摘要
名称	类型	方向	概述
`cdrom`	cdrom	in/Out	有关 CDROM 设备的信息。
`current`	布尔值	in	指明更新应应用到当前正在运行的虚拟机，还是在下次启动后应用到虚拟机。

指明更新应应用到当前正在运行的虚拟机，还是在下次启动后应用到虚拟机。这个参数是可选的，默认值为 false，这表示默认情况下，更新仅在下一次引导后才会生效。