14.7. サブコレクション
14.7.1. ホストネットワーク添付ファイルのサブコレクション
network_attachments サブコレクションは、ホストのネットワーク設定を表します。各 network_attachment 要素は、ホストに接続されているネットワークを表し、以下の要素が含まれます。
|
要素
|
タイプ
|
説明
|
プロパティー
|
|---|---|---|---|
network id=
|
GUID
|
ホストが接続されているネットワークへの参照。
| 
|
host_nic id=
|
GUID
|
ネットワークが接続されているホストネットワークインターフェイスへの参照。
|
|
ip_address_assignments
|
complex
|
ネットワークの IP 設定。各
ip_address_assignment には assignment_method および ip address= netmask= gateway= サブ要素が含まれます。
| |
properties
|
complex
| ||
reported_configurations
|
complex
|
ネットワークアタッチメントの設定プロパティーの読み取り専用リスト。
in_sync ブール値は、ネットワークアタッチメントがデータセンターの論理ネットワーク定義と同期していない場合に false になります。reported_configuration ごとに 名前、expected_value、actual_value、および in_sync サブ要素が含まれます。
| 
|
host id=
|
GUID
|
ホストへの参照。
|
|
例14.9 ホスト上のネットワークアタッチメントの XML 表現
<network_attachment href="/ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000/networkattachments/00000000-0000-0000-0000-000000000000" id="00000000-0000-0000-0000-000000000000">
<network href="/ovirt-engine/api/networks/00000000-0000-0000-0000-000000000009" id="00000000-0000-0000-0000-000000000009"/>
<host_nic href="/ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000/nics/00000000-0000-0000-0000-000000000000" id="00000000-0000-0000-0000-000000000000"/>
<ip_address_assignments>
<ip_address_assignment>
<ip address="XX.XX.XX.XX" netmask="255.255.255.0" gateway="XX.XX.XX.XX"/>
<assignment_method>dhcp</assignment_method>
</ip_address_assignment>
</ip_address_assignments>
<reported_configurations>
<in_sync>true</in_sync>
<reported_configuration>
<name>mtu</name>
<expected_value>1500</expected_value>
<actual_value>1500</actual_value>
<in_sync>true</in_sync>
</reported_configuration>
<reported_configuration>
<name>bridged</name>
<expected_value>true</expected_value>
<actual_value>true</actual_value>
<in_sync>true</in_sync>
</reported_configuration>
<reported_configuration>
<name>vlan</name>
<in_sync>true</in_sync>
</reported_configuration>
<reported_configuration>
<name>boot_protocol</name>
<expected_value>DHCP</expected_value>
<actual_value>DHCP</actual_value>
<in_sync>true</in_sync>
</reported_configuration>
</reported_configurations>
<host href="/ovirt-engine/api/hosts/f59a29cd-587d-48a3-b72a-db537eb21957" id="f59a29cd-587d-48a3-b72a-db537eb21957"/>
</network_attachment>
ネットワークをホストにアタッチする場合、
id または name のいずれかの network 要素および host_nic 要素が必要です。host_nic ID は、未使用のネットワークインターフェイスカードまたはボンディングのいずれかを参照できます。
例14.10 ネットワークをホストに接続します。
POST /ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000/nics/00000000-0000-0000-0000-000000000000/networkattachments HTTP/1.1
Accept: application/xml
Content-type: application/xml
<network_attachment>
<network id="00000000-0000-0000-0000-000000000000"/>
<host_nic id="00000000-0000-0000-0000-000000000000"/>
</network_attachment>host_nic、ip_address_assignments、および properties 要素は、作成後に更新可能です。host_nic ID を変更すると、ネットワークを別のネットワークインターフェイスカードに移動します。
例14.11 ホストネットワーク割り当ての変更
PUT /ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000/nics/00000000-0000-0000-0000-000000000000/networkattachments/00000000-0000-0000-0000-000000000000 HTTP/1.1
Accept: application/xml
Content-type: application/xml
<network_attachment>
<host_nic id="00000000-0000-0000-0000-000000000000"/>
<ip_address_assignments>
<ip_address_assignment>
<ip address="XX.XX.XX.XX" netmask="255.255.255.0" gateway="XX.XX.XX.XX"/>
<assignment_method>static</assignment_method>
</ip_address_assignment>
</ip_address_assignments>
<properties>
<property>
<name>bridge_opts</name>
<value>
forward_delay=1500 group_fwd_mask=0x0 multicast_snooping=1
</value>
</property>
</properties>
</network_attachment>
ネットワークアタッチメントの
DELETE 要求を使用して、ホストからネットワークを切断します。
例14.12 ホストからネットワークを切断する
DELETE /ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000/nics/00000000-0000-0000-0000-000000000000/networkattachments/00000000-0000-0000-0000-000000000000 HTTP/1.1 Accept: application/xml Content-type: application/xml HTTP/1.1 204 No Content
重要
ネットワークアタッチメント設定への変更は、明示的にコミットする必要があります。「ホストネットワーク設定アクションのコミット」を参照してください。
