2.3.6. 更新
Update
メソッドは、既存のオブジェクトを更新します。実行する更新を記述した関連タイプのインスタンスを受け取り、それを更新する要求を送信し、更新されたオブジェクトを記述したタイプのインスタンスを返します。
この update メソッドによって返される Ruby オブジェクトは、関連するタイプのインスタンスです。これはサービスではなく、データの単なるコンテナーです。この特定の例では、返されるオブジェクトは Vm クラスのインスタンスになります。
次の例では、service locator
メソッドが仮想マシンを管理しているサービスを検索し、update
メソッドがその名前を更新します。
仮想マシン名の更新
オブジェクトを更新するときは、更新する属性のみを更新します。
仮想マシンの選択された属性の更新 (推奨)
vm = vm_service.get vm.name = 'newvm'
vm = vm_service.get
vm.name = 'newvm'
オブジェクト全体を更新しないでください。
仮想マシンのすべての属性の更新 (非推奨)
Retrieve the current representation:
# Retrieve the current representation:
vms_service.update(vm)
仮想マシンのすべての属性を更新することはリソースの浪費であり、サーバー側で予期しないバグを引き起こす可能性があります。
一部のサービスの Update
メソッドは、更新の方法または内容を制御するために使用できる追加のパラメーターをサポートします。たとえば、仮想マシンのメモリーを現在の状態ではなく、次に起動したときに更新したい場合があります。仮想マシンを管理するサービスの update
メソッドは、next_run ブール値パラメーターをサポートします。
次回実行時の仮想マシンのメモリー更新
更新を実行できない場合、SDK は失敗の詳細を含む エラー 例外を発生させます。nil
を返すことはありません。