6.271. VmHostDevices
仮想マシンにアタッチされたホストデバイスを管理するサービス。
名前 | 概要 |
---|---|
| ターゲットデバイスを指定された仮想マシンにアタッチします。 |
| 指定された仮想マシンに割り当てられているホストデバイスを一覧表示します。 |
6.271.1. add POST
ターゲットデバイスを指定された仮想マシンにアタッチします。
例:
POST /ovirt-engine/api/vms/123/hostdevices
HostDevice タイプのリクエスト本文の例
<host_device id="123" />
ホストデバイスを正常にアタッチするために必要な前提条件は、仮想マシンが 必ず 1 つのホストにピニングされていることです。その場合、このホストに関連してデバイス ID が取得されます。
より大きな IOMMU グループの一部である PCI デバイスをアタッチすると、その IOMMU グループの残りのデバイスがプレースホルダーとしてアタッチされます。その後、これらのデバイスは、true
に設定された HostDevice タイプの placeholder
属性を使用して識別されます。
すでに IOMMU プレースホルダーとして機能しているデバイスをアタッチする場合は、そのデバイスに対して明示的な Add 操作を発行するだけで、その placeholder
フラグがクリアされ、デバイスが仮想マシンにアクセスできるようになります。
名前 | タイプ | 方向 | 概要 |
---|---|---|---|
| In/Out | 指定された仮想マシンにアタッチするホストデバイス。 |
6.271.2. list GET
指定された仮想マシンに割り当てられているホストデバイスを一覧表示します。
返されるデバイス一覧の順序は保証されません。
名前 | タイプ | 方向 | 概要 |
---|---|---|---|
| Out | 取得した、指定された仮想マシンにアタッチされているホストデバイスのリスト。 | |
| In | たどる 必要のある内部リンクを指定します。 | |
| In | 返すデバイスの最大数を設定します。 |
6.271.2.1. follow
たどる 必要のある内部リンクを指定します。これらのリンクで参照されるオブジェクトは、現在の要求の一部としてフェッチされます。詳細は、こちら を参照してください。
6.271.2.2. max
返すデバイスの最大数を設定します。指定しない場合、すべてのデバイスが返されます。