Realizar una restauración selectiva de archivos

En esta página se describe cómo realizar una restauración selectiva de archivos.

Antes de empezar

Revisa los siguientes requisitos previos antes de restaurar archivos de forma selectiva:

  • Configuración de la captura: debe verse el directorio de la captura del volumen de destino en el que se inicia la restauración. En la página Crear nuevo volumen a partir de una copia de seguridad, selecciona la casilla Hacer visible el directorio de instantáneas. Para obtener más información, consulta el artículo Crear un volumen.

  • Versión de la CLI de Google Cloud: para acceder a la restauración selectiva de archivos, asegúrate de que tu versión de la CLI de Google Cloud sea al menos la 2025.08.08. Esta función se expone en el componente beta y debe instalarse como parte del paquete de Google Cloud CLI.

    Para verificar y actualizar la versión de Google Cloud CLI, sigue estos pasos:

    1. Comprueba la versión de Google Cloud CLI:

      gcloud --version

    2. Si el componente beta no está instalado, ejecuta el siguiente comando:

      gcloud components install beta

    3. Si tu versión de Google Cloud CLI es anterior a 2025.08.08, actualízala:

      gcloud components update beta

Realizar una restauración selectiva de archivos

Puedes usar la restauración selectiva de archivos para recuperar archivos de las siguientes formas:

  • Restaurar los archivos en el volumen de origen y en el mismo directorio de origen.

  • Restaurar archivos en el volumen de origen en otro directorio.

  • Restaurar archivos en un volumen nuevo en el directorio que elijas.

La restauración selectiva de archivos admite copias de seguridad tanto en la misma región como en otra. En este procedimiento se describen dos casos diferentes:

Caso 1: Restauración en la misma región en el volumen de origen en el mismo directorio de origen

Sigue estas instrucciones para realizar una restauración selectiva de archivos en la misma región con la CLI de Google Cloud.

gcloud

Para restaurar archivos de forma selectiva, sigue estos pasos:

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

Sustituye la siguiente información:

  • DESTINATION_VOLUME_NAME: nombre del volumen de destino de la operación de restauración. Puede ser el volumen original del que se hizo la copia de seguridad o un volumen nuevo.

  • LOCATION: la región en la que reside el volumen.

  • PROJECT_ID: el ID del proyecto en el que se crea el volumen y el pool de almacenamiento.

  • VAULT_NAME: el nombre del depósito de copias de seguridad. Se admiten los almacenes de copias de seguridad de la misma región y de otras regiones.

  • BACKUP_NAME: el nombre de la copia de seguridad que contiene los archivos que se van a restaurar.

  • FILE_LIST: lista de rutas de archivos separadas por comas en la copia de seguridad elegida que se debe restaurar.

  • RESTORE_DESTINATION_PATH: opcional: la ruta específica donde se restaurarán los archivos. Si no se proporciona ninguna ruta en este parámetro, se realizará una restauración in situ.

Ejemplo:

Imagina que se realiza una operación de restauración selectiva de archivos en una copia de seguridad de un volumen de origen llamado sfr-demo-vol-1. El volumen de origen se ha creado como copia de seguridad en sfr-demo-backup-1 dentro del archivo de copias de seguridad llamado sfr-demo-vault-in-region.

El volumen de origen contiene tres archivos de texto:

  • 1.txt

  • 2.txt

  • directory/3.txt

Se ha identificado una copia de seguridad, sfr-demo-backup-1, en el archivo de copia de seguridad de la región.

Situación: El archivo directory/3.txt y su directorio superior se eliminan del volumen de origen. A continuación, se realiza una operación de restauración con parámetros específicos.

Intento 1: restaura el archivo sin volver a crear el directorio en el volumen de origen.

Primero, se intenta restaurar el archivo directory/3.txt sin volver a crear el directorio en el volumen de origen. Se espera que este intento falle.

Restaura el archivo:

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/

Se te pedirá que confirmes la operación de restauración:

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

La operación falla y se produce el siguiente error:

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."

Intento 2: Restaura el archivo después de volver a crear el directorio.

Vuelve a crear el directorio en el volumen de origen y ejecuta el mismo comando de restauración. Esta vez, la operación se ha realizado correctamente.

Restaura el archivo:

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/

Se te pedirá de nuevo que confirmes la operación de restauración:

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

La operación se completa correctamente:

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

Caso 2: Restauración entre regiones en un volumen nuevo de un directorio nuevo

Sigue estas instrucciones para realizar una restauración selectiva de archivos entre regiones con la CLI de Google Cloud.

gcloud

Para restaurar archivos de forma selectiva, sigue estos pasos:

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

Sustituye la siguiente información:

  • DESTINATION_VOLUME_NAME: nombre del volumen de destino de la operación de restauración. Puede ser el volumen original del que se hizo la copia de seguridad o un volumen nuevo.

  • LOCATION: la región en la que reside el volumen.

  • PROJECT_ID: el ID del proyecto en el que se crea el volumen y el pool de almacenamiento.

  • VAULT_NAME: el nombre del depósito de copias de seguridad. Se admiten los almacenes de copias de seguridad de la misma región y de otras regiones.

  • BACKUP_NAME: el nombre de la copia de seguridad que contiene los archivos que se van a restaurar.

  • FILE_LIST: lista de rutas de archivos separadas por comas en la copia de seguridad elegida que se debe restaurar.

  • RESTORE_DESTINATION_PATH: opcional: la ruta específica donde se restaurarán los archivos. Si no se proporciona ninguna ruta en este parámetro, se realizará una restauración in situ.

Ejemplo:

Imagina que se realiza una operación de restauración selectiva de archivos en una copia de seguridad de un volumen de origen llamado sfr-demo-vol-2. El volumen de origen se ha creado como copia de seguridad en sfr-demo-backup dentro del archivo de copias de seguridad llamado sfr-demo-vault-cross-region.

El volumen de origen contiene dos archivos de texto:

  • 1.txt

  • 2.txt

Se ha identificado una copia de seguridad, sfr-demo-backup, en un almacén de copias de seguridad entre regiones, con us-central1 como región de origen y us-east4 como región de destino. Después de crear la copia de seguridad, se ha eliminado el archivo 1.txt del volumen de origen.

El archivo 1.txt de sfr-demo-backup se restaurará en un nuevo volumen llamado sfr-demo-vol-3 en un nuevo directorio llamado test.

Restaura el archivo:

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

Se te pedirá que confirmes la operación de restauración:

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

Una vez confirmada, la operación se habrá completado correctamente.

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