2.3.2.3. 添加

添加 方法向集合添加新元素。它们收到描述要添加的对象的相关类型实例，发送请求来添加它，以及返回描述添加对象的类型实例。

添加新虚拟机

# Add the virtual machine:
vm = vms_service.add(
  OvirtSDK4::Vm.new(
    name: 'myvm',
    cluster: {
      name: 'mycluster'
    },
    template: {
      name: 'mytemplate'
    }
  )
)

重要

add 方法返回的 Ruby 对象是相关类型的实例。它并不是一个服务，只是一个数据容器。在上例中，返回的对象是 Vm 类的实例。

如果您需要对刚添加的虚拟机执行操作，您必须找到管理该服务并调用服务 locator：

启动新的虚拟机

# Add the virtual machine:
vm = vms_service.add(
  ...
)

# Find the service that manages the virtual machine:
vm_service = vms_service.vm_service(vm.id)

# Start the virtual machine:
vm_service.start

大多数对象的创建都是异步任务。例如，如果您创建新虚拟机，则添加 方法将在虚拟机完全创建并准备好使用前返回虚拟机。您应该轮询对象的状态，直到对象完全创建。对于表示处于 DOWN 状态之前检查的虚拟机。

推荐的方法是创建虚拟机，找到管理新虚拟机的服务，并重复检索到虚拟机状态为 DOWN，这表示已创建所有磁盘。

添加虚拟机、循环服务并检索到它的状态

# Add the virtual machine:
vm = vms_service.add(
  ...
)

# Find the service that manages the virtual machine:
vm_service = vms_service.vm_service(vm.id)

# Wait until the virtual machine is DOWN, indicating that all the
# disks have been created:
loop do
  sleep(5)
  vm = vm_service.get
  break if vm.status == OvirtSDK4::VmStatus::DOWN
end

如果无法创建对象，则 SDK 将生成包含失败详情的 Error 异常。它永远不会返回 nil。