1.3. 検索

1.3.1. Red Hat Virtualization での検索

管理ポータルでは、仮想マシン、ホスト、ユーザーなど、何千ものリソースを管理することができます。検索を行うには、各リソースのメインページにある検索バーに、検索クエリー (フリーテキストまたは構文ベース) を入力します。検索条件をブックマークとして保存しておけば、検索結果を必要とするたびに検索条件を再入力する必要はありません。検索では大文字小文字の区別はありません。

1.3.2. 検索構文と例

Red Hat Virtualization リソースの検索クエリーの構文は以下のとおりです。

result type: {criteria} [sortby sort_spec]

構文の例

以下の例は、検索クエリーの使用方法と、Red Hat Virtualization が検索クエリーの構築を支援する方法を理解するのに役立ちます。

表1.15 検索クエリーの例
例	結果
Hosts: Vms.status = up page 2	稼働中の仮想マシンを実行しているすべてのホストのリストの 2 ページ目を表示します。
Vms: domain = qa.company.com	指定されたドメインで稼働しているすべての仮想マシンの一覧を表示します。
Vms: users.name = Mary	ユーザー名が Mary のユーザーに属する全仮想マシンの一覧を表示します。
Events: severity > normal sortby time	重大度が Normal よりも高いすべての Events の一覧を表示します。

1.3.3. 自動完了の検索

管理ポータルは、有効で強力な検索クエリーの作成に役立つ自動補完を提供します。検索クエリーの各部分を入力すると、検索の次の部分を選択するドロップダウンリストが、Search Bar の下に開きます。一覧から選択して検索の次の部分を入力/選択するか、オプションを無視して手動でクエリーを入力できます。

以下の表では、管理ポータルでクエリーを構築する際に自動補完がどのように機能するか、例を挙げて説明しています。

Hosts: Vms.status = down

表1.16 自動補完を使用した検索クエリーの例
入力	表示されるリスト項目	アクション
h	`Hosts` (1 つのオプションのみ)	`Hosts` を選択、または Hosts を入力
Hosts:	すべてのホストプロパティー	v を入力
Hosts: v	`v` で始まるホストプロパティー	`Vms` を選択、または Vms を入力
Hosts: Vms	すべての仮想マシンプロパティー	s を入力
Hosts: Vms.s	`s` で始まるすべての仮想マシンプロパティー	`status` を選択、または status を入力
Hosts: Vms.status	`=` `!=`	= を選択/入力
Hosts: Vms.status =	すべてのステータス値	down を選択/入力

1.3.4. 検索結果タイプのオプション

結果タイプを使用すると、以下のタイプのリソースを検索できます。

Vms、仮想マシンのリスト。
Host、ホストのリスト。
Pools、プールのリスト。
Template、テンプレートのリスト。
Events、イベントのリスト。
Users、ユーザーのリスト。
Cluster、クラスターのリスト。
DataCenter、データセンターのリスト。
Storage、ストレージドメインのリスト。

各タイプのリソースには、一意のプロパティーセットと、関連付けられたその他のリソースタイプのセットがあるため、各検索タイプには、有効な構文の組み合わせがあります。自動補完機能を使用すると、有効なクエリーも簡単に作成できます。

1.3.5. 検索基準

クエリーのコロンの後に検索条件を指定できます。{criteria} の構文は以下のようになります。

<prop><operator><value>

または

<obj-type><prop><operator><value>

例

以下の表は、構文の部分を示しています。

表1.17 検索基準の例
部分	説明	値	例	注記
prop	検索対象リソースのプロパティー。リソースタイプのプロパティー (`obj-type` を参照) または tag (カスタムタグ) にすることもできます。	検索対象を、特定のプロパティーを持つオブジェクトに制限します。たとえば、status プロパティーでオブジェクトを検索します。	Status	該当なし
obj-type	検索対象のリソースに関連付けることができるリソースタイプ。	データセンターや仮想マシンなどのシステムオブジェクトです。	Users	該当なし
operator	比較演算子。	= != (等しくない) > < >= <=	該当なし	値オプションはプロパティーによって異なります。
Value	その式が何と比較されるか。	文字列 Integer Ranking Date (Regional Settings に応じた書式設定)	Jones 256 normal	ワイルドカードは文字列内で使用できます。 "" (間にスペースが入っていない 2 つの引用符のセット) は、初期化されていない (空の) 文字列を表すために使用できます。スペースが含まれる文字列または日付を二重引用符で囲む必要があります

1.3.6. 検索: 複数の基準およびワイルドカード

ワイルドカードは文字列の構文の <value> 部分で使用できます。たとえば、m で始まる全ユーザーを検索するには、m* を入力します。

ブール演算子の AND および OR を使用して、2 つの基準を持つ検索を実行できます。以下に例を示します。

Vms: users.name = m* AND status = Up

このクエリーは、名前が "m" で始まるユーザーに対して実行中の仮想マシンをすべて返します。

Vms: users.name = m* AND tag = "paris-loc"

このクエリーは、名前が "m" で始まるユーザーに対して "paris-loc" でタグ付けされたすべての仮想マシンを返します。

AND または OR を使用せずに 2 つの基準を指定した場合、AND が暗黙的に指定されます。AND は OR よりも優先され、OR は暗黙の AND よりも優先されます。

1.3.7. 検索: 検索順序の決定

返される情報の並び替え順序は、sortby を使用して決定できます。並べ替え方向 (昇順は asc、降順は desc) を含めることができます。

以下に例を示します。

events: severity > normal sortby time desc

このクエリーは、重大度が Normal よりも大きいすべての Events を時刻でソートして返します (降順)。

1.3.8. データセンターの検索

以下の表は、データセンターのすべての検索オプションを示しています。

表1.18 データセンターの検索
プロパティー (リソースまたはリソースタイプの)	タイプ	説明 (参照)
`Clusters.clusters-prop`	プロパティータイプによります。	データセンターに関連付けられたクラスターのプロパティー。
`name`	文字列	データセンターの名前。
`description`	文字列	データセンターの説明。
`type`	文字列	データセンターのタイプ。
`status`	List	データセンターの可用性。
`sortby`	List	返された結果をリソースプロパティーの 1 つで並べ替えます。
`page`	Integer	表示する結果のページ番号。

例

Datacenter: type = nfs and status != up

この例では、ストレージタイプが NFS で、ステータスが up 以外のデータセンターの一覧を返します。

1.3.9. クラスターの検索

以下の表は、クラスターのすべての検索オプションを説明しています。

表1.19 クラスターの検索
プロパティー (リソースまたはリソースタイプの)	タイプ	説明 (参照)
`Datacenter.datacenter-prop`	プロパティータイプによります。	クラスターに関連付けられたデータセンターのプロパティー。
`Datacenter`	文字列	クラスターが属するデータセンター。
`name`	文字列	ネットワーク上のクラスターを識別する一意の名前。
`description`	文字列	クラスターの説明。
`initialized`	文字列	クラスターのステータスを示す True または False。
`sortby`	List	返された結果をリソースプロパティーの 1 つで並べ替えます。
`page`	Integer	表示する結果のページ番号。

例

Clusters: initialized = true or name = Default

この例では、初期化されたクラスターまたは Default という名前のクラスターの一覧を返します。

1.3.10. ホストの検索

以下の表は、ホストの全検索オプションを示しています。

表1.20 ホストの検索
プロパティー (リソースまたはリソースタイプの)	タイプ	説明 (参照)
`Vms.Vms-prop`	プロパティータイプによります。	ホストに関連付けられた仮想マシンのプロパティー。
`Templates.templates-prop`	プロパティータイプによります。	ホストに関連付けられたテンプレートのプロパティー。
`Events.events-prop`	プロパティータイプによります。	ホストに関連付けられたイベントのプロパティー。
`Users.users-prop`	プロパティータイプによります。	ホストに関連付けられたユーザーのプロパティー。
`name`	文字列	ホストの名前。
`status`	List	ホストの可用性。
`external_status`	文字列	外部システムおよびプラグインによって報告されるホストのヘルスステータス。
`cluster`	文字列	ホストが属するクラスター。
`address`	文字列	ネットワーク上のホストを識別する一意の名前。
`cpu_usage`	Integer	使用される処理能力の割合。
`mem_usage`	Integer	使用されるメモリーの割合。
`network_usage`	Integer	ネットワーク使用率の割合。
`load`	Integer	特定のタイムスライスで、プロセッサーごとに run-queue で実行されるのを待っているジョブ。
`version`	Integer	オペレーティングシステムのバージョン番号。
`cpus`	Integer	ホスト上の CPU 数。
`memory`	Integer	使用可能なメモリーの量。
`cpu_speed`	Integer	CPU の処理速度。
`cpu_model`	文字列	CPU のタイプ。
`active_vms`	Integer	現在実行中の仮想マシンの数。
`migrating_vms`	Integer	現在移行中の仮想マシンの数。
`committed_mem`	Integer	コミットされたメモリーの割合
`tag`	文字列	ホストに割り当てられたタグ。
`type`	文字列	ホストのタイプ。
`datacenter`	文字列	ホストが属するデータセンター。
`sortby`	List	返された結果をリソースプロパティーの 1 つで並べ替えます。
`page`	Integer	表示する結果のページ番号。

例

Hosts: cluster = Default and Vms.os = rhel6

この例では、Default クラスターの一部であるホストの一覧と、Red Hat Enterprise Linux 6 オペレーティングシステムを実行するホスト仮想マシンを返します。

1.3.11. ネットワークの検索

以下の表は、ネットワークの全検索オプションを説明しています。

表1.21 ネットワークの検索
プロパティー (リソースまたはリソースタイプの)	タイプ	説明 (参照)
`Cluster_network.clusternetwork-prop`	プロパティータイプによります。	ネットワークに関連付けられたクラスターのプロパティー。
`Host_Network.hostnetwork-prop`	プロパティータイプによります。	ネットワークに関連付けられたホストのプロパティー。
`name`	文字列	ネットワークを識別するための人が判読可能な名前。
`description`	文字列	ネットワークを記述するキーワードまたはテキスト。オプションでネットワークの作成時に使用されます。
`vlanid`	Integer	ネットワークの VLAN ID。
`stp`	文字列	Spanning Tree Protocol (STP) がネットワークで有効か無効かを示します。
`mtu`	Integer	論理ネットワークの最大伝送単位。
`vmnetwork`	文字列	ネットワークが仮想マシントラフィックのみに使用されているかどうか。
`datacenter`	文字列	ネットワークが接続されているデータセンター。
`sortby`	List	返された結果をリソースプロパティーの 1 つで並べ替えます。
`page`	Integer	表示する結果のページ番号。

例

Network: mtu > 1500 and vmnetwork = true

この例では、最大転送単位が 1500 バイトを超え、仮想マシンのみが使用するように設定されているネットワークの一覧を返します。

1.3.12. ストレージの検索

以下の表は、ストレージのすべての検索オプションを説明しています。

表1.22 ストレージの検索
プロパティー (リソースまたはリソースタイプの)	タイプ	説明 (参照)
`Hosts.hosts-prop`	プロパティータイプによります。	ストレージに関連付けられたホストのプロパティー。
`Clusters.clusters-prop`	プロパティータイプによります。	ストレージに関連付けられたクラスターのプロパティー。
`name`	文字列	ネットワーク上のストレージを識別する一意の名前。
`status`	文字列	ストレージドメインのステータス。
`external_status`	文字列	外部システムおよびプラグインによって報告されるストレージドメインのヘルスステータス。
`datacenter`	文字列	ストレージが属するデータセンター。
`type`	文字列	ストレージのタイプ。
`free-size`	Integer	空きストレージのサイズ (GB)。
`used-size`	Integer	使用されるストレージの容量 (GB)。
`total_size`	Integer	利用可能なストレージの合計量 (GB)。
`committed`	Integer	コミットされたストレージの量 (GB)。
`sortby`	List	返された結果をリソースプロパティーの 1 つで並べ替えます。
`page`	Integer	表示する結果のページ番号。

例

Storage: free_size > 6 GB and total_size < 20 GB

この例では、空き領域が 6 GB を超えるストレージの一覧または、合計ストレージ容量が 20 GB 未満のストレージの一覧を返します。

1.3.13. ディスクの検索

以下の表は、ディスクの全検索オプションを示しています。

注記

Disk Type および Content Type フィルターオプションを使用して、表示される仮想ディスクの数を減らすことができます。

表1.23 ディスクの検索
プロパティー (リソースまたはリソースタイプの)	タイプ	説明 (参照)
`Datacenters.datacenters-prop`	プロパティータイプによります。	ディスクに関連付けられたデータセンターのプロパティー。
`Storages.storages-prop`	プロパティータイプによります。	ディスクに関連付けられたストレージのプロパティー。
`alias`	文字列	ネットワーク上のストレージを識別する人が判読可能な名前。
`description`	文字列	ディスクを記述するキーワードまたはテキスト。オプションでディスクの作成時に使用されます。
`provisioned_size`	Integer	ディスクの仮想サイズ
`size`	Integer	ディスクのサイズ。
`actual_size`	Integer	ディスクに割り当てられる実際のサイズ。
`creation_date`	Integer	ディスクが作成された日付。
`bootable`	文字列	ディスクを起動できるかどうか。有効な値は `0`、`1`、`yes`、`no` のいずれかです。
`shareable`	文字列	ディスクを一度に複数の仮想マシンにアタッチできるかどうか。有効な値は `0`、`1`、`yes`、`no` のいずれかです。
`format`	文字列	ディスクの形式。`unused`、`unassigned`、`cow`、`raw` のいずれかです。
`status`	文字列	ディスクのステータス`unassigned`、`ok`、`locked`、`invalid`、`illegal` のいずれかです。
`disk_type`	文字列	ディスクのタイプ。`image` または `lun` のいずれかです。
`number_of_vms`	Integer	ディスクがアタッチされている仮想マシンの数。
`vm_names`	文字列	ディスクがアタッチされている仮想マシンの名前。
`quota`	文字列	仮想ディスクで強制されるクォータの名前。
`sortby`	List	返された結果をリソースプロパティーの 1 つで並べ替えます。
`page`	Integer	表示する結果のページ番号。

例

Disks: format = cow and provisioned_size > 8

この例では、QCOW 形式の仮想ディスクの一覧と、8 GB を超える割り当て済みのディスクサイズを返します。

1.3.14. ボリュームの検索

以下の表は、ボリュームのすべての検索オプションを説明しています。

表1.24 ボリュームの検索
プロパティー (リソースまたはリソースタイプの)	タイプ	説明 (参照)
`Cluster`	文字列	ボリュームに関連付けられたクラスターの名前。
`Cluster.cluster-prop`	プロパティータイプ (例: name、description、comment、architecture) による	ボリュームに関連付けられたクラスターのプロパティー。
`name`	文字列	ボリュームを識別する、人が判読可能な名前。
`type`	文字列	distribute、replicate、distributed_replicate、stripe、または distributed_stripe のいずれか。
`transport_type`	Integer	TCP または RDMA のいずれか。
`replica_count`	Integer	レプリカの数。
`stripe_count`	Integer	ストライプの数。
`status`	文字列	ボリュームのステータス。Up または Down のいずれかです。
`sortby`	List	返された結果をリソースプロパティーの 1 つで並べ替えます。
`page`	Integer	表示する結果のページ番号。

例

Volume: transport_type = rdma and stripe_count >= 2

この例では、トランスポートタイプが RDMA に設定され、ストライプが 2 つ以上あるボリュームのリストを返します。

1.3.15. 仮想マシンの検索

以下の表は、仮想マシンのすべての検索オプションを説明しています。

注記

現時点で、Network Label、Custom Emulated Machine、および Custom CPU Type プロパティーはサポートされていない検索プロパティーです。

