Trabaja con instantáneas de discos persistentes

Crea instantáneas para crear copias de seguridad de los datos de tus discos persistentes zonales o discos persistentes regionales de forma periódica.

Puedes crear instantáneas desde discos incluso mientras están conectados a instancias en ejecución. Las instantáneas son recursos globales, por lo que puedes usarlas para restablecer datos en un disco o instancia nuevos dentro del mismo proyecto. También puedes compartir instantáneas entre proyectos.

Antes de comenzar

Si deseas usar los ejemplos de línea de comandos en esta guía, haz lo siguiente:
1. Instala la herramienta de línea de comandos de gcloud o actualízala a la última versión.
2. Configura una región y una zona predeterminadas.
Si deseas usar los ejemplos de API de esta guía, configura el acceso a la API.

Crea instantáneas

A fin de prepararte para crear instantáneas de discos persistentes, haz lo siguiente:

Revisa las Prácticas recomendadas para las instantáneas de discos persistentes a fin de preparar el disco con el objetivo de realizar una instantánea.
Lee Crea un programa de instantáneas de disco persistente para obtener información sobre cómo crear un programa de instantáneas y adjuntarlo a los discos. Crear copias de seguridad de tus discos periódicamente con instantáneas programadas puede reducir el riesgo de pérdida inesperada de datos.

Crea una instantánea de un disco persistente zonal

Permisos necesarios para esta tarea

Para realizar esta tarea, debes tener los siguientes permisos:

compute.snapshots.create en el proyecto
compute.instances.useReadOnly en la instancia de origen
compute.disks.createSnapshot en el disco

Console

Ve a la página Crear una instantánea en Google Cloud Console.
Ir a la página Crear una instantánea
Ingresa un Nombre para la instantánea.
De manera opcional, ingresa una Descripción de la instantánea.
Selecciona el Disco de origen en el menú desplegable.
Determina la ubicación de almacenamiento de la instantánea. Puedes usar la ubicación de almacenamiento predeterminada o una ubicación de almacenamiento personalizada.
1. En Ubicación, selecciona si deseas almacenar la instantánea en una ubicación multirregional o una ubicación regional.
2. Selecciona la región específica o multirregión que deseas usar. Para usar la región o multirregión más cercana al disco de origen, selecciona En función de la ubicación del disco (predeterminado).
Haz clic en Crear para crear la instantánea.

gcloud

Crea la instantánea en la ubicación de almacenamiento predeterminada o una ubicación de almacenamiento seleccionada. Debes especificar un nombre de instantánea. El nombre debe tener entre 1 y 63 caracteres y cumplir con RFC 1035.

Si quieres crear una instantánea de un disco persistente zonal en la ubicación de almacenamiento predeterminada, usa el comando gcloud compute disks snapshot:
```
gcloud compute disks snapshot DISK_NAME
```
Reemplaza DISK_NAME por el nombre del disco persistente zonal desde el que quieres crear una instantánea.
De lo contrario, si quieres crear una instantánea en una ubicación de almacenamiento personalizada, usa la marca --storage-location a fin de indicar dónde almacenar la instantánea:
```
gcloud compute disks snapshot DISK_NAME \
    --snapshot-names=SNAPSHOT_NAME
    --storage-location STORAGE_LOCATION
```
Donde:
- DISK_NAME es el nombre del disco persistente zonal desde el que quieres crear una instantánea.
- SNAPSHOT_NAME es el nombre de la instantánea.
- STORAGE_LOCATION es la multirregión de Cloud Storage o la región de Cloud Storage en la que quieres almacenar la instantánea. Solo puedes especificar una ubicación de almacenamiento.

La herramienta de la línea de comandos de gcloud espera hasta que la operación muestre un estado de READY o FAILED, o hasta que alcance el tiempo de espera máximo y muestre los últimos detalles conocidos de la instantánea.

API

