Cómo realizar una restauración selectiva de archivos

En esta página, se describe cómo realizar un restablecimiento selectivo de archivos.

Antes de comenzar

Revisa los siguientes requisitos previos antes de realizar un restablecimiento selectivo de archivos:

  • Configuración de instantáneas: El directorio de instantáneas del volumen de destino en el que se inicia el restablecimiento debe estar visible. En la página Crear un volumen nuevo a partir de la copia de seguridad, selecciona la casilla de verificación Hacer visible el directorio de instantáneas. Para obtener más información, consulta Crea un volumen nuevo.

  • Versión de Google Cloud CLI: Para acceder a la restauración selectiva de archivos, asegúrate de que tu versión de Google Cloud CLI 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, haz lo siguiente:

    1. Verifica tu 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

Cómo realizar una restauración selectiva de archivos

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

  • Restaurar archivos en el volumen de origen y en el mismo directorio del código fuente

  • Restablece los archivos en el volumen de origen en un directorio diferente.

  • Restablece los archivos en un volumen nuevo en el directorio que elijas.

El restablecimiento selectivo de archivos admite copias de seguridad dentro de la región y entre regiones. 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 del código fuente

Usa las siguientes instrucciones para realizar un restablecimiento selectivo de archivos en la misma región con Google Cloud CLI.

gcloud

Para realizar una restauración selectiva de archivos, 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

Reemplaza la siguiente información:

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

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

  • PROJECT_ID: Es el ID del proyecto en el que se crean el volumen y el grupo de almacenamiento.

  • VAULT_NAME: Es el nombre de la bóveda de copias de seguridad. Se admiten las backup vaults tanto en la misma región como en otras regiones.

  • BACKUP_NAME: Es el nombre de la copia de seguridad que contiene los archivos que se restablecerán.

  • FILE_LIST: Es una lista separada por comas de las rutas de acceso de los archivos en la copia de seguridad elegida que se deben restablecer.

  • RESTORE_DESTINATION_PATH: Es el path específico en el que se restablecerán los archivos (opcional). Si no se proporciona ninguna ruta en este parámetro, se realiza una restauración en su ubicación.

Ejemplo:

Considera una operación de restablecimiento de archivos selectiva que se realiza en una copia de seguridad de un volumen de origen llamado sfr-demo-vol-1. Este volumen de origen se copia en sfr-demo-backup-1 dentro de la backup vault llamada sfr-demo-vault-in-region.

El volumen de origen contiene tres archivos de texto:

  • 1.txt

  • 2.txt

  • directory/3.txt

Se identificó una copia de seguridad, sfr-demo-backup-1, en la backup vault dentro de la región.

Situación: El archivo directory/3.txt y su directorio principal se quitan del volumen de origen. Luego, se realiza una operación de restablecimiento con parámetros específicos.

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

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

Restablece 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 restablecimiento:

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 con 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 restablecimiento. Esta vez, la operación se realiza correctamente.

Restablece 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á nuevamente que confirmes la operación de restablecimiento:

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: Restablecimiento entre regiones en un volumen nuevo en un directorio nuevo

Sigue estas instrucciones para realizar un restablecimiento selectivo de archivos entre regiones con Google Cloud CLI.

gcloud

Para realizar una restauración selectiva de archivos, 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

Reemplaza la siguiente información:

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

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

  • PROJECT_ID: Es el ID del proyecto en el que se crean el volumen y el grupo de almacenamiento.

  • VAULT_NAME: Es el nombre de la bóveda de copias de seguridad. Se admiten las backup vaults tanto en la misma región como en otras regiones.

  • BACKUP_NAME: Es el nombre de la copia de seguridad que contiene los archivos que se restablecerán.

  • FILE_LIST: Es una lista separada por comas de las rutas de acceso de los archivos en la copia de seguridad elegida que se deben restablecer.

  • RESTORE_DESTINATION_PATH: Es el path específico en el que se restablecerán los archivos (opcional). Si no se proporciona ninguna ruta en este parámetro, se realiza una restauración en su ubicación.

Ejemplo:

Considera una operación de restablecimiento de archivos selectiva que se realiza en una copia de seguridad de un volumen de origen llamado sfr-demo-vol-2. Este volumen de origen se copia en sfr-demo-backup dentro de la backup vault llamada sfr-demo-vault-cross-region.

El volumen de origen contiene dos archivos de texto:

  • 1.txt

  • 2.txt

Se identificó una copia de seguridad, sfr-demo-backup, en una backup vault interregional, 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 quitó el archivo 1.txt del volumen de origen.

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

Restablece 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 restablecimiento:

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

Después de la confirmación, la operación se realiza correctamente.

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