7.176. NetworkAttachment 構造体

ホストがネットワークに接続する方法について説明します。

ホスト上のネットワークアタッチメントの XML 表現:

<network_attachment href="/ovirt-engine/api/hosts/123/nics/456/networkattachments/789" id="789">
  <network href="/ovirt-engine/api/networks/234" id="234"/>
  <host_nic href="/ovirt-engine/api/hosts/123/nics/123" id="123"/>
  <in_sync>true</in_sync>
  <ip_address_assignments>
    <ip_address_assignment>
      <assignment_method>static</assignment_method>
      <ip>
        <address>192.168.122.39</address>
        <gateway>192.168.122.1</gateway>
        <netmask>255.255.255.0</netmask>
        <version>v4</version>
      </ip>
    </ip_address_assignment>
  </ip_address_assignments>
  <reported_configurations>
    <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_configurations>
</network_attachment>

ネットワークをネットワークインターフェイスカード (NIC) にアタッチするには、name または id を持つ ネットワーク要素が必要です。

たとえば、ネットワークをホストネットワークインターフェイスカードにアタッチするには、以下のようなリクエストを送信します。

POST /ovirt-engine/api/hosts/123/nics/456/networkattachments

リクエスト本文は以下のようになります。

<networkattachment>
  <network id="234"/>
</networkattachment>

ネットワークをホストにアタッチするには、次のようなリクエストを送信します。

POST /ovirt-engine/api/hosts/123/networkattachments

リクエスト本文は以下のようになります。

<network_attachment>
  <network id="234"/>
  <host_nic id="456"/>
</network_attachment>

ip_address_assignments および properties 要素は、作成後に更新可能です。

たとえば、ネットワークアタッチメントを更新するには、以下のようなリクエストを送信します。

PUT /ovirt-engine/api/hosts/123/nics/456/networkattachments/789

リクエスト本文は以下のようになります。

<network_attachment>
  <ip_address_assignments>
    <ip_address_assignment>
      <assignment_method>static</assignment_method>
      <ip>
        <address>7.1.1.1</address>
        <gateway>7.1.1.2</gateway>
        <netmask>255.255.255.0</netmask>
        <version>v4</version>
      </ip>
    </ip_address_assignment>
  </ip_address_assignments>
</network_attachment>

ネットワークインターフェイスカードからネットワークをデタッチするには、以下のようなリクエストを送信します。

DELETE /ovirt-engine/api/hosts/123/nics/456/networkattachments/789

ネットワークアタッチメントの properties サブコレクションの XML 表現。

<network_attachment>
  <properties>
    <property>
      <name>bridge_opts</name>
      <value>
        forward_delay=1500 group_fwd_mask=0x0 multicast_snooping=1
      </value>
    </property>
  </properties>
  ...
</network_attachment>