15.6.4. CD-ROMs Sub-Collection
cdroms
子集合表示虚拟机上的 CD-ROM 设备。cdrom
表示包含以下元素:
元素 | 类型 | Description | Properties |
---|---|---|---|
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 仅使用
PUT
请求和其他当前 URI 参数更改 当前会话
的 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
matrix 参数:
例 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 设备。