2.3.6. 更新


Update メソッドは、既存のオブジェクトを更新します。実行する更新を記述した関連タイプのインスタンスを受け取り、それを更新する要求を送信し、更新されたオブジェクトを記述したタイプのインスタンスを返します。

注記

この update メソッドによって返される Ruby オブジェクトは、関連するタイプのインスタンスです。これはサービスではなく、データの単なるコンテナーです。この特定の例では、返されるオブジェクトは Vm クラスのインスタンスになります。

次の例では、service locator メソッドが仮想マシンを管理しているサービスを検索し、update メソッドがその名前を更新します。

仮想マシン名の更新

# 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'
  )
)
Copy to Clipboard Toggle word wrap

オブジェクトを更新するときは、更新する属性のみを更新します。

仮想マシンの選択された属性の更新 (推奨)

vm = vm_service.get
vm.name = 'newvm'
Copy to Clipboard Toggle word wrap

オブジェクト全体を更新しないでください。

仮想マシンのすべての属性の更新 (非推奨)

# Retrieve the current representation:
vms_service.update(vm)
Copy to Clipboard Toggle word wrap

仮想マシンのすべての属性を更新することはリソースの浪費であり、サーバー側で予期しないバグを引き起こす可能性があります。

一部のサービスの Update メソッドは、更新の方法または内容を制御するために使用できる追加のパラメーターをサポートします。たとえば、仮想マシンのメモリーを現在の状態ではなく、次に起動したときに更新したい場合があります。仮想マシンを管理するサービスの update メソッドは、next_run ブール値パラメーターをサポートします。

次回実行時の仮想マシンのメモリー更新

vm = vm_service.update(
  OvirtSDK4::Vm.new(
    memory: 1073741824
  ),
  next_run: true
)
Copy to Clipboard Toggle word wrap

更新を実行できない場合、SDK は失敗の詳細を含む エラー 例外を発生させます。nil を返すことはありません。

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat