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 上传工具。