Red Hat Training

A Red Hat training course is available for Red Hat Virtualization

14.7. サブコレクション

14.7.1. ホストネットワーク添付ファイルのサブコレクション

network_attachments サブコレクションは、ホストのネットワーク設定を表します。各 network_attachment 要素は、ホストに接続されているネットワークを表し、以下の要素が含まれます。

表14.3 ホストのネットワークアタッチメントの要素

要素
タイプ
説明
プロパティー
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 サブ要素が含まれます。
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
重要
ネットワークアタッチメント設定への変更は、明示的にコミットする必要があります。「ホストネットワーク設定アクションのコミット」を参照してください。