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

    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 tu versión de Google Cloud CLI es anterior a la 540.0.0, actualízala:

      gcloud components update

Cómo realizar una restauración selectiva de archivos

Puedes usar el restablecimiento selectivo 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 tres 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 un restablecimiento selectivo de archivos, sigue estos pasos:

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

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 regionales y las interregionales.

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

El archivo directory/3.txt de sfr-demo-backup-1 se restablecerá en el volumen de origen.

Restablece el archivo:

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/

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 se completa correctamente:

Waiting for [operation-1758048175178-63eef7cfac198-a94afb9b-913b60d5] to finish...done.
'@type': type.googleapis.com/google.cloud.netapp.v1.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 un restablecimiento selectivo de archivos, sigue estos pasos:

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

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 regionales y las interregionales.

  • 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 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.v1.RestoreBackupFilesResponse

Caso 3: Restablecimiento en el lugar a un volumen nuevo

Usa las siguientes instrucciones para realizar un restablecimiento selectivo de archivos in situ con Google Cloud CLI.

gcloud

Para realizar un restablecimiento selectivo de archivos, sigue estos pasos:

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

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 regionales y las interregionales.

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

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, pero no se especificará el directorio para la operación de restablecimiento.

Restablece el archivo:

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

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-1758875604584-63fb0239d87b7-1035ba74-caed1838] to finish...done.
'@type': type.googleapis.com/google.cloud.netapp.v1.RestoreBackupFilesResponse