Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

14.7.2. ホストネットワークインターフェイスのサブコレクション

14.7.2.1. ホストネットワークインターフェイスのサブコレクション
リンクのコピー

nics サブコレクションは、ホストの物理ネットワークインターフェイスを表します。All-Content: true ヘッダーを使用して GET リクエストに関する追加情報を取得できます。表現の各 host_nic 要素はネットワークインターフェイスとして機能し、以下の要素が含まれます。
Expand
表14.4 ホストのネットワークインターフェイスの要素
要素 タイプ 説明 プロパティー
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
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

Legal Notice

Theme

© 2026 Red Hatトップに戻る