Crea la instantánea en la ubicación de almacenamiento predeterminada o una ubicación de almacenamiento seleccionada. Debes especificar un nombre de instantánea con el campo name. El nombre debe tener entre 1 y 63 caracteres y cumplir con RFC 1035.

Si quieres crear tu instantánea en la ubicación de almacenamiento predeterminada, realiza una solicitud POST al método disks.createSnapshot:
```
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME/createSnapshot

{
  "name": SNAPSHOT_NAME
}
```
Donde:
- PROJECT_ID es el ID del proyecto.
- ZONE es la zona en la que se encuentran la instancia y el disco.
- DISK_NAME es el nombre del disco persistente zonal desde el que quieres crear una instantánea.
- SNAPSHOT_NAME es el nombre de la instantánea.
De forma alternativa, para crear una instantánea en una ubicación de almacenamiento personalizada, realiza una solicitud POST al método disks.createSnapshot y especifica la ubicación de almacenamiento:
```
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME/createSnapshot

{
  "name": SNAPSHOT_NAME
  "storageLocations": STORAGE_LOCATION
}
```
Donde:
- PROJECT_ID es el ID del proyecto.
- ZONE es la zona en la que se encuentran la instancia y el disco.
- DISK_NAME es el nombre del disco persistente zonal desde el que quieres crear una instantánea.
- SNAPSHOT_NAME es el nombre de la instantánea.
- STORAGE_LOCATION es la multirregión de Cloud Storage o la región de Cloud Storage en la que quieres almacenar la instantánea. Solo puedes especificar una ubicación de almacenamiento.

Crea una instantánea de un disco persistente regional

Permisos necesarios para esta tarea

Para realizar esta tarea, debes tener los siguientes permisos:

compute.snapshots.create en el proyecto
compute.instances.useReadOnly en la instancia de origen
compute.disks.createSnapshot en el disco

Una vez preparado el disco, puedes crear una instantánea. Cuando creas una instantánea de un disco persistente regional, debes indicar la región en la que se encuentra el disco.

Console

Ve a la página Crear una instantánea en Google Cloud Console.
Ir a la página Crear una instantánea
Ingresa un Nombre para la instantánea.
De manera opcional, ingresa una Descripción de la instantánea.
En Disco de origen, selecciona un disco existente del que deseas crear una instantánea.
De manera opcional, puedes especificar una ubicación de almacenamiento personalizada:
1. En Ubicación, selecciona si deseas almacenar la instantánea en una ubicación multirregional o una ubicación regional.
2. Selecciona la región específica o multirregión que deseas usar. Para usar la región o multirregión más cercana al disco de origen, selecciona En función de la ubicación del disco.
Haz clic en Crear para crear la instantánea.

gcloud

Crea la instantánea en la ubicación de almacenamiento predeterminada o una ubicación de almacenamiento seleccionada.

Si quieres crear una instantánea de un disco persistente regional en la ubicación de almacenamiento predeterminada, usa el comando gcloud compute disks snapshot:
```
gcloud compute disks snapshot DISK_NAME \
    --region=REGION
```
Reemplaza lo siguiente:
- DISK_NAME: Es el nombre del disco persistente regional desde el que quieres crear una instantánea.
- REGION: la región en la que se encuentra el disco persistente regional.
De manera opcional, puedes especificar una ubicación de almacenamiento personalizada:
```
gcloud compute disks snapshot DISK_NAME --region
    REGION --storage-location STORAGE_LOCATION
```
En el ejemplo anterior, se ilustra lo siguiente:
- DISK_NAME es el nombre del disco persistente regional desde el que quieres crear una instantánea.
- REGION es la región en la que se encuentra el disco persistente regional.
- STORAGE_LOCATION es la multirregión de Cloud Storage o la región de Cloud Storage en la que quieres almacenar la instantánea. Solo puedes especificar una ubicación de almacenamiento.
La herramienta de línea de comandos de gcloud espera hasta que la operación muestre un estado de READY o FAILED, o hasta que alcance el tiempo de espera máximo y muestre los últimos detalles conocidos de la instantánea.

