第16章 Floating ディスク
16.1. Floating ディスク要素
disks コレクションは、Red Hat Virtualization 環境内のすべてのディスクに関する情報を提供します。ユーザーは、任意の仮想マシンからディスクをアタッチおよび割り当て解除し、仮想マシン間でディスクを移動します。API ユーザーは、エントリーポイント URI から取得した rel="disks" リンクを使用してこの情報にアクセスします。
以下の表は、Disks リソース表現に含まれる特定の要素を示しています。
| 要素 | タイプ | 説明 | プロパティー |
|---|---|---|---|
link rel="statistics" | 関係 | 仮想マシンのディスク 統計の統計 サブコレクションへのリンク。 | 
|
image_id | GUID | 定義されたストレージドメインに保存されている仮想マシンイメージへの参照。 |
|
storage_domains | Complex | このディスクに関連付けられているストレージドメイン。各 storage_domain 要素には、関連付けられたストレージドメインの GUID を持つ id 属性が含まれます。この要素を POST で更新して、あるデータストレージドメインから別のデータストレージドメインへのディスクのライブマイグレーションを実行します。 | 
|
size | integer | ディスクのサイズ（バイト単位）。 | 
|
provisioned_size | integer | ディスクのプロビジョニングされたサイズ（バイト単位）。 |
|
actual_size | integer | ディスクの実際のサイズ（バイト単位）。 |
|
status | illegal、invalid、locked、または okのいずれか | ディスクデバイスのステータス。これらの状態は capabilities の disk_states に一覧表示されます。 |
|
interface | 列挙 | ディスクデバイスへの接続に使用されるインターフェイスドライバーのタイプ。列挙値のリストは、機能 で確認できます。 | |
format | 列挙 | 基礎となるストレージフォーマット。列挙値のリストは、機能 で確認できます。Copy On Write (COW)は、パフォーマンスのオーバーヘッドが小さいスナップショットを許可します。Raw ではスナップショットは許可されませんが、パフォーマンスが向上します。 |
|
sparse | ブール値：true または false | ディスクの物理ストレージを事前に割り当てない場合は True。 |
|
bootable | ブール値：true または false | このディスクを起動可能としてマークする場合は True。 | |
shareable | ブール値：true または false | 複数の仮想マシンとディスクを共有する場合は True。 | |
wipe_after_delete | ブール値：true または false | ディスクの削除時に、ディスクの基礎となる物理ストレージがゼロにする必要がある場合は True。 | |
propagate_errors | ブール値：true または false | ディスクエラーによって仮想マシンを一時停止してはならない場合は True。代わりに、ディスクエラーをゲスト OS に伝播する必要があります。 | |
quota id= | GUID | ディスクのクォータを設定します。 | |
lunStorage | complex | ストレージ使用のための直接 LUN マッピングへの参照。iSCSI または FCP デバイスの詳細が含まれる storage 要素が必要です。 |
|
active | ブール値 | ディスクが仮想マシンに接続されているかどうかを定義します。 |
|
重要
名前に基づくディスクの検索クエリーには、名前 ではなく
alias 検索パラメーターが必要です。