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, 2025.08.08. Esta funcionalidade é exposta no componente beta e tem de ser instalada como parte do conjunto da CLI Google Cloud.

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

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

      gcloud --version

    2. Se o componente beta não estiver instalado, execute o seguinte comando:

      gcloud components install beta

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

      gcloud components update beta

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.

  • Restaurar 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 dois 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 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 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.

Cenário: 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.

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

Primeiro, é feita uma tentativa de restaurar o ficheiro directory/3.txt sem recriar o diretório no volume de origem. Esta tentativa deve falhar.

Restaure o ficheiro:

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/

É-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 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 ficheiro depois de recriar o diretório.

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

Restaure o ficheiro:

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/

É-lhe pedido novamente 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.v1beta1.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 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 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 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

É-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.v1beta1.RestoreBackupFilesResponse