6.259. VmBackups
仮想マシンのバックアップを一覧表示します。
| 名前 | 概要 |
|---|---|
|
| 新しいバックアップエンティティーを仮想マシンに追加します。 |
|
| 仮想マシンのバックアップのリスト。 |
6.259.1. add POST
新しいバックアップエンティティーを仮想マシンに追加します。
たとえば、チェックポイント ID previous-checkpoint-uuid から仮想マシンの新しい増分バックアップを開始するには、次のようなリクエストを送信します。
POST /ovirt-engine/api/vms/123/backups
リクエスト本文は以下のようになります。
<backup>
<from_checkpoint_id>previous-checkpoint-uuid</from_checkpoint_id>
<disks>
<disk id="disk-uuid" />
...
</disks>
</backup>応答本文:
<backup id="backup-uuid">
<from_checkpoint_id>previous-checkpoint-uuid</from_checkpoint_id>
<to_checkpoint_id>new-checkpoint-uuid</to_checkpoint_id>
<disks>
<disk id="disk-uuid" />
...
...
</disks>
<status>initializing</status>
<creation_date>
</backup>作成されたバックアップの ID を提供するには、次のようなリクエストを送信します。
POST /ovirt-engine/api/vms/123/backups
リクエスト本文は以下のようになります。
<backup id="backup-uuid">
<from_checkpoint_id>previous-checkpoint-uuid</from_checkpoint_id>
<disks>
<disk id="disk-uuid" />
...
</disks>
</backup>| 名前 | タイプ | 方向 | 概要 |
|---|---|---|---|
|
| In/Out | 仮想マシンのバックアップエンティティーに関する情報。 | |
|
| In | VM がフリーズに失敗した場合にバックアップが失敗するかどうかを示します。 | |
|
| In | バックアップの実行にアクティブボリュームを使用するかどうかを示します。 |
6.259.1.1. require_consistency
VM がフリーズに失敗した場合にバックアップが失敗するかどうかを示します。
requireConsistency=True の場合に、VM のフリーズに失敗した場合は VM のバックアップは失敗します。
REST API 呼び出しは次のようになります。
POST /ovirt-engine/api/vms/123/backups?require_consistency=true
requireConsistency フラグのデフォルト値は false です。
6.259.1.2. use_active
バックアップの実行にアクティブボリュームを使用するかどうかを示します。
useActive=False の場合、バックアップ操作用のスナップショットが作成されます。
REST API 呼び出しは次のようになります。
POST /ovirt-engine/api/vms/123/backups?use_active=false
useActive フラグのデフォルト値は false です。
6.259.2. list GET
仮想マシンのバックアップのリスト。
| 名前 | タイプ | 方向 | 概要 |
|---|---|---|---|
|
| Out | 仮想マシンのバックアップエンティティーに関する情報。 | |
|
| In | たどる 必要のある内部リンクを指定します。 | |
|
| In | 返す仮想マシンバックアップの最大数を設定します。 |
6.259.2.1. backups
仮想マシンのバックアップエンティティーに関する情報。
<backups>
<backup id="backup-uuid">
<from_checkpoint_id>previous-checkpoint-uuid</from_checkpoint_id>
<disks>
<disk id="disk-uuid" />
...
...
</disks>
<status>initiailizing</status>
<creation_date>
</backup>
</backups>6.259.2.2. follow
たどる 必要のある内部リンクを指定します。これらのリンクで参照されるオブジェクトは、現在の要求の一部としてフェッチされます。詳細は、こちら を参照してください。
6.259.2.3. max
返す仮想マシンバックアップの最大数を設定します。指定されていない場合は、すべての仮想マシンのバックアップが返されます。
