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 540.0.0.
Para verificar y actualizar la versión de Google Cloud CLI, sigue estos pasos:
Comprueba la versión de Google Cloud CLI:
gcloud --version
Si tu versión de Google Cloud CLI es anterior a la 540.0.0, actualízala:
gcloud components update
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 tres 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 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.txt2.txtdirectory/3.txt
Se ha identificado una copia de seguridad, sfr-demo-backup-1, en el archivo de copia de seguridad de la regió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.
El archivo directory/3.txt de sfr-demo-backup-1 se restaurará en el volumen de origen.
Restaura 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 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.v1.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 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.txt2.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 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.v1.RestoreBackupFilesResponse
Caso 3: Restauración in situ en un volumen nuevo
Sigue estas instrucciones para restaurar selectivamente archivos en el mismo lugar con la CLI de Google Cloud.
gcloud
Para restaurar archivos de forma selectiva, 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
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.
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.txt2.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, pero no se especificará el directorio de la operación de restauración.
Restaura 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 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-1758875604584-63fb0239d87b7-1035ba74-caed1838] to finish...done. '@type': type.googleapis.com/google.cloud.netapp.v1.RestoreBackupFilesResponse