Faça um restauro seletivo de ficheiros

Esta página descreve como fazer uma restauração seletiva de ficheiros.

Antes de começar

Reveja os seguintes pré-requisitos antes de fazer um restauro seletivo de ficheiros:

  • Configuração do Snapshot: o diretório de snapshots do volume de destino para o qual o restauro é iniciado tem de estar visível. Na página Crie um novo volume a partir da cópia de segurança, selecione a caixa de verificação Tornar o diretório de instantâneos visível. Para mais informações, consulte Crie um novo volume.

  • Versão da CLI do Google Cloud: para aceder à restauro seletivo de ficheiros, certifique-se de que a versão da CLI do Google Cloud é, pelo menos, 540.0.0.

    Para validar e atualizar a versão da CLI gcloud:

    1. Verifique a versão da CLI do Google Cloud:

      gcloud --version

    2. Se a versão da CLI do Google Cloud for anterior à 540.0.0, atualize-a:

      gcloud components update

Faça um restauro seletivo de ficheiros

Pode usar o restauro seletivo de ficheiros para recuperar ficheiros das seguintes formas:

  • Restaurar ficheiros para o volume de origem e o mesmo diretório de origem.

  • Restaure ficheiros para o volume de origem num diretório diferente.

  • Restaure ficheiros para um novo volume num diretório à sua escolha.

O restauro seletivo de ficheiros suporta cópias de segurança na região e entre regiões. Este procedimento descreve três casos diferentes:

Caso 1: restauro na região para o volume de origem no mesmo diretório de origem

Use as instruções seguintes para fazer uma restauro seletivo de ficheiros na região com a CLI do Google Cloud.

gcloud

Para fazer um restauro seletivo de ficheiros:

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

Substitua as seguintes informações:

  • DESTINATION_VOLUME_NAME: o nome do volume de destino para a operação de restauro. Pode ser o volume original a partir do qual foi feita a cópia de segurança ou um novo volume.

  • LOCATION: a região onde o volume reside.

  • PROJECT_ID: o ID do projeto onde o volume e o conjunto de armazenamento são criados.

  • VAULT_NAME: o nome do cofre de segurança. Os cofres de cópias de segurança na região e entre regiões são suportados.

  • BACKUP_NAME: o nome da cópia de segurança que contém os ficheiros a restaurar.

  • FILE_LIST: uma lista de caminhos de ficheiros separados por vírgulas na cópia de segurança escolhida que precisa de ser restaurada.

  • RESTORE_DESTINATION_PATH: opcional: o caminho específico onde os ficheiros vão ser restaurados. Se não for fornecido nenhum caminho neste parâmetro, é feita uma restauração no local.

Exemplo:

Considere uma operação de restauro seletivo de ficheiros realizada numa cópia de segurança de um volume de origem denominado sfr-demo-vol-1. É feita uma cópia de segurança deste volume de origem para sfr-demo-backup-1 no cofre de cópias de segurança denominado sfr-demo-vault-in-region.

O volume de origem contém três ficheiros de texto:

  • 1.txt

  • 2.txt

  • directory/3.txt

Foi identificada uma cópia de segurança, sfr-demo-backup-1, no cofre de cópias de segurança na região. O ficheiro directory/3.txt e o respetivo diretório principal são removidos do volume de origem. Em seguida, é realizada uma operação de restauro com parâmetros específicos.

O ficheiro directory/3.txt de sfr-demo-backup-1 vai ser restaurado para o volume de origem.

Restaure o ficheiro:

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/

É-lhe pedido que confirme a operação de restauro:

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

A operação é concluída com êxito:

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

Caso 2: restauro entre regiões para um novo volume num novo diretório

Use as instruções seguintes para fazer um restauro seletivo de ficheiros entre regiões com a Google Cloud CLI.

gcloud

Para fazer um restauro seletivo de ficheiros:

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

Substitua as seguintes informações:

  • DESTINATION_VOLUME_NAME: o nome do volume de destino para a operação de restauro. Pode ser o volume original a partir do qual foi feita a cópia de segurança ou um novo volume.

  • LOCATION: a região onde o volume reside.

  • PROJECT_ID: o ID do projeto onde o volume e o conjunto de armazenamento são criados.

  • VAULT_NAME: o nome do cofre de segurança. Os cofres de cópias de segurança na região e entre regiões são suportados.

  • BACKUP_NAME: o nome da cópia de segurança que contém os ficheiros a restaurar.

  • FILE_LIST: uma lista de caminhos de ficheiros separados por vírgulas na cópia de segurança escolhida que precisa de ser restaurada.

  • RESTORE_DESTINATION_PATH: opcional: o caminho específico onde os ficheiros vão ser restaurados. Se não for fornecido nenhum caminho neste parâmetro, é feita uma restauração no local.

Exemplo:

Considere uma operação de restauro seletivo de ficheiros realizada numa cópia de segurança de um volume de origem denominado sfr-demo-vol-2. É feita uma cópia de segurança deste volume de origem para sfr-demo-backup no cofre de cópias de segurança denominado sfr-demo-vault-cross-region.

O volume de origem contém dois ficheiros de texto:

  • 1.txt

  • 2.txt

Foi identificada uma cópia de segurança, sfr-demo-backup, num cofre de cópias de segurança entre regiões, com us-central1 como região de origem e us-east4 como região de destino. Após a criação da cópia de segurança, o ficheiro 1.txt foi removido do volume de origem.

O ficheiro 1.txt de sfr-demo-backup vai ser restaurado para um novo volume denominado sfr-demo-vol-3 num novo diretório denominado test.

Restaure o ficheiro:

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

É-lhe pedido que confirme a operação de restauro:

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

Após a confirmação, a operação é bem-sucedida.

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

Caso 3: restauração no local para um novo volume

Siga as instruções abaixo para fazer uma restauro seletivo de ficheiros no local com a CLI do Google Cloud.

gcloud

Para fazer um restauro seletivo de ficheiros:

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

Substitua as seguintes informações:

  • DESTINATION_VOLUME_NAME: o nome do volume de destino para a operação de restauro. Pode ser o volume original a partir do qual foi feita a cópia de segurança ou um novo volume.

  • LOCATION: a região onde o volume reside.

  • PROJECT_ID: o ID do projeto onde o volume e o conjunto de armazenamento são criados.

  • VAULT_NAME: o nome do cofre de segurança. Os cofres de cópias de segurança na região e entre regiões são suportados.

  • BACKUP_NAME: o nome da cópia de segurança que contém os ficheiros a restaurar.

  • FILE_LIST: uma lista de caminhos de ficheiros separados por vírgulas na cópia de segurança escolhida que precisa de ser restaurada.

Exemplo:

Considere uma operação de restauro seletivo de ficheiros realizada numa cópia de segurança de um volume de origem denominado sfr-demo-vol-2. É feita uma cópia de segurança deste volume de origem para sfr-demo-backup no cofre de cópias de segurança denominado sfr-demo-vault-cross-region.

O volume de origem contém dois ficheiros de texto:

  • 1.txt

  • 2.txt

Foi identificada uma cópia de segurança, sfr-demo-backup, num cofre de cópias de segurança entre regiões, com us-central1 como região de origem e us-east4 como região de destino. Após a criação da cópia de segurança, o ficheiro 1.txt foi removido do volume de origem.

O ficheiro 1.txt de sfr-demo-backup vai ser restaurado para um novo volume com o nome sfr-demo-vol-3, mas o diretório para a operação de restauro não vai ser especificado.

Restaure o ficheiro:

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

É-lhe pedido que confirme a operação de restauro:

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

Após a confirmação, a operação é bem-sucedida.

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