Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

6.259. VmBackups

仮想マシンのバックアップをリスト表示します。

Expand
表6.804 メソッドの概要
名前Summary

add

新しいバックアップエンティティーを仮想マシンに追加します。

list

仮想マシンのバックアップのリスト。

6.259.1. add POST
リンクのコピー

新しいバックアップエンティティーを仮想マシンに追加します。

たとえば、チェックポイント ID previous-checkpoint-uuid から仮想マシンの新しい増分バックアップを開始するには、次のようなリクエストを送信します。 

POST /ovirt-engine/api/vms/123/backups
Copy to Clipboard Toggle word wrap

リクエスト本文は以下のようになります。 

<backup>
  <from_checkpoint_id>previous-checkpoint-uuid</from_checkpoint_id>
  <disks>
      <disk id="disk-uuid" />
      ...
  </disks>
</backup>
Copy to Clipboard Toggle word wrap

応答本文: 

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

作成されたバックアップの ID を提供するには、次のようなリクエストを送信します。 

POST /ovirt-engine/api/vms/123/backups
Copy to Clipboard Toggle word wrap

リクエスト本文は以下のようになります。 

<backup id="backup-uuid">
  <from_checkpoint_id>previous-checkpoint-uuid</from_checkpoint_id>
  <disks>
      <disk id="disk-uuid" />
      ...
  </disks>
</backup>
Copy to Clipboard Toggle word wrap
Expand
表6.805 パラメーターの概要
名前型方向Summary

backup

バックアップ

In/Out

仮想マシンのバックアップエンティティーに関する情報。

require_consistency

ブール値

In

VM がフリーズに失敗した場合にバックアップが失敗するかどうかを示します。

use_active

ブール値

In

バックアップの実行にアクティブボリュームを使用するかどうかを示します。

6.259.1.1. require_consistency
リンクのコピー

VM がフリーズに失敗した場合にバックアップが失敗するかどうかを示します。

requireConsistency=True の場合に、VM のフリーズに失敗した場合は VM のバックアップは失敗します。

REST API 呼び出しは次のようになります。 

POST /ovirt-engine/api/vms/123/backups?require_consistency=true
Copy to Clipboard Toggle word wrap

requireConsistency フラグのデフォルト値は false です。

6.259.1.2. use_active
リンクのコピー

バックアップの実行にアクティブボリュームを使用するかどうかを示します。

useActive=False の場合、バックアップ操作用のスナップショットが作成されます。

REST API 呼び出しは次のようになります。 

POST /ovirt-engine/api/vms/123/backups?use_active=false
Copy to Clipboard Toggle word wrap

useActive フラグのデフォルト値は false です。

6.259.2. list GET
リンクのコピー

仮想マシンのバックアップのリスト。

Expand
表6.806 パラメーターの概要
名前型方向Summary

backups

Backup[]

Out

仮想マシンのバックアップエンティティーに関する情報。

follow

String

In

たどる 必要のある内部リンクを指定します。

max

Integer

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

6.259.2.2. follow
リンクのコピー

たどる 必要のある内部リンクを指定します。これらのリンクで参照されるオブジェクトは、現在の要求の一部としてフェッチされます。詳細は、こちら を参照してください。

6.259.2.3. max
リンクのコピー

返す仮想マシンバックアップの最大数を設定します。指定されていない場合は、すべての仮想マシンのバックアップが返されます。

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

Theme

© 2025 Red Hat