14.7. サブコレクション

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

network_attachments サブコレクションは、ホストのネットワーク設定を表現します。各 network_attachment 要素は、ホストにアタッチされたネットワークを表現しており、この要素には以下の要素が含まれます。

表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>
ホストをネットワークにアタッチする際には、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>
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>
ネットワークアタッチメントに対する 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

重要

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

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

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

nics サブコレクションは、ホストの物理ネットワークインターフェースを表します。GET 要求に関する追加の情報は、All-Content: true ヘッダーを使用して取得することができます。表現内の各 host_nic 要素はネットワークインターフェースとして機能し、次の要素を含みます。

表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>
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>
DELETE 要求でネットワークインターフェースを削除します。 
DELETE /api/hosts/00000000-0000-0000-0000-000000000000/nics/
00000000-0000-0000-0000-000000000000 HTTP/1.1

HTTP/1.1 204 No Content

14.7.2.2. ボンディングインターフェース

ボンディングインターフェースは bonding 要素を含む host_nic のリソースとして表します。

表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>

重要

ボンディングインターフェースの有効な名前は、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

重要

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

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

14.7.2.3.1. ネットワークインターフェースのネットワークアタッチメント
ホストの各ネットワークインターフェースは、ネットワークインターフェースカードのネットワークアタッチメントを表現する network_attachments サブコレクションを公開します。各 network_attachment は、ネットワークインターフェースにアタッチされるネットワークを表現しており、このサブコレクションには以下の要素が含まれます。

表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>
ネットワークインターフェースカードにネットワークをアタッチする場合は、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>
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>
ネットワークアタッチメントに対する 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

重要

ネットワークアタッチメントの設定への変更は明示的にコミットする必要があります。「ネットワーク設定をコミットするアクション」を参照してください。
14.7.2.3.2. ネットワークアタッチメントのカスタムプロパティー
ホストのネットワークアタッチメントにカスタムプロパティーを適用することができます。各プロパティーには name と value のサブ要素が含まれます。カスタムプロパティーを変更するには、ネットワークアタッチメントに対して PUT 要求を実行するか、setupnetworks アクションを使用して POST 要求を実行してください。

表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>

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" />
物理ホストのネットワークインターフェースカードからラベルを削除するには 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

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

各ホストのネットワークインタフェースは、ホストのネットワークインターフェースの統計の statistics サブコレクションを公開します。各 statistic には、次のような要素が含まれます。

表14.8 ホストのネットワークインターフェース統計の要素

要素タイプ説明
name文字列統計エントリーの一意識別子
description文字列プレーンテキストで記述された統計の説明
unit文字列統計値測定の単位またはレート
typeGAUGE または COUNTER統計測定値のタイプ
values type=INTEGER または DECIMALその後に続く統計値のデータタイプ
value複合型datum を含むデータセット
datumvalues type を参照value に含まれるデータの 1 つ
host_nic id=リレーションシップ格納している host_nic リソースとのリレーションシップ
次の表には、ホスト上のネットワークインターフェースの統計タイプをまとめています。

表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>

注記

上記の 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>

注記

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>

注記

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

14.7.4.2. NUMA ノードの統計

各ホスト NUMA ノードは、NUMA ノードの統計の statistics サブコレクションを公開します。各 statistics には、次のような要素が含まれます。

表14.10 ホストの NUMA ノード統計の要素

要素タイプ説明
name文字列統計エントリーの一意識別子
description文字列プレーンテキストで記述された統計の説明
unit文字列統計値測定の単位またはレート
typeGAUGE または COUNTER統計測定値のタイプ
values type=INTEGER または DECIMALその後に続く統計値のデータタイプ
value複合型datum を含むデータセット
datumvalues type を参照value に含まれるデータの 1 つ
host_numa_node id=リレーションシップ格納している vm リソースとのリレーションシップ
以下の表には、ホストの NUMA ノードの統計タイプをまとめています。

表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>

注記

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

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

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

各ホストリソースは、ホスト固有の統計の statistics サブコレクションを公開します。各 statistics には、次のような要素が含まれます。

表14.12 VNIC プロファイルの要素

要素タイプ説明
name文字列統計エントリーの一意識別子
description文字列プレーンテキストで記述された統計の説明
unit文字列統計値測定の単位またはレート
typeGAUGE または COUNTER統計測定値のタイプ
values type=INTEGER または DECIMALその後に続く統計値のデータタイプ
value複合型datum を含むデータセット
datumvalues type を参照value に含まれるデータの 1 つ
host id=リレーションシップ格納している host リソースとのリレーションシップ
次の表には、ホストの統計タイプをまとめています。

表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>

注記

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