Las instantáneas de disco estándar te ayudan a crear copias de seguridad periódicas de los datos de tu Persistent Disk y Google Cloud Hyperdisk.
Puedes ver, enumerar y borrar instantáneas de disco. También puedes compartir instantáneas entre proyectos.
Antes de comenzar
-
Si aún no lo hiciste, configura la autenticación.
La autenticación es el proceso mediante el cual se verifica tu identidad para acceder a los servicios y las APIs de Google Cloud .
Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
- Set a default region and zone.
-
Administrador de instancias de Compute (v1) (
roles/compute.instanceAdmin.v1
) - Para conectarte a una VM que puede ejecutarse como una cuenta de servicio:
Usuario de cuenta de servicio (v1) (
roles/iam.serviceAccountUser
) -
Para enumerar instantáneas, usa
compute.snapshots.list
en el proyecto. -
Para ver información sobre una instantánea, haz lo siguiente:
compute.snapshots.get
en la instantánea -
Para borrar una instantánea, sigue estos pasos:
compute.snapshots.delete
en la instantánea. -
Para borrar instantáneas según un filtro, haz lo siguiente:
-
compute.snapshots.delete
en la instantánea compute.snapshots.list
en el proyecto
-
-
Para compartir datos de instantáneas entre proyectos, haz lo siguiente:
-
compute.storageAdmin
en el proyecto (para acceder a todas las instantáneas estándar) -
compute.disks.create
en el proyecto con el que quieres compartirlo -
compute.snapshots.create
en el proyecto de origen. compute.disks.createSnapshot
en el disco de origen
-
En la consola de Google Cloud, ve a la página Instantáneas.
En la pestaña Instantáneas, puedes ver las instantáneas estándar del proyecto actual.
Opcional. Limita los resultados con el campo Filtro de filter_list. Ingresa el nombre o el valor de una propiedad en el campo Filtro o elige una de las propiedades disponibles.
Si quieres ver una lista de todas las instantáneas disponibles en un proyecto específico, usa el comando
gcloud compute snapshots list
.gcloud compute snapshots list --project=PROJECT_ID
(Versión preliminar) Para ver una lista de instantáneas centradas regionalmente disponibles en un proyecto en particular, usa el comando
gcloud compute snapshots list
y especifica la región.gcloud compute snapshots list --region=REGION_NAME
Si quieres ver una lista de instantáneas de alcance global disponibles en un proyecto en particular, usa el comando
gcloud compute snapshots list
y, luego, incluye la marca--global
.gcloud compute snapshots list --global
PROJECT_ID
: Opcional Reemplaza por el ID del proyecto. Si omites esta marca, se usará el proyecto actual. Puedes configurar el proyecto predeterminado de tu sesión con el comandogcloud config set project PROJECT_ID
de la gcloud CLI.REGION_NAME
: Es el nombre de la región para la que deseas ver las instantáneas.Si deseas ver una lista de todas las instantáneas disponibles en un proyecto específico, realiza una solicitud
GET
al métodosnapshots.list
y especifica "aggregated".GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/snapshots
(Versión preliminar) Para ver una lista de las instantáneas centradas regionalmente que tienes disponibles en un proyecto en particular, realiza una solicitud
GET
al métodosnapshots.list
y especifica la región.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/snapshots
Si deseas ver una lista de instantáneas de alcance global disponibles en un proyecto específico, realiza una solicitud
GET
al métodosnapshots.list
y especifica "global".GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshots
PROJECT_ID
: El ID del proyectoREGION_NAME
: Es el nombre de la región para la que deseas ver las instantáneas.En la consola de Google Cloud, ve a la página Instantáneas.
En la pestaña Instantáneas, aparece una lista de todas las instantáneas estándar del proyecto.
Limita los resultados por disco de origen:
Ingresa
Source disk:
en el campo Filtro filter_list o haz clic en el campo Filtro y, luego, elige lo siguiente: valorSource disk
de la lista Propiedades.Selecciona el nombre del disco de la lista Valores que aparece junto a
Source disk:
en el campo Filtro.Las instantáneas que se muestran en la consola ahora muestran todas las instantáneas estándar del disco especificado.
Si no ves el nombre de un disco en la lista Valores, en el campo Filtro junto a
Source disk:
, escribe las primeras letras del nombre del disco de origen para cambiar la lista de valores que ves.
Enumera la instantánea estándar de un disco zonal:
gcloud compute snapshots list --filter="sourceDisk:projects/PROJECT_ID/zones/SOURCE_ZONE/disks/DISK_NAME
Enumera las instantáneas estándar para un disco regional:
gcloud compute snapshots list --filter=sourceDisk:projects/PROJECT_ID/regions/SOURCE_REGION/disks/DISK_NAME
PROJECT_ID
: el ID del proyecto.SOURCE_ZONE
: (Solo para discos zonales) Es el nombre de la zona del disco, por ejemplo,us-west1-a
.SOURCE_REGION
: (Solo para discos regionales) El nombre de la región del disco, por ejemplo,us-west1
.DISK_NAME
: el nombre del disco, por ejemplo,disk-1
.Enumera la instantánea estándar de un disco zonal:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshots?filter=sourceDisk:'https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/SOURCE_ZONE/disks/DISK_NAME'
Enumera las instantáneas estándar para un disco regional:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshots?filter=sourceDisk:'https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/SOURCE_REGION/disks/DISK_NAME'
PROJECT_ID
: el ID del proyecto.SOURCE_ZONE
: (Solo para discos zonales) Es el nombre de la zona del disco, por ejemplo,us-west1-a
.SOURCE_REGION
: (Solo para discos regionales) El nombre de la región del disco, por ejemplo,us-west1
.DISK_NAME
: el nombre del disco de origen, por ejemplo,disk-1
.En la consola de Google Cloud, ve a la página Instantáneas.
En la pestaña Instantáneas, consulta la lista de instantáneas del proyecto.
En la columna Nombre, haz clic en el nombre de la instantánea estándar. Aparecerá la página Detalles de la instantánea estándar para la instantánea seleccionada, con sus propiedades.
Para ver información sobre una instantánea estándar de alcance global, usa el comando
gcloud compute snapshots describe
.gcloud compute snapshots describe SNAPSHOT_NAME
(Versión preliminar) Para ver información sobre una instantánea estándar centrada en una región, usa el comando
gcloud compute snapshots describe
y especifica la región.gcloud compute snapshots describe SNAPSHOT_NAME --regions=REGION_NAME
SNAPSHOT_NAME
: Es el nombre de la instantánea estándar.REGION_NAME
: Es el nombre de la región para la que se asignó tu instantánea.Para ver información sobre una instantánea estándar de alcance global, realiza una solicitud
GET
al métodosnapshots.get
.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshots/SNAPSHOT_NAME
(Versión preliminar) Para ver información sobre una instantánea estándar centrada regionalmente, realiza una solicitud
GET
al métodosnapshots.get
y especifica la región.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/snapshots/SNAPSHOT_NAME
PROJECT_ID
: Es el nombre del proyecto que contiene la instantánea estándar.SNAPSHOT_NAME
: Es el nombre de la instantánea estándar.REGION_NAME
: Es el nombre de la región para la que se asignó tu instantánea.Ve a la página Instantáneas en la consola de Google Cloud.
Selecciona una o más instantáneas que desees borrar.
En la parte superior de la página Instantáneas, haz clic en Borrar.
Para borrar una instantánea con alcance global, usa el comando
gcloud compute snapshots delete
.gcloud compute snapshots delete SNAPSHOT_NAME
(Versión preliminar) Para borrar una instantánea con un alcance regional, usa el comando
gcloud compute snapshots delete
y especifica el nombre de la región.gcloud compute snapshots delete SNAPSHOT_NAME --regions=REGION_NAME
- SNAPSHOT_NAME: Es el nombre de la instantánea que deseas borrar.
- REGION_NAME: Es la región a la que se aplica el alcance de la instantánea.
Para borrar una instantánea con alcance global, realiza una solicitud
DELETE
al métodosnapshots.delete
.DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshots/SNAPSHOT_NAME
(Versión preliminar) Para borrar una instantánea con un alcance regional, realiza una solicitud
DELETE
al métodosnapshots.delete
y especifica la región.DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/snapshots/SNAPSHOT_NAME
- PROJECT_ID: el nombre del proyecto.
- SNAPSHOT_NAME: Es el nombre de la instantánea que se borrará.
- REGION_NAME: Es la región a la que se aplica el alcance de la instantánea.
Crea una instantánea estándar en el proyecto de destino mediante el comando
gcloud compute snapshots create
. Por ejemplo, para crear una instantánea de un Persistent Disk o Hyperdisk zonal, usa el siguiente comando:gcloud compute snapshots create SNAPSHOT_NAME \ --source-disk https://www.googleapis.com/compute/v1/projects/SOURCE_PROJECT_ID/zones/ZONE/disks/SOURCE_DISK_NAME \ --project DESTINATION_PROJECT_ID
Reemplaza lo siguiente:
- SNAPSHOT_NAME: un nombre único para la instantánea nueva.
- SOURCE_PROJECT_ID: el ID del proyecto para el disco de origen.
- ZONE: Es la zona del disco de origen.
- SOURCE_DISK_NAME: el nombre del disco de origen.
- DESTINATION_PROJECT_ID: el ID del proyecto de destino para la instantánea nueva.
En el proyecto de destino, crea un disco zonal o regional que se base en la instantánea mediante el comando
gcloud compute disks create
:gcloud compute disks create DISK_NAME \ --source-snapshot SNAPSHOT_NAME \ --project DESTINATION_PROJECT_ID
Reemplaza lo siguiente:
- DISK_NAME: Es un nombre para el disco nuevo.
- SNAPSHOT_NAME: Es el nombre de la instantánea.
- DESTINATION_PROJECT_ID: Es el ID del proyecto de destino para el disco nuevo.
Crea una instantánea estándar en el proyecto de destino mediante una llamada al método
snapshots.insert
. Por ejemplo, para tomar una instantánea de un Persistent Disk o Hyperdisk zonal, realiza la siguiente solicitud:POST https://compute.googleapis.com/compute/v1/projects/DESTINATION_PROJECT_ID/global/snapshots { "name": SNAPSHOT_NAME "sourceDisk": "projects/SOURCE_PROJECT_ID/zones/SOURCE_ZONE/disks/SOURCE_DISK_NAME }
Reemplaza lo siguiente:
- DESTINATION_PROJECT_ID: Es el ID del proyecto de destino para la instantánea nueva.
- SNAPSHOT_NAME: Es un nombre para la instantánea.
- SOURCE_PROJECT_ID: Es el ID del proyecto del disco de origen.
- SOURCE_ZONE: Es la zona del disco de origen.
- SOURCE_DISK_NAME: el nombre del disco de origen.
En el proyecto de destino, crea un disco zonal o regional que se base en la instantánea mediante el método zonal
disks.insert
o el método regionalregionDisks.insert
.Por ejemplo, para crear un disco zonal, realiza la siguiente solicitud:
POST https://compute.googleapis.com/compute/v1/projects/DESTINATION_PROJECT_ID/zones/DESTINATION_ZONE/disks { "name": DISK_NAME "sourceSnapshot": SNAPSHOT_NAME }
Reemplaza lo siguiente:
- DESTINATION_PROJECT_ID: Es el ID del proyecto de destino para el disco nuevo.
- DESTINATION_ZONE: Es la zona del proyecto de destino para el disco nuevo.
- DISK_NAME: Es un nombre para el disco nuevo.
- SNAPSHOT_NAME: Es el nombre de la instantánea.
En el proyecto de origen, crea un disco que se base en la instantánea mediante el comando
gcloud compute disks create
.gcloud compute disks create DISK_NAME \ --source-snapshot SNAPSHOT_NAME \ --project SOURCE_PROJECT_ID \ --zone ZONE
Reemplaza lo siguiente:
- DISK_NAME: Es un nombre para el disco nuevo.
- SNAPSHOT_NAME: Es el nombre de la instantánea.
- SOURCE_PROJECT_ID: el ID del proyecto de origen.
- ZONE: la zona en la que se creará el disco nuevo
Este es un disco temporal que se crea solo para copiar la instantánea en todas las organizaciones.
En el proyecto de destino, crea una instantánea mediante el comando
gcloud compute snapshots create
.Por ejemplo, para crear una instantánea con el disco zonal que se creó en el primer paso, usa el siguiente comando:
gcloud compute snapshots create SNAPSHOT_NAME \ --source-disk https://www.googleapis.com/compute/v1/projects/SOURCE_PROJECT_ID/zones/ZONE/disks/DISK_NAME \ --project DESTINATION_PROJECT_ID
Reemplaza lo siguiente:
- SNAPSHOT_NAME: Es un nombre para la instantánea.
- SOURCE_PROJECT_ID: El ID del proyecto que contiene el disco de origen.
- ZONE: Es la zona del disco de origen.
- DISK_NAME: El nombre del disco creado en el paso 1.
- DESTINATION_PROJECT_ID: el ID del proyecto de destino para la instantánea nueva.
Para obtener una lista de las instantáneas disponibles, consulta Visualiza las instantáneas estándar en un proyecto o una ubicación.
Borra el disco temporal creado en el primer paso con el comando
gcloud compute disks delete
.gcloud compute disks delete DISK_NAME \ --project SOURCE_PROJECT_ID --zone ZONE
Reemplaza lo siguiente:
- DISK_NAME: El nombre del disco creado en el paso 1.
- SOURCE_PROJECT_ID: El ID del proyecto que contiene el disco de origen.
- ZONE: la zona del disco.
En el proyecto de origen, crea un disco zonal o regional que se base en la instantánea mediante el método zonal
disks.insert
.Por ejemplo, para crear un disco zonal, realiza la siguiente solicitud:
POST https://compute.googleapis.com/compute/v1/projects/SOURCE_PROJECT_ID/zones/SOURCE_ZONE/disks { "name": DISK_NAME "sourceSnapshot": SNAPSHOT_NAME }
Reemplaza lo siguiente:
- SOURCE_PROJECT_ID: El ID del proyecto de destino para el disco nuevo.
- SOURCE_ZONE: La zona para el disco nuevo.
- DISK_NAME: Es un nombre para el disco nuevo.
- SNAPSHOT_NAME: Es el nombre de la instantánea.
Este es un disco temporal que se crea solo para copiar la instantánea en todas las organizaciones.
Crea una instantánea en el proyecto de destino mediante una llamada al método
snapshots.insert
.Por ejemplo, para crear una instantánea con el disco zonal que se creó en el primer paso, usa el siguiente comando:
POST https://compute.googleapis.com/compute/v1/projects/DESTINATION_PROJECT_ID/global/snapshots { "name": SNAPSHOT_NAME "sourceDisk": "projects/SOURCE_PROJECT_ID/zones/SOURCE_ZONE/disks/DISK_NAME }
Reemplaza lo siguiente:
- DESTINATION_PROJECT_ID: el ID del proyecto de destino para la instantánea nueva.
- SNAPSHOT_NAME: Es un nombre para la instantánea.
- SOURCE_PROJECT_ID: El ID del proyecto que contiene el disco de origen.
- SOURCE_ZONE: Es la zona del disco de origen.
- DISK_NAME: el nombre del disco de origen.
Borra el disco temporal creado en el primer paso con el método
disks.delete
.DELETE https://compute.googleapis.com/compute/v1/projects/SOURCE_PROJECT_ID/zones/SOURCE_ZONE/disks/DISK_NAME
Reemplaza lo siguiente:
- SOURCE_PROJECT_ID: El ID del proyecto que contiene el disco temporal.
- SOURCE_ZONE: la zona del disco.
- DISK_NAME: El nombre del disco temporal creado en el paso 1.
- Obtén información sobre cómo crear instantáneas programadas para discos.
- Obtén más información sobre cómo crear una imagen de disco a partir de instantáneas.
REST
Para usar las muestras de la API de REST en esta página en un entorno de desarrollo local, debes usar las credenciales que proporcionas a la CLI de gcloud.
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
Para obtener más información, consulta Autentica para usar REST en la documentación de autenticación de Google Cloud .
Roles y permisos requeridos
Para obtener los permisos que necesitas para administrar las instantáneas estándar, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto:
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
Estos roles predefinidos contienen los permisos necesarios para administrar instantáneas estándar. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para administrar instantáneas estándar:
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.
Visualiza las instantáneas estándar en un proyecto o una ubicación
Puedes ver o enumerar las instantáneas estándar de un proyecto o una ubicación con gcloud CLI, la consola de Google Cloud o REST.
Console
gcloud
Reemplaza lo siguiente:
REST
Reemplaza lo siguiente:
Visualiza las instantáneas estándar de un disco
Puedes ver la lista de instantáneas estándar de un disco a través de la consola de Google Cloud, gcloud CLI o REST.
Console
gcloud
Enumera las instantáneas estándar para un disco con el comando
gcloud compute snapshots list
y el argumento--filter
:Reemplaza lo siguiente:
REST
Enumera las instantáneas estándar de un disco zonal o regional con una solicitud
GET
al métodosnapshots.list
.Usa el parámetro de consulta
filter=sourceDisk
para especificar el nombre del disco.Reemplaza lo siguiente:
Visualiza información sobre una instantánea estándar
Recupera información detallada sobre una instantánea estándar, como su hora de creación, el disco de origen y el tamaño, a través de la consola de Google Cloud, Google Cloud CLI o REST.
Console
gcloud
Reemplaza lo siguiente:
REST
Reemplaza lo siguiente:
Borrar una instantánea
Compute Engine usa instantáneas diferenciales 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.
Console
gcloud
Reemplaza lo siguiente:
Go
Java
Node.js
Python
REST
Reemplaza lo siguiente:
Borra varias instantáneas según un filtro
Compute Engine usa instantáneas diferenciales 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.
Puedes borrar una serie de instantáneas según un filtro determinado. Para obtener más información sobre cómo usar filtros con la CLI de gcloud, consulta Filtros de temas de la gcloud CLI.
Para borrar las instantáneas, usa una combinación del comando
gcloud compute snapshots list
con un filtro determinado y el comandogcloud compute snapshots delete
conxargs
.gcloud compute snapshots list --filter="EXPRESSION" --uri | xargs gcloud compute snapshots delete
Reemplaza
EXPRESSION
por un filtro de tema de la gcloud CLI.Por ejemplo,
--filter="creationTimestamp<'2023-12-31'"
borra todas las instantáneas creadas antes del 31 de diciembre de 2023.Comparte datos de instantáneas entre proyectos en la misma organización
Puedes usar este procedimiento para mover datos de un disco en un proyecto a un disco en un proyecto diferente dentro de la misma organización.
gcloud
REST
Para obtener una lista de las instantáneas disponibles, consulta Visualiza las instantáneas estándar en un proyecto o una ubicación.
Comparte una instantánea entre proyectos en diferentes organizaciones
Puedes usar este procedimiento para compartir una instantánea estándar en un proyecto de una organización con un proyecto diferente de otra organización.
gcloud
REST
¿Qué sigue?
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-03-27 (UTC)
-