API

Si quieres crear una instantánea en la ubicación de almacenamiento predeterminada, realiza una solicitud POST al método regionDisk.createSnapshot:
```
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/disks/DISK_NAME/createSnapshot
{
 "name": SNAPSHOT_NAME
}
```
Donde:
- PROJECT_ID es el ID del proyecto.
- REGION es la región en la que se encuentra el disco persistente regional.
- DISK_NAME es el nombre del disco que desea capturar.
- SNAPSHOT_NAME es el nombre de la instantánea.
De forma alternativa, para crear una instantánea en una ubicación de almacenamiento personalizada, realiza una solicitud POST al método regionDisk.createSnapshot y especifica la ubicación de almacenamiento:
```
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/VAR/disks/DISK_NAME/createSnapshot
{
 "name": SNAPSHOT_NAME
 "storageLocations": STORAGE_LOCATION
}
```
Donde:
- PROJECT_ID es el ID del proyecto.
- REGION es la región en la que se encuentra el disco persistente regional.
- DISK_NAME es el nombre del disco persistente regional desde el que quieres crear una instantánea.
- SNAPSHOT_NAME es el nombre de la instantánea.
- STORAGE_LOCATION es la multirregión de Cloud Storage o la región de Cloud Storage en la que quieres almacenar la instantánea. Solo puedes especificar una ubicación de almacenamiento.

Comparte instantáneas entre proyectos

Comparte una instantánea del disco con usuarios de otros proyectos para mover los datos del disco entre proyectos. Por ejemplo, para mover los datos del disco disk-1 en project-a a un disco nuevo disk-2 en project-b, sigue estos pasos. En este ejemplo, disk-1 se encuentra en la zona us-west2-a, y instance-1, en la zona us-west2-b.

gcloud

Crea una instantánea del disk-1:

gcloud compute disks snapshot disk-1 --project project-a --snapshot-names snapshot-1

Crea un disco nuevo en project-b que se base en la instantánea:

gcloud compute disks create disk-2  --project project-b --source-snapshot projects/project-a/global/snapshots/snapshot-1

Adjunta el disco nuevo a la instancia instance-1 en project-b.
```
gcloud compute instances attach-disk instance-1 --project project-b --disk disk-2
```
Nota: El disco debe estar en la misma zona que la instancia.
Activa el disco. Consulta los pasos 5 a 7 de Formatea y activa un disco persistente.

API

Crea una instantánea del disk-1 mediante una solicitud POST al método disks.createSnapshot.

POST https://compute.googleapis.com/compute/v1/projects/project-a/zones/us-west2-a/disks/disk-1/createSnapshot

{
"name": "snapshot-1"
}

Crea un disco nuevo disk-2 en project-b que se base en la instantánea. Crea una solicitud POST para crear un disco persistente zonal mediante el método disks.insert.
```
POST https://compute.googleapis.com/compute/v1/projects/project-b/zones/us-west2-b/disks

{
"name": "disk-2",
"type": "zones/us-west2-b/diskTypes/DISK_TYPE"
"sourceSnapshot": "projects/project-a/global/snapshots/snapshot-1"
}
```
Reemplaza lo siguiente:
- DISK_TYPE: Es el tipo de disco persistente. Puede ser pd-standard, pd-ssd o pd-balanced.
Adjunta el disco nuevo a la instancia instance-1 en project-b. El disco debe estar en la misma zona que la instancia. Crea una solicitud POST para el método instances.attachDisk y, luego, incluye la URL en el disco persistente de la zona que acabas de crear.
```
POST https://compute.googleapis.com/compute/v1/projects/project-b/zones/us-west2-b/instances/instance-1/attachDisk

{
"source": "/compute/v1/projects/project-b/zones/us-west2-b/disks/disk-2"
}
```
Activa el disco. Consulta los pasos 5 a 7 de Formatea y activa un disco persistente.

