6.244. テンプレート

新しいテンプレートを作成します。

これには、name 要素と vm 要素が必要です。仮想マシンを識別するには、vm.id または vm.name 属性を使用します。たとえば、識別子が 123 の仮想マシンからテンプレートを作成するには、以下のようなリクエストを送信します。

POST /ovirt-engine/api/templates

リクエスト本文は以下のようになります。

<template>
  <name>mytemplate</name>
  <vm id="123"/>
</template>

バージョン 4.3 以降、スナップショットから仮想マシンテンプレートを作成するには、以下のようなリクエスト本文を送信します。

<template>
  <name>mytemplate</name>
  <vm id="123">
    <snapshots>
      <snapshot id="456"/>
    </snapshots>
  </vm>
</template>

テンプレートのディスクをカスタマイズして、元の仮想マシンのディスクとは異なる特性を作成できます。これを行うには、vm.disk_attachments 属性を使用し、元の仮想マシンのディスクの識別子と変更する特性を指定します。たとえば、元の仮想マシンに識別子 456 のディスクがあり、そのディスクの名前を mydisk に、フォーマットを Copy On Write に変更して sparse にする場合は、次のようなリクエスト本文を送信します。

<template>
  <name>mytemplate</name>
  <vm id="123">
    <disk_attachments>
      <disk_attachment>
        <disk id="456">
          <name>mydisk</name>
          <format>cow</format>
          <sparse>true</sparse>
        </disk>
      </disk_attachment>
    </disk_attachments>
  </vm>
</template>

テンプレートは、既存テンプレートのサブバージョンとして作成できます。これには、新しいテンプレートの name および vm 属性と、新しいテンプレートバージョンの base_template および version_name 属性が必要です。base_template および version_name 属性は、template セクションにある version セクション内で指定する必要があります。id または name 属性で仮想マシンを識別します。

<template>
  <name>mytemplate</name>
  <vm id="123"/>
  <version>
    <base_template id="456"/>
    <version_name>mytemplate_001</version_name>
  </version>
</template>

テンプレートの宛先ストレージドメインは、次の 2 つのいずれかの方法でカスタマイズできます。

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

<template>
  <name>mytemplate<name>
  <vm>
    <name>myvm<name>
  </vm>
</template>

仮想マシンテンプレートの一覧を返します。

以下はその例です。

GET /ovirt-engine/api/templates

仮想マシンと仮想マシンテンプレートの一覧を返します。

返されるテンプレート一覧の順序は保証されません。