Fazer uma restauração seletiva de arquivos

Nesta página, descrevemos como fazer uma restauração seletiva de arquivos.

Antes de começar

Confira os seguintes pré-requisitos antes de fazer uma restauração seletiva de arquivos:

  • Configuração do snapshot: o diretório de snapshots do volume de destino em que a restauração é iniciada precisa estar visível. Na página Criar volume com base no backup, marque a caixa de seleção Tornar o diretório de snapshots visível. Para mais informações, consulte Criar um novo volume.

  • Versão da Google Cloud CLI: para acessar a restauração seletiva de arquivos, verifique se a versão da Google Cloud CLI é pelo menos 2025.08.08. Esse recurso é exposto no componente beta e precisa ser instalado como parte do pacote da Google Cloud CLI.

    Para verificar e atualizar a versão da Google Cloud CLI:

    1. Verifique sua versão da Google Cloud CLI:

      gcloud --version

    2. Se o componente Beta não estiver instalado, execute:

      gcloud components install beta

    3. Se a versão da Google Cloud CLI for anterior a 2025.08.08, atualize-a:

      gcloud components update beta

Fazer uma restauração seletiva de arquivos

É possível usar a restauração seletiva de arquivos para recuperar arquivos das seguintes maneiras:

  • Restaure os arquivos para o volume de origem e o mesmo diretório de origem.

  • Restaure os arquivos para o volume de origem em um diretório diferente.

  • Restaure os arquivos para um novo volume em um diretório da sua escolha.

A restauração seletiva de arquivos é compatível com backups na região e entre regiões. Este procedimento descreve dois casos diferentes:

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

Use as instruções a seguir para fazer uma restauração seletiva de arquivos na região usando a Google Cloud CLI.

gcloud

Para fazer uma restauração seletiva de arquivos:

gcloud beta 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 restauração. Pode ser o volume original de que o backup foi feito ou um novo volume.

  • LOCATION: a região em que o volume está localizado.

  • PROJECT_ID: o ID do projeto em que o volume e o pool de armazenamento são criados.

  • VAULT_NAME: o nome do cofre de backup. Os backup vaults na região e entre regiões são compatíveis.

  • BACKUP_NAME: o nome do backup que contém os arquivos a serem restaurados.

  • FILE_LIST: uma lista separada por vírgulas de caminhos de arquivos no backup escolhido que precisam ser restaurados.

  • RESTORE_DESTINATION_PATH: opcional: o caminho específico em que os arquivos serão restaurados. Se nenhum caminho for fornecido nesse parâmetro, uma restauração no local será realizada.

Exemplo:

Considere uma operação de restauração seletiva de arquivos realizada em um backup de um volume de origem chamado sfr-demo-vol-1. O volume de origem é armazenado em backup em sfr-demo-backup-1 no backup vault chamado sfr-demo-vault-in-region.

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

  • 1.txt

  • 2.txt

  • directory/3.txt

Um backup, sfr-demo-backup-1, foi identificado no backup vault na região.

Cenário: o arquivo directory/3.txt e o diretório pai dele são removidos do volume de origem. Em seguida, uma operação de restauração é realizada com parâmetros específicos.

Tentativa 1: restaure o arquivo sem recriar o diretório no volume de origem.

Primeiro, uma tentativa é feita para restaurar o arquivo directory/3.txt sem recriar o diretório no volume de origem. Essa tentativa vai falhar.

Restaure o arquivo:

gcloud beta 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/

Será necessário confirmar a operação de restauração:

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 falha com o seguinte erro:

Waiting for [operation-1758047951007-63eef6f9e2f5d-40212146-348595a4] to finish...failed.
ERROR: (gcloud.beta.netapp.volumes.restore-backup-files) bad request error: "Error when create - FAILED - The Single File Backup Restore cannot be processed due to invalid destination path/directory."

Tentativa 2: restaure o arquivo depois de recriar o diretório.

Crie o diretório novamente no volume de origem e execute o mesmo comando de restauração. Desta vez, a operação é bem-sucedida.

Restaure o arquivo:

gcloud beta 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/

Será necessário confirmar novamente a operação de restauração:

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:

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

Caso 2: restauração entre regiões para um novo volume em um novo diretório

Use as instruções a seguir para realizar uma restauração seletiva de arquivos entre regiões usando a Google Cloud CLI.

gcloud

Para fazer uma restauração seletiva de arquivos:

gcloud beta 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 restauração. Pode ser o volume original de que o backup foi feito ou um novo volume.

  • LOCATION: a região em que o volume está localizado.

  • PROJECT_ID: o ID do projeto em que o volume e o pool de armazenamento são criados.

  • VAULT_NAME: o nome do cofre de backup. Os backup vaults na região e entre regiões são compatíveis.

  • BACKUP_NAME: o nome do backup que contém os arquivos a serem restaurados.

  • FILE_LIST: uma lista separada por vírgulas de caminhos de arquivos no backup escolhido que precisam ser restaurados.

  • RESTORE_DESTINATION_PATH: opcional: o caminho específico em que os arquivos serão restaurados. Se nenhum caminho for fornecido nesse parâmetro, uma restauração no local será realizada.

Exemplo:

Considere uma operação de restauração seletiva de arquivos realizada em um backup de um volume de origem chamado sfr-demo-vol-2. O volume de origem é armazenado em backup em sfr-demo-backup no backup vault chamado sfr-demo-vault-cross-region.

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

  • 1.txt

  • 2.txt

Um backup, sfr-demo-backup, foi identificado em um backup vault entre regiões, com us-central1 como a região de origem e us-east4 como a região de destino. Depois que o backup foi criado, o arquivo 1.txt foi removido do volume de origem.

O arquivo 1.txt de sfr-demo-backup será restaurado para um novo volume chamado sfr-demo-vol-3 em um novo diretório chamado test.

Restaure o arquivo:

gcloud beta 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

Será necessário confirmar a operação de restauração:

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 é concluída.

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