Para obtener una lista de las instantáneas disponibles, consulta Enumera instantáneas.

Restablece instantáneas

Para restablecer el contenido de una instantánea en un disco nuevo, tienes las siguientes opciones:

Crea un disco persistente nuevo a partir de una instantánea: crea un disco nuevo y selecciona la instantánea como el Origen.
Crea una instancia nueva a partir de una instantánea: Cuando creas una instancia nueva, puedes usar instantáneas para crear discos de arranque y discos de datos de esa instancia. En el caso de una interrupción, puedes recuperar tus datos con rapidez si restableces una o más instantáneas en los discos persistentes nuevos en una instancia nueva. Para obtener más información, consulta Crea una instancia a partir de instantáneas.

Crea un disco persistente nuevo a partir de una instantánea

Permisos necesarios para esta tarea

Para realizar esta tarea, debes tener los siguientes permisos:

compute.disks.create en el proyecto para crear un disco nuevo
compute.instances.attachDisk en la instancia de VM
permiso compute.disks.use en el disco que se conectará

El disco persistente nuevo debe tener, como mínimo, el mismo tamaño que el disco de origen original de la instantánea. Si creas un disco persistente que es más grande que el disco de origen original de la instantánea, debes cambiar el tamaño del sistema de archivos en ese disco persistente para incluir el espacio de disco adicional.

Puedes crear un disco persistente zonal nuevo a partir de una instantánea determinada una vez cada diez minutos. Si deseas generar una ráfaga de solicitudes para crear una instantánea del disco, puedes emitir como máximo 6 solicitudes en 60 minutos. Este límite no se aplica cuando se crean discos persistentes regionales a partir de una instantánea. Para obtener más información, consulta Límites de frecuencia de instantáneas.

Según el sistema operativo y el tipo de sistema de archivos, es posible que debas usar otra herramienta de cambio de tamaño para el sistema de archivos. Para obtener más información, consulta la documentación de tu sistema operativo.

Console

En Google Cloud Console, ve a la página Instantáneas.

Ir a instantáneas
Busca el nombre de la instantánea que deseas restablecer.
Ir a la página Discos

Ir a la página Discos
Haz clic en Crear disco nuevo.
Especifica los siguientes parámetros de configuración:
- Un nombre para el disco
- Un tipo para el disco
- De manera opcional, puedes anular la selección de región y zona predeterminadas. Puedes seleccionar cualquier región y zona, independientemente de la ubicación de almacenamiento de la instantánea de origen.
En Tipo de fuente, haz clic en Instantánea.
Selecciona el nombre de la instantánea que deseas restablecer.
Opcional: Selecciona un tamaño en gigabytes, para el disco. Este número debe ser igual o mayor que el disco de origen para la instantánea. Si no especificas este valor, el disco nuevo es del mismo tamaño que el disco de origen de la instantánea.
Haz clic en Crear para crear el disco.

gcloud

Usa el comando gcloud compute snapshots list para encontrar el nombre de la instantánea que deseas restablecer:
```
gcloud compute snapshots list
```
Usa el comando gcloud compute snapshots describe para encontrar el tamaño de la instantánea que deseas restablecer:
```
gcloud compute snapshots describe SNAPSHOT_NAME
```
Reemplaza SNAPSHOT_NAME por el nombre de la instantánea que se restablecerá.
Usa el comando gcloud compute disks create para crear un nuevo disco persistente regional ozonal desde tu instantánea. Si necesitas un disco persistente SSD para obtener capacidad de procesamiento o IOPS adicionales, incluye la marca --type y especifica pd-ssd.
```
gcloud compute disks create DISK_NAME \
    --size=DISK_SIZE \
    --source-snapshot=SNAPSHOT_NAME \
    --type=DISK_TYPE
```
Reemplaza lo siguiente:
- DISK_NAME: Es el nombre del disco nuevo.
- DISK_SIZE: Es el tamaño, en gigabytes, del disco nuevo. Este número debe ser igual o mayor que el disco de origen para la instantánea.
- SNAPSHOT_NAME: Es el nombre de la instantánea que se restablecerá.
- DISK_TYPE: Es el tipo del disco persistente. Por ejemplo, pd-ssd.

API

Crea una solicitud GET a snapshots.list para ver la lista de instantáneas de tu proyecto.
```
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshots
```
Reemplaza PROJECT_ID con el ID del proyecto.
Crea una solicitud POST para crear un disco persistente zonal con el método disks.insert. Incluye las propiedades name, sizeGb y type. Para restablecer un disco con una instantánea, debes incluir la propiedad sourceSnapshot.
```
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks

{
 "name": "DISK_NAME",
 "sizeGb": "DISK_SIZE",
 "type": "zones/ZONE/diskTypes/DISK_TYPE"
 "sourceSnapshot": "SNAPSHOT_NAME"
}
```
Reemplaza lo siguiente:
- PROJECT_ID: el ID de tu proyecto
- ZONE: Es la zona en la que se encuentran la instancia y el disco nuevo.
- DISK_NAME: Es el nombre del disco nuevo.
- DISK_SIZE: Es el tamaño, en gigabytes, del disco nuevo.
- DISK_TYPE: Es el tipo del disco persistente. Por ejemplo, pd-ssd.
- SNAPSHOT_NAME es la instantánea de origen del disco que se restablecerá.

De manera opcional, puedes conectar el disco nuevo a una instancia existente.

Console

Ve a la página Instancias de VM.
Ir a la página Instancias de VM
Haz clic en el nombre de la instancia en la que deseas restablecer el disco que no sea de arranque.
En la parte superior de esta página, haz clic en Editar.
En Discos adicionales, haz clic en Adjuntar disco existente.
Selecciona el nombre del disco nuevo creado a partir de la instantánea.
Haz clic en Listo para conectar el disco.
En la parte inferior de la página de detalles de la instancia, haz clic en Guardar para aplicar los cambios en la instancia.

gcloud

Usa el comando gcloud compute instances attach-disk para conectar el disco persistente a una instancia:
```
gcloud compute instances attach-disk INSTANCE_NAME \
    --disk DISK_NAME
```
Donde:
- INSTANCE_NAME es el nombre de la instancia.
- DISK_NAME es el nombre del disco creado a partir de la instantánea.

API

Crea una solicitud POST al método instances.attachDisk y, luego, incluye la URL del disco persistente zonal que acabas de crear a partir de tu instantánea.
```
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/attachDisk

{
 "source": "/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME"
}
```
Donde:
- PROJECT_ID es el ID del proyecto.
- ZONE es la zona en la que se encuentran tu instancia y el disco nuevo.
- INSTANCE_NAME es el nombre de la instancia en la que agregas el disco persistente nuevo.
- DISK_NAME es el nombre del disco nuevo.

Después de crear y conectar un disco nuevo a una instancia, debes activar el disco para que el sistema operativo pueda usar el espacio de almacenamiento disponible.

Importante: Si creas una instancia de VM a partir de una instantánea del disco basada en una imagen de VM protegida, el modelo de referencia de la política de integridad original se pierde y el primer conjunto de mediciones de secuencia de inicio en la instancia de VM nueva se usa como el modelo de referencia nuevo. Debido a que este nuevo conjunto de mediciones no se verifica, debes validar la integridad de arranque de la instancia de VM después de restablecer desde una instantánea. Puedes hacerlo examinando de forma manual el registro de inicio y verificando que las claves adecuadas estén cargadas en la base de datos de SecureBoot, y que la versión de kernel prevista esté en ejecución. Además, no se puede acceder a los secretos guardados en el vTPM de la instancia de VM original desde las instancias de VM restablecidas a partir de una instantánea de esa instancia.

