Las instantáneas de disco estándar lo ayudan a realizar copias de seguridad periódicas de los datos de su disco persistente y Google Cloud Hyperdisk.
Puede ver, enumerar y eliminar instantáneas del disco. También puede compartir instantáneas entre proyectos.
Antes de comenzar
- Si aún no lo has hecho, configura la autenticación. La autenticación es el proceso mediante el cual se verifica su identidad para acceder a Google Cloud servicios y API. 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 informáticas (v1) (
roles/compute.instanceAdmin.v1
) - Para conectarse a una máquina virtual que pueda ejecutarse como una cuenta de servicio: Usuario de cuenta de servicio (v1) (
roles/iam.serviceAccountUser
) - Para enumerar instantáneas:
compute.snapshots.list
en el proyecto - Para ver información sobre una instantánea:
compute.snapshots.get
en la instantánea - Para eliminar una instantánea:
compute.snapshots.delete
en la instantánea - Para eliminar instantáneas basadas en un filtro:
-
compute.snapshots.delete
en la instantánea -
compute.snapshots.list
en el proyecto
-
- Para compartir datos de instantáneas entre proyectos:
-
compute.storageAdmin
en el proyecto (para acceder a todas las instantáneas estándar) -
compute.disks.create
en el proyecto para compartir. -
compute.snapshots.create
en el proyecto de origen -
compute.disks.createSnapshot
en el disco de origen
-
En la consola de Google Cloud, vaya a la página Instantáneas .
En la pestaña Instantáneas , puede ver las instantáneas estándar del proyecto actual.
Opcional. Limite sus resultados con el campo de filtro filter_list . Ingrese un nombre o valor de propiedad en el campo Filtro , o elija entre las propiedades disponibles.
Para ver una lista de todas las instantáneas disponibles en un proyecto en particular, usa el comando
gcloud compute snapshots list
.gcloud compute snapshots list --project=PROJECT_ID
( Vista previa ) Para ver una lista de instantáneas con ámbito regional disponibles para usted en un proyecto en particular, use el comando
gcloud compute snapshots list
y especifique la región.gcloud compute snapshots list --region=REGION_NAME
Para ver una lista de instantáneas de ámbito global disponibles para ti en un proyecto en particular, usa el comando
gcloud compute snapshots list
e incluye la marca--global
.gcloud compute snapshots list --global
-
PROJECT_ID
: Opcional. Reemplace con el ID del proyecto. Si omite este indicador, se utiliza el proyecto actual. Puedes configurar el proyecto predeterminado para tu sesión mediante el comando de la CLI de gcloudgcloud config set project PROJECT_ID
. -
REGION_NAME
: el nombre de la región de la que desea ver instantáneas. Para ver una lista de todas las instantáneas disponibles en un proyecto en particular, realice una solicitud
GET
al métodosnapshots.list
y especifique "agregado".GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/snapshots
( Vista previa ) Para ver una lista de instantáneas con ámbito regional disponibles para usted en un proyecto en particular, realice una solicitud
GET
al métodosnapshots.list
y especifique la región.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/snapshots
Para ver una lista de instantáneas de alcance global disponibles para usted en un proyecto en particular, realice una solicitud
GET
al métodosnapshots.list
y especifique "global".GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshots
-
PROJECT_ID
: el ID del proyecto. -
REGION_NAME
: el nombre de la región de la que desea ver instantáneas. En la consola de Google Cloud, vaya a la página Instantáneas .
En la pestaña Instantáneas , aparece una lista de todas las instantáneas estándar del proyecto.
Limite los resultados por disco de origen:
Ingrese
Source disk:
en el campo Filtro filter_list , o haga clic en el campo Filtro y luego elija el valorSource disk
de la lista Propiedades .Seleccione 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 para el disco especificado.
Si no ve el nombre de un disco en la lista Valores , en el campo Filtro junto a
Source disk:
escriba las primeras letras del nombre del disco de origen para cambiar la lista de valores que ve.
Enumere las instantáneas estándar para un disco zonal:
gcloud compute snapshots list --filter="sourceDisk:projects/PROJECT_ID/zones/SOURCE_ZONE/disks/DISK_NAME
Enumere 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 discos zonales) el nombre de la zona del disco, por ejemplo,us-west1-a
. -
SOURCE_REGION
: (solo discos regionales) el nombre de la región del disco, por ejemplo,us-west1
. -
DISK_NAME
: el nombre del disco, por ejemplo,disk-1
. Enumere las instantáneas estándar para 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'
Enumere 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 discos zonales) el nombre de la zona del disco, por ejemplo,us-west1-a
. -
SOURCE_REGION
: (solo discos regionales) el nombre de la región del disco, por ejemplo,us-west1
. -
DISK_NAME
: el nombre del disco de origen, por ejemplodisk-1
. En la consola de Google Cloud, vaya a la página Instantáneas .
En la pestaña Instantáneas , vea la lista de instantáneas del proyecto.
En la columna Nombre , haga clic en el nombre de la instantánea estándar. Aparece la página de detalles de la instantánea seleccionada, que muestra sus propiedades.
Para ver información sobre una instantánea estándar de ámbito global, usa el comando
gcloud compute snapshots describe
.gcloud compute snapshots describe SNAPSHOT_NAME
( Vista previa ) Para ver información sobre una instantánea estándar con ámbito regional, use el comando
gcloud compute snapshots describe
y especifique la región.gcloud compute snapshots describe SNAPSHOT_NAME --regions=REGION_NAME
-
SNAPSHOT_NAME
: el nombre de la instantánea estándar. -
REGION_NAME
: el nombre de la región a la que pertenece su instantánea. Para ver información sobre una instantánea estándar de ámbito global, realice una solicitud
GET
al métodosnapshots.get
.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshots/SNAPSHOT_NAME
( Vista previa ) Para ver información sobre una instantánea estándar de ámbito regional, realice una solicitud
GET
al métodosnapshots.get
y especifique la región.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/snapshots/SNAPSHOT_NAME
-
PROJECT_ID
: el nombre del proyecto que contiene la instantánea estándar. -
SNAPSHOT_NAME
: el nombre de la instantánea estándar. -
REGION_NAME
: el nombre de la región a la que pertenece su instantánea. Vaya a la página Instantáneas en la consola de Google Cloud.
Seleccione una o más instantáneas que desee eliminar.
En la parte superior de la página Instantáneas , haga clic en Eliminar .
Para eliminar una instantánea de ámbito global, usa el comando
gcloud compute snapshots delete
.gcloud compute snapshots delete SNAPSHOT_NAME
( Vista previa ) Para eliminar una instantánea con ámbito regional, use el comando
gcloud compute snapshots delete
y especifique el nombre de la región.gcloud compute snapshots delete SNAPSHOT_NAME --regions=REGION_NAME
- SNAPSHOT_NAME : el nombre de la instantánea que desea eliminar.
- REGION_NAME : la región a la que pertenece la instantánea.
Para eliminar una instantánea de ámbito global, realice una solicitud
DELETE
al métodosnapshots.delete
.DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshots/SNAPSHOT_NAME
( Vista previa ) Para eliminar una instantánea de ámbito regional, realice una solicitud
DELETE
al métodosnapshots.delete
y especifique la región.DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/snapshots/SNAPSHOT_NAME
- PROJECT_ID : El nombre de su proyecto.
- SNAPSHOT_NAME : el nombre de la instantánea que se eliminará.
- REGION_NAME : la región a la que pertenece 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 disco persistente o hiperdisco zonal, utilice 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
Reemplace lo siguiente:
- SNAPSHOT_NAME : un nombre para la nueva instantánea.
- SOURCE_PROJECT_ID : el ID del proyecto para el disco de origen.
- ZONE : 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 nueva instantánea.
En el proyecto de destino, crea un disco zonal o regional basado 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
Reemplace lo siguiente:
- DISK_NAME : un nombre para el nuevo disco.
- SNAPSHOT_NAME : el nombre de la instantánea.
- DESTINATION_PROJECT_ID : el ID del proyecto de destino para el nuevo disco.
Cree una instantánea estándar en el proyecto de destino llamando al método
snapshots.insert
. Por ejemplo, para tomar una instantánea de un disco persistente o hiperdisco zonal, realice 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 }
Reemplace lo siguiente:
- DESTINATION_PROJECT_ID : el ID del proyecto de destino para la nueva instantánea.
- SNAPSHOT_NAME : un nombre para la instantánea.
- SOURCE_PROJECT_ID : el ID del proyecto del disco de origen.
- SOURCE_ZONE : La zona del disco de origen.
- SOURCE_DISK_NAME : el nombre del disco de origen.
En el proyecto de destino, cree un disco zonal o regional basado en la instantánea mediante el método zonal
disks.insert
o el método regionalregionDisks.insert
.Por ejemplo, para crear un disco zonal, realice la siguiente solicitud:
POST https://compute.googleapis.com/compute/v1/projects/DESTINATION_PROJECT_ID/zones/DESTINATION_ZONE/disks { "name": DISK_NAME "sourceSnapshot": SNAPSHOT_NAME }
Reemplace lo siguiente:
- DESTINATION_PROJECT_ID : el ID del proyecto de destino para el nuevo disco.
- DESTINATION_ZONE : la zona en el proyecto de destino para el nuevo disco.
- DISK_NAME : un nombre para el nuevo disco.
- SNAPSHOT_NAME : el nombre de la instantánea.
En el proyecto de origen, crea un disco basado 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
Reemplace lo siguiente:
- DISK_NAME : un nombre para el nuevo disco.
- SNAPSHOT_NAME : el nombre de la instantánea.
- SOURCE_PROJECT_ID : El ID del proyecto de origen.
- ZONE : La zona en la que se creará el nuevo disco.
Este disco es un disco temporal que se crea únicamente para copiar la instantánea entre organizaciones.
En el proyecto de destino, crea una instantánea con el comando
gcloud compute snapshots create
.Por ejemplo, para crear una instantánea usando el disco zonal creado en el primer paso, use 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
Reemplace lo siguiente:
- SNAPSHOT_NAME : un nombre para la instantánea.
- SOURCE_PROJECT_ID : el ID del proyecto que contiene el disco de origen.
- ZONE : 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 nueva instantánea.
Para obtener una lista de instantáneas disponibles, consulte Ver las instantáneas estándar en un proyecto o ubicación .
Elimina el disco temporal creado en el primer paso mediante el comando
gcloud compute disks delete
.gcloud compute disks delete DISK_NAME \ --project SOURCE_PROJECT_ID --zone ZONE
Reemplace 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, cree un disco zonal o regional basado en la instantánea mediante el método zonal
disks.insert
.Por ejemplo, para crear un disco zonal, realice la siguiente solicitud:
POST https://compute.googleapis.com/compute/v1/projects/SOURCE_PROJECT_ID/zones/SOURCE_ZONE/disks { "name": DISK_NAME "sourceSnapshot": SNAPSHOT_NAME }
Reemplace lo siguiente:
- SOURCE_PROJECT_ID : el ID del proyecto de origen para el nuevo disco.
- SOURCE_ZONE : la zona para el disco nuevo.
- DISK_NAME : un nombre para el nuevo disco.
- SNAPSHOT_NAME : el nombre de la instantánea.
Este disco es un disco temporal que se crea únicamente para copiar la instantánea entre organizaciones.
Cree una instantánea en el proyecto de destino llamando al método
snapshots.insert
.Por ejemplo, para crear una instantánea usando el disco zonal creado en el primer paso, use 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 }
Reemplace lo siguiente:
- DESTINATION_PROJECT_ID : el ID del proyecto de destino para la nueva instantánea.
- SNAPSHOT_NAME : un nombre para la instantánea.
- SOURCE_PROJECT_ID : el ID del proyecto que contiene el disco de origen.
- SOURCE_ZONE : La zona del disco de origen.
- DISK_NAME : el nombre del disco de origen.
Elimine el disco temporal creado en el primer paso utilizando el método
disks.delete
.DELETE https://compute.googleapis.com/compute/v1/projects/SOURCE_PROJECT_ID/zones/SOURCE_ZONE/disks/DISK_NAME
Reemplace 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.
- Aprenda a crear instantáneas programadas para discos .
- Aprenda a crear una imagen de disco a partir de su instantánea .
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 necesarios
Para obtener los permisos que necesita para administrar instantáneas estándar, solicite a su administrador que le otorgue los siguientes roles de IAM en el proyecto:
Para obtener más información sobre cómo otorgar roles, consulte Administrar 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 se requieren, expanda la sección Permisos requeridos :
Permisos requeridos
Se requieren los siguientes permisos para administrar instantáneas estándar:
Es posible que también pueda obtener estos permisos con roles personalizados u otros roles predefinidos .
Ver las instantáneas estándar en un proyecto o ubicación
Puedes ver o enumerar las instantáneas estándar en un proyecto o ubicación mediante la CLI de gcloud, la consola de Google Cloud o REST.
Consola
nube de gcloud
Reemplace lo siguiente:
DESCANSAR
Reemplace lo siguiente:
Ver las instantáneas estándar de un disco
Puedes ver la lista de instantáneas estándar de un disco mediante la consola de Google Cloud, la CLI de gcloud o REST.
Consola
nube de gcloud
Enumera las instantáneas estándar de un disco con el comando
gcloud compute snapshots list
y el argumento--filter
.Reemplace lo siguiente:
DESCANSAR
Enumere las instantáneas estándar para un disco zonal o regional con una solicitud
GET
al métodosnapshots.list
.Utilice el parámetro de consulta
filter=sourceDisk
para especificar el nombre del disco.Reemplace lo siguiente:
Ver información sobre una instantánea estándar
Recupere información detallada sobre una instantánea estándar, como su hora de creación, el disco de origen y el tamaño, mediante la consola de Google Cloud, la CLI de Google Cloud o REST.
Consola
nube de gcloud
Reemplace lo siguiente:
DESCANSAR
Reemplace lo siguiente:
Eliminar una instantánea
Compute Engine utiliza instantáneas diferenciales para que cada instantánea contenga solo los datos que han cambiado desde la instantánea anterior. Debido a que las instantáneas posteriores pueden requerir información almacenada en una instantánea anterior, tenga en cuenta que eliminar una instantánea no necesariamente elimina todos los datos de la instantánea.
Para obtener más información sobre la eliminación de instantáneas, consulte Eliminación de instantáneas .
Consola
nube de gcloud
Reemplace lo siguiente:
Ir
Java
Nodo.js
Pitón
DESCANSAR
Reemplace lo siguiente:
Eliminar varias instantáneas según un filtro
Compute Engine utiliza instantáneas diferenciales para que cada instantánea contenga solo los datos que han cambiado desde la instantánea anterior. Debido a que las instantáneas posteriores pueden requerir información almacenada en una instantánea anterior, eliminar una instantánea no necesariamente elimina todos los datos de la instantánea.
Para obtener más información sobre la eliminación de instantáneas, consulte Eliminación de instantáneas .
Puede eliminar una cantidad 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 CLI de gcloud .
Para eliminar 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
Reemplace
EXPRESSION
con un filtro de temas de la CLI de gcloud.Por ejemplo,
--filter="creationTimestamp<'2023-12-31'"
elimina todas las instantáneas creadas antes del 31 de diciembre de 2023.Comparta datos instantáneos entre proyectos de la misma organización
Puede utilizar este procedimiento para mover datos de un disco de un proyecto a un disco de un proyecto diferente dentro de la misma organización.
nube de gcloud
DESCANSAR
Para obtener una lista de instantáneas disponibles, consulte Ver las instantáneas estándar en un proyecto o ubicación .
Comparta una instantánea entre proyectos en diferentes organizaciones
Puede utilizar este procedimiento para compartir una instantánea estándar en un proyecto de una organización con un proyecto diferente en otra organización.
nube de gcloud
DESCANSAR
¿Qué sigue?
A menos que se indique lo contrario, el contenido de esta página está sujeto a la licencia Reconocimiento 4.0 de Creative Commons y las muestras de código están sujetas a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio web de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-04-17 (UTC).
-