表1.25 仮想マシンの検索
プロパティー (リソースまたはリソースタイプの)	タイプ	説明 (参照)
`Hosts.hosts-prop`	プロパティータイプによります。	仮想マシンに関連付けられたホストのプロパティー。
`Templates.templates-prop`	プロパティータイプによります。	仮想マシンに関連付けられたテンプレートのプロパティー。
`Events.events-prop`	プロパティータイプによります。	仮想マシンに関連付けられたイベントのプロパティー。
`Users.users-prop`	プロパティータイプによります。	仮想マシンに関連付けられたユーザーのプロパティー。
`Storage.storage-prop`	プロパティータイプによります。	仮想マシンに関連付けられたストレージデバイスのプロパティー。
`Vnic.vnic-prop`	プロパティータイプによります。	仮想マシンに関連付けられた vNIC のプロパティー。
`name`	文字列	仮想マシンの名前。
`status`	List	仮想マシンの可用性
`ip`	Integer	仮想マシンの IP アドレス。
`uptime`	Integer	仮想マシンが実行されている期間 (分単位)。
`domain`	文字列	マシンをグループ化するドメイン (通常は Active Directory ドメイン)。
`os`	文字列	仮想マシンの作成時に選択されたオペレーティングシステム。
`creationdate`	Date	仮想マシンが作成された日付。
`address`	文字列	ネットワーク上の仮想マシンを識別する一意の名前。
`cpu_usage`	Integer	使用される処理能力の割合。
`mem_usage`	Integer	使用されるメモリーの割合。
`network_usage`	Integer	使用されるネットワークの割合。
`memory`	Integer	定義された最大メモリー。
`apps`	文字列	仮想マシンに現在インストールされているアプリケーション。
`cluster`	List	仮想マシンが属するクラスター。
`pool`	List	仮想マシンが属する仮想マシンプール。
`loggedinuser`	文字列	仮想マシンに現在ログインしているユーザーの名前。
`tag`	List	仮想マシンが属するタグ。
`datacenter`	文字列	仮想マシンが属するデータセンター。
`type`	List	仮想マシンタイプ (サーバーまたはデスクトップ)。
`quota`	文字列	仮想マシンに関連付けられたクォータの名前。
`description`	文字列	仮想マシンを記述するキーワードまたはテキスト。オプションとして、仮想マシンの作成時に使用されます。
`sortby`	List	返された結果をリソースプロパティーの 1 つで並べ替えます。
`page`	Integer	表示する結果のページ番号。
`next_run_configuration_exists`	Boolean	仮想マシンに保留中の設定変更があります。

例

Vms: template.name = Win* and user.name = ""

この例では、ベーステンプレート名が Win で始まり、任意のユーザーに割り当てられている仮想マシンの一覧を返します。

例

Vms: cluster = Default and os = windows7

この例では、Default クラスターに属し、Windows 7 を実行している仮想マシンの一覧を返します。

1.3.16. プールの検索

以下の表は、プールの全検索オプションを示しています。

表1.26 プールの検索
プロパティー (リソースまたはリソースタイプの)	タイプ	説明 (参照)
`name`	文字列	プールの名前。
`description`	文字列	プールの説明。
`type`	List	プールのタイプ。
`sortby`	List	返された結果をリソースプロパティーの 1 つで並べ替えます。
`page`	Integer	表示する結果のページ番号。

例

Pools: type = automatic

この例では、タイプが automatic のプールの一覧を返します。

1.3.17. テンプレートの検索

以下の表は、テンプレートの全検索オプションを示しています。

表1.27 テンプレートの検索
プロパティー (リソースまたはリソースタイプの)	タイプ	説明 (参照)
`Vms.Vms-prop`	文字列	テンプレートに関連付けられた仮想マシンのプロパティー。
`Hosts.hosts-prop`	文字列	テンプレートに関連付けられたホストのプロパティー。
`Events.events-prop`	文字列	テンプレートに関連付けられたイベントのプロパティー。
`Users.users-prop`	文字列	テンプレートに関連付けられたユーザーのプロパティー。
`name`	文字列	テンプレートの名前。
`domain`	文字列	テンプレートのドメイン。
`os`	文字列	オペレーティングシステムのタイプ。
`creationdate`	Integer	テンプレートが作成された日付。日付の形式は mm/dd/yy です。
`childcount`	Integer	テンプレートから作成された仮想マシンの数。
`mem`	Integer	定義されたメモリー。
`description`	文字列	テンプレートの説明。
`status`	文字列	テンプレートのステータス。
`cluster`	文字列	テンプレートに関連付けられたクラスター。
`datacenter`	文字列	テンプレートに関連付けられたデータセンター。
`quota`	文字列	テンプレートに関連付けられたクォータ。
`sortby`	List	返された結果をリソースプロパティーの 1 つで並べ替えます。
`page`	Integer	表示する結果のページ番号。

