6.217. StorageDomainVms
エクスポートストレージドメインの仮想マシンを一覧表示します。
たとえば、識別子が 123 のストレージドメインで利用可能な仮想マシンを取得するには、以下のリクエストを送信します。
GET /ovirt-engine/api/storagedomains/123/vms
これにより、以下のレスポンス本文が返されます。
<vms>
<vm id="456" href="/api/storagedomains/123/vms/456">
<name>vm1</name>
...
<storage_domain id="123" href="/api/storagedomains/123"/>
<actions>
<link rel="import" href="/api/storagedomains/123/vms/456/import"/>
</actions>
</vm>
</vms>これらのコレクションの仮想マシンとテンプレートは、StorageDomain 参照と インポート アクションも含まれていることを除き、最上位の Vm コレクションと Template コレクションの対応するものと同様の表現をしています。
| 名前 | 概要 |
|---|---|
|
| エクスポートストレージドメインの仮想マシンの一覧を返します。 |
6.217.1. list GET
エクスポートストレージドメインの仮想マシンの一覧を返します。
返される仮想マシン一覧の順序は保証されません。
| 名前 | タイプ | 方向 | 概要 |
|---|---|---|---|
|
| In | たどる 必要のある内部リンクを指定します。 | |
|
| In | 返す仮想マシンの最大数を設定します。 | |
|
| In | ストレージドメイン上のディスクを含む登録済みまたは未登録の仮想マシンのリストを取得するかどうかを示します。 | |
|
| Vm[] | Out |
6.217.1.1. follow
たどる 必要のある内部リンクを指定します。これらのリンクで参照されるオブジェクトは、現在の要求の一部としてフェッチされます。詳細は、こちら を参照してください。
6.217.1.2. max
返す仮想マシンの最大数を設定します。指定されていない場合は、すべての仮想マシンが返されます。
6.217.1.3. unregistered
ストレージドメイン上のディスクを含む登録済みまたは未登録の仮想マシンのリストを取得するかどうかを示します。未登録の仮想マシンのリストを取得するには、呼び出しで未登録フラグを示す必要があります。たとえば、未登録の仮想マシンのリストを取得するには、REST API 呼び出しは次のようになります。
GET /ovirt-engine/api/storagedomains/123/vms?unregistered=true
未登録フラグのデフォルト値は false です。リクエストは、アタッチされているストレージドメインにのみ適用されます。
