7.124. Host 構造体

ホストを表すタイプ。

Expand

表7.167 属性の概要
名前	型	Summary
`address`	String	ホストアドレス (FQDN/IP)。
`auto_numa_status`	AutoNumaStatus	ホストの自動 Non-Uniform Memory Access (NUMA) ステータス。
`certificate`	証明書	ホスト証明書。
`comment`	String	このオブジェクトに関するコメントを含むフリーテキスト。
`cpu`	Cpu	このホストの CPU タイプ。
`description`	String	プレーンテキストでの人間が判読できる説明。
`device_passthrough`	HostDevicePassthrough	このホストでホストデバイスのパススルーが有効であるかどうかを指定します。
`display`	表示	オプションで、このホストの表示アドレスを明示的に指定します。
`external_status`	ExternalStatus	ホストの外部ステータス。
`hardware_information`	HardwareInformation	ホストハードウェア情報。
`hosted_engine`	HostedEngine	このホストの自己ホスト型エンジンステータス。
`id`	String	一意の ID
`iscsi`	IscsiDetails	ホスト iSCSI の詳細。
`kdump_status`	KdumpStatus	ホストの KDUMP ステータス。
`ksm`	Ksm	Kernel SamePage Merging(KSM) は、複数の同一ページから 1 つのページ参照にメモリーページへの参照を削減します。
`libvirt_version`	バージョン	ホストの libvirt バージョン。
`max_scheduling_memory`	Integer	このホストの最大スケジューリングメモリー (バイト単位)。
`memory`	Integer	このホストの物理メモリーの量 (バイト単位)。
`name`	String	人間が判読できるプレーンテキストでの名前。
`network_operation_in_progress`	ブール値	'setup networks'、'sync networks'、または 'refresh capabilities' などのネットワーク関連の操作が現在このホストで実行されているかどうかを指定します。
`numa_supported`	ブール値	このホストで Non-Uniform Memory Access (NUMA) をサポートしているかどうかを指定します。
`os`	OperatingSystem	このホストのオペレーティングシステム。
`override_iptables`	ブール値	ファイアウォール定義をオーバーライドする必要があるかどうかを指定します。
`ovn_configured`	ブール値	ホストが OVN を正しく設定したかどうかを示します。
`port`	Integer	ホストポート。
`power_management`	PowerManagement	ホストの電源管理の定義。
`protocol`	HostProtocol	エンジンがホストとの通信に使用するプロトコル。
`reinstallation_required`	ブール値	ホストを再インストールする必要があるかどうかを指定します。
`root_password`	String	新しいホストを作成するときに、パスワード認証方法を選択した場合は root パスワードが必要ですが、これはその後の表現には含まれません。
`se_linux`	SeLinux	ホストの SElinux ステータス。
`spm`	Spm	ホスト Storage Pool Manager (SPM) のステータスと定義。
`ssh`	Ssh	SSH 定義。
`status`	HostStatus	ホストのステータス。
`status_detail`	String	ホストステータスの詳細。
`summary`	VmSummary	仮想マシンの概要 - アクティブ数、移行数、および合計数。
`transparent_huge_pages`	TransparentHugePages	透過的な Huge Page のサポートにより、メモリーページのサイズが標準の 4 KiB の制限を超えて拡張されます。
`type`	HostType	ホストにオペレーティングシステムのフルインストールが含まれているか、仮想マシンをホストすることのみを目的とした縮小版が含まれているかを示します。
`update_available`	ブール値	このホストに oVirt 関連の更新があるかどうかを指定します。
`version`	バージョン	VDSM のバージョン。
`vgpu_placement`	VgpuPlacement	vGPU 配置ストラテジーを指定します。

7.124.1. external_status
リンクのコピー

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

7.124.2. hosted_engine
リンクのコピー

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

重要

ホストまたはホストのコレクションが取得されるとき、操作の all_content パラメーターが明示的に true に設定されていない限り、この属性は含まれません。詳細は、ホスト 1 つまたは複数を取得する操作のドキュメントを参照してください。

7.124.3. kdump_status
リンクのコピー

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

7.124.4. ksm
リンクのコピー

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

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

PUT /ovirt-engine/api/hosts/123

PUT /ovirt-engine/api/hosts/123

Copy to Clipboard

Toggle word wrap

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

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

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

Copy to Clipboard

Toggle word wrap

7.124.5. libvirt_version
リンクのコピー

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

7.124.6. network_operation_in_progress
リンクのコピー

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

注記

この属性を応答に含めるには、ヘッダー All-Content:true を要求に追加する必要があります。

7.124.7. override_iptables
リンクのコピー

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

7.124.8. protocol
リンクのコピー

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

警告

エンジンのバージョン 4.1 以降、xml が削除されたため、プロトコルは常に stomp に設定されています。

7.124.9. se_linux
リンクのコピー

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

7.124.10. spm
リンクのコピー

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

7.124.11. status_detail
リンクのコピー

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

7.124.12. transparent_huge_pages
リンクのコピー

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

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

PUT /ovirt-engine/api/hosts/123

PUT /ovirt-engine/api/hosts/123

Copy to Clipboard

Toggle word wrap

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

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

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

Copy to Clipboard

Toggle word wrap

7.124.13. version
リンクのコピー

VDSM のバージョン。

以下に例を示します。

GET /ovirt-engine/api/hosts/123

GET /ovirt-engine/api/hosts/123

Copy to Clipboard

Toggle word wrap

この 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>

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

Copy to Clipboard

Toggle word wrap

Expand

表7.168 リンクの概要
名前	型	Summary
`affinity_labels`	AffinityLabel[]
`agents`	Agent[]
`cluster`	クラスター
`cpu_units`	HostCpuUnit[]	トポロジー (ソケット、コア) に関する詳細情報と、現在の CPU ピン留めに関する情報を含むすべてのホストの CPU のリスト。
`devices`	HostDevice[]
`external_host_provider`	ExternalHostProvider
`external_network_provider_configurations`	ExternalNetworkProviderConfiguration[]	ホスト上でプロビジョニングされた外部ネットワークプロバイダー。
`hooks`	Hook[]
`katello_errata`	KatelloErratum[]	ホストに割り当てられているすべての Katello エラータをリスト表示します。
`network_attachments`	NetworkAttachment[]
`nics`	HostNic[]
`numa_nodes`	NumaNode[]
`permissions`	Permission[]
`statistics`	Statistic[]	各ホストリソースは、ホスト固有の統計の統計サブコレクションを公開します。
`storage_connection_extensions`	StorageConnectionExtension[]
`storages`	HostStorage[]
`tags`	Tag[]
`unmanaged_networks`	UnmanagedNetwork[]

7.124.14. cpu_units
リンクのコピー

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

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

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

Copy to Clipboard

Toggle word wrap

以下のような 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>

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

Copy to Clipboard

Toggle word wrap

7.124.15. external_network_provider_configurations
リンクのコピー

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

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

7.124.16. katello_errata
リンクのコピー

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

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

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

Copy to Clipboard

Toggle word wrap

以下のような 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>

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

Copy to Clipboard

Toggle word wrap

7.124.17. statistics
リンクのコピー

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

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>

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

Copy to Clipboard

Toggle word wrap

注記

この統計サブコレクションは読み取り専用です。

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

Expand

名前	説明
`memory.total`	ホスト上の合計メモリー (バイト単位)。
`memory.used`	ホストで使用されるバイト単位のメモリー。
`memory.free`	ホスト上の空きメモリー (バイト単位)。
`memory.shared`	ホスト上で共有しているメモリー (バイト単位)。
`memory.buffers`	バイト単位の I/O バッファー。
`memory.cached`	OS のキャッシュ (バイト単位)。
`swap.total`	ホスト上の合計スワップメモリー (バイト単位)。
`swap.free`	ホスト上の空きスワップメモリー (バイト単位)。
`swap.used`	ホスト上で使用されているスワップメモリー (バイト単位)。
`swap.cached`	バイト単位のスワップメモリーもホストのメモリーにキャッシュされます。
`ksm.cpu.current`	カーネル SamePage マージの CPU 使用率。
`cpu.current.user`	ユーザースライスの CPU 使用率。
`cpu.current.system`	システムの CPU 使用率。
`cpu.current.idle`	アイドル状態の CPU 使用率。
`cpu.load.avg.5m`	5 分あたりの CPU 負荷の平均。
`boot.time`	マシンの起動時間。

