6.271. VmHostDevices
仮想マシンにアタッチされたホストデバイスを管理するサービス。
| 名前 | Summary |
|---|---|
|
| ターゲットデバイスを指定された仮想マシンにアタッチします。 |
|
| 指定された仮想マシンに割り当てられているホストデバイスをリスト表示します。 |
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 フラグがクリアされ、デバイスが仮想マシンにアクセスできるようになります。
| 名前 | 型 | 方向 | Summary |
|---|---|---|---|
|
| In/Out | 指定された仮想マシンにアタッチするホストデバイス。 |
6.271.2. list GET
指定された仮想マシンに割り当てられているホストデバイスをリスト表示します。
返されるデバイスリストの順序は保証されません。
| 名前 | 型 | 方向 | Summary |
|---|---|---|---|
|
| Out | 取得した、指定された仮想マシンにアタッチされているホストデバイスのリスト。 | |
|
| In | たどる 必要のある内部リンクを指定します。 | |
|
| In | 返すデバイスの最大数を設定します。 |
6.271.2.1. follow
たどる 必要のある内部リンクを指定します。これらのリンクで参照されるオブジェクトは、現在の要求の一部としてフェッチされます。詳細は、こちら を参照してください。
6.271.2.2. max
返すデバイスの最大数を設定します。指定しない場合、すべてのデバイスが返されます。
