Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

6.217. StorageDomainVms

エクスポートストレージドメインの仮想マシンをリスト表示します。

たとえば、識別子が 123 のストレージドメインで利用可能な仮想マシンを取得するには、以下のリクエストを送信します。 

GET /ovirt-engine/api/storagedomains/123/vms
Copy to Clipboard Toggle word wrap

これにより、以下のレスポンス本文が返されます。 

<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>
Copy to Clipboard Toggle word wrap

これらのコレクションの仮想マシンとテンプレートは、StorageDomain 参照と インポート アクションも含まれていることを除き、最上位の Vm コレクションと Template コレクションの対応するものと同様の表現をしています。

Expand
表6.661 メソッドの概要
名前Summary

list

エクスポートストレージドメインの仮想マシンのリストを返します。

6.217.1. list GET
リンクのコピー

エクスポートストレージドメインの仮想マシンのリストを返します。

返される仮想マシンリストの順序は保証されません。

Expand
表6.662 パラメーターの概要
名前型方向Summary

follow

String

In

たどる 必要のある内部リンクを指定します。

max

Integer

In

返す仮想マシンの最大数を設定します。

unregistered

ブール値

In

ストレージドメイン上のディスクを含む登録済みまたは未登録の仮想マシンのリストを取得するかどうかを示します。

vm

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
Copy to Clipboard Toggle word wrap

未登録フラグのデフォルト値は false です。リクエストは、アタッチされているストレージドメインにのみ適用されます。

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat