第14章 ホスト
14.1. ホスト要素
hosts コレクションは、Red Hat Virtualization 環境内のホストに関する情報を提供します。API ユーザーは、エントリーポイント URI から取得した rel="hosts" リンクを使用してこの情報にアクセスします。
All-Content: true ヘッダーを使用して GET リクエストに関する追加情報を取得できます。
以下の表は、ホストリソース表現に含まれる特定の要素を示しています。
| 要素 | タイプ | 説明 | プロパティー |
|---|---|---|---|
link rel="storage" | 関係 | ホスト ストレージのストレージ サブコレクションへのリンク。 | 
|
link rel="nics" | 関係 | ホストネットワークインターフェイスの nics サブコレクションへのリンク。 | |
link rel="numanodes" | 関係 | ホスト NUMA ノードの numanodes サブコレクションへのリンク。 | |
link rel="tags" | 関係 | ホスト タグのタグ サブコレクションへのリンク。 | |
link rel="permissions" | 関係 | ホスト パーミッションのパーミッション サブコレクションへのリンク。 | |
link rel="statistics" | 関係 | ホスト 統計の統計 サブコレクションへのリンク。 |
|
link rel="hooks" | 関係 | ホスト フックのフック サブコレクションへのリンク。 | |
link rel="fenceagents" | 関係 | ホストフェンスエージェント用の フェンスエージェント サブコレクションへのリンク。 | |
link rel="katelloerrata" | 関係 | ホストエラータの katelloerrata サブコレクションへのリンク。 | |
link rel="devices" | 関係 | ホスト デバイスのデバイス サブコレクションへのリンク。 | |
link rel="networkattachments" | 関係 | ホストネットワーク設定用の networkattachments サブコレクションへのリンク。 | |
link rel="unmanagednetworks" | 関係 | ホスト上の管理対象外ネットワークの unmanagednetworks サブコレクションへのリンク。 | |
link rel="storageconnectionextensions" | 関係 | ホストストレージ接続拡張用の storageconnectionextensions サブコレクションへのリンク。 | |
name | string | ホストの一意識別子。 | |
root_password | string | このホストのルートパスワードは、作成時にクライアント提供のホスト表現にのみ含まれる慣例によるものです。 | 
|
comment | string | ホストに関するコメント。 | |
address | string | ホストの IP アドレスまたはホスト名。 |
|
certificate | complex | 組織 および サブジェクト を含むホスト証明書の詳細への参照。 |
|
status | 以下を参照してください。 | ホストのステータス。 |
|
external_status | 複雑/列挙型 | 外部システムおよびプラグインによって報告されるホストのヘルスステータス。state 要素には、ok、info、warning、error、または failure の列挙値が含まれます。 | |
Cluster id= | GUID | このホストを含むクラスターへの参照。 | |
port | integer | このホストで実行されている VDSM デーモンのリッスンポート。 |
|
type | rhel または ovirt_nodeのいずれか | ホストタイプ。 |
|
storage_manager priority= | ブール値：true または false | ホストがストレージマネージャーであるかどうかを指定します。 |
|
version major= minor= build= revision= full_version= | complex | ホストの互換性レベルです。 |
|
hardware_information | complex | 製造元、バージョン、serial_number、product_name、uuid、ファミリー など、ホストのハードウェアに関する情報。 | |
power_management type= | complex | 有効な オプション、kdump_detection オプション、auto_pm_ 、ホストの電源管理用設定オプション。ホストの電源管理オプションの詳細は、「電源管理要素」 を参照してください。 | |
ksm | ブール値：true または false | Kernel SamePage Merging (KSM)が有効な場合は True。 | |
transparent_hugepages | ブール値：true または false | THP が 有効になっている場合は True。 | |
iscsi | complex | ホストの SCSI イニシエーター。 |
|
ssh | complex | ポート や フィンガープリント を含む、ホストとの SSH 接続に関する詳細。 | |
cpu | complex | ホスト CPU の統計。CPU の 名前、トポロジーコア=、トポロジー 、および speed のサブ要素が含まれます。トポロジー cores= はコアの合計を集約し、トポロジー sockets= は物理 CPU の合計を集約します。仮想マシンで利用可能なコアの合計は、ソケット数をソケットごとに乗算したソケット数と等しくなります。 |
|
memory | integer | ホストメモリーの合計量（バイト単位）。 |
|
max_scheduling_memory | integer | スケジューリングで使用できるメモリーの最大量（バイト単位）。 |
|
summary | complex | ホスト上の仮想マシンの要約統計。アクティブな、移行、および 合計 の仮想マシン数のサブ要素が含まれます。 |
|
OS type= | complex | バージョン full_version= を含む、ホストにインストールされているオペレーティングシステムの詳細。 |
|
libvirt_version major= minor= build= revision= full_version= | complex | ホストの libvirt 互換性レベル。 |
|
ステータス には、down,error,initializing,installing,install_failed,maintenance,non_operational,non_responsive,pending_approval,preparing_for_maintenance,connecting,reboot,unassigned and up の列挙値のいずれかが含まれます。これらの状態は capabilities の host_states に一覧表示されます。
