ファイルを選択的に復元する

このページでは、ファイルを選択して復元する方法について説明します。

始める前に

ファイルを選択して復元する前に、次の前提条件を確認してください。

  • スナップショット構成: 復元が開始されるターゲット ボリュームのスナップショット ディレクトリが表示されている必要があります。[バックアップから新しいボリュームを作成] ページで、[スナップショット ディレクトリを表示する] チェックボックスをオンにします。詳細については、新しいボリュームを作成するをご覧ください。

  • Google Cloud CLI のバージョン: ファイルの選択的復元にアクセスするには、Google Cloud CLI のバージョンが 540.0.0 以降であることを確認します。

    Google Cloud CLI のバージョンを確認して更新するには:

    1. Google Cloud CLI のバージョンを確認します。

      gcloud --version

    2. Google Cloud CLI のバージョンが 540.0.0 より古い場合は、更新します。

      gcloud components update

ファイルを選択的に復元する

選択的ファイル復元を使用して、次の方法でファイルを復元できます。

  • ファイルをソース Volume と同じソース ディレクトリに復元します。

  • ファイルを別のディレクトリのソース ボリュームに復元します。

  • ファイルを任意のディレクトリの新しいボリュームに復元します。

選択的ファイル復元は、リージョン内バックアップとクロスリージョン バックアップの両方をサポートしています。この手順では、次の 3 つのケースについて説明します。

ケース 1: 同じソース ディレクトリ内のソースボリュームへのリージョン内復元

Google Cloud CLI を使用してリージョン内のファイルを選択的に復元するには、次の操作を行います。

gcloud

ファイルを選択的に復元するには:

gcloud netapp volumes restore-backup-files DESTINATION_VOLUME_NAME \
  --location=LOCATION --project=PROJECT_ID \
  --backup=projects/PROJECT_ID/locations/LOCATION/backupVaults/VAULT_NAME/backups/BACKUP_NAME \
  --file-list=FILE_LIST \
  --restore-destination-path=RESTORE_DESTINATION_PATH

次の情報を置き換えます。

  • DESTINATION_VOLUME_NAME: 復元オペレーションの宛先ボリュームの名前。これは、バックアップが作成された元のボリュームまたは新しいボリュームにできます。

  • LOCATION: ボリュームが存在するリージョン。

  • PROJECT_ID: ボリュームとストレージ プールが作成されるプロジェクトの ID。

  • VAULT_NAME: Backup Vault の名前。リージョン内とクロスリージョンの両方の Backup Vault がサポートされています。

  • BACKUP_NAME: 復元するファイルを含むバックアップの名前。

  • FILE_LIST: 選択したバックアップで復元する必要があるファイルパスのカンマ区切りリスト。

  • RESTORE_DESTINATION_PATH: 省略可。ファイルの復元先の特定のパス。このパラメータでパスが指定されていない場合、インプレース復元が実行されます。

例:

sfr-demo-vol-1 という名前のソース ボリュームのバックアップに対して実行されるファイル選択復元オペレーションについて考えてみましょう。このソース ボリュームは、sfr-demo-vault-in-region という名前の Backup Vault 内の sfr-demo-backup-1 にバックアップされます。

ソース Volume には、次の 3 つのテキスト ファイルが含まれています。

  • 1.txt

  • 2.txt

  • directory/3.txt

リージョン内 Backup Vault 内でバックアップ sfr-demo-backup-1 が特定されました。ファイル directory/3.txt とその親ディレクトリがソース ボリュームから削除されます。その後、特定のパラメータを使用して復元オペレーションが実行されます。

sfr-demo-backup-1 のファイル directory/3.txt がソース ボリュームに復元されます。

ファイルを復元します。

gcloud netapp volumes restore-backup-files sfr-demo-vol-1
--location=us-central1 --project=my-project
--backup=projects/my-project/locations/us-central1/backupVaults/sfr-demo-vault-in-region/backups/sfr-demo-backup-1
--file-list=/directory/3.txt --restore-destination-path=/directory/

復元操作の確認を求めるメッセージが表示されます。

You are about to restore files from a backup to Volume
projects/my-project/locations/us-central1/volumes/sfr-demo-vol-1.
Are you sure?

Do you want to continue (Y/n)? Y

オペレーションが正常に完了します。

Waiting for [operation-1758048175178-63eef7cfac198-a94afb9b-913b60d5] to finish...done.
'@type': type.googleapis.com/google.cloud.netapp.v1.RestoreBackupFilesResponse

ケース 2: 新しいディレクトリの新しいボリュームへのクロスリージョン復元

Google Cloud CLI を使用してクロスリージョン選択的ファイル復元を行うには、次の操作を行います。

gcloud

ファイルを選択的に復元するには:

gcloud netapp volumes restore-backup-files DESTINATION_VOLUME_NAME \
  --location=LOCATION --project=PROJECT_ID \
  --backup=projects/PROJECT_ID/locations/LOCATION/backupVaults/VAULT_NAME/backups/BACKUP_NAME \
  --file-list=FILE_LIST \
  --restore-destination-path=RESTORE_DESTINATION_PATH

