2.3.4. list

list 方法检索集合中多个对象的表示。

列出一组虚拟机

# Find the service that manages the collection of virtual
# machines:
vms_service = system_service.vms_service
vms = vms_service.list

结果是一个 Ruby 阵列，其中包含相应类型的实例。在上例中，响应是 Ruby 类 Vm 的实例列表。

某些服务的 list 方法支持额外的参数。

例如，几乎所有顶级集合都支持 搜索参数 来过滤结果，以及一个 max 参数来限制服务器返回的结果数量。

列出 Ten 虚拟机调用的 "my*"

vms = vms_service.list(search: 'name=my*', max: 10)

注意

并非所有列表方法都支持 search 或 max 参数。某些列表方法可能会支持其他参数。详情请查看参考文档。

如果结果列表为空，返回的值将是一个空的 Ruby 数组。它永远不会是 nil。

如果无法检索结果列表，SDK 将引发错误异常，其中包含故障的详细信息。http://www.rubydoc.info/gems/ovirt-engine-sdk/OvirtSDK4/Error