6.63. ディスク
システムで利用可能なディスクのコレクションを管理します。
名前 | Summary |
---|---|
| 新しいフローティングディスクを追加します。 |
| ディスクのリストを取得します。 |
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
POST /ovirt-engine/api/disks
リクエスト本文の場合は、以下のようになります。
新規ダイレクト LUN ディスクの追加:
API を介して新しいフローティングダイレクト LUN を追加する場合、使用できるフレーバーは 2 つあります。
-
host
要素の場合: この場合、ホストは健全性チェック (たとえば、LUN が表示されていること) および LUN に関する基本情報 (たとえば、サイズやシリアル) を取得するために使用されます。 -
host
要素がない場合: この場合、操作はデータベースのみの操作となり、ストレージにはアクセスされません。
ID が 123
、指定された alias
、type
、および ID が 456
の logical_unit
(属性 address
、port
、target
を持つ) の host
要素を持つ新しいフローティングダイレクト LUN ディスクを作成するには、次のようにリクエストを送信します。
POST /ovirt-engine/api/disks
POST /ovirt-engine/api/disks
リクエスト本文の場合は、以下のようになります。
ホストを使用せずに新しい Floating ダイレクト LUN ディスクを作成するには、host
要素を削除します。
新しい Cinder ディスクを追加します。
Cinder 統合は、マネージドブロックストレージに置き換えられました。
ディスクスナップショットをアップロードするためのフローティングディスクの追加:
エンジンのバージョン 4.2 以降、スナップショットでディスクをアップロードできます。この要求は、イメージチェーンのベースイメージを作成するために使用する必要があります (連続するディスクスナップショット (イメージ) は、スナップショットを作成するときに disk-attachments
要素を使用して作成する必要があります)。
ディスクは、アップロードされたイメージと同じディスク識別子とイメージ識別子で作成する必要があります。つまり、識別子はバックアッププロセスの一部として保存する必要があります。イメージ識別子は、qemu-img info
コマンドを使用して取得することもできます。たとえば、ディスクイメージが b7a4c6c5-443b-47c5-967f-6abc79675e8b/myimage.img
という名前のファイルに保存されている場合:
上記の qemu-img info
コマンドで取得したディスク ID とイメージ ID でディスクを作成するには、以下のように要求を送信します。
POST /ovirt-engine/api/disks
POST /ovirt-engine/api/disks
リクエスト本文の場合は、以下のようになります。
名前 | 型 | 方向 | Summary |
---|---|---|---|
| In/Out | ディスク。 |
6.63.2. list GET リンクのコピーリンクがクリップボードにコピーされました!
ディスクのリストを取得します。
GET /ovirt-engine/api/disks
GET /ovirt-engine/api/disks
以下のような XML 応答を取得します。
返されるディスクのリストの順序は、sortby
句が search
パラメーターに含まれている場合にのみ保証されます。
名前 | 型 | 方向 | Summary |
---|---|---|---|
| In |
| |
| Out | 取得されたディスクのリスト。 | |
| In | たどる 必要のある内部リンクを指定します。 | |
| In | 返すディスクの最大数を設定します。 | |
| In | 返されたディスクを制限するために使用されるクエリー文字列。 |
6.63.2.1. case_sensitive リンクのコピーリンクがクリップボードにコピーされました!
search
パラメーターを使用して実行する検索を、大文字と小文字を区別して実行する必要があるかどうかを示します。デフォルト値は true
です。つまり、大文字と小文字の区別が考慮されます。ケースを無視する場合は、false
に設定します。
6.63.2.2. follow リンクのコピーリンクがクリップボードにコピーされました!
たどる 必要のある内部リンクを指定します。これらのリンクで参照されるオブジェクトは、現在の要求の一部としてフェッチされます。詳細は、こちら を参照してください。
6.63.2.3. max リンクのコピーリンクがクリップボードにコピーされました!
返すディスクの最大数を設定します。指定しない場合、すべてのディスクが返されます。