7.124. Host 構造体

ホストの外部ステータス。これは、サードパーティーのソフトウェアが、問題が発生した場合にホスト外部のステータスを変更するために使用することができます。サードパーティーのソフトウェアがこのステータスをチェックしてそれに応じて行動しない限り、これはホストのライフサイクルに影響を与えません。

このホストの自己ホスト型エンジンステータス。

ホストの KDUMP ステータス。KDUMP は、ホストカーネルがクラッシュし、メモリーダンプが実行されているときに発生します。

Kernel SamePage Merging(KSM) は、複数の同一ページから 1 つのページ参照にメモリーページへの参照を削減します。これは、メモリー密度の最適化に役立ちます。

たとえば、ホスト 123 に対して KSM を有効にするには、以下のようなリクエストを送信します。

PUT /ovirt-engine/api/hosts/123

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

<host>
  <ksm>
    <enabled>true</enabled>
  </ksm>
</host>

ホストの libvirt バージョン。libvirt の詳細は、libvirt を参照してください。

'setup networks'、'sync networks'、または 'refresh capabilities'などのネットワーク関連の操作が現在このホストで実行されているかどうかを指定します。

ファイアウォール定義をオーバーライドする必要があるかどうかを指定します。これは、ホストがインストールまたは再インストールされた場合にのみ適用されます。

エンジンがホストとの通信に使用するプロトコル。

ホストの SElinux ステータス。Security-Enhanced Linux (SELinux) は、アクセス制御セキュリティーポリシーをサポートするためのメカニズムを提供する Linux カーネルのコンポーネントです。

ホスト Storage Pool Manager (SPM) のステータスと定義。これを使用して、このホストの SPM 優先度を設定し、これが現在の SPM であるかどうかを確認します。

ホストステータスの詳細。Gluster ホストに関連します。

透過的な Huge Page のサポートにより、メモリーページのサイズが標準の 4 KiB の制限を超えて拡張されます。これにより、メモリー消費が削減され、ホストのパフォーマンスが向上します。

たとえば、ホスト 123 の透過的な Huge Page のサポートを有効にするには、次のようなリクエストを送信します。

PUT /ovirt-engine/api/hosts/123

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

<host>
  <transparent_hugepages>
    <enabled>true</enabled>
  </transparent_hugepages>
</host>

VDSM のバージョン。

以下はその例です。

GET /ovirt-engine/api/hosts/123

この GET リクエストは、以下の出力を返します。

<host>
  ...
  <version>
    <build>999</build>
    <full_version>vdsm-4.18.999-419.gitcf06367.el7</full_version>
    <major>4</major>
    <minor>18</minor>
    <revision>0</revision>
  </version>
  ...
</host>

トポロジー (ソケット、コア) に関する詳細情報と、現在の CPU ピン留めに関する情報を含むすべてのホストの CPU のリスト。

GET /ovirt-engine/api/hosts/123/cpuunits

以下のような XML で応答を受け取ります。

<host_cpu_units>
  <host_cpu_unit>
    <core_id>0</core_id>
    <cpu_id>0</cpu_id>
    <socket_id>0</socket_id>
    <vms>
      <vm href="/ovirt-engine/api/vms/def" id="def" />
    </vms>
  </host_cpu_unit>
  <host_cpu_unit>
    <core_id>0</core_id>
    <cpu_id>1</cpu_id>
    <socket_id>1</socket_id>
    <runs_vdsm>true</runs_vdsm>
  </host_cpu_unit>
  <host_cpu_unit>
    <core_id>0</core_id>
    <cpu_id>2</cpu_id>
    <socket_id>2</socket_id>
  </host_cpu_unit>
</host_cpu_units>

ホスト上でプロビジョニングされた外部ネットワークプロバイダー。

この属性は読み取り専用です。これを設定しても、ホストには影響しません。このパラメーターの値は、クラスターの Default Network Provider を反映しています。

ホストに割り当てられているすべての Katello エラータを一覧表示します。

GET /ovirt-engine/api/hosts/123/katelloerrata

以下のような XML で応答を受け取ります。

<katello_errata>
  <katello_erratum href="/ovirt-engine/api/katelloerrata/456" id="456">
    <name>RHBA-2013:XYZ</name>
    <description>The description of the erratum</description>
    <title>some bug fix update</title>
    <type>bugfix</type>
    <issued>2013-11-20T02:00:00.000+02:00</issued>
    <solution>Few guidelines regarding the solution</solution>
    <summary>Updated packages that fix one bug are now available for XYZ</summary>
    <packages>
      <package>
        <name>libipa_hbac-1.9.2-82.11.el6_4.i686</name>
      </package>
      ...
    </packages>
  </katello_erratum>
  ...
</katello_errata>

各ホストリソースは、ホスト固有の統計の統計サブコレクションを公開します。

XML 表現の例:

<statistics>
  <statistic href="/ovirt-engine/api/hosts/123/statistics/456" id="456">
    <name>memory.total</name>
    <description>Total memory</description>
    <kind>gauge</kind>
    <type>integer</type>
    <unit>bytes</unit>
    <values>
      <value>
        <datum>25165824000</datum>
      </value>
    </values>
    <host href="/ovirt-engine/api/hosts/123" id="123"/>
  </statistic>
    ...
</statistics>

次のリストは、ホストの統計タイプを示しています。