14.7.2.3. ネットワークインターフェイスのネットワーク接続
14.7.2.3.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
|
ネットワークのカスタムプロパティーキーを定義します。各
プロパティー には、name および value サブ要素が含まれます。
| |
reported_configurations
|
complex
|
ネットワークアタッチメントの設定プロパティーの読み取り専用リスト。
in_sync ブール値は、ネットワークアタッチメントにコミットされていないネットワーク設定が含まれる場合に false になります。reported_configuration ごとに 名前、expected_value、actual_value、および in_sync サブ要素が含まれます。
| 
|
例14.16 ネットワークインターフェイスカードでのネットワークアタッチメントの XML 表現
<network_attachment href="/ovirt-engine/api/hosts/00000000-0000-0000-0000-000000000000/nics/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>static</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>
</network_attachment>
ネットワークインターフェイスカードにネットワークを接続する場合は、
id または 名前 のいずれかで network 要素が必要です。
例14.17 ネットワークをホストネットワークインターフェイスカードにアタッチします。
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
<networkattachment>
<network id="00000000-0000-0000-0000-000000000000"/>
</networkattachment>ip_address_assignments および properties 要素は、作成後に更新可能です。
例14.18 ネットワーク割り当ての変更
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
<networkattachment>
<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>
</networkattachment>
ネットワークアタッチメントの
DELETE 要求を使用して、ネットワークインターフェイスカードからネットワークをデタッチします。
例14.19 ホストネットワークインターフェイスカードからネットワークを切断する
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
重要
ネットワークアタッチメント設定への変更は、明示的にコミットする必要があります。「ホストネットワーク設定アクションのコミット」を参照してください。
