2.3.6. Update(更新)
更新
方法更新现有对象。它们接收描述要执行更新的相关类型的实例,发送请求来更新它,并返回描述更新对象的类型的实例。
注意
此更新方法返回的 Ruby 对象是相关类型的实例。它不是一种服务,只是数据容器。在本例中,返回的对象将是 Vm 类的实例。
在以下示例中,服务 locator
方法找到管理虚拟机的服务,更新方法
会更新其名称:
更新虚拟机名称
# Find the virtual machine and the service that # manages it: vm = vms_service.list(search: 'name=myvm').first vm_service = vms_service.vm_service(vm.id) # Update the name: updated_vm = vms_service.update( OvirtSDK4::Vm.new( name: 'newvm' ) )
当您更新对象时,只更新您要更新的属性:
更新虚拟机的所选属性(推荐)
vm = vm_service.get vm.name = 'newvm'
不要更新整个对象:
更新虚拟机的所有属性(不推荐)
# Retrieve the current representation: vms_service.update(vm)
更新虚拟机的所有属性都是资源浪费,并可在服务器端引入意外的错误。
更新
某些服务的方法支持可用于控制更新方式或什么更新的其他参数。例如,您可能希望更新虚拟机的内存,而不是处于当前状态,而是在下次启动时更新。管理虚拟机的服务 的更新
方法支持 next_run 布尔值参数:
在 Next Run 更新虚拟机的内存
vm = vm_service.update( OvirtSDK4::Vm.new( memory: 1073741824 ), next_run: true )
如果无法执行更新,SDK 将引发一个 错误 异常,其中包含失败的详细信息。它永远不会返回 nil
。