15.6.2. ネットワークインターフェイスのサブコレクション
15.6.2.1. ネットワークインターフェイスのサブコレクション
nics サブコレクションは、仮想マシン上のすべてのネットワークインターフェイスデバイスを表します。nic 表現には、以下の要素が含まれます。
| 要素 | タイプ | 説明 | プロパティー |
|---|---|---|---|
link rel="statistics" | 関係 | 仮想マシンのネットワークインターフェイス 統計の統計 サブコレクションへのリンク。 | 
|
network id= | GUID | インターフェイスが接続するネットワークへの参照。空のネットワーク ID が許可されます。 | 
|
interface | 列挙 | nic に使用するドライバーのタイプ。列挙値のリストは、機能 で確認できます。 | |
mac address= | string | インターフェイスの MAC アドレス。 | 
|
port_mirroring | complex | NIC がミラーリングされたトラフィックを受信するかどうかを定義します。一連の ネットワーク id= 参照で networks 要素を定義します。 | |
plugged | ブール値 | NIC が仮想マシンに接続されているかどうかを定義します。 |
|
linked | ブール値 | NIC が仮想マシンにリンクされているかどうかを定義します。 |
|
例15.24 ネットワークインターフェイスの XML 表現
<nic id="7a3cff5e-3cc4-47c2-8388-9adf16341f5e"
ref="/ovirt-engine/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/nics/
7a3cff5e-3cc4-47c2-8388-9adf16341f5e">
<link rel="statistics"
href="/ovirt-engine/api/vms/082c794b-771f-452f-83c9-b2b5a19c0399/nics/
7a3cff5e-3cc4-47c2-8388-9adf16341f5e/statistics"/>
<name>nic1</name>
<interface>virtio</interface>
<mac address="00:1a:4a:16:84:07"/>
<network id="00000000-0000-0000-0000-000000000009"
href="/ovirt-engine/api/networks/00000000-0000-0000-0000-000000000009"/>
<vm id="cdc0b102-fbfe-444a-b9cb-57d2af94f401"
href="/ovirt-engine/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401"/>
<port_mirroring>
<networks>
<network id="56087282-d7a6-11e1-af44-001a4a400e0c"
href="/ovirt-engine/api/networks/56087282-d7a6-11e1-af44-001a4a400e0c"/>
</networks>
</port_mirroring>
</nic>
新しいネットワークインターフェイスを追加する場合は、
name 要素と network 要素が必要です。id 属性または name 要素で ネットワーク 要素を特定します。
例15.25 仮想マシン NIC の作成
POST /ovirt-engine/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/nics HTTP/1.1
Accept: application/xml
Content-type: application/xml
<nic>
<name>nic1</name>
<network id="00000000-0000-0000-0000-000000000009"/>
</nic>
API ユーザーは
PUT リクエストでネットワークインターフェイスを変更します。
例15.26 仮想マシン NIC の更新
PUT /ovirt-engine/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/nics/
7a3cff5e-3cc4-47c2-8388-9adf16341f5e HTTP/1.1
Accept: application/xml
Content-type: application/xml
<nic>
<name>nic2</name>
<network id="00000000-0000-0000-0000-000000000010"/>
<type>e1000</type>
</nic>
API ユーザーは、
DELETE リクエストを持つネットワークインターフェイスを削除します。
例15.27 仮想マシン NIC の削除
DELETE /ovirt-engine/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/nics/ 7a3cff5e-3cc4-47c2-8388-9adf16341f5e HTTP/1.1 HTTP/1.1 204 No Content
重要
ホットプラグ機能は、ホットプラグ操作を行う仮想マシンオペレーティングシステムのみをサポートします。オペレーティングシステムの例は次のとおりです。
- Red Hat Enterprise Linux 6;
- Red Hat Enterprise Linux 5;
- Windows Server 2008、および
- Windows Server 2003.