トップに戻る

7.124. Host 構造体

7.124.1. external_status
リンクのコピー

7.124.2. hosted_engine
リンクのコピー

7.124.3. kdump_status
リンクのコピー

7.124.4. ksm
リンクのコピー

7.124.5. libvirt_version
リンクのコピー

7.124.6. network_operation_in_progress
リンクのコピー

7.124.7. override_iptables
リンクのコピー

7.124.8. protocol
リンクのコピー

7.124.9. se_linux
リンクのコピー

7.124.10. spm
リンクのコピー

7.124.11. status_detail
リンクのコピー

7.124.12. transparent_huge_pages
リンクのコピー

7.124.13. version
リンクのコピー

7.124.14. cpu_units
リンクのコピー

7.124.15. external_network_provider_configurations
リンクのコピー

7.124.16. katello_errata
リンクのコピー

7.124.17. statistics
リンクのコピー

詳細情報

試用、購入および販売

コミュニティー

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

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

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

7.124. Host 構造体

7.124.1. external_statusリンクのコピーリンクがクリップボードにコピーされました!

7.124.2. hosted_engineリンクのコピーリンクがクリップボードにコピーされました!

7.124.3. kdump_statusリンクのコピーリンクがクリップボードにコピーされました!

7.124.4. ksmリンクのコピーリンクがクリップボードにコピーされました!

7.124.5. libvirt_versionリンクのコピーリンクがクリップボードにコピーされました!

7.124.6. network_operation_in_progressリンクのコピーリンクがクリップボードにコピーされました!

7.124.7. override_iptablesリンクのコピーリンクがクリップボードにコピーされました!

7.124.8. protocolリンクのコピーリンクがクリップボードにコピーされました!

7.124.9. se_linuxリンクのコピーリンクがクリップボードにコピーされました!

7.124.10. spmリンクのコピーリンクがクリップボードにコピーされました!

7.124.11. status_detailリンクのコピーリンクがクリップボードにコピーされました!

7.124.12. transparent_huge_pagesリンクのコピーリンクがクリップボードにコピーされました!

7.124.13. versionリンクのコピーリンクがクリップボードにコピーされました!

7.124.14. cpu_unitsリンクのコピーリンクがクリップボードにコピーされました!

7.124.15. external_network_provider_configurationsリンクのコピーリンクがクリップボードにコピーされました!

7.124.16. katello_errataリンクのコピーリンクがクリップボードにコピーされました!

7.124.17. statisticsリンクのコピーリンクがクリップボードにコピーされました!

詳細情報

試用、購入および販売

コミュニティー

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

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

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

7.124.1. external_status
リンクのコピー

7.124.2. hosted_engine
リンクのコピー

7.124.3. kdump_status
リンクのコピー

7.124.4. ksm
リンクのコピー

7.124.5. libvirt_version
リンクのコピー

7.124.6. network_operation_in_progress
リンクのコピー

7.124.7. override_iptables
リンクのコピー

7.124.8. protocol
リンクのコピー

7.124.9. se_linux
リンクのコピー

7.124.10. spm
リンクのコピー

7.124.11. status_detail
リンクのコピー

7.124.12. transparent_huge_pages
リンクのコピー

7.124.13. version
リンクのコピー

7.124.14. cpu_units
リンクのコピー

7.124.15. external_network_provider_configurations
リンクのコピー

7.124.16. katello_errata
リンクのコピー

7.124.17. statistics
リンクのコピー