Borra una instantánea

Compute Engine usa instantáneas incrementales de modo que cada instantánea contiene solo los datos que cambiaron desde la instantánea anterior. Dado que las instantáneas posteriores pueden requerir información almacenada en una instantánea anterior, ten en cuenta que, si se borra una instantánea, no siempre se borran todos los datos que contiene. Para obtener más información sobre la eliminación de instantáneas, consulta Eliminación de instantáneas.

Permisos necesarios para esta tarea

Para realizar esta tarea, debes tener los siguientes permisos:

compute.snapshots.delete en la instantánea

Para borrar una instantánea, haz lo siguiente:

Console

Ve a la página Instantáneas en Google Cloud Console.
Ir a la página de instantáneas
Selecciona una o más instantáneas que desees borrar.
En la parte superior de la página Instantáneas, haz clic en Borrar.

gcloud

Para borrar una instantánea, usa el comando gcloud compute snapshots delete:

gcloud compute snapshots delete SNAPSHOT_NAME

En este comando, SNAPSHOT_NAME es el nombre de la instantánea que se borrará.

API

Realiza una solicitud DELETE al método compute.snapshots.delete para borrar instantáneas.

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshots/SNAPSHOT_NAME

Donde:

PROJECT_ID es el nombre de tu proyecto.
SNAPSHOT_NAME es el nombre de la instantánea que se borrará.

Borra varias instantáneas según un filtro

Compute Engine usa instantáneas incrementales de modo que cada instantánea contiene solo los datos que cambiaron desde la instantánea anterior. Dado que las instantáneas posteriores pueden requerir información almacenada en una instantánea anterior, si se borra una instantánea, no siempre se borran todos los datos que contiene. Para obtener más información sobre la eliminación de instantáneas, consulta Eliminación de instantáneas.

En las siguientes secciones, se describe cómo borrar una serie de instantáneas según un filtro determinado. Para obtener más información sobre los filtros de la herramienta gcloud, consulta los filtros de temas de la herramienta gcloud.

Permisos necesarios para esta tarea

Para realizar esta tarea, debes tener los siguientes permisos:

compute.snapshots.delete en la instantánea

Para borrar las instantáneas, usa una combinación del comando gcloud compute snapshots list con un filtro determinado y el comando gcloud compute snapshots delete con xargs:

gcloud compute snapshots list --filter="EXPRESSION" --uri |
   xargs gcloud compute snapshots delete

Reemplaza EXPRESSION por un filtro de tema gcloud.

Por ejemplo, --filter="creationTimestamp>'2021-01-01'" borra todas las instantáneas creadas después del 1 de enero de 2021.

Enumera instantáneas

Permisos necesarios para esta tarea

Para realizar esta tarea, debes tener los siguientes permisos:

compute.snapshots.list en el proyecto

gcloud

Si quieres ver una lista de instantáneas disponibles en un proyecto específico, usa el comando gcloud compute snapshots list.

gcloud compute snapshots list --project PROJECT_ID

En el ejemplo anterior, PROJECT_ID es el ID del proyecto.

API

Si deseas ver una lista de instantáneas disponibles en un proyecto específico, realiza una solicitud GET al método snapshots.list:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshots

En el ejemplo anterior, PROJECT_ID es el ID del proyecto.

Visualiza información sobre una instantánea

Si quieres enumerar la información sobre una instantánea en particular, como la hora de creación, el tamaño y el disco de origen, usa el comando gcloud compute snapshots describe:

gcloud compute snapshots describe SNAPSHOT_NAME

En el ejemplo anterior, SNAPSHOT_NAME es el nombre de la instantánea.

¿Qué sigue?

Obtén información sobre cómo crear un programa de instantáneas para discos persistentes.
Obtén más información sobre cómo crear una imagen de disco a partir de instantáneas.