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

14.7. サブコレクション

14.7.1. ホストのネットワークアタッチメントのサブコレクション
リンクのコピー

network_attachments サブコレクションは、ホストのネットワーク設定を表現します。各 network_attachment 要素は、ホストにアタッチされたネットワークを表現しており、この要素には以下の要素が含まれます。
Expand
表14.3 ホストのネットワークアタッチメントの要素
要素
タイプ
説明
プロパティー
network id=
GUID
ホストがアタッチされたネットワークへの参照
host_nic id=
GUID
ネットワークがアタッチされるホストネットワークインターフェースへの参照
ip_address_assignments
複合型
ネットワークの IP 設定。各ip_address_assignment には、assignment_method と ip address= netmask= gateway= サブ要素が含まれています。
 
properties
複合型
ネットワークのカスタムプロパティーキーを定義します。各 property には name および value のサブ要素が含まれます。「ネットワークアタッチメントのカスタムプロパティー」を参照してください。
 
reported_configurations
複合型
読み取り専用のネットワークアタッチメントの設定プロパティー一覧。ネットワークアタッチメントがデータセンターの論理ネットワーク定義と同期されてない場合には、in_sync ブール値は false です。各 reported_configuration には name、expected_value、actual_value、in_sync サブ要素が含まれます。
host id=
GUID
ホストへの参照

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

<network_attachment href="/api/hosts/00000000-0000-0000-0000-000000000000/networkattachments/00000000-0000-0000-0000-000000000000" id="00000000-0000-0000-0000-000000000000">
    <network href="/api/networks/00000000-0000-0000-0000-000000000009" id="00000000-0000-0000-0000-000000000009"/>
    <host_nic href="/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="/api/hosts/f59a29cd-587d-48a3-b72a-db537eb21957" id="f59a29cd-587d-48a3-b72a-db537eb21957"/>
</network_attachment>
Copy to Clipboard Toggle word wrap
ホストをネットワークにアタッチする際には、id または name を指定した network と host_nic 要素が必要です。host_nic ID は、未使用のネットワークインターフェースカードまたはボンぢングのいずれかを参照することができます。

例14.10 ホストへのネットワークのアタッチ

POST /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>
Copy to Clipboard Toggle word wrap
host_nic、ip_address_assignments、properties 要素は、作成後に更新可能です。host_nic ID を変更すると、ネットワークが別のネットワークインターフェースカードに移動されます。

例14.11 ホストネットワークのアタッチメントの変更

PUT /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>
Copy to Clipboard Toggle word wrap
ネットワークアタッチメントに対する DELETE 要求を使用して、ホストからネットワークをデタッチします。

例14.12 ホストからのネットワークのデタッチ

DELETE /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
Copy to Clipboard Toggle word wrap

重要

ネットワークアタッチメントの設定への変更は明示的にコミットする必要があります。「ネットワーク設定をコミットするアクション」を参照してください。

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

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

nics サブコレクションは、ホストの物理ネットワークインターフェースを表します。GET 要求に関する追加の情報は、All-Content: true ヘッダーを使用して取得することができます。表現内の各 host_nic 要素はネットワークインターフェースとして機能し、次の要素を含みます。
Expand
表14.4 ホストのネットワークインターフェースの要素
要素タイプ説明プロパティー
name文字列ホストのネットワークインターフェース名 (例: eth0) [a]
link rel="statistics"リレーションシップホストのネットワークインターフェース統計の statistics サブコレクションへのリンク
link rel="labels"リレーションシップホストのネットワークインターフェースラベルの labels サブコレクションへのリンク
link rel="networkattachments"リレーションシップホストのネットワークインターフェース設定の networkattachments サブコレクションへのリンク 
link rel="master"リレーションシップスレーブインターフェースである場合は、マスターのボンディングインターフェースへの参照
host id=GUIDホストへの参照
network id=GUIDインターフェースがアタッチされたネットワークがある場合は、そのネットワークへの参照 [b]
mac address=文字列インターフェースの MAC アドレス
ip address= netmask= gateway= mtu=複合型インターフェースの IP レベルの設定 
mtu複合型インターフェースの最大伝送単位 
boot_protocol列挙型ホスト起動時の IP アドレス割り当てのプロトコル。列挙値の一覧は capabilities に記載されています。 
status列挙型ネットワークインターフェースのリンクステータス。これらのステータスは capabilities の下の host_nic_states に記載されています。
vlan id整数このインターフェースが表している VLAN
bonding複合型ボンディングインターフェースの options と slave の各 NIC の一覧 [c]
bridgedブール値ネットワークのブリッジングステータスを定義します。ブリッジされたネットワークの場合は true に、ブリッジされていないネットワークの場合は false に設定します。 
[a] ボンディングインターフェースを追加する場合にのみ必要。その他のインターフェースは読み取り専用で、追加することはできません。
[b] ボンディングインターフェースを追加する場合にのみ必要。その他のインターフェースは読み取り専用で、追加することはできません。
[c] ボンディングインターフェースを追加する場合にのみ必要。その他のインターフェースは読み取り専用で、追加することはできません。

