1.3. 搜索

1.3.1. 在 Red Hat Virtualization 中执行搜索

管理门户允许您管理数千资源，如虚拟机、主机、用户等。要执行搜索，请在搜索栏中输入搜索查询（自由文本或语法），可在每个资源的主页中找到。搜索查询可以保存为书签以供以后重复使用，因此您不必在每次需要特定搜索结果时重新设置搜索查询。搜索不区分大小写。

1.3.2. 搜索语法和示例

对 Red Hat Virtualization 资源的搜索查询的语法如下：

结果类型：{criteria} [sortby sort_spec]

语法示例

以下示例描述了如何使用搜索查询，并帮助您了解 Red Hat Virtualization 如何协助构建搜索查询。

表 1.15. Search Queries 示例
Example	结果
Hosts: Vms.status = up page 2	显示正在运行虚拟机的所有主机的列表（第 2 页）。
VM: domain = qa.company.com	显示在指定域中运行的所有虚拟机的列表。
VM: users.name = Mary	显示属于用户名称 Mary 的所有虚拟机的列表。
events: severity > normal sortby time	显示所有严重性高于 Normal 的事件的列表，按时间排序。

1.3.3. 搜索 Auto-Completion

管理门户提供自动完成功能，可帮助您创建有效且强大的搜索查询。当您输入搜索查询的每个部分时，搜索的下一部分的下拉列表会在搜索栏下打开。您可以从列表中选择，然后继续键入/选择搜索的下一部分，或者忽略选项并继续手动输入查询。

下表指定，管理门户自动完成有助于构建查询的示例：

Hosts: Vms.status = down

表 1.16. 使用 Auto-Completion 的搜索查询示例
输入	列出显示的项目	操作
h	`Hosts` (仅 1 个选项)	选择 `Hosts` 或 type Hosts
Hosts：	所有主机属性	类型 v
Hosts: v	从 `v`开始的主机属性	选择 `Vms` 或 type Vms
Hosts: Vms	所有虚拟机属性	类型 s
Hosts：Vms.s	以 `s`开头的所有虚拟机属性	选择 `状态` 或类型状态
Hosts: Vms.status	`=` `!=`	选择或类型 =
Hosts: Vms.status =	所有状态值	选择或类型关闭

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. 搜索条件示例
Part	Description	值	Example	备注
prop	search-for 资源的属性。也可以是资源类型的属性（请参阅 `obj-type`）或 tag (custom tag)。	将搜索范围限制为带有特定属性的对象。例如，搜索具有 status 属性的对象。	状态	N/A
obj-type	与搜索资源关联的资源类型。	它们是系统对象，如数据中心和虚拟机。	用户	N/A
operator	比较运算符。	= != (not equal) > < >= <=	N/A	值选项取决于属性。
值	哪些表达式与以下内容进行比较：	字符串整数等级日期（根据区域设置格式化）	jones 256 normal	通配符可以在字符串中使用。 "" （两个一组没有空格的引号），可用于表示未初始化（空字符串）字符串。双引号应该在包含空格的字符串或日期后面使用

1.3.6. 搜索：多个标准和通配符

通配符可用于字符串语法的 <value > 部分。例如，要查找以 m 开头的所有用户，请输入 m*。

您可以使用布尔值运算符和 OR 执行具有两个 条件 的搜索。例如：

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

此查询返回所有正在运行的虚拟机，适用于其名称以"m"开头的用户。

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

对于名称以"m"开头的用户，此查询会返回带有"paris-loc"标记的所有虚拟机。

在没有使用 AND 或 OR 的情况下指定了两个条件，代表 AND。AND 的优先级高于 OR，OR 的优先级高于没有明确指定的 AND。

1.3.7. 搜索：确定搜索顺序

您可以使用 sortby 确定返回的信息的排序顺序。可以包括排序方向（asc 代表升序，desc 代表降序）。

例如：

events: severity > normal sortby time desc

此查询会返回所有严重性高于 Normal 的事件，按时间排序（降序）。

1.3.8. 搜索数据中心

下表描述了数据中心的所有搜索选项。

表 1.18. 搜索数据中心
属性（资源或资源类型）	类型	描述（参考）
`cluster.cluster-prop`	取决于属性类型	与数据中心关联的集群属性。
`name`	字符串	数据中心的名称。
`description`	字符串	数据中心的描述。
`type`	字符串	数据中心的类型。
`status`	list	数据中心的可用性。
`sortby`	list	根据其中一个资源属性对返回的结果进行排序。
`page`	整数	要显示的结果的页面数。

Example

datacenter: type = nfs and status != up

这个示例返回类型为 NFS 的数据中心列表，以及除 up 以外的状态。

1.3.9. 搜索集群

