14.7.2. ホストネットワークインターフェイスのサブコレクション
14.7.2.1. ホストネットワークインターフェイスのサブコレクション
nics サブコレクションは、ホストの物理ネットワークインターフェイスを表します。All-Content: true ヘッダーを使用して GET リクエストに関する追加情報を取得できます。表現の各 host_nic 要素はネットワークインターフェイスとして機能し、以下の要素が含まれます。
| 要素 | タイプ | 説明 | プロパティー |
|---|---|---|---|
name | string | ホストネットワークインターフェイスの名前（例： eth0 ）。 | 
[a] 
|
link rel="statistics" | 関係 | ホストのネットワークインターフェイス 統計の統計 サブコレクションへのリンク。 | 
|
link rel="labels" | 関係 | ホストのネットワークインターフェイス ラベルのラベル サブコレクションへのリンク。 | |
link rel="networkattachments" | 関係 | ホストのネットワークインターフェイス設定用の networkattachments サブコレクションへのリンク。 | |
link rel="master" | 関係 | これがスレーブインターフェイスの場合、マスターボンディングインターフェイスへの参照。 |
|
host id= | GUID | ホストへの参照。 |
|
network id= | GUID | ネットワークへの参照（ある場合）。 |
[b] |
mac address= | string | インターフェイスの MAC アドレス。 |
|
ip address= netmask= gateway= mtu= | complex | インターフェイスの IP レベルの設定。 | |
mtu | complex | インターフェイスの最大伝送単位。 | |
boot_protocol | 列挙 | ホスト起動時の IP アドレスの割り当てのプロトコル。列挙値のリストは、機能 で確認できます。 | |
status | 列挙 | ネットワークインターフェイスのリンクステータス。これらの状態は capabilities の host_nic_states に一覧表示されます。 |
|
vlan id | integer | このインターフェイスが表す VLAN。 |
|
bonding | complex | ボンディングされたインターフェイス用の オプション および スレーブ NIC の一覧。 |
[c]
|
bridged | ブール値 | ブリッジネットワークのステータスを定義します。ブリッジネットワークの場合は true に設定し、ブリッジレスネットワークの場合は false に設定します。 | |
[a]
ボンディングインターフェイスを追加する場合にのみ必要です。他のインターフェイスは読み取り専用で、追加できません。
[b]
ボンディングインターフェイスを追加する場合にのみ必要です。他のインターフェイスは読み取り専用で、追加できません。
[c]
ボンディングインターフェイスを追加する場合にのみ必要です。他のインターフェイスは読み取り専用で、追加できません。
| |||
例14.13 ホスト上のネットワークインターフェイスの XML 表現
<host_nic id="00000000-0000-0000-0000-000000000000"
href="/ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000/nics/
00000000-0000-0000-0000-000000000000">
<actions>
<link rel="attach"
href="/ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000/nics/
00000000-0000-0000-0000-000000000000/attach"/>
<link rel="detach"
href="/ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000/nics/
00000000-0000-0000-0000-000000000000/detach"/>
</actions>
<name>bond0</name>
<link href="/ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000/nics/00000000-0000-0000-0000-000000000000/statistics" rel="statistics"/>
<link href="/ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000/nics/00000000-0000-0000-0000-000000000000/labels" rel="labels"/>
<link href="/ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000/nics/00000000-0000-0000-0000-000000000000/networkattachments" rel="networkattachments"/>
<host href="/ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000" id="00000000-0000-0000-0000-000000000000"/>
<network href="/ovirt-engine/api/networks/00000000-0000-0000-0000-000000000000" id="00000000-0000-0000-0000-000000000000"/>
<mac address="00:00:00:00:00:00"/>
<ip address="XX.XX.XX.XX" netmask="255.255.255.0" gateway="XX.XX.XX.XX"/>
<boot_protocol>dhcp</boot_protocol>
<status>
<state>up</state>
</status>
<bonding>
<options>
<option name="mode" value="4" type="Dynamic link aggregation (802.3ad)"/>
<option name="miimon" value="100"/>
</options>
<slaves>
<host_nic id="00000000-0000-0000-0000-000000000000"/>
<host_nic id="00000000-0000-0000-0000-000000000000"/>
</slaves>
</bonding>
<mtu>1500</mtu>
<bridged>true</bridged>
<custom_configuration>false</custom_configuration>
</host_nic>
REST API では、ボンディングされたインターフェイスのみを作成できます。「ボンディングされたインターフェイス」を参照してください。他のすべてのネットワークインターフェイスには、updatable
ネットワーク、ip 要素、および boot_protocol 要素が含まれます。
PUT 要求でネットワークインターフェイスを変更します。
PUT /ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000/nics/
00000000-0000-0000-0000-000000000000 HTTP/1.1
Accept: application/xml
Content-type: application/xml
<host_nic>
<ip address="XX.XX.XX.XX" netmask="255.255.255.0" gateway="XX.XX.XX.XX"/>
<boot_protocol>static</boot_protocol>
</host_nic>
DELETE リクエストでネットワークインターフェイスを削除します。
DELETE /ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000/nics/ 00000000-0000-0000-0000-000000000000 HTTP/1.1 HTTP/1.1 204 No Content
