15.7. Actions
15.7.1. 启动虚拟机操作
start 操作将启动已停止、关闭或暂停的虚拟机。
例 15.46. 启动虚拟机的操作
POST /ovirt-engine/api/vms/5114bb3e-a4e6-44b2-b783-b3eea7d84720/start HTTP/1.1 Accept: application/xml Content-type: application/xml <action/>
start 操作允许提供
vm
元素作为参数。如果提供了 vm
元素,虚拟机将使用提供的元素中的值,并在启动时覆盖系统设置。在 REST API 中将 start 操作与 vm
元素一起使用等同于在管理门户或用户门户中使用 Run Once 窗口。这些设置会保留,直到用户停止虚拟机。这些元素的示例包括 os
、domain
、placement_policy
、cdroms
、stateless
和 display 类型
。
例 15.47. 使用覆盖参数启动虚拟机的操作
POST /ovirt-engine/api/vms/5114bb3e-a4e6-44b2-b783-b3eea7d84720/start HTTP/1.1 Accept: application/xml Content-type: application/xml <action> <pause>true</pause> <vm> <stateless>true</stateless> <display> <type>spice</type> </display> <os> <boot dev="cdrom"/> </os> <cdroms> <cdrom> <file id="windows-xp.iso"/> </cdrom> </cdroms> <floppies> <floppy> <file id="virtio-win_x86.vfd"/> </floppy> </floppies> <domain> <name>domain.example.com</name> <user> <user_name>domain_user</user_name> <password>domain_password</password> </user> </domain> <placement_policy> <host id="02447ac6-bcba-448d-ba2b-f0f453544ed2"/> </placement_policy> </vm> </action>
注意
domain
元素仅用于 Windows 系统,用于启动时使用start
操作覆盖参数。domain
元素决定 Windows 虚拟机加入的域。如果域集合中不存在域
,此元素需要额外的用户身份验证详细信息,包括user
_name和密码
。如果域集合中存在域
,则操作不需要额外的用户身份验证
详情。- CD 镜像和软盘文件必须已经在 ISO 域中可用。如果没有,使用 ISO uploader 工具上传文件。如需更多信息,请参阅 ISO 上传工具。