下表描述了集群的所有搜索选项。

表 1.19. 搜索集群
属性（资源或资源类型）	类型	描述（参考）
`Datacenter.datacenter-prop`	取决于属性类型	与集群关联的数据中心的属性。
`数据中心`	字符串	集群所属的数据中心。
`name`	字符串	标识网络上的集群的唯一名称。
`description`	字符串	集群的描述。
`初始化`	字符串	判断集群的状态的 True 或 False。
`sortby`	list	根据其中一个资源属性对返回的结果进行排序。
`page`	整数	要显示的结果的页面数。

Example

clusters: initialized = true 或 name = Default

本例返回初始化或名为 Default 的集群列表。

1.3.10. 搜索主机

下表描述了主机的所有搜索选项。

表 1.20. 搜索主机
属性（资源或资源类型）	类型	描述（参考）
`vm.Vms-prop`	取决于属性类型	与主机关联的虚拟机的属性。
`templates.templates-prop`	取决于属性类型	与主机关联的模板的属性。
`events.events-prop`	取决于属性类型	与主机关联的事件的属性。
`users.users-prop`	取决于属性类型	与主机关联的用户的属性。
`name`	字符串	主机的名称。
`status`	list	主机的可用性。
`external_status`	字符串	外部系统和插件报告的主机的健康状况。
`cluster`	字符串	主机所属的集群。
`address`	字符串	标识网络主机上主机的唯一名称。
`cpu_usage`	整数	使用的处理能力百分比。
`mem_usage`	整数	使用的内存百分比。
`network_usage`	整数	网络使用量的百分比。
`load`	整数	在给定时间片段中的每个处理器的 run-queue 中执行的作业。
`version`	整数	操作系统的版本号。
`cpus`	整数	主机上的 CPU 数量。
`内存`	整数	可用的内存量。
`cpu_speed`	整数	CPU 的处理速度。
`cpu_model`	字符串	CPU 的类型。
`active_vms`	整数	当前运行的虚拟机数量。
`migrating_vms`	整数	当前迁移的虚拟机数量。
`committed_mem`	整数	已提交的内存百分比。
`tag`	字符串	分配给主机的标签。
`type`	字符串	主机的类型。
`datacenter`	字符串	主机所属的数据中心。
`sortby`	list	根据其中一个资源属性对返回的结果进行排序。
`page`	整数	要显示的结果的页面数。

Example

Hosts: cluster = Default 和 Vms.os = rhel6

这个示例返回作为默认集群的一部分的主机列表，以及运行 Red Hat Enterprise Linux 6 操作系统的主机。

1.3.11. 搜索网络

下表描述了网络的所有搜索选项。

表 1.21. 搜索网络
属性（资源或资源类型）	类型	描述（参考）
`Cluster_network.clusternetwork-prop`	取决于属性类型	与网络关联的集群的属性。
`Host_Network.hostnetwork-prop`	取决于属性类型	与网络关联的主机的属性。
`name`	字符串	标识网络的人类可读名称。
`description`	字符串	描述网络的关键字或文本（在创建网络时可选使用）。
`vlanid`	整数	网络的 VLAN ID。
`stp`	字符串	网络是否启用或禁用生成树协议(STP)。
`mtu`	整数	逻辑网络的最大传输单元。
`vmnetwork`	字符串	网络是否仅用于虚拟机流量。
`datacenter`	字符串	附加网络的数据中心。
`sortby`	list	根据其中一个资源属性对返回的结果进行排序。
`page`	整数	要显示的结果的页面数。

Example

Network: mtu > 1500 and vmnetwork = true

这个示例会返回一个最大传输单元大于 1500 字节的网络列表，仅用于虚拟机使用。

1.3.12. 搜索存储

下表描述了存储的所有搜索选项。

表 1.22. 搜索存储
属性（资源或资源类型）	类型	描述（参考）
`主机.host-prop`	取决于属性类型	与存储关联的主机的属性。
`cluster.cluster-prop`	取决于属性类型	与存储关联的集群的属性。
`name`	字符串	标识网络上存储的唯一名称。
`status`	字符串	存储域的状态。
`external_status`	字符串	外部系统和插件报告的存储域的健康状况。
`datacenter`	字符串	存储所属的数据中心。
`type`	字符串	存储的类型。
`free-size`	整数	可用存储的大小(GB)。
`used-size`	整数	使用的存储量(GB)。
`total_size`	整数	可用存储的总量(GB)。
`committed`	整数	提交的存储量(GB)。
`sortby`	list	根据其中一个资源属性对返回的结果进行排序。
`page`	整数	要显示的结果的页面数。

Example