例14.13 ホスト上のネットワークインターフェースの XML 表現

<host_nic id="00000000-0000-0000-0000-000000000000"
  href="/api/hosts/00000000-0000-0000-0000-000000000000/nics/
  00000000-0000-0000-0000-000000000000">
    <actions>
        <link rel="attach"
      href="/api/hosts/00000000-0000-0000-0000-000000000000/nics/
      00000000-0000-0000-0000-000000000000/attach"/>
        <link rel="detach"
      href="/api/hosts/00000000-0000-0000-0000-000000000000/nics/
      00000000-0000-0000-0000-000000000000/detach"/>
    </actions>
    <name>bond0</name>
    <link href="/api/hosts/00000000-0000-0000-0000-000000000000/nics/00000000-0000-0000-0000-000000000000/statistics" rel="statistics"/>
    <link href="/api/hosts/00000000-0000-0000-0000-000000000000/nics/00000000-0000-0000-0000-000000000000/labels" rel="labels"/>
    <link href="/api/hosts/00000000-0000-0000-0000-000000000000/nics/00000000-0000-0000-0000-000000000000/networkattachments" rel="networkattachments"/>
    <host href="/api/hosts/00000000-0000-0000-0000-000000000000" id="00000000-0000-0000-0000-000000000000"/>
    <network href="/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>
Copy to Clipboard Toggle word wrap
REST API では、ボンディングインターフェースのみが作成可能です。「ボンディングインターフェース」を参照してください。その他のネットワークインターフェースにはすべて、更新可能な network、ip、boot_protocol の要素が含まれます。
PUT 要求を使用してネットワークインターフェースを変更します。 
PUT /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>
Copy to Clipboard Toggle word wrap
DELETE 要求でネットワークインターフェースを削除します。 
DELETE /api/hosts/00000000-0000-0000-0000-000000000000/nics/
00000000-0000-0000-0000-000000000000 HTTP/1.1

HTTP/1.1 204 No Content
Copy to Clipboard Toggle word wrap

14.7.2.2. ボンディングインターフェース
リンクのコピー

ボンディングインターフェースは bonding 要素を含む host_nic のリソースとして表します。
Expand
表14.5 ボンディングインターフェースのプロパティー
要素タイプ説明プロパティー
options複合型ボンディングインターフェースの option 要素の一覧。各 option にはプロパティーの name と value の属性が含まれます。 [a]
slaves複合型ボンディングインターフェースのスレーブ host_nic id= 要素の一覧 [b]
[a] ボンディングインターフェースを追加する場合にのみ必要。その他のインターフェースは読み取り専用で、追加することはできません。
[b] ボンディングインターフェースを追加する場合にのみ必要。その他のインターフェースは読み取り専用で、追加することはできません。
API ユーザーは、host_nic (POST) の作成時、または host_nic (PUT) の更新時に新しいボンディングを作成します。id または name 要素のいずれかを使用して、スレーブ host_nic 要素を特定します。新しいネットワークインターフェースを追加するには、name と network 要素が必要です。id 属性または name 要素で network 要素を特定します。

例14.14 ボンディングインターフェースの作成

POST /api/hosts/00000000-0000-0000-0000-000000000000/nics HTTP/1.1
Accept: application/xml
Content-Type: application/xml

<host_nic>
    <name>bond4</name>
    <network id="00000000-0000-0000-0000-000000000000"/>
    <bonding>
        <slaves>
            <host_nic id="00000000-0000-0000-0000-000000000000"/>
            <host_nic id="00000000-0000-0000-0000-000000000000"/>
        </slaves>
    </bonding>
