搜索

2.3.2.4. Update(更新)

download PDF

更新 方法更新现有对象。它们收到描述要执行更新的相关类型的实例,发送请求更新,再返回描述更新对象的类型实例。

注意

这个更新方法返回的 Ruby 对象是相关类型的实例。它并不是一个服务,只是一个数据容器。在这个特定示例中,返回的对象将是 Vm 类的实例。

在以下示例中,service 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 布尔值参数:

在下一次运行中更新虚拟机的内存

vm = vm_service.update(
  OvirtSDK4::Vm.new(
    memory: 1073741824
  ),
  next_run: true
)

如果无法进行更新,则 SDK 将生成包含失败详情的 Error 异常。它永远不会返回 nil

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.