17.3. メソッド

17.3.1. 新規のテンプレートの作成

新規テンプレートの作成には、name 要素と vm 要素が必要です。vm は id 属性または name 要素で特定します。

例17.2 仮想マシンからのテンプレート作成

POST /api/templates HTTP/1.1
Accept: application/xml
Content-type: application/xml

<template>
    <name>template1</name>
    <vm id="00000000-0000-0000-0000-000000000000"/>
</template>

17.3.2. 新しいテンプレートのサブバージョンの作成

新しいテンプレートのサブバージョンを作成するには、新規テンプレートの name と vm の要素、新規テンプレートバージョンの base_template と version_name の要素が必要です。base_template とversion_name の要素は、template セクションの version セクション内に指定する必要があります。id 属性または name 要素で vm を特定します。

例17.3 仮想マシンからのテンプレートのサブバージョンの作成

POST /api/templates HTTP/1.1
Accept: application/xml
Content-type: application/xml

<template>
  <name>template1_001</name>
  <vm id="00000000-0000-0000-0000-000000000000"/>
  <version>
    <base_template id="00000000-0000-0000-0000-000000000000"/>
    <version_name>"template1_001"</version_name>
  </version>
</template>

17.3.3. テンプレートの更新

name、description、type、memory、cpu topology、os、high_availability、display、stateless、usb、timezone の要素はテンプレート作成後に更新できます。

例17.4 仮想マシンのテンプレートのメモリーを 1 GB に更新

PUT /api/templates/00000000-0000-0000-0000-000000000000 HTTP/1.1
Accept: application/xml
Content-type: application/xml

<template>
    <memory>1073741824</memory>
</template>

17.3.4. テンプレートのサブバージョンの更新

テンプレートのサブバージョンが作成されてから更新できるのは、version_name 要素のみです。

例17.5 仮想マシンのテンプレートのサブバージョン名の更新

PUT /api/templates/00000000-0000-0000-0000-000000000000 HTTP/1.1
Accept: application/xml
Content-type: application/xml

<template>
  <version>
    <version_name>template1_002</version_name>
  </version>
</template>

17.3.5. テンプレートの削除

仮想マシンテンプレートの削除には DELETE が必要です。

例17.6 仮想マシンテンプレートの削除

DELETE /api/templates/00000000-0000-0000-0000-000000000000 HTTP/1.1

HTTP/1.1 204 No Content