Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

6.63. ディスク

システムで利用可能なディスクのコレクションを管理します。

Expand
表6.192 メソッドの概要
名前Summary

add

新しいフローティングディスクを追加します。

list

ディスクのリストを取得します。

6.63.1. add POST
リンクのコピー

新しいフローティングディスクを追加します。

追加できるディスクには、ディスクイメージ、ダイレクト LUN、マネージドブロックディスクの 3 種類があります。Cinder 統合は、マネージドブロックストレージに置き換えられました。

新しいイメージディスクの追加:

新しいフローティングイメージ Disk を作成する場合、API には storage_domain、provisioned_size、および format 属性が必要です。

ブロックストレージドメイン (つまり、ストレージタイプ が iSCSI または FCP のストレージドメイン) は、raw format と sparse=true の組み合わせをサポートしていないため、sparse=false を明示的に指定する必要があることに注意してください。

ID が 123 で、増分バックアップが有効になっているストレージドメインに、provisioned_size、format、name を指定して新しいフローティングイメージディスクを作成するには、次のようにリクエストを送信します。 

POST /ovirt-engine/api/disks

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

<disk>
  <storage_domains>
    <storage_domain id="123"/>
  </storage_domains>
  <name>mydisk</name>
  <provisioned_size>1048576</provisioned_size>
  <format>cow</format>
  <backup>incremental</backup>
</disk>

新規ダイレクト LUN ディスクの追加:

API を介して新しいフローティングダイレクト LUN を追加する場合、使用できるフレーバーは 2 つあります。

  1. host 要素の場合: この場合、ホストは健全性チェック (たとえば、LUN が表示されていること) および LUN に関する基本情報 (たとえば、サイズやシリアル) を取得するために使用されます。
  2. host 要素がない場合: この場合、操作はデータベースのみの操作となり、ストレージにはアクセスされません。

ID が 123、指定された alias、type、および ID が 456 の logical_unit (属性 address、port、target を持つ) の host 要素を持つ新しいフローティングダイレクト LUN ディスクを作成するには、次のようにリクエストを送信します。 

POST /ovirt-engine/api/disks

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

<disk>
  <alias>mylun</alias>
  <lun_storage>
    <host id="123"/>
    <type>iscsi</type>
    <logical_units>
      <logical_unit id="456">
        <address>10.35.10.20</address>
        <port>3260</port>
        <target>iqn.2017-01.com.myhost:444</target>
      </logical_unit>
    </logical_units>
  </lun_storage>
</disk>

ホストを使用せずに新しい Floating ダイレクト LUN ディスクを作成するには、host 要素を削除します。

新しい Cinder ディスクを追加します。

Cinder 統合は、マネージドブロックストレージに置き換えられました。

ディスクスナップショットをアップロードするためのフローティングディスクの追加:

エンジンのバージョン 4.2 以降、スナップショットでディスクをアップロードできます。この要求は、イメージチェーンのベースイメージを作成するために使用する必要があります (連続するディスクスナップショット (イメージ) は、スナップショットを作成するときに disk-attachments 要素を使用して作成する必要があります)。

ディスクは、アップロードされたイメージと同じディスク識別子とイメージ識別子で作成する必要があります。つまり、識別子はバックアッププロセスの一部として保存する必要があります。イメージ識別子は、qemu-img info コマンドを使用して取得することもできます。たとえば、ディスクイメージが b7a4c6c5-443b-47c5-967f-6abc79675e8b/myimage.img という名前のファイルに保存されている場合: 

$ qemu-img info b7a4c6c5-443b-47c5-967f-6abc79675e8b/myimage.img
image: b548366b-fb51-4b41-97be-733c887fe305
file format: qcow2
virtual size: 1.0G (1073741824 bytes)
disk size: 196K
cluster_size: 65536
backing file: ad58716a-1fe9-481f-815e-664de1df04eb
backing file format: raw

上記の qemu-img info コマンドで取得したディスク ID とイメージ ID でディスクを作成するには、以下のように要求を送信します。 

POST /ovirt-engine/api/disks

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

<disk id="b7a4c6c5-443b-47c5-967f-6abc79675e8b">
  <image_id>b548366b-fb51-4b41-97be-733c887fe305</image_id>
  <storage_domains>
    <storage_domain id="123"/>
  </storage_domains>
  <name>mydisk</name>
  <provisioned_size>1048576</provisioned_size>
  <format>cow</format>
</disk>
Expand
表6.193 パラメーターの概要
名前型方向Summary

disk

ディスク

In/Out

ディスク。

6.63.2. list GET
リンクのコピー

ディスクのリストを取得します。 

GET /ovirt-engine/api/disks

以下のような XML 応答を取得します。 

<disks>
  <disk id="123">
    <actions>...</actions>
    <name>MyDisk</name>
    <description>MyDisk description</description>
    <link href="/ovirt-engine/api/disks/123/permissions" rel="permissions"/>
    <link href="/ovirt-engine/api/disks/123/statistics" rel="statistics"/>
    <actual_size>5345845248</actual_size>
    <alias>MyDisk alias</alias>
    ...
    <status>ok</status>
    <storage_type>image</storage_type>
    <wipe_after_delete>false</wipe_after_delete>
    <disk_profile id="123"/>
    <quota id="123"/>
    <storage_domains>...</storage_domains>
  </disk>
  ...
</disks>

返されるディスクのリストの順序は、sortby 句が search パラメーターに含まれている場合にのみ保証されます。

Expand
表6.194 パラメーターの概要
名前型方向Summary

case_sensitive

ブール値

In

search パラメーターを使用して実行する検索を、大文字と小文字を区別して実行する必要があるかどうかを示します。

disks

Disk[]

Out

取得されたディスクのリスト。

follow

String

In

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

max

Integer

In

返すディスクの最大数を設定します。

search

String

In

返されたディスクを制限するために使用されるクエリー文字列。

6.63.2.1. case_sensitive
リンクのコピー

search パラメーターを使用して実行する検索を、大文字と小文字を区別して実行する必要があるかどうかを示します。デフォルト値は true です。つまり、大文字と小文字の区別が考慮されます。ケースを無視する場合は、false に設定します。

6.63.2.2. follow
リンクのコピー

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

6.63.2.3. max
リンクのコピー

返すディスクの最大数を設定します。指定しない場合、すべてのディスクが返されます。

Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

Theme

© 2026 Red Hatトップに戻る