検索

6.229. Template

download PDF

仮想マシンのテンプレートとテンプレートのバージョンを管理します。

表6.695 メソッドの概要
名前概要

export

テンプレートをデータセンターのエクスポートドメインにエクスポートします。

get

このテンプレートまたはテンプレートバージョンに関する情報を返します。

remove

仮想マシンテンプレートを削除します。

update

テンプレートを更新します。

6.229.1. export POST

テンプレートをデータセンターのエクスポートドメインにエクスポートします。

たとえば、以下のリクエストを送信します。

POST /ovirt-engine/api/templates/123/export

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

<action>
  <storage_domain id="456"/>
  <exclusive>true<exclusive/>
</action>

エンジンのバージョン 4.2 以降、テンプレートを仮想アプライアンス (OVA) としてエクスポートすることも可能となっています。たとえば、テンプレート 123 を、ホスト myhost のディレクトリー /home/ovirt/ に配置される myvm.ova という名前の OVA ファイルとしてエクスポートするには、次のようにします。

POST /ovirt-engine/api/templates/123/export

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

<action>
  <host>
    <name>myhost</name>
  </host>
  <directory>/home/ovirt</directory>
  <filename>myvm.ova</filename>
</action>
表6.696 パラメーターの概要
名前タイプ方向概要

exclusive

Boolean

In

同じ名前の既存のテンプレートを上書きする必要があるかどうかを示します。

storage_domain

StorageDomain

In

宛先のエクスポートストレージドメインを指定します。

6.229.1.1. exclusive

同じ名前の既存のテンプレートを上書きする必要があるかどうかを示します。

宛先ドメインに同じ名前のテンプレートが存在する場合、エクスポートアクションは失敗したアクションを報告します。このパラメーターを true に設定すると、この動作が変更され、既存のテンプレートがすべて上書きされます。

6.229.2. get GET

このテンプレートまたはテンプレートバージョンに関する情報を返します。

表6.697 パラメーターの概要
名前タイプ方向概要

filter

Boolean

In

ユーザーのパーミッションにしたがって、結果をフィルターする必要があるかどうかを示します。

follow

文字列

In

たどる 必要のある内部リンクを指定します。

template

Template

Out

テンプレートまたはテンプレートバージョンに関する情報。

6.229.2.1. follow

たどる 必要のある内部リンクを指定します。これらのリンクで参照されるオブジェクトは、現在の要求の一部としてフェッチされます。詳細は、こちら を参照してください。

6.229.3. remove DELETE

仮想マシンテンプレートを削除します。

DELETE /ovirt-engine/api/templates/123
表6.698 パラメーターの概要
名前タイプ方向概要

async

Boolean

In

削除を非同期的に実行するかどうかを指定します。

6.229.4. update PUT

テンプレートを更新します。

namedescriptiontypememorycputopologyoshigh_availabilitydisplaystatelessusb、および timezone 要素は、テンプレートの作成後に更新できます。

たとえば、1 GiB のメモリーを持つようにテンプレートを更新するには、次のようなリクエストを送信します。

PUT /ovirt-engine/api/templates/123

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

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

version_name name 属性は、テンプレートバージョンに使用される version 属性内で更新できる唯一の属性です。

<template>
  <version>
    <version_name>mytemplate_2</version_name>
  </version>
</template>
表6.699 パラメーターの概要
名前タイプ方向概要

async

Boolean

In

更新を非同期的に実行するかどうかを指定します。

template

Template

In/Out

 
Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

© 2024 Red Hat, Inc.