Un disco es un disco de arranque que se usa para iniciar y ejecutar el sistema operativo en una instancia informática o un disco que no es de arranque y que una instancia usa solo para almacenamiento de datos.
Puede utilizar instantáneas para realizar copias de seguridad y restaurar datos del disco de las siguientes maneras:
Después de tomar una instantánea de un disco de arranque o de otro disco, cree un disco nuevo basado en la instantánea .
Después de tomar una instantánea de un disco de inicio, cree una nueva instancia basada en la instantánea del disco de inicio .
Después de tomar una instantánea de un disco que no es de arranque, cree una nueva instancia con un nuevo disco que no sea de arranque basado en la instantánea .
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.
- Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, confirm that you have configured the gcloud CLI to use Workforce Identity Federation.
- Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, confirm that you have configured the gcloud CLI to use Workforce Identity Federation.
- Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, confirm that you have configured the gcloud CLI to use Workforce Identity Federation.
- Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, confirm that you have configured the gcloud CLI to use Workforce Identity Federation.
- Para crear un disco a partir de una instantánea de ámbito global (predeterminado):
-
compute.disks.create
en el proyecto. -
compute.instances.attachDisk
en la instancia -
compute.disks.use
en el disco para adjuntar -
compute.snapshots.useReadOnly
,compute.snapshots.create
ocompute.disks.createSnapshot
en el proyecto.
-
- ( Vista previa ) Para crear un disco a partir de una instantánea de ámbito regional:
-
compute.disks.create
en el proyecto. -
compute.instances.attachDisk
en la instancia -
compute.disks.use
en el disco para adjuntar -
compute.snapshots.useReadOnly
en el proyecto
-
- Para crear una instancia a partir de una instantánea de un disco de arranque y de un disco que no sea de arranque, necesita como mínimo los siguientes permisos:
-
compute.instances.create
en el proyecto. -
compute.snapshots.useReadOnly
en la instantánea -
compute.disks.create
en el proyecto. -
compute.disks.use
en el disco -
compute.instances.attachDisk
en la instancia
-
El nuevo disco debe tener al menos el mismo tamaño que el disco de origen original de la instantánea. Si crea un disco que es más grande que el disco de origen original para la instantánea, debe cambiar el tamaño del sistema de archivos en ese disco para incluir el espacio adicional en el disco. Dependiendo de su sistema operativo y tipo de sistema de archivos, es posible que necesite utilizar una herramienta de cambio de tamaño del sistema de archivos diferente. Para obtener más información, consulte la documentación de su sistema operativo.
Puede crear nuevos discos zonales o regionales a partir de una instantánea determinada como máximo una vez cada diez minutos. Si desea emitir una ráfaga de solicitudes para tomar instantáneas de sus discos, puede emitir como máximo 6 solicitudes en 60 minutos. Este límite no se aplica al crear discos regionales a partir de una instantánea. Para obtener más información, consulte Límites de frecuencia de instantáneas .
En la consola de Google Cloud, vaya a la página Instantáneas .
Busque el nombre de la instantánea que desea restaurar.
Vaya a la página Discos .
Haga clic en Crear nuevo disco .
Especifique los siguientes parámetros de configuración:
- Un nombre para el disco.
- Un tipo para el disco.
- Opcionalmente, puede anular la selección de zona y región predeterminada. Puede seleccionar cualquier región y zona, independientemente de la ubicación de almacenamiento de la instantánea de origen.
En Tipo de fuente , haga clic en Instantánea .
Seleccione el nombre de la instantánea para restaurar.
Seleccione el tamaño del nuevo disco, en gigabytes. Este número debe ser igual o mayor que el disco de origen original de la instantánea.
Haga clic en Crear para crear el disco.
Usa el comando
gcloud compute snapshots list
para buscar el nombre de la instantánea que deseas restaurar:gcloud compute snapshots list
Usa el comando
gcloud compute snapshots describe
para encontrar el tamaño de la instantánea que deseas restaurar:gcloud compute snapshots describe SNAPSHOT_NAME
Reemplace SNAPSHOT_NAME con el nombre de la instantánea que se está restaurando.
Usa el comando
gcloud compute disks create
para crear un nuevo disco regional o zonal a partir de tu instantánea. Puede incluir el indicador--type
para especificar el tipo de disco que se creará.- Para crear un disco zonal a partir de una instantánea de ámbito global:
gcloud compute disks create DISK_NAME \ --zone=ZONE \ --size=DISK_SIZE \ --source-snapshot=SNAPSHOT_NAME \ --type=DISK_TYPE
- ( Vista previa ) Para crear un disco zonal a partir de una instantánea de ámbito regional:
gcloud beta compute disks create DISK_NAME \ --zone=ZONE \ --source-snapshot=SNAPSHOT_NAME \ --source-snapshot-region=SOURCE_REGION \ --type=DISK_TYPE
- Para crear un disco regional a partir de una instantánea de ámbito global:
gcloud beta compute disks create DISK_NAME \ --size=DISK_SIZE \ --source-snapshot=SNAPSHOT_NAME \ --type=DISK_TYPE \ --region=REGION \ --replica-zones=ZONE1,ZONE2
- ( Vista previa ) Para crear un disco regional a partir de una instantánea de ámbito regional:
gcloud beta compute disks create DISK_NAME \ --size=DISK_SIZE \ --source-snapshot=SNAPSHOT_NAME \ --source-snapshot-region=SOURCE_REGION \ --type=DISK_TYPE \ --region=REGION \ --replica-zones=ZONE1,ZONE2
Reemplace lo siguiente:
- DISK_NAME : el nombre del nuevo disco
- DISK_SIZE : el tamaño del nuevo disco, en gibibytes (GiB). Este número debe ser igual o mayor que el disco de origen original de la instantánea.
- SNAPSHOT_NAME : el nombre de la instantánea que se está restaurando
- DISK_TYPE : el tipo de disco, por ejemplo,
pd-ssd
,hyperdisk-throughput
ohyperdisk-balanced-high-availability
- REGION : la región en la que residirá el disco regional, por ejemplo:
europe-west1
- SOURCE_REGION : la región a la que pertenece la instantánea de origen
- ZONE : la zona donde residirá el nuevo disco
- ZONE1,ZONE2 : las zonas dentro de la región donde se encuentran las dos réplicas de disco, por ejemplo:
europe-west1-b
yeurope-west1-c
Opcional: conecta el nuevo disco a una instancia existente mediante el comando
gcloud compute instances attach-disk
:gcloud compute instances attach-disk INSTANCE_NAME \ --disk DISK_NAME
Reemplace lo siguiente:
- INSTANCE_NAME : el nombre de la instancia
- DISK_NAME : el nombre del disco creado a partir de tu instantánea
Cree una solicitud
GET
parasnapshots.list
para mostrar la lista de instantáneas en su proyecto.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/snapshots
Reemplace PROJECT_ID con su ID de proyecto.
Construya una solicitud
POST
para crear un disco zonal o un disco regional usando el métododisks.insert
respectivo:- Para discos zonales:
disks.insert
- Para discos regionales:
regionDisks.insert
Incluya las propiedades
name
,sizeGb
ytype
. Para restaurar un disco usando una instantánea, debe incluir la propiedadsourceSnapshot
.- Para crear un disco zonal a partir de una instantánea de ámbito global:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks { "name": "DISK_NAME", "sourceSnapshot": "SNAPSHOT_NAME", "sizeGb": "DISK_SIZE", "type": "zones/ZONE/diskTypes/DISK_TYPE" }
- ( Vista previa ) Para crear un disco zonal a partir de una instantánea de ámbito regional:
POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/disks { "name": "DISK_NAME", "sourceSnapshot": "projects/PROJECT_ID/regions/SOURCE_REGION/snapshots/SNAPSHOT_NAME", "sizeGb": "DISK_SIZE", "type": "projects/PROJECT_ID/zones/ZONE/diskTypes/DISK_TYPE", "zone": "projects/PROJECT_ID/zones/ZONE" }
- Para crear un disco regional a partir de una instantánea de ámbito global:
POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/disks { "name": "DISK_NAME", "sourceSnapshot": "SNAPSHOT_NAME", "region": "projects/PROJECT_ID/regions/REGION", "replicaZones": [ "projects/PROJECT_ID/zones/ZONE1", "projects/PROJECT_ID/zones/ZONE2" ], "sizeGb": "DISK_SIZE", "type": "zones/ZONE/diskTypes/DISK_TYPE" }
- ( Vista previa ) Para crear un disco regional a partir de una instantánea de ámbito regional:
POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/disks { "name": "DISK_NAME", "sourceSnapshot": "projects/PROJECT_ID/regions/SOURCE_REGION/snapshots/SNAPSHOT_NAME", "replicaZones": [ "projects/PROJECT_ID/zones/ZONE1", "projects/PROJECT_ID/zones/ZONE2" ], "sizeGb": "DISK_SIZE", "type": "projects/PROJECT_ID/regions/REGION/diskTypes/DISK_TYPE" }
Reemplace lo siguiente:
- PROJECT_ID : ID de tu proyecto
- ZONE : la zona donde se encuentran su instancia y su nuevo disco
- DISK_NAME : el nombre del nuevo disco
- SNAPSHOT_NAME : la instantánea de origen del disco que estás restaurando
- REGION : la región en la que residirá el disco regional, por ejemplo:
europe-west1
- SOURCE_REGION : la región a la que pertenece la instantánea de origen
- ZONE1 , ZONE2 : las zonas donde se deben ubicar las réplicas del nuevo disco
- DISK_SIZE : el tamaño del nuevo disco, en gibibytes (GiB). Este número debe ser igual o mayor que el disco de origen original de la instantánea.
- DISK_TYPE : URL completa o parcial para el tipo de disco, por ejemplo,
PROJECT_ID /zones/ ZONE /diskTypes/pd-ssd
,PROJECT_ID /zones/ ZONE /diskTypes/hyperdisk-balanced
oPROJECT_ID /zones/ ZONE /diskTypes/hyperdisk-balanced-high-availability
- Para discos zonales:
Opcional. Adjunte el nuevo disco a una instancia existente.
Cree una solicitud
POST
para el métodoinstances.attachDisk
e incluya la URL del disco que acaba de crear a partir de su instantánea.Para discos zonales:
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" }
Para discos regionales:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/attachDisk { "source": "/compute/v1/projects/PROJECT_ID/regions/REGION/disks/DISK_NAME" }
Reemplace lo siguiente:
- PROJECT_ID : ID de tu proyecto
- ZONE : la zona donde se encuentran su instancia y su nuevo disco
- REGION : la región donde se encuentra el disco regional. Debe ser la misma región en la que se encuentra la instancia informática.
- INSTANCE_NAME : el nombre de la instancia donde estás agregando el nuevo disco
- DISK_NAME : el nombre del nuevo disco
En la consola de Google Cloud, vaya a la página Crear una instancia .
Si se le solicita, seleccione su proyecto y haga clic en Continuar . Aparece la página Crear una instancia y muestra el panel de configuración de la máquina .
En el panel de configuración de la máquina , haga lo siguiente:
- En el campo Nombre , especifique un nombre para su instancia. Para obtener más información, consulte Convención de nomenclatura de recursos .
Opcional: en el campo Zona , seleccione una zona para esta instancia.
La selección predeterminada es Cualquiera . Si no cambia esta selección predeterminada, Google elegirá automáticamente una zona según el tipo de máquina y la disponibilidad.
Seleccione la familia de máquinas para su instancia. Luego, la consola de Google Cloud muestra la serie de máquinas que están disponibles para la familia de máquinas seleccionada. Están disponibles las siguientes opciones de familia de máquinas:
- Propósito general
- Computación optimizada
- Memoria optimizada
- Almacenamiento optimizado
- GPU
En la columna Serie , seleccione la serie de máquinas para su instancia.
Si seleccionó GPU como familia de máquinas en el paso anterior, seleccione el tipo de GPU que desee. Luego, la serie de máquinas se selecciona automáticamente para el tipo de GPU seleccionado.
En la sección Tipo de máquina , seleccione el tipo de máquina para su instancia.
En el menú de navegación, haga clic en SO y almacenamiento . En el panel Sistema operativo y almacenamiento que aparece, configure su disco de arranque haciendo lo siguiente:
- Haga clic en Cambiar . Aparece el panel Disco de arranque y muestra la pestaña Imágenes públicas .
- Haga clic en Instantáneas . Aparece la pestaña Instantánea .
- En la lista Instantánea , seleccione la instantánea que desea utilizar.
- En la lista Tipo de disco de arranque , seleccione el tipo de disco de arranque.
- En el campo Tamaño (GB) , especifique el tamaño del disco de arranque.
- Opcional: para opciones de configuración avanzadas, expanda la sección Mostrar configuraciones avanzadas .
- Para confirmar las opciones de su disco de arranque y regresar al panel Sistema operativo y almacenamiento , haga clic en Seleccionar .
En el menú de navegación, haga clic en Redes . En el panel Redes que aparece, haga lo siguiente:
- Vaya a la sección Cortafuegos .
- Para permitir el tráfico HTTP o HTTPS a la instancia, seleccione Permitir tráfico HTTP o Permitir tráfico HTTPS .
La consola de Google Cloud agrega una etiqueta de red a su instancia y crea la regla de firewall de ingreso correspondiente que permite todo el tráfico entrante en
tcp:80
(HTTP) otcp:443
(HTTPS). La etiqueta de red asocia la regla de firewall con la instancia. Para obtener más información, consulte Descripción general de las reglas de firewall en la documentación de Virtual Private Cloud.Opcional: especifique otras opciones de configuración. Para obtener más información, consulte Opciones de configuración durante la creación de instancias .
Para crear e iniciar la instancia, haga clic en Crear .
-
INSTANCE_NAME
: nombre de la nueva instancia -
BOOT_SNAPSHOT_NAME
: nombre de la instantánea del disco de inicio que desea restaurar en el disco de inicio de la nueva instancia BOOT_DISK_SIZE
: Opcional: tamaño, en GiB, del nuevo disco de arranqueEl tamaño debe ser igual o mayor que el tamaño del disco de origen desde el que se realizó la instantánea.
BOOT_DISK_TYPE
: Opcional: tipo de disco de arranque, por ejemploPROJECT_ID /zones/ ZONE /diskTypes/pd-ssd
oPROJECT_ID /zones/ ZONE /diskTypes/hyperdisk-balanced
BOOT_DISK_NAME
: nombre del nuevo disco de arranque para esta instancia-
INSTANCE_NAME
: nombre de la nueva instancia -
ZONE
: A la zona para crear la instancia en -
DISK_NAME
: Opcional: un nombre para el disco -
BOOT_SNAPSHOT_NAME
: nombre de la instantánea del disco de inicio que desea restaurar en el disco de inicio de la nueva instancia. -
BOOT_DISK_TYPE
: Opcional: tipo de disco de arranque, por ejemplopd-ssd
ohyperdisk-balanced-high-availability
-
REMOTE_ZONE
: la región en la que se replica el disco de arranque. La propiedadreplica-zones
requiere dos zonas separadas por comas, y una de las zonas debe ser la misma que la zona de la instancia. - Sólo se puede utilizar un disco como disco de arranque.
- Debe adjuntar el disco de arranque como primer disco para esa instancia.
- Si especifica la propiedad
source
, no puede especificar también la propiedadinitializeParams
. Proporcionar unasource
indica que el disco de inicio ya existe, pero la propiedadinitializeParams
indica que Compute Engine debe crear un nuevo disco de inicio. -
PROJECT_ID
: ID de tu proyecto -
ZONE
: zona donde desea crear la nueva instancia -
INSTANCE_NAME
: nombre de la instancia en la que desea restaurar una instantánea -
MACHINE_TYPE
: tipo de máquina de la instancia -
BOOT_SNAPSHOT_NAME
: nombre de la instantánea que desea usar para crear el disco de arranque de la nueva instancia BOOT_DISK_SIZE
: Opcional: tamaño, en gibibytes (GiB), para el nuevo disco de arranqueEl tamaño debe ser igual o mayor que el tamaño del disco de origen desde el que se realizó la instantánea.
BOOT_DISK_TYPE
: Opcional: tipo de disco de arranque, por ejemploPROJECT_ID /zones/ ZONE /diskTypes/pd-ssd
oPROJECT_ID /zones/ ZONE /diskTypes/hyperdisk-balanced
-
PROJECT_ID
: ID de tu proyecto -
ZONE
: el nombre de la zona donde desea crear la instancia -
INSTANCE_NAME
`: un nombre para la instancia -
BOOT_SNAPSHOT_NAME
: el nombre de la instantánea del disco de arranque -
REMOTE_ZONE
: la zona remota para el disco regional BOOT_DISK_TYPE
: Opcional: tipo de disco de arranque, por ejemploPROJECT_ID /zones/ ZONE /diskTypes/pd-ssd
oPROJECT_ID /zones/ ZONE /diskTypes/hyperdisk-balanced-high-availability
Restaure cada instantánea que no sea de arranque en un disco nuevo.
En la consola de Google Cloud, vaya a la página Discos .
Haga clic en Crear disco .
Especifique un nombre para su disco. Para obtener más información, consulte Convención de nomenclatura de recursos .
Seleccione la Región y Zona para este disco. El disco y la instancia deben estar en la misma zona para discos zonales o región para discos regionales.
Seleccione un tipo de disco.
En Tipo de fuente , seleccione Instantánea .
En el nuevo campo Instantánea de origen , seleccione una instantánea que no sea de arranque y que desee restaurar en el nuevo disco.
Para crear el disco, haga clic en Crear .
Repita estos pasos para crear un disco a partir de cada instantánea que desee restaurar.
En la consola de Google Cloud, vaya a la página de instancias de VM .
Seleccione su proyecto y haga clic en Continuar .
Haga clic en Crear instancia .
Especifique un nombre para su instancia. Para obtener más información, consulte Convención de nomenclatura de recursos .
Seleccione la Región y Zona para esta instancia. El disco y la instancia deben estar en la misma zona para discos zonales o región para discos regionales.
Seleccione un tipo de máquina para su instancia.
Si desea permitir el tráfico externo entrante, cambie las reglas del Firewall para la instancia.
Para adjuntar discos a la instancia, expanda la sección Opciones avanzadas y luego haga lo siguiente:
- Expanda la sección Discos .
- Haga clic en Adjuntar disco existente .
- En la lista Disco , seleccione un disco para adjuntarlo a esta instancia.
- En la sección Configuración de archivos adjuntos , seleccione el Modo de archivo adjunto del disco y la Regla de eliminación . Para obtener más información sobre cómo agregar nuevos discos, consulteAgregar un disco persistente oAgregar hiperdisco .
- Haga clic en Guardar .
Repita estos pasos para cada disco que desee conectar.
Para crear e iniciar la instancia, haga clic en Crear .
-
INSTANCE_NAME
: nombre de la nueva instancia -
SNAPSHOT_1_NAME
ySNAPSHOT_2_NAME
: nombres de las instantáneas del disco que no son de arranque que desea restaurar -
DISK_1_NAME
yDISK_2_NAME
: nombres de los nuevos discos que no son de arranque para crear para esta instancia DISK_1_SIZE
yDISK_2_SIZE
: opcional: tamaños, en gibibytes (GiB), de cada nuevo disco que no sea de arranque.Los tamaños deben ser iguales o mayores que los tamaños de los discos de origen a partir de los cuales se realizó la instantánea.
DISK_1_TYPE
yDISK_2_TYPE
: Opcional: los tipos de disco a crear, por ejemplopd-ssd
ohyperdisk-balanced
- Sólo un disco puede ser el disco de arranque.
- Debe adjuntar el disco de arranque como primer disco para esa instancia.
- Si especifica la propiedad
source
, no puede especificar también la propiedadinitializeParams
. Proporcionar unasource
indica que el disco de inicio ya existe, pero la propiedadinitializeParams
indica que Compute Engine debe crear un nuevo disco de inicio. -
PROJECT_ID
: ID de tu proyecto -
ZONE
: zona donde desea crear la instancia -
INSTANCE_NAME
: un nombre para la nueva instancia -
MACHINE_TYPE
: tipo de máquina de la instancia DISK_SIZE
: Opcional: tamaño, en gibibytes (GiB), del disco correspondienteCuando se proporciona, esta propiedad debe ser igual o mayor que el tamaño del disco de origen desde el que se realizó la instantánea.
DISK_TYPE
: Opcional: URL completa o parcial para el tipo de disco correspondiente, por ejemplo,PROJECT_ID /zones/ ZONE /diskTypes/pd-ssd
oPROJECT_ID /zones/ ZONE /diskTypes/hyperdisk-balanced
IMAGE_PROJECT
: el proyecto que contiene la imagen. Por ejemplo,debian-cloud
IMAGE_FAMILY
: una familia de imágenes. Esto crea la instancia a partir de la imagen de sistema operativo no obsoleta más reciente de esa familia. Por ejemplo, si especifica"sourceImage": "projects/debian-cloud/global/images/family/debian-11"
, Compute Engine crea una instancia utilizando la última versión de la imagen del sistema operativo en la familia de imágenes de Debian 11.DEVICE_NAME
: Opcional: el nombre del dispositivo que se muestra en el sistema operativo invitado de la instancia.SNAPSHOT_NAME
: los nombres de las instantáneas de disco correspondientes que no son de arranque y que desea restaurar en discos nuevos en la instancia.
Go
Para usar las muestras de Go de esta página en un entorno de desarrollo local, instala e inicializa gcloud CLI y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
Para obtener más información, consulta Set up authentication for a local development environment.
Java
Para usar las muestras de Java de esta página en un entorno de desarrollo local, instala e inicializa gcloud CLI y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
Para obtener más información, consulta Set up authentication for a local development environment.
Node.js
Para usar las muestras de Node.js de esta página en un entorno de desarrollo local, instala e inicializa gcloud CLI y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
Para obtener más información, consulta Set up authentication for a local development environment.
Python
Para usar las muestras de Python de esta página en un entorno de desarrollo local, instala e inicializa gcloud CLI y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
Para obtener más información, consulta Set up authentication for a local development environment.
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 requeridos
Para obtener los permisos que necesita restaurar a partir de una instantánea, solicite a su administrador que le otorgue el rol de IAM de Administrador de instancia informática (v1) (
roles/compute.instanceAdmin.v1
) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulte Administrar el acceso a proyectos, carpetas y organizaciones .Esta función predefinida contiene los permisos necesarios para restaurar desde una instantánea. Para ver los permisos exactos que se requieren, expanda la sección Permisos requeridos :
Permisos requeridos
Se requieren los siguientes permisos para restaurar desde una instantánea:
Es posible que también pueda obtener estos permisos con roles personalizados u otros roles predefinidos .
Limitaciones
Cree un disco a partir de una instantánea y, opcionalmente, adjuntelo a una instancia
Si realizó una copia de seguridad de un disco de arranque o de otro disco con una instantánea, puede crear un disco nuevo basado en la instantánea.
Consola
Opcionalmente, puede adjuntar un disco que no sea de arranque a una instancia .
nube de gcloud
Ir
Go
Antes de probar este ejemplo, sigue las instrucciones de configuración Go en el inicio rápido de Compute Engine usando bibliotecas cliente . Para obtener más información, consulta la documentación de referencia de la API Go de Compute Engine .
Para autenticarse en Compute Engine, configure las credenciales predeterminadas de la aplicación. Para obtener más información, consulte Configurar la autenticación para un entorno de desarrollo local .
Java
Java
Antes de probar este ejemplo, sigue las instrucciones de configuración Java en el inicio rápido de Compute Engine usando bibliotecas cliente . Para obtener más información, consulta la documentación de referencia de la API Java de Compute Engine .
Para autenticarse en Compute Engine, configure las credenciales predeterminadas de la aplicación. Para obtener más información, consulte Configurar la autenticación para un entorno de desarrollo local .
Nodo.js
Node.js
Antes de probar este ejemplo, sigue las instrucciones de configuración de Node.js en el inicio rápido de Compute Engine usando bibliotecas cliente . Para obtener más información, consulta la documentación de referencia de la API de Compute Engine Node.js
Para autenticarse en Compute Engine, configure las credenciales predeterminadas de la aplicación. Para obtener más información, consulte Configurar la autenticación para un entorno de desarrollo local .
Pitón
Python
Antes de probar este ejemplo, sigue las instrucciones de configuración Python en el inicio rápido de Compute Engine usando bibliotecas cliente . Para obtener más información, consulta la documentación de referencia de la API Python de Compute Engine .
Para autenticarse en Compute Engine, configure las credenciales predeterminadas de la aplicación. Para obtener más información, consulte Configurar la autenticación para un entorno de desarrollo local .
DESCANSAR
Después de crear y adjuntar un nuevo disco a una instancia, debe montar el disco para que el sistema operativo pueda utilizar el espacio de almacenamiento disponible.
Crear una instancia a partir de discos existentes
Puede crear discos de arranque y discos de datos a partir de instantáneas y luego adjuntar estos discos a una nueva instancia informática.
Ir
Go
Antes de probar este ejemplo, sigue las instrucciones de configuración Go en el inicio rápido de Compute Engine usando bibliotecas cliente . Para obtener más información, consulta la documentación de referencia de la API Go de Compute Engine .
Para autenticarse en Compute Engine, configure las credenciales predeterminadas de la aplicación. Para obtener más información, consulte Configurar la autenticación para un entorno de desarrollo local .
Java
Java
Antes de probar este ejemplo, sigue las instrucciones de configuración Java en el inicio rápido de Compute Engine usando bibliotecas cliente . Para obtener más información, consulta la documentación de referencia de la API Java de Compute Engine .
Para autenticarse en Compute Engine, configure las credenciales predeterminadas de la aplicación. Para obtener más información, consulte Configurar la autenticación para un entorno de desarrollo local .
Nodo.js
Node.js
Antes de probar este ejemplo, sigue las instrucciones de configuración de Node.js en el inicio rápido de Compute Engine usando bibliotecas cliente . Para obtener más información, consulta la documentación de referencia de la API de Compute Engine Node.js
Para autenticarse en Compute Engine, configure las credenciales predeterminadas de la aplicación. Para obtener más información, consulte Configurar la autenticación para un entorno de desarrollo local .
Pitón
Python
Antes de probar este ejemplo, sigue las instrucciones de configuración Python en el inicio rápido de Compute Engine usando bibliotecas cliente . Para obtener más información, consulta la documentación de referencia de la API Python de Compute Engine .
Para autenticarse en Compute Engine, configure las credenciales predeterminadas de la aplicación. Para obtener más información, consulte Configurar la autenticación para un entorno de desarrollo local .
Crear una instancia a partir de una instantánea del disco de arranque
Si creó una instantánea del disco de arranque de una instancia informática, puede usar esa instantánea para crear una nueva instancia.
Para crear rápidamente más de una instancia con el mismo disco de arranque, cree una imagen personalizada y luego cree instancias a partir de esa imagen en lugar de usar una instantánea.
Para crear una instancia informática con un disco de arranque regional creado a partir de una instantánea, utilice la CLI o REST de Google Cloud.
Consola
nube de gcloud
Disco de arranque zonal
Utilice el comando
gcloud compute instances create
e incluya la marca--source-snapshot
.gcloud compute instances create INSTANCE_NAME
--source-snapshot=BOOT_SNAPSHOT_NAME
--boot-disk-size=BOOT_DISK_SIZE
--boot-disk-type=BOOT_DISK_TYPE
--boot-disk-device-name=BOOT_DISK_NAMEReemplace lo siguiente:
Disco de arranque regional
Utilice el comando
gcloud compute instances create
e incluya la marca--create-disk
con las propiedadessource-snapshot
,replica-zones
yboot
.gcloud compute instances create INSTANCE_NAME
--zone=ZONE
--create-disk=^:^name=DISK_NAME:source-snapshot=BOOT_SNAPSHOT_NAME:boot=true:type=BOOT_DISK_TYPE:replica-zones=ZONE,REMOTE_ZONELos caracteres
^:^
especifican que dos puntos:
se utilizan como separador entre cada una de las propiedades del disco. Esto es necesario para que pueda utilizar una,
al especificar las zonas parareplica-zones
.Reemplace lo siguiente:
Ir
Go
Antes de probar este ejemplo, sigue las instrucciones de configuración Go en el inicio rápido de Compute Engine usando bibliotecas cliente . Para obtener más información, consulta la documentación de referencia de la API Go de Compute Engine .
Para autenticarse en Compute Engine, configure las credenciales predeterminadas de la aplicación. Para obtener más información, consulte Configurar la autenticación para un entorno de desarrollo local .
Java
Java
Antes de probar este ejemplo, sigue las instrucciones de configuración Java en el inicio rápido de Compute Engine usando bibliotecas cliente . Para obtener más información, consulta la documentación de referencia de la API Java de Compute Engine .
Para autenticarse en Compute Engine, configure las credenciales predeterminadas de la aplicación. Para obtener más información, consulte Configurar la autenticación para un entorno de desarrollo local .
Nodo.js
Node.js
Antes de probar este ejemplo, sigue las instrucciones de configuración de Node.js en el inicio rápido de Compute Engine usando bibliotecas cliente . Para obtener más información, consulta la documentación de referencia de la API de Compute Engine Node.js
Para autenticarse en Compute Engine, configure las credenciales predeterminadas de la aplicación. Para obtener más información, consulte Configurar la autenticación para un entorno de desarrollo local .
Pitón
Python
Antes de probar este ejemplo, sigue las instrucciones de configuración Python en el inicio rápido de Compute Engine usando bibliotecas cliente . Para obtener más información, consulta la documentación de referencia de la API Python de Compute Engine .
Para autenticarse en Compute Engine, configure las credenciales predeterminadas de la aplicación. Para obtener más información, consulte Configurar la autenticación para un entorno de desarrollo local .
DESCANSAR
Cuando utiliza la API para crear una instancia a partir de una instantánea, se aplican las siguientes restricciones:
Disco de arranque zonal
Para crear una instancia a partir de una instantánea del disco de arranque, utilice el métodoinstances.insert
y especifique el camposourceSnapshot
en la propiedaddisks
. Opcionalmente, puede especificar las propiedadesdiskSizeGb
ydiskType
para el nuevo disco de inicio. Reemplace lo siguiente:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances { "name": "INSTANCE_NAME", "machineType": "machineTypes/MACHINE_TYPE", "disks": [{ "boot": true, "initializeParams": { "sourceSnapshot": "global/snapshots/BOOT_SNAPSHOT_NAME", "diskSizeGb": "BOOT_DISK_SIZE", "diskType": "BOOT_DISK_TYPE" } }], "networkInterfaces": [ { "nicType": "GVNIC" } ] }
Disco de arranque regional
Para crear una instancia informática con un disco de arranque regional usando una instantánea del disco de arranque como origen, use el métodoinstances.insert
y especifique los campossourceSnapshot
yreplicaZones
en la propiedaddisks
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances { "name": "INSTANCE_NAME", "disks": [ { "boot": true, "initializeParams": { "sourceSnapshot": "global/snapshots/BOOT_SNAPSHOT_NAME", "replicaZones": [ "projects/PROJECT_ID/zones/ZONE", "projects/PROJECT_ID/zones/REMOTE_ZONE" ], "diskType": "BOOT_DISK_TYPE" } } ], "networkInterfaces": [ { "nicType": "GVNIC" } ] }
Reemplace lo siguiente:
Cree una instancia informática a partir de una instantánea del disco que no sea de arranque
Si realizó una copia de seguridad de un disco que no es de arranque con una instantánea, puede crear una instancia con un disco que no es de arranque adicional basado en la instantánea.
Consola
Al restaurar instantáneas que no son de arranque en una nueva instancia desde la consola, primero cree un disco a partir de cada instantánea. Luego, adjunte los nuevos discos cuando cree la instancia.
nube de gcloud
Crea una instancia mediante el comando
gcloud compute instances create
. Para cada instantánea que no sea de arranque y que desee restaurar, incluya la marca--create-disk
y especifique unasource-snapshot
.Por ejemplo, para restaurar dos instantáneas de discos que no son de arranque en una nueva instancia, use el siguiente comando:
gcloud compute instances create INSTANCE_NAME \ --create-disk source-snapshot=SNAPSHOT_1_NAME,name=DISK_1_NAME,size=DISK_1_SIZE,type=DISK_1_TYPE \ --create-disk source-snapshot=SNAPSHOT_2_NAME,name=DISK_2_NAME,size=DISK_2_SIZE,type=DISK_2_TYPE
Reemplace lo siguiente:
DESCANSAR
Cuando se utiliza REST para restaurar una instantánea que no es de inicio en una nueva instancia, se aplican las siguientes restricciones:
Cree una solicitud
POST
para el métodoinstances.insert
y especifique el camposourceSnapshot
en la propiedadinitializeParams
. Puede agregar varios discos que no sean de arranque repitiendo la propiedadinitializeParams
para cada disco que no sea de arranque que desee crear. Opcionalmente, puede especificar las propiedadesdiskSizeGb
ydiskType
para cualquiera de los discos que cree.Por ejemplo, para restaurar dos instantáneas de disco que no son de arranque en una nueva instancia, realice la siguiente solicitud:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances { "name": "INSTANCE_NAME", "machineType": "machineTypes/MACHINE_TYPE", "networkInterfaces": [ { "nicType": "GVNIC" } ], "disks": [ { "autoDelete": "true", "boot": "true", "diskSizeGb": "BOOT_DISK_SIZE", "diskType": "BOOT_DISK_TYPE", "initializeParams": { "sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY" } }, { "deviceName": "DEVICE_1_NAME", "initializeParams": { "sourceSnapshot": "global/snapshots/SNAPSHOT_1_NAME", "diskSizeGb": "DISK_1_SIZE", "diskType": "DISK_1_TYPE" } }, { "deviceName": "DEVICE_2_NAME", "initializeParams": { "sourceSnapshot": "global/snapshots/SNAPSHOT_2_NAME", "diskSizeGb": "DISK_2_SIZE", "diskType": "DISK_2_TYPE" } } ] }
Reemplace lo siguiente:
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).
-