6.209. StorageDomainDisks
特定のストレージドメイン内で利用可能なディスクコレクションを管理します。
| 名前 | 概要 |
|---|---|
|
| ディスクを追加または登録します。 |
|
| ストレージドメインで利用可能なディスクの一覧を取得する。 |
6.209.1. add POST
ディスクを追加または登録します。
| 名前 | タイプ | 方向 | 概要 |
|---|---|---|---|
|
| In/Out | 追加または登録するディスク。 | |
|
| In | 新しいディスクを追加するか、または既存の登録されていないディスクを登録する必要があるかどうかを示します。 |
6.209.1.1. unregistered
新しいディスクを追加するか、または既存の登録されていないディスクを登録する必要があるかどうかを示します。値が true の場合、登録するディスクの ID を指定する必要があります。たとえば、ID 456 のディスクを登録する場合は、以下のようなリクエストを送信します。
POST /ovirt-engine/api/storagedomains/123/disks?unregistered=true
リクエスト本文は以下のようになります。
<disk id="456"/>
値が false の場合、ストレージドメインに新しいディスクが作成されます。この場合、provisioned_size 属性、format 属性、および name 属性が必須となります。たとえば、1 GiB の 書き込みディスクに新しいコピー を作成するには、次のようなリクエストを送信します。
POST /ovirt-engine/api/storagedomains/123/disks
リクエスト本文は以下のようになります。
<disk> <name>mydisk</name> <format>cow</format> <provisioned_size>1073741824</provisioned_size> </disk>
デフォルト値は false です。
このパラメーターは、Red Hat Virtualization Manager のバージョン 4.2 以降で非推奨となっています。
6.209.2. list GET
ストレージドメインで利用可能なディスクの一覧を取得する。
返されるディスク一覧の順序は保証されません。
| 名前 | タイプ | 方向 | 概要 |
|---|---|---|---|
|
| Out | 取得されたディスクの一覧。 | |
|
| In | たどる 必要のある内部リンクを指定します。 | |
|
| In | 返すディスクの最大数を設定します。 | |
|
| In | ストレージドメイン内の登録済みディスクまたは未登録ディスクのリストを取得するかどうかを示します。 |
6.209.2.1. follow
たどる 必要のある内部リンクを指定します。これらのリンクで参照されるオブジェクトは、現在の要求の一部としてフェッチされます。詳細は、こちら を参照してください。
6.209.2.2. max
返すディスクの最大数を設定します。指定されていない場合は、すべてのディスクが返されます。
6.209.2.3. unregistered
ストレージドメイン内の登録済みディスクまたは未登録ディスクのリストを取得するかどうかを示します。ストレージドメイン内の未登録ディスクのリストを取得するには、呼び出しで未登録フラグを示す必要があります。たとえば、未登録ディスクの一覧を取得するための REST API 呼び出しは、以下のようになります。
GET /ovirt-engine/api/storagedomains/123/disks?unregistered=true
未登録フラグのデフォルト値は false です。リクエストは、アタッチされているストレージドメインにのみ適用されます。