例

Template: Events.severity >= normal and Vms.uptime > 0

この例では、テンプレートから派生した仮想マシンで重大度が Normal 以上のイベントが発生し、かつ仮想マシンが引き続き実行されているテンプレートの一覧が返されます。

1.3.18. ユーザーの検索

以下の表は、ユーザーの全検索オプションを説明しています。

表1.28 ユーザーの検索
プロパティー (リソースまたはリソースタイプの)	タイプ	説明 (参照)
`Vms.Vms-prop`	プロパティータイプによります。	ユーザーに関連付けられた仮想マシンのプロパティー。
`Hosts.hosts-prop`	プロパティータイプによります。	ユーザーに関連付けられたホストのプロパティー。
`Templates.templates-prop`	プロパティータイプによります。	ユーザーに関連付けられたテンプレートのプロパティー。
`Events.events-prop`	プロパティータイプによります。	ユーザーに関連するイベントのプロパティー。
`name`	文字列	ユーザーの名前。
`lastname`	文字列	ユーザーの名字。
`usrname`	文字列	ユーザーの一意の名前。
`department`	文字列	ユーザーが属する部門。
`group`	文字列	ユーザーが属するグループ。
`title`	文字列	ユーザーのタイトル。
`status`	文字列	ユーザーの状態。
`role`	文字列	ユーザーのロール。
`tag`	文字列	ユーザーが属するタグ。
`pool`	文字列	ユーザーが属するプール。
`sortby`	List	返された結果をリソースプロパティーの 1 つで並べ替えます。
`page`	Integer	表示する結果のページ番号。

例

Users: Events.severity > normal and Vms.status = up or Vms.status = pause

この例では、仮想マシンで重大度が Normal よりも高いイベントが発生し、かつ仮想マシンがまだ稼働している場合や、ユーザーの仮想マシンが一時停止している場合のユーザーの一覧を返します。

1.3.19. イベントの検索

以下の表は、イベントの検索に使用できるすべての検索オプションを説明しています。自動補完は、必要に応じて多くのオプションに対して提供されます。

表1.29 イベントの検索
プロパティー (リソースまたはリソースタイプの)	タイプ	説明 (参照)
`Vms.Vms-prop`	プロパティータイプによります。	イベントに関連付けられた仮想マシンのプロパティー。
`Hosts.hosts-prop`	プロパティータイプによります。	イベントに関連付けられたホストのプロパティー。
`Templates.templates-prop`	プロパティータイプによります。	イベントに関連付けられたテンプレートのプロパティー。
`Users.users-prop`	プロパティータイプによります。	イベントに関連付けられたユーザーのプロパティー。
`Clusters.clusters-prop`	プロパティータイプによります。	イベントに関連付けられたクラスターのプロパティー。
`Volumes.Volumes-prop`	プロパティータイプによります。	イベントに関連付けられたボリュームのプロパティー。
`type`	List	イベントのタイプ。
`severity`	List	イベントの重大度: Warning/Error/Normal
`message`	文字列	イベントタイプの説明。
`time`	List	イベントが発生した日。
`usrname`	文字列	イベントに関連付けられたユーザー名。
`event_host`	文字列	イベントに関連付けられたホスト。
`event_vm`	文字列	イベントに関連付けられた仮想マシン。
`event_template`	文字列	イベントに関連付けられたテンプレート。
`event_storage`	文字列	イベントに関連付けられたストレージ。
`event_datacenter`	文字列	イベントに関連付けられたデータセンター。
`event_volume`	文字列	イベントに関連付けられたボリューム。
`correlation_id`	Integer	イベントの識別番号。
`sortby`	List	返された結果をリソースプロパティーの 1 つで並べ替えます。
`page`	Integer	表示する結果のページ番号。

例

Events: Vms.name = testdesktop and Hosts.name = gonzo.example.com

この例では、ホスト gonzo.example.com で実行中の testdesktop という名前の仮想マシンで発生したイベントの一覧を返します。