次の情報を置き換えます。

  • DESTINATION_VOLUME_NAME: 復元オペレーションの宛先ボリュームの名前。これは、バックアップが作成された元のボリュームまたは新しいボリュームにできます。

  • LOCATION: ボリュームが存在するリージョン。

  • PROJECT_ID: ボリュームとストレージ プールが作成されるプロジェクトの ID。

  • VAULT_NAME: Backup Vault の名前。リージョン内とクロスリージョンの両方の Backup Vault がサポートされています。

  • BACKUP_NAME: 復元するファイルを含むバックアップの名前。

  • FILE_LIST: 選択したバックアップで復元する必要があるファイルパスのカンマ区切りリスト。

  • RESTORE_DESTINATION_PATH: 省略可。ファイルの復元先の特定のパス。このパラメータでパスが指定されていない場合、インプレース復元が実行されます。

例:

sfr-demo-vol-2 という名前のソース ボリュームのバックアップに対して実行されるファイル選択復元オペレーションについて考えてみましょう。このソース ボリュームは、sfr-demo-vault-cross-region という名前の Backup Vault 内の sfr-demo-backup にバックアップされます。

ソース ボリュームには次の 2 つのテキスト ファイルが含まれています。

  • 1.txt

  • 2.txt

クロスリージョン Backup Vault でバックアップ sfr-demo-backup が特定されました。ソース リージョンは us-central1、宛先リージョンは us-east4 です。バックアップが作成された後、ファイル 1.txt がソースボリュームから削除されました。

sfr-demo-backup のファイル 1.txt が、test という新しいディレクトリの sfr-demo-vol-3 という新しいボリュームに復元されます。

ファイルを復元します。

gcloud netapp volumes restore-backup-files sfr-demo-vol-3
--location=us-central1 --project=my-project
--backup=projects/my-project/locations/us-central1/backupVaults/sfr-demo-vault-cross-region/backups/sfr-demo-backup
--file-list=/1.txt --restore-destination-path=/test

復元操作の確認を求めるメッセージが表示されます。

You are about to restore files from a backup to Volume
projects/my-project/locations/us-central1/volumes/sfr-demo-vol-3.
Are you sure?

Do you want to continue (Y/n)? Y

確認後、オペレーションは成功します。

Waiting for [operation-1758050930422-63ef02134743f-8761c12f-b05a405e] to finish...done.
'@type': type.googleapis.com/google.cloud.netapp.v1.RestoreBackupFilesResponse

ケース 3: 新しいボリュームへのインプレース復元

Google Cloud CLI を使用してインプレースのファイル選択復元を行うには、次の操作を行います。

gcloud

ファイルを選択的に復元するには:

gcloud netapp volumes restore-backup-files DESTINATION_VOLUME_NAME \
  --location=LOCATION --project=PROJECT_ID \
  --backup=projects/PROJECT_ID/locations/LOCATION/backupVaults/VAULT_NAME/backups/BACKUP_NAME \
  --file-list=FILE_LIST

次の情報を置き換えます。

  • DESTINATION_VOLUME_NAME: 復元オペレーションの宛先ボリュームの名前。これは、バックアップが作成された元のボリュームまたは新しいボリュームにできます。

  • LOCATION: ボリュームが存在するリージョン。

  • PROJECT_ID: ボリュームとストレージ プールが作成されるプロジェクトの ID。

  • VAULT_NAME: Backup Vault の名前。リージョン内とクロスリージョンの両方の Backup Vault がサポートされています。

  • BACKUP_NAME: 復元するファイルを含むバックアップの名前。

  • FILE_LIST: 選択したバックアップで復元する必要があるファイルパスのカンマ区切りリスト。

例:

sfr-demo-vol-2 という名前のソース ボリュームのバックアップに対して実行されるファイル選択復元オペレーションについて考えてみましょう。このソース ボリュームは、sfr-demo-vault-cross-region という名前の Backup Vault 内の sfr-demo-backup にバックアップされます。

ソース ボリュームには次の 2 つのテキスト ファイルが含まれています。

  • 1.txt

  • 2.txt

クロスリージョン Backup Vault でバックアップ sfr-demo-backup が特定されました。ソース リージョンは us-central1、宛先リージョンは us-east4 です。バックアップが作成された後、ファイル 1.txt がソースボリュームから削除されました。

sfr-demo-backup のファイル 1.txt は sfr-demo-vol-3 という名前の新しいボリュームに復元されますが、復元オペレーションのディレクトリは指定されません。

ファイルを復元します。

gcloud netapp volumes restore-backup-files sfr-demo-vol-3
--location=us-central1 --project=my-project
--backup=projects/my-project/locations/us-central1/backupVaults/sfr-demo-vault-cross-region/backups/sfr-demo-backup
--file-list=/1.txt

復元操作の確認を求めるメッセージが表示されます。

You are about to restore files from a backup to Volume
projects/my-project/locations/us-central1/volumes/sfr-demo-vol-3.
Are you sure?

Do you want to continue (Y/n)? Y

確認後、オペレーションは成功します。

Waiting for [operation-1758875604584-63fb0239d87b7-1035ba74-caed1838] to finish...done.
'@type': type.googleapis.com/google.cloud.netapp.v1.RestoreBackupFilesResponse