Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

5.238. vms

Expand
表 5.754. 方法概述
名称概述

add

创建新虚拟机。

list

 

5.238.1. 添加 POST
复制链接

创建新虚拟机。

虚拟机可以通过不同的方式创建：

  • 模板中。在这种情况下，必须提供模板的标识符或名称。例如，使用普通 shell 脚本和 XML： 
#!/bin/sh -ex

url="https://engine.example.com/ovirt-engine/api"
user="admin@internal"
password="..."
curl \
--verbose \
--cacert /etc/pki/ovirt-engine/ca.pem \
--user "${user}:${password}" \
--request POST \
--header "Version: 4" \
--header "Content-Type: application/xml" \
--header "Accept: application/xml" \
--data '
<vm>
  <name>myvm</name>
  <template>
    <name>Blank</name>
  </template>
  <cluster>
    <name>mycluster</name>
  </cluster>
</vm>
' \
"${url}/vms"
  • 从快照中。在这种情况下，必须提供快照的标识符。例如，使用纯文本脚本和 XML： 
#!/bin/sh -ex

url="https://engine.example.com/ovirt-engine/api"
user="admin@internal"
password="..."
curl \
--verbose \
--cacert /etc/pki/ovirt-engine/ca.pem \
--user "${user}:${password}" \
--request POST \
--header "Content-Type: application/xml" \
--header "Accept: application/xml" \
--data '
<vm>
  <name>myvm</name>
  <snapshots>
    <snapshot id="266742a5-6a65-483c-816d-d2ce49746680"/>
  </snapshots>
  <cluster>
    <name>mycluster</name>
  </cluster>
</vm>
' \
"${url}/vms"

从模板创建虚拟机时，或从快照创建虚拟机时，在什么存储域中明确指明为虚拟机创建磁盘通常很有用。如果从模板创建虚拟机，则通过一组 disk_attachment 元素来实现，以指示映射： 

<vm>
  ...
  <disk_attachments>
    <disk_attachment>
      <disk id="8d4bd566-6c86-4592-a4a7-912dbf93c298">
        <storage_domains>
          <storage_domain id="9cb6cb0a-cf1d-41c2-92ca-5a6d665649c9"/>
        </storage_domains>
      </disk>
    <disk_attachment>
  </disk_attachments>
</vm>

从快照创建虚拟机时，这个磁盘集合略有不同，它使用 image_id 属性而不是 id。 

<vm>
  ...
  <disk_attachments>
    <disk_attachment>
      <disk>
        <image_id>8d4bd566-6c86-4592-a4a7-912dbf93c298</image_id>
        <storage_domains>
          <storage_domain id="9cb6cb0a-cf1d-41c2-92ca-5a6d665649c9"/>
        </storage_domains>
      </disk>
    <disk_attachment>
  </disk_attachments>
</vm>

可以在 XML 描述中指定额外的虚拟机参数，例如，桌面 类型的虚拟机，2 GiB RAM，额外描述可以添加如下请求正文： 

<vm>
  <name>myvm</name>
  <description>My Desktop Virtual Machine</description>
  <type>desktop</type>
  <memory>2147483648</memory>
  ...
</vm>

可以设置可引导 CDROM 设备，如下所示： 

<vm>
  ...
  <os>
    <boot dev="cdrom"/>
  </os>
</vm>

为了从 CDROM 引导，您首先需要插入一个磁盘，如 CDROM 服务 所述。然后，可以使用 os.boot.devices 属性指定该 CDROM 启动： 

<vm>
  ...
  <os>
    <boot>
      <devices>
        <device>cdrom</device>
      </devices>
    </boot>
  </os>
</vm>

在所有情况下，创建虚拟机的集群的名称或标识符都是强制的。

Expand
表 5.755. 参数概述
名称类型方向概述

克隆

布尔值

In

指定虚拟机是否应独立于模板。

clone_permissions

布尔值

In

指定模板的权限应复制到虚拟机。

vm

Vm

in/Out

 

5.238.1.1. 克隆
复制链接

指定虚拟机是否应独立于模板。

当默认从模板创建虚拟机时，虚拟机的磁盘取决于模板的磁盘，它们将在 写入机制上使用副本，以便只有模板的不同占用实际存储空间。如果指定了此参数，且值为 true，则创建的虚拟机的磁盘将 克隆，并独立于模板。例如，要创建独立虚拟机，请发送如下请求： 

POST /ovirt-engine/vms?clone=true

使用请求正文，如下所示： 

<vm>
  <name>myvm<name>
  <template>
    <name>mytemplate<name>
  </template>
  <cluster>
    <name>mycluster<name>
  </cluster>
</vm>
注意

当此参数为 true 时，模板的权限也会被复制，就像使用 clone_permissions=true 一样。

5.238.1.2. clone_permissions
复制链接

指定模板的权限应复制到虚拟机。

如果提供了此可选参数，其值为 true，则模板的权限（只有直接参数，而不是继承的参数）将被复制到创建的虚拟机。例如，要从 mytemplate 模板创建虚拟机复制其权限，请发送如下请求： 

POST /ovirt-engine/api/vms?clone_permissions=true

使用请求正文，如下所示： 

<vm>
  <name>myvm<name>
  <template>
    <name>mytemplate<name>
  </template>
  <cluster>
    <name>mycluster<name>
  </cluster>
</vm>
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2026 Red Hat返回顶部