</host_nic>
Copy to Clipboard Toggle word wrap

重要

ボンディングインターフェースの有効な名前は、bond0、bond1、bond2, bond3、bond4 のみです。

例14.15 ボンディングインターフェースの削除

DELETE 要求でボンディングインターフェースを削除します。 
DELETE /api/hosts/00000000-0000-0000-0000-000000000000/nics/00000000-0000-0000-0000-000000000000 HTTP/1.1

HTTP/1.1 204 No Content
Copy to Clipboard Toggle word wrap

重要

ボンディングインターフェースの設定に対する変更は、明示的にコミットする必要があります。「ネットワーク設定をコミットするアクション」を参照してください。

14.7.2.3. ネットワークインターフェースのネットワークアタッチメント
リンクのコピー

14.7.2.3.1. ネットワークインターフェースのネットワークアタッチメント
リンクのコピー
ホストの各ネットワークインターフェースは、ネットワークインターフェースカードのネットワークアタッチメントを表現する network_attachments サブコレクションを公開します。各 network_attachment は、ネットワークインターフェースにアタッチされるネットワークを表現しており、このサブコレクションには以下の要素が含まれます。
Expand
表14.6 ホストネットワークインターフェースのネットワークアタッチメントの要素
要素
タイプ
説明
プロパティー
network id=
GUID
インターフェースがアタッチされたネットワークへの参照
host_nic id=
GUID
ホストのネットワークインターフェースへの参照
ip_address_assignments
複合型
ネットワークの IP 設定。各ip_address_assignment には、assignment_method と ip address= netmask= gateway= サブ要素が含まれています。
 
properties
複合型
ネットワークのカスタムプロパティーキーを定義します。各 property には name および value のサブ要素が含まれます。
 
reported_configurations
複合型
読み取り専用のネットワークアタッチメントの設定プロパティー一覧。ネットワークアタッチメントにコミットされていないネットワーク設定が含まれている場合には、in_sync ブール値は false です。各 reported_configuration には name、expected_value、actual_value、in_sync サブ要素が含まれます。

例14.16 ネットワークインターフェースカードのネットワークアタッチメントのXML 表現

<network_attachment href="/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="/api/networks/00000000-0000-0000-0000-000000000009" id="00000000-0000-0000-0000-000000000009"/>
    <host_nic href="/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>
Copy to Clipboard Toggle word wrap
ネットワークインターフェースカードにネットワークをアタッチする場合は、id または name のいずれかと、network 要素が必要です。

例14.17 ホストのネットワークインターフェースカードに対するネットワークのアタッチ

POST /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>
Copy to Clipboard Toggle word wrap
ip_address_assignments と properties 要素は、作成後に更新可能です。

例14.18 ネットワークアタッチメントの変更

PUT /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>
Copy to Clipboard Toggle word wrap
ネットワークアタッチメントに対する DELETE 要求を使用して、ネットワークインターフェースからネットワークをデタッチします。

例14.19 ホストネットワークインターフェースカードからのネットワークのデタッチ

DELETE /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
Copy to Clipboard Toggle word wrap

重要

ネットワークアタッチメントの設定への変更は明示的にコミットする必要があります。「ネットワーク設定をコミットするアクション」を参照してください。
14.7.2.3.2. ネットワークアタッチメントのカスタムプロパティー
リンクのコピー
ホストのネットワークアタッチメントにカスタムプロパティーを適用することができます。各プロパティーには name と value のサブ要素が含まれます。カスタムプロパティーを変更するには、ネットワークアタッチメントに対して PUT 要求を実行するか、setupnetworks アクションを使用して POST 要求を実行してください。
Expand
表14.7 ホストネットワークインターフェースのカスタムブリッジオプションの要素
要素タイプ説明
name文字列プロパティーの一意識別子。ブリッジオプションには、bridge_opts というセット名があります。
value文字列有効なキーと値を「[key]=[value]」の構文で示すブリッジオプション。エントリーが複数ある場合には、空白文字で区切ります。有効なキーは以下のようになります。値は例として示しています。