Storage: free_size > 6 GB 和 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`	整数	磁盘的虚拟大小。
`size`	整数	磁盘大小。
`actual_size`	整数	分配给磁盘的实际大小。
`creation_date`	整数	创建磁盘的日期。
`bootable`	字符串	磁盘是否可以引导。有效值为 `0`, `1`, `yes`, 或 `no` 之一
`shareable`	字符串	磁盘是否能一次连接到多个虚拟机。有效值为 `0`, `1`, `yes`, 或 `no` 之一
`格式`	字符串	磁盘格式。可以是 `unused`, `unassigned`, `cow`, 或 `raw` 之一。
`status`	字符串	磁盘状态。可以是 `unassigned`, `ok`, `locked`, `invalid`, 或 `illegal` 之一。
`disk_type`	字符串	磁盘的类型。可以是 `镜像` 之一或 `lun`。
`number_of_vms`	整数	附加磁盘的虚拟机数量。
`vm_names`	字符串	附加磁盘的虚拟机的名称。
`quota`	字符串	虚拟磁盘强制配额的名称。
`sortby`	list	根据其中一个资源属性对返回的结果进行排序。
`page`	整数	要显示的结果的页面数。

Example

disks: format = cow 和 provisioned_size > 8

这个示例返回带有 QCOW 格式和分配的磁盘大小大于 8 GB 的虚拟磁盘列表。

1.3.14. 搜索卷

下表描述了卷的所有搜索选项。

表 1.24. 搜索卷
属性（资源或资源类型）	类型	描述（参考）
`集群`	字符串	与卷关联的集群名称。
`cluster.cluster-prop`	取决于属性类型（示例：名称、描述、注释、架构）	与卷关联的集群的属性。
`name`	字符串	标识卷的人类可读名称。
`type`	字符串	可以是分发、复制、distributed_replicate、stripe 或 distributed_stripe 中的一个。
`transport_type`	整数	可以是 TCP 或 RDMA 之一。
`replica_count`	整数	副本数。
`stripe_count`	整数	条带数。
`status`	字符串	卷的状态。可以是 Up 或 Down 之一。
`sortby`	list	根据其中一个资源属性对返回的结果进行排序。
`page`	整数	要显示的结果的页面数。

Example

volume: transport_type = rdma 和 stripe_count >= 2

这个示例返回有传输类型设置为 RDMA 的卷列表，以及 2 个或更多条带。

1.3.15. 搜索虚拟机

下表描述了虚拟机的所有搜索选项。

注意

目前，Network Label, Custom Emulated Machine, 和 Custom CPU Type 属性不支持搜索参数。

表 1.25. 搜索虚拟机
属性（资源或资源类型）	类型	描述（参考）
`主机.host-prop`	取决于属性类型	与虚拟机关联的主机的属性。
`templates.templates-prop`	取决于属性类型	与虚拟机关联的模板的属性。
`events.events-prop`	取决于属性类型	与虚拟机关联的事件的属性。
`users.users-prop`	取决于属性类型	与虚拟机关联的用户的属性。
`storage.storage-prop`	取决于属性类型	与虚拟机关联的存储设备的属性。
`vNIC.vnic-prop`	取决于属性类型	与虚拟机关联的 vNIC 属性。
`name`	字符串	虚拟机的名称。
`status`	list	虚拟机的可用性。
`ip`	整数	虚拟机的 IP 地址。
`uptime`	整数	虚拟机运行了几分钟的时间。
`domain`	字符串	对这些机器进行分组的域（通常为 Active Directory 域）。
`os`	字符串	创建虚拟机时选择的操作系统。
`creationdate`	Date	创建虚拟机的日期。
`address`	字符串	标识网络上的虚拟机的唯一名称。
`cpu_usage`	整数	使用的处理能力百分比。
`mem_usage`	整数	使用的内存百分比。
`network_usage`	整数	使用的网络的百分比。
`内存`	整数	定义的最大内存。
`apps`	字符串	当前在虚拟机上安装的应用程序。
`cluster`	list	虚拟机所属的集群。
`pool`	list	虚拟机所属的虚拟机池。
`loggedinuser`	字符串	当前登录到虚拟机的用户的名称。
`tag`	list	虚拟机所属的标签。
`datacenter`	字符串	虚拟机所属的数据中心。
`type`	list	虚拟机类型（服务器或桌面）。
`quota`	字符串	与虚拟机关联的配额名称。
`description`	字符串	描述虚拟机的关键字或文本，可以选择创建虚拟机时使用。
`sortby`	list	根据其中一个资源属性对返回的结果进行排序。
`page`	整数	要显示的结果的页面数。
`next_run_configuration_exists`	布尔值	虚拟机有待处理的配置更改。

Example

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

本例返回其基础模板名称以 Win 开头的虚拟机列表，并分配给任何用户。

Example

VM: cluster = Default and os = windows7

这个示例返回属于 Default 集群且正在运行 Windows 7 的虚拟机列表。

1.3.16. 搜索池

下表描述了池的所有搜索选项。

表 1.26. 搜索池
属性（资源或资源类型）	类型	描述（参考）
`name`	字符串	池的名称。
`description`	字符串	池的描述。
`type`	list	池的类型。
`sortby`	list	根据其中一个资源属性对返回的结果进行排序。
`page`	整数	要显示的结果的页面数。

Example

pool: type = automatic

这个示例返回了类型为 automatic 的池列表。

1.3.17. 搜索模板

下表描述了模板的所有搜索选项。

表 1.27. 搜索模板
属性（资源或资源类型）	类型	描述（参考）
`vm.Vms-prop`	字符串	与模板关联的虚拟机的属性。
`主机.host-prop`	字符串	与模板关联的主机的属性。
`events.events-prop`	字符串	与模板关联的事件的属性。
`users.users-prop`	字符串	与模板关联的用户的属性。
`name`	字符串	模板的名称。
`domain`	字符串	模板的域。
`os`	字符串	操作系统的类型。
`creationdate`	整数	创建模板的日期。日期格式是 mm/dd/yy。
`childcount`	整数	从模板创建的虚拟机数量。
`mem`	整数	定义的内存。
`description`	字符串	模板的描述。
`status`	字符串	模板的状态。
`cluster`	字符串	与模板关联的集群。
`datacenter`	字符串	与模板关联的数据中心。
`quota`	字符串	与模板关联的配额。
`sortby`	list	根据其中一个资源属性对返回的结果进行排序。
`page`	整数	要显示的结果的页面数。

Example

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

本例返回模板列表，其中事件是从模板派生的虚拟机上发生正常或更大严重性的事件，并且虚拟机仍在运行。

1.3.18. 搜索用户

下表描述了用户的所有搜索选项。

表 1.28. 搜索用户
属性（资源或资源类型）	类型	描述（参考）
`vm.Vms-prop`	取决于属性类型	与用户关联的虚拟机的属性。
`主机.host-prop`	取决于属性类型	与用户关联的主机的属性。
`templates.templates-prop`	取决于属性类型	与用户关联的模板的属性。
`events.events-prop`	取决于属性类型	与用户关联的事件的属性。
`name`	字符串	用户名称。
`lastname`	字符串	用户的姓氏。
`usrname`	字符串	用户的唯一名称。
`department`	字符串	用户所属的部门。
`group`	字符串	用户所属的组。
`title`	字符串	用户标题。
`status`	字符串	用户的状态。
`role`	字符串	用户的角色。
`tag`	字符串	用户所属的标签。
`pool`	字符串	用户所属的池。
`sortby`	list	根据其中一个资源属性对返回的结果进行排序。
`page`	整数	要显示的结果的页面数。

Example

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

此示例返回一个用户列表，其中事件超过正常严重性的事件已发生在虚拟机，并且虚拟机仍在运行中；或者用户的虚拟机已暂停。

1.3.19. 搜索事件

下表描述了可用于搜索事件的所有搜索选项。根据情况提供许多选项的自动完成功能。

表 1.29. 搜索事件
属性（资源或资源类型）	类型	描述（参考）
`vm.Vms-prop`	取决于属性类型	与事件关联的虚拟机的属性。
`主机.host-prop`	取决于属性类型	与事件关联的主机的属性。
`templates.templates-prop`	取决于属性类型	与事件关联的模板的属性。
`users.users-prop`	取决于属性类型	与事件关联的用户的属性。
`cluster.cluster-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`	整数	事件的标识号。
`sortby`	list	根据其中一个资源属性对返回的结果进行排序。
`page`	整数	要显示的结果的页面数。

Example

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

本例返回事件列表，其中事件发生在名为 testdesktop 的虚拟机上，同时在主机 gonzo.example.com 上运行。

1.3.1. 在 Red Hat Virtualization 中执行搜索

1.3.2. 搜索语法和示例

1.3.3. 搜索 Auto-Completion

1.3.4. 搜索结果类型选项

1.3.5. 搜索标准

1.3.6. 搜索：多个标准和通配符

1.3.7. 搜索：确定搜索顺序

1.3.8. 搜索数据中心

1.3.9. 搜索集群

1.3.10. 搜索主机

1.3.11. 搜索网络

1.3.12. 搜索存储

1.3.13. 搜索磁盘

1.3.14. 搜索卷

1.3.15. 搜索虚拟机

1.3.16. 搜索池

1.3.17. 搜索模板

1.3.18. 搜索用户

1.3.19. 搜索事件

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Red Hat legal and privacy links

Red Hat legal and privacy links