6.63. ディスク

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

追加できるディスクには、ディスクイメージ、ダイレクト 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 つあります。

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>

ディスクの一覧を取得します。

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 パラメーターに含まれている場合にのみ保証されます。