forward_delay=1500
gc_timer=3765 
group_addr=1:80:c2:0:0:0
group_fwd_mask=0x0
hash_elasticity=4
hash_max=512
hello_time=200
hello_timer=70
max_age=2000
multicast_last_member_count=2
multicast_last_member_interval=100
multicast_membership_interval=26000
multicast_querier=0
multicast_querier_interval=25500
multicast_query_interval=13000
multicast_query_response_interval=1000
multicast_query_use_ifaddr=0
multicast_router=1
multicast_snooping=1
multicast_startup_query_count=2
multicast_startup_query_interval=3125

例14.20 ネットワークアタッチメントのプロパティーサブコレクションの 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>
Copy to Clipboard Toggle word wrap

14.7.2.4. ネットワークインターフェースのラベル
リンクのコピー

ホストのネットワークインターフェースカードにラベルをつけて、同じラベルが付けられた論理ネットワークとネットワークインターフェースカードを自動的に関連付けることができます。

例14.21 ネットワークインターフェースカードへのラベルのアタッチ

POST /api/hosts/00000000-0000-0000-0000-000000000000/nics/00000000-0000-0000-0000-000000000000/labels HTTP/1.1
Accept: application/xml
Content-type: application/xml

<label id="Label_001" />
Copy to Clipboard Toggle word wrap
物理ホストのネットワークインターフェースカードからラベルを削除するには DELETE 要求が必要です。

例14.22 ネットワークインターフェースカードからのラベルの削除

DELETE /api/hosts/00000000-0000-0000-0000-000000000000/nics/00000000-0000-0000-0000-000000000000/labels/00000000-0000-0000-0000-000000000000 HTTP/1.1

HTTP/1.1 204 No Content
Copy to Clipboard Toggle word wrap

14.7.2.5. ネットワークインターフェースの統計
リンクのコピー

各ホストのネットワークインタフェースは、ホストのネットワークインターフェースの統計の statistics サブコレクションを公開します。各 statistic には、次のような要素が含まれます。
Expand
表14.8 ホストのネットワークインターフェース統計の要素
要素タイプ説明
name文字列統計エントリーの一意識別子
description文字列プレーンテキストで記述された統計の説明
unit文字列統計値測定の単位またはレート
typeGAUGE または COUNTER統計測定値のタイプ
values type=INTEGER または DECIMALその後に続く統計値のデータタイプ
value複合型datum を含むデータセット
datumvalues type を参照value に含まれるデータの 1 つ
host_nic id=リレーションシップ格納している host_nic リソースとのリレーションシップ
次の表には、ホスト上のネットワークインターフェースの統計タイプをまとめています。
Expand
表14.9 ホストの NIC 統計タイプ
名前
説明
data.current.rx
データの受信速度 (ビット毎秒)
data.current.tx
データの送信速度 (ビット毎秒)
data.total.rx
合計受信データ
data.total.tx
合計送信データ
errors.total.rx
データ受信でのエラーの合計数
errors.total.tx
データ送信でのエラーの合計数

例14.23 ホストのネットワークインターフェース統計サブコレクションの XML 表現

<statistics>
    <statistic id="00000000-0000-0000-0000-000000000000"
      href="/api/hosts/00000000-0000-0000-0000-000000000000/nics/
      00000000-0000-0000-0000-000000000000/statistics/
      00000000-0000-0000-0000-000000000000">
        <name>data.current.rx</name>
        <description>Receive data rate</description>
        <values type="DECIMAL">
            <value>
                <datum>0</datum>
            </value>
        </values>
        <type>GAUGE</type>
        <unit>BYTES_PER_SECOND</unit>
        <host_nic id="00000000-0000-0000-0000-000000000000"
          href="/api/hosts/00000000-0000-0000-0000-000000000000/nics/
          00000000-0000-0000-0000-000000000000"/>
    </statistic>
    ...
</statistics>
Copy to Clipboard Toggle word wrap

注記

上記の statistics サブコレクションは読み取り専用です。

14.7.3. ストレージのサブコレクション
リンクのコピー

storage サブコレクションは、ホストで使用可能な iSCSI および FCP ストレージの表現の一覧を提供します。このストレージは、ストレージドメインを作成する際に使用します。
サブコレクション内の各 storage の表現は SCSI LUN を表します。

例14.24 ホスト上のストレージサブコレクションの XML 表現

