6.56. ディスク

ディスクフォーマットや事前割り当てモードを変換します。

たとえば、ディスク形式を preallocated-cow から sparse-raw イメージに変換するには、以下のようなリクエストを送信します。

POST /ovirt-engine/api/disks/123/convert

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

 <action>
   <disk>
     <sparse>true</sparse>
     <format>raw</format>
   </disk>
 </action>

注: ディスクをスパース化するには、ディスクがブロックストレージドメイン上にある場合、変換が 2 回必要になることがあります。例: ディスクが RAW の場合、QCOW に変換するとディスクが大きくなります。サイズを小さくするために、ディスクを再度 QCOW に変換し、同じ割り当てポリシーを維持することができます。

この操作により、指定されたストレージドメインにディスクをコピーします。

たとえば、以下の要求を使用してディスクをコピーすることができます。

POST /ovirt-engine/api/disks/123/copy

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

<action>
  <storage_domain id="456"/>
  <disk>
    <name>mydisk</name>
  </disk>
</action>

ディスクプロファイルまたは現在ディスクが使用しているクォータが新規ストレージドメインに定義されていない場合は、明示的に指定できます。これらが指定されていない場合、最初に利用可能なディスクプロファイルとデフォルトのクォータが使用されます。

たとえば、ディスクプロファイル 987 とクォータ 753 を指定するには、以下のようなリクエスト本文を送信します。

<action>
  <storage_domain id="456"/>
  <disk_profile id="987"/>
  <quota id="753"/>
</action>

POST /ovirt-engine/api/storagedomains/123/disks/789

<action>
  <storage_domain>
    <name>mydata</name>
  </storage_domain>
</action>

ディスクをエクスポートストレージドメインにエクスポートします。

ディスクの説明を取得します。

GET /ovirt-engine/api/disks/123?all_content=true

ディスクを別のストレージドメインに移動します。

たとえば、識別子 123 のディスクを、識別子 456 が指定されたストレージドメインに移動するには、以下のリクエストを送信します。

POST /ovirt-engine/api/disks/123/move

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

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

ディスクプロファイルまたはディスクで現在使用されているクォータが新しいストレージドメインに対して定義されていない場合は、それらを明示的に指定できます。そうでない場合は、最初に使用可能なディスクプロファイルとデフォルトのクォータが使用されます。

たとえば、ディスクプロファイル 987 とクォータ 753 を明示的に使用するには、次のようなリクエスト本文を送信します。

<action>
  <storage_domain id="456"/>
  <disk_profile id="987"/>
  <quota id="753"/>
</action>

ディスクイメージのサイズを縮小します。

論理ボリュームで 縮小 を呼び出します (つまり、ブロックストレージドメインにのみ適用されます)。これは、フローティングディスクおよび実行されていない仮想マシンに接続されているディスクに適用されます。最適なサイズは自動的に算出されるため、サイズを指定する必要はありません。

ストレージの最新情報で直接 LUN ディスクを更新します。

直接 LUN ディスクの更新は、以下の場合に役に立ちます。

ホスト 456 を使用して直接 LUN ディスク 123 を更新するには、以下の要求を送信します。

POST /ovirt-engine/api/disks/123/refreshlun

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

<action>
  <host id='456'/>
</action>

ディスクを削除します。

ディスクをスパース化します。

Sparsification は、ファイルシステムで使用されていないディスクイメージのスペースを解放します。その結果、イメージはストレージの領域を減らします。

現在、スパース化はスナップショットのないディスクでのみ機能します。派生ディスクを持つディスクも許可されていません。

指定されたディスクのパラメーターを更新します。

この操作により、次のフローティングディスクのプロパティーを更新できます。

たとえば、ディスクの更新は、次の要求を使用して実行できます。

PUT /ovirt-engine/api/disks/123

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

<disk>
  <qcow_version>qcow2_v3</qcow_version>
  <alias>new-alias</alias>
  <description>new-desc</description>
</disk>

バックエンド操作は非同期であるため、ユーザーに返されるディスク要素は、変更されたプロパティーと同期されない場合があります。