6.259. VmBackups
列出虚拟机的备份。
| 名称 | 概述 |
|---|---|
|
| 将新的备份实体添加到虚拟机。 |
|
| 虚拟机备份列表。 |
6.259.1. 添加 POST
将新的备份实体添加到虚拟机。
例如，要从检查点 id 之前-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 | 指明如果虚拟机无法停止，备份是否会失败。 | |
|
| in | 指明是否使用活动卷来执行备份。 |
6.259.1.1. require_consistency
指明如果虚拟机无法停止，备份是否会失败。
如果 requireConsistency=True 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。