<host_storage>
    <storage id="82fb123b-321e-40a1-9889-95dcd2654463"
      href="/api/hosts/2ab5e1da-b726-4274-bbf7-0a42b16a0fc3/storage/
      82fb123b-321e-40a1-9889-95dcd2654463">
        <name>LUN0</name>
        <type>iscsi</type>
        <logical_unit id="LUN0">
            <address>mysan.example.com</address>
            <target>iqn.2009-08.com.example:mysan.foobar</target>
        </logical_unit>
    </storage>
</host_storage>
Copy to Clipboard Toggle word wrap

注記

host_storage コレクションは読み取り専用です。

重要

API は、本セクションに記載した時点では試験段階にあり、今後変更される可能性があるため、後方互換性に関する記載内容は適用されません。

14.7.4. ホスト NUMA ノードのサブコレクション
リンクのコピー

14.7.4.1. NUMA ノードのサブコレクション
リンクのコピー

numanodes サブコレクションは、ホストの NUMA トポロジーを表現します。サブコレクションの各 host_numa_node 要素は、NUMA ノードを表現します。

例14.25 ホスト上にある NUMA ノードのサブコレクションの XML 表現

<host_numa_nodes>
    <host_numa_node href="/api/hosts/f6735fa9-4ee5-47ce-b750-a87863736cc2/numanodes/91d8537c-699e-460b-9a70-285f651e7d68" id="91d8537c-699e-460b-9a70-285f651e7d68">
        <link href="/api/hosts/f6735fa9-4ee5-47ce-b750-a87863736cc2/numanodes/91d8537c-699e-460b-9a70-285f651e7d68/statistics" rel="statistics"/>
        <host href="/api/hosts/f6735fa9-4ee5-47ce-b750-a87863736cc2" id="f6735fa9-4ee5-47ce-b750-a87863736cc2"/>
        <index>0</index>
        <memory>8157</memory>
        <cpu>
            <cores>
                <core index="0"/>
                <core index="2"/>
                <core index="4"/>
                <core index="6"/>
            </cores>
        </cpu>
        <node_distance>10 16</node_distance>
    </host_numa_node>
    <host_numa_node href="/api/hosts/f6735fa9-4ee5-47ce-b750-a87863736cc2/numanodes/4b18926e-6faf-43f5-9fc2-0503f1531562" id="4b18926e-6faf-43f5-9fc2-0503f1531562">
        <link href="/api/hosts/f6735fa9-4ee5-47ce-b750-a87863736cc2/numanodes/4b18926e-6faf-43f5-9fc2-0503f1531562/statistics" rel="statistics"/>
        <host href="/api/hosts/f6735fa9-4ee5-47ce-b750-a87863736cc2" id="f6735fa9-4ee5-47ce-b750-a87863736cc2"/>
        <index>2</index>
        <memory>8175</memory>
        <cpu>
            <cores>
                <core index="1"/>
                <core index="3"/>
                <core index="5"/>
                <core index="7"/>
            </cores>
        </cpu>
        <node_distance>16 10</node_distance>
    </host_numa_node>
</host_numa_nodes>
Copy to Clipboard Toggle word wrap

注記

上記の host_numa_nodes サブコレクションは読み取り専用です。

14.7.4.2. NUMA ノードの統計
リンクのコピー

各ホスト NUMA ノードは、NUMA ノードの統計の statistics サブコレクションを公開します。各 statistics には、次のような要素が含まれます。
Expand
表14.10 ホストの NUMA ノード統計の要素
要素タイプ説明
name文字列統計エントリーの一意識別子
description文字列プレーンテキストで記述された統計の説明
unit文字列統計値測定の単位またはレート
typeGAUGE または COUNTER統計測定値のタイプ
values type=INTEGER または DECIMALその後に続く統計値のデータタイプ
value複合型datum を含むデータセット
datumvalues type を参照value に含まれるデータの 1 つ
host_numa_node id=リレーションシップ格納している vm リソースとのリレーションシップ
以下の表には、ホストの NUMA ノードの統計タイプをまとめています。
Expand
表14.11 ホストの NUMA ノード統計
名前説明
memory.totalホスト上のメモリー合計 (バイト単位)
memory.usedNUMA ノード上の使用メモリー容量 (バイト単位)
memory.freeNUMA ノード上の空きメモリー容量 (バイト単位)
cpu.current.userユーザーの CPU 使用率
cpu.current.systemシステムの CPU 使用率
cpu.current.idleアイドル時の CPU 使用率

例14.26 ホスト NUMA ノードの統計サブコレクションの XML 表現

<statistics>
    <statistic href="/api/hosts/f6745fa9-4ee5-47ce-b750-a87863736cc2/numanodes/91d8537c-689e-460b-9a70-285f651e7d68/statistics/7816602b-c05c-3dc7-a4da-3769f7ad8896" id="7816602b-c05c-3dc7-a4da-3769f7ad8896">
        <name>memory.total</name>
        <description>Total memory</description>
        <values type="INTEGER">
            <value>
                <datum>8157</datum>
            </value>
        </values>
        <type>GAUGE</type>
        <unit>BYTES</unit>
        <host_numa_node href="/api/hosts/f6745fa9-4ee5-47ce-b750-a87863736cc2/numanodes/91d8537c-689e-460b-9a70-285f651e7d68" id="91d8537c-689e-460b-9a70-285f651e7d68"/>
    </statistic>
    ...
</statistics>
Copy to Clipboard Toggle word wrap

注記

ホスト NUMA ノードの statistics サブコレクションは読み取り専用です。

14.7.5. ホスト統計のサブコレクション
リンクのコピー

14.7.5.1. ホスト統計のサブコレクション
リンクのコピー

各ホストリソースは、ホスト固有の統計の statistics サブコレクションを公開します。各 statistics には、次のような要素が含まれます。
Expand
表14.12 VNIC プロファイルの要素
要素タイプ説明
name文字列統計エントリーの一意識別子
description文字列プレーンテキストで記述された統計の説明
unit文字列統計値測定の単位またはレート
typeGAUGE または COUNTER統計測定値のタイプ
values type=INTEGER または DECIMALその後に続く統計値のデータタイプ
value複合型datum を含むデータセット
datumvalues type を参照value に含まれるデータの 1 つ
host id=リレーションシップ格納している host リソースとのリレーションシップ
次の表には、ホストの統計タイプをまとめています。
Expand
表14.13 ホストの統計タイプ
名前
説明
memory.total
ホスト上のメモリー合計 (バイト単位)
memory.used
ホスト上の使用メモリー容量 (バイト単位)
memory.free
ホスト上の空きメモリー容量 (バイト単位)
memory.shared
ホストで共有されるメモリー容量 (バイト単位)
memory.buffers
I/O バッファー (バイト単位)
memory.cached
OS キャッシュ (バイト単位)
swap.total
ホスト上の swap メモリー容量 (バイト単位)
swap.free
ホスト上の空き swap メモリー容量 (バイト単位)
swap.used
ホスト上の使用 swap メモリー容量 (バイト単位)
swap.cached
ホストのメモリー内にもキャッシュされている swap メモリー容量 (バイト単位)
ksm.cpu.current
Kernel SamePage Merging (KSM) の CPU 使用率
cpu.current.user
ユーザーの CPU 使用率
cpu.current.system
システムの CPU 使用率
cpu.current.idle
アイドル時の CPU 使用率
cpu.load.avg.5m
5 分あたりの CPU 負荷平均

例14.27 ホストの統計サブコレクションの XML 表現

<statistics>
    <statistic id="4ae97794-f56d-3f05-a9e7-8798887cd1ac"
      href="/api/hosts/2ab5e1da-b726-4274-bbf7-0a42b16a0fc3/
      statistics/4ae97794-f56d-3f05-a9e7-8798887cd1ac">
        <name>memory.total</name>
        <description>Total memory</description>
        <unit>BYTES</unit>
        <type>GUAGE</type>
        <values type="INTEGER">
            <value>
                <datum>3983540224<datum>
            </value>
        </values>
        <host id="2ab5e1da-b726-4274-bbf7-0a42b16a0fc3"
          href="/api/hosts/2ab5e1da-b726-4274-bbf7-0a42b16a0fc3"/>
    </statistic>
    ...
</statistics>
Copy to Clipboard Toggle word wrap

注記

ホストの statistics サブコレクションは読み取り専用です。
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

Theme

© 2025 Red Hat