15.6.4. CD-ROMs サブコレクション
cdroms サブコレクションは、仮想マシン上の CD-ROM デバイスを表します。cdrom 表現には以下の要素が含まれます。
| 要素 | タイプ | 説明 | プロパティー |
|---|---|---|---|
file id= | string/filename | ISO イメージへの参照。 |
例15.33 CD-ROM デバイスの XML 表現
<cdrom id="00000000-0000-0000-0000-000000000000"
href="/ovirt-engine/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/cdroms/
00000000-0000-0000-0000-000000000000">
<file id="rhel-server-6.0-x86_64-dvd.iso"/>
<vm id="cdc0b102-fbfe-444a-b9cb-57d2af94f401"
href="/ovirt-engine/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401"/>
</cdrom>
file id 要素を使用して PUT 要求を送信し、新しい CD-ROM リソースを追加します。
例15.34 新規 CD-ROM ファイルの追加
PUT /ovirt-engine/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/cdroms/00000000-0000-0000-0000-000000000000 HTTP/1.1
Accept: application/xml
Content-type: application/xml
<cdrom>
<file id="fedora-15-x86_64-dvd.iso"/>
</cdrom>
API は、
PUT 要求を使用して CD-ROM を変更します。
例15.35 CD-ROM ファイルの変更
PUT /ovirt-engine/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/cdroms/00000000-0000-0000-0000-000000000000 HTTP/1.1
Accept: application/xml
Content-type: application/xml
<cdrom>
<file id="fedora-15-x86_64-dvd.iso"/>
</cdrom>
API は、追加の現在の URI 引数と共に
PUT リクエストを使用してのみ、現行セッションの CD-ROM を変更します。
例15.36 現行セッションでの CD-ROM ファイルの変更
PUT /ovirt-engine/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/cdroms/00000000-0000-0000-0000-000000000000;current=true HTTP/1.1
Accept: application/xml
Content-type: application/xml
<cdrom>
<file id="fedora-15-x86_64-dvd.iso"/>
</cdrom>
CD-ROM を一時的に取り除くには、仮想マシンの
cdroms サブコレクションに PUT リクエストを送信し、current=true マトリックスパラメーターを追加します。
例15.37 現行セッション中の CD-ROM ファイルの取り出し
PUT /ovirt-engine/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/cdroms/00000000-0000-0000-0000-000000000000;current=true HTTP/1.1
Accept: application/xml
Content-type: application/xml
<cdrom>
<file id=""/>
</cdrom>
注記
仮想マシンを再起動すると、CD-ROM が再び接続されます。
CD-ROM を永続的に取り込むには、仮想マシンの
cdroms サブコレクションに PUT リクエストを送信します。
例15.38 CD-ROM ファイルの永続的な取り出し
PUT /ovirt-engine/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/cdroms/00000000-0000-0000-0000-000000000000 HTTP/1.1
Accept: application/xml
Content-type: application/xml
<cdrom>
<file id=""/>
</cdrom>
注記
仮想マシンには、単一の CD-ROM デバイスのみが含まれます。