6.96. ファイル
クライアントが利用可能なファイルを一覧表示する方法を提供します。
このサービスは、管理者がアップロードする ISO イメージと仮想フロッピーディスク (VFD) を含む ISO ストレージドメインを特に対象としています。
CD-ROM デバイスを仮想マシンに追加するには、ISO ストレージドメインのファイルからの ISO イメージが必要です。
| 名前 | 概要 |
|---|---|
|
| ストレージドメインで利用可能な ISO イメージおよび仮想フロッピーのディスク一覧を返します。 |
6.96.1. list GET
ストレージドメインで利用可能な ISO イメージおよび仮想フロッピーのディスク一覧を返します。返されるリストの順序は保証されません。
refresh パラメーターが false の場合、返されるリストはストレージドメインへの最近の変更を反映していない可能性があります。たとえば、最近追加された新しい ISO ファイルが含まれていない場合があります。これは、サーバーがファイルの一覧をキャッシュしてパフォーマンスを向上するためです。最新の結果を取得するには、refresh パラメーターを true に設定します。
refresh パラメーターのデフォルト値は true ですが、ForceRefreshDomainFilesByDefault 値を使用して変更できます。
# engine-config -s ForceRefreshDomainFilesByDefault=false
refresh パラメーターの値を true に設定すると、サーバーのパフォーマンスに影響します。必要な場合にのみ使用してください。
| 名前 | タイプ | 方向 | 概要 |
|---|---|---|---|
|
| In |
| |
|
| Out | ||
|
| In | たどる 必要のある内部リンクを指定します。 | |
|
| In | 返すファイルの最大数を設定します。 | |
|
| In | 特定の間隔で更新されるキャッシュされた結果を表示するのではなく、ファイルのリストをストレージドメインから更新する必要があるかどうかを示します。 | |
|
| In | 返されたファイルを制限するために使用されるクエリー文字列。 |
6.96.1.1. case_sensitive
search パラメーターを使用して実行した検索を討すべきかどうかを示します。デフォルト値は true です。
6.96.1.2. follow
たどる 必要のある内部リンクを指定します。これらのリンクで参照されるオブジェクトは、現在の要求の一部としてフェッチされます。詳細は、こちら を参照してください。
6.96.1.3. max
返すファイルの最大数を設定します。指定のない場合は、すべてのファイルが返されます。
