6.260. VmCdrom

この CDROM デバイスに関する情報を返します。

この情報は、CDROM デバイス、仮想マシン、およびオプションで挿入されたディスクへの参照を含む cdrom 属性で設定されます。

ディスクが挿入されている場合は、file 属性には ISO イメージへの参照が含まれます。

<cdrom href="..." id="00000000-0000-0000-0000-000000000000">
  <file id="mycd.iso"/>
  <vm href="/ovirt-engine/api/vms/123" id="123"/>
</cdrom>

ディスクが挿入されていない場合は、file 属性は報告されません。

<cdrom href="..." id="00000000-0000-0000-0000-000000000000">
  <vm href="/ovirt-engine/api/vms/123" id="123"/>
</cdrom>

この 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 を持つ file を使用します。

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

デフォルトでは、上記の操作は次回の起動後に仮想マシンに表示されるディスクを永続的に変更しますが、現在実行中の仮想マシンには影響しません。現在実行中の仮想マシンに表示されるディスクを変更する場合は、current=true パラメーターを追加します。たとえば、現在のディスクを取り出すには、次のようなリクエストを送信します。

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

リクエスト本文は以下のようになります。

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