En este documento, se explica cómo detener y reiniciar de forma manual una instancia de máquina virtual (VM), y cómo restablecer o reiniciar una VM.
Detén una VM si ya no la usas o si deseas modificar una o más de sus propiedades; por ejemplo, si deseas cambiar nombre de la VM, su tipo de máquina, agregar o quitar discos adjuntos o cambiar la plataforma de CPU mínima. Después de detener la VM, reiníciala para reanudar tu carga de trabajo o bórrala si ya no la necesitas.
Restablece una VM si, por ejemplo, esta no responde o el sistema operativo (SO) invitado falla. Después de restablecer la VM, puedes reanudar la carga de trabajo.
Reinicia una VM desde el SO invitado si, por ejemplo, deseas limpiar la memoria de la VM y volver a inicializarla a su estado de inicio original. Después de reiniciar una VM desde su SO invitado, puedes reanudar la carga de trabajo.
Antes de comenzar
-
Configura la autenticación si aún no lo hiciste.
La autenticación es el proceso mediante el cual se verifica tu identidad para acceder a los servicios y las API de Google Cloud.
Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine de la siguiente manera.
Select the tab for how you plan to use the samples on this page:
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
- Install the Google Cloud CLI.
-
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.
- Install the Google Cloud CLI.
-
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.
- Install the Google Cloud CLI.
-
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.
- Install the Google Cloud CLI.
-
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.
- Install the Google Cloud CLI.
-
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.
-
Para detener una VM, haz lo siguiente:
compute.instances.stop
en la VM -
Para detener una VM desde el SO invitado:
compute.instances.setMetadata
en la VM si usa Llaves SSH públicas a nivel de instancia. -
Para reiniciar una VM:
compute.instances.start
en la VM -
Para reiniciar una VM que usa claves de encriptación:
compute.instances.startWithEncryptionKey
en la VM -
Para restablecer una VM, haz lo siguiente:
compute.instances.reset
en la VM -
Para reiniciar una VM desde el SO invitado, haz lo siguiente:
compute.instances.setMetadata
en la VM Compute Engine envía la señal de cierre de ACPI a la VM y espera un momento hasta que el SO invitado realice un cierre ordenado. Luego, Compute Engine establece el estado de la VM en
STOPPING
primero y, luego, lo pasa aTERMINATED
en un minuto.La VM se restablece a su estado de encendido y conserva sus IP internas, direcciones MAC, ajustes de configuración y metadatos. Sin embargo, la VM pierde sus datos en la memoria y el estado de la VM. Si necesitas retener los datos en la memoria y el estado de la VM, suspende la VM.
En la consola de Google Cloud, ve a la página Instancias de VM.
Selecciona las VMs que deseas detener.
Haz clic en
Detener y, luego, en Detener para confirmar.VM_NAME
: el nombre de la VM.PROJECT_ID
: El ID del proyecto en el que se encuentra la VM.ZONE
: la zona donde se ubica la VM.VM_NAME
: el nombre de la VM.PROJECT_ID
: El ID del proyecto en el que se encuentra la VM.ZONE
: la zona donde se ubica la VM.Para obtener un cierre ordenado que permita a la VM ejecutar secuencias de comandos de apagado antes de enviar la señal de cierre de ACPI a la VM, ejecuta el siguiente comando:
sudo shutdown -h now
De lo contrario, para forzar un cierre, ejecuta el siguiente comando:
sudo poweroff
Para obtener un cierre ordenado que permita a la VM ejecutar secuencias de comandos de apagado antes de enviar la señal de cierre de ACPI a la VM, ejecuta el siguiente comando:
shutdown /s
De lo contrario, para forzar un cierre, ejecuta el siguiente comando:
shutdown /f
Reinicia una VM sin discos encriptados (predeterminado).
En la consola de Google Cloud, ve a la página Instancias de VM.
Selecciona una o más VMs.
Haz clic en
Iniciar/Reanudar.VM_NAME
: el nombre de la VM.PROJECT_ID
: El ID del proyecto en el que se encuentra la VM.ZONE
: la zona donde se ubica la VM.VM_NAME
: el nombre de la VM que se reiniciará.PROJECT_ID
: El ID del proyecto en el que se encuentra la VM.ZONE
: la zona donde se ubica la VM.En la consola de Google Cloud, ve a la página Instancias de VM.
Selecciona la VM que deseas reiniciar.
Haz clic en
Iniciar/Reanudar.Especifica las claves de encriptación para cada uno de los discos encriptados conectados a esta VM y, luego, haz clic en Iniciar.
VM_NAME
: el nombre de la VM.ENCRYPTION_KEY_FILE
: Es la ruta de acceso relativa al archivo JSON que contiene la clave de encriptación proporcionada por el cliente.PROJECT_ID
: El ID del proyecto en el que se encuentra la VM.ZONE
: la zona donde se ubica la VM.PROJECT_ID
: El ID del proyecto en el que se encuentra la VM.ZONE
: la zona donde se ubica la VM.VM_NAME
: el nombre de la VM.DISK_URL
: Es la URL del recurso que corresponde al nombre del recurso completo del disco adjunto que se encripta con una clave de encriptación proporcionada por el cliente.ENCRYPTION_TYPE
: el tipo de encriptación del disco que usas, que puede ser una de las siguientes opciones:rawKey
,kmsKeyName
orsaEncryptedKey
. Si usas el tiporsaEncryptedKey
, debes realizar una solicitudPOST
a la API Beta en lugar de a la API v1.ENCRYPTION_KEY
: la clave de encriptación que se usa para encriptar los discos persistentes conectados a la VM. Las clavesrawKey
orsaEncryptedKey
deben estar codificadas en base64. Además, para preparar una claversaEncryptedKey
, consulta Unión de clave RSA.La VM se vuelve a inicializar a su estado de inicio inicial con los metadatos, la imagen y los discos persistentes originales.
La VM limpia de manera forzosa el contenido de la memoria de la máquina, a menos que realices una copia de seguridad de los datos.
El estado de la VM permanece
RUNNING
durante el proceso.En la consola de Google Cloud, ve a la página Instancias de VM.
Selecciona las VMs que deseas restablecer.
Haz clic en Restablecer y, luego, vuelve a hacer clic en Restablecer.
VM_NAME
: el nombre de la VM.PROJECT_ID
: El ID del proyecto en el que se encuentra la VM.ZONE
: la zona donde se ubica la VM.VM_NAME
: el nombre de la VM.PROJECT_ID
: El ID del proyecto en el que se encuentra la VM.ZONE
: la zona donde se ubica la VM.La VM se vuelve a inicializar a su estado de inicio inicial con los metadatos, la imagen y los discos persistentes originales.
La VM limpia el contenido de la memoria de la máquina, a menos que realices una copia de seguridad de los datos.
El estado de la VM permanece
RUNNING
durante el proceso.Desconecta esos recursos de la VM detenida.
Borra la VM. Esta acción también borra los recursos adjuntos a la VM.
Obtén más información para programar las VM a fin de que se inicien y se detengan de forma automática.
Obtén más información para limitar el entorno de ejecución de una VM.
Obtén información para solucionar problemas de una VM después de que se cierra de forma inesperada mediante una de las siguientes acciones:
Soluciona los problemas de la VM con la consola en serie interactiva.
Obtén más información sobre cómo cambiar el tipo de máquina en una VM.
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.
PHP
Para usar las muestras de PHP 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.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Si deseas obtener más información, consulta Autentica para usar REST en la documentación de autenticación de Google Cloud.
Roles obligatorios
Para obtener los permisos que necesitas para detener y reiniciar una VM, pídele a tu administrador que te otorgue el rol de Administrador de instancias de Compute (v1) (
roles/compute.instanceAdmin.v1
) de IAM en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.Este rol predefinido contiene los permisos necesarios para detener y reiniciar una VM. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para detener y reiniciar una VM:
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos
Detén una VM
Cuando detienes una VM en ejecución, sucede lo siguiente:
Además, si adjuntaste recursos a la VM, estos permanecen conectados hasta que los desvincules de forma manual o borres la VM. Si la VM tiene discos SSD locales conectados, la detención de la VM descarta todos los datos en los discos SSD locales de forma predeterminada. Para mantener los datos en los discos SSD locales, debes detener la VM mediante gcloud CLI con la marca
--discard-local-ssd=false
. Para obtener más información, consulta Detén una VM con SSD local.Para detener una VM, elige uno de los métodos que se describen en este documento:
Después de detener una VM, puedes reiniciarla o borrarla. Si no planeas reiniciar la VM, se recomienda borrarla.
Detén una VM a través de Google Cloud
Para detener más de una VM a la vez, usa la consola de Google Cloud.
Console
Para detener una o más VM, haz lo siguiente:
gcloud
Para detener una VM, usa el comando
gcloud compute instances stop
.gcloud compute instances stop VM_NAME \ --project=PROJECT_ID \ --zone=ZONE
Reemplaza lo siguiente:
Si conectaste un disco SSD local a la VM y deseas conservarlos después de detenerla, usa el comando
gcloud beta compute instances stop
con la marca--discard-local-ssd=false
.gcloud beta compute instances stop VM_NAME \ --discard-local-ssd=false \ --project=PROJECT_ID \ --zone=ZONE
Go
Java
Node.js
PHP
Python
REST
Para detener una VM, realiza una solicitud
POST
al métodoinstances.stop
.POST https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/stop
Reemplaza lo siguiente:
Detén una VM desde el SO invitado
Para detener una VM desde el SO invitado cuando te conectas a la VM, selecciona una de las siguientes pestañas.
Linux
Para detener una VM de Linux, elige uno de los siguientes métodos:
Windows
Para detener una VM de Windows, elige uno de los siguientes métodos:
Reinicia una VM
Puedes reiniciar una VM detenida solo si la VM está en estado
TERMINATED
. Para reiniciar una VM, elige uno de los siguientes métodos que se describen en este documento:Reinicia una VM sin discos encriptados
Reinicia una VM detenida que no use ningún disco encriptado (predeterminado). Para reiniciar más de una VM a la vez, usa la consola de Google Cloud.
Console
Para reiniciar una o más VMs, haz lo siguiente:
gcloud
Para detener una VM, usa el comando
gcloud compute instances start
:gcloud compute instances start VM_NAME \ --project=PROJECT_ID \ --zone=ZONE
Reemplaza lo siguiente:
Go
Java
Node.js
PHP
Python
REST
Para reiniciar una VM, realiza una solicitud
POST
al métodoinstances.start
.POST https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/start
Reemplaza lo siguiente:
Reinicia una VM que tenga discos encriptados
Puedes reiniciar una VM detenida que usa claves de encriptación proporcionadas por el cliente para encriptar los discos persistentes conectados a la VM.
Console
Para reiniciar una VM que usa discos encriptados, haz lo siguiente:
gcloud
Para reiniciar una VM que usa discos encriptados, usa el comando
gcloud compute instances start
con la marca--csek-key-file
. Si usas una clave unida con RSA, usa el comandogcloud beta compute instances start
en su lugar.gcloud compute instances start VM_NAME \ --csek-key-file=ENCRYPTION_KEY_FILE \ --project=PROJECT_ID \ --zone=ZONE
Reemplaza lo siguiente:
Go
Java
Node.js
PHP
Python
REST
Para reiniciar una VM que usa discos encriptados, realiza una solicitud
POST
al métodoinstances.startWithEncryptionKey
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/startWithEncryptionKey { "disks": [ { "source": "DISK_URL", "diskEncryptionKey": { "ENCRYPTION_TYPE": "ENCRYPTION_KEY" } } ] }
Reemplaza lo siguiente:
Restablece una VM
Restablecer una VM en ejecución es similar a restablecer manualmente una computadora, como cuando presionas un botón de restablecimiento o mantienes presionado el botón de encendido. Cuando restableces una VM, no le das tiempo a la VM para realizar un cierre ordenado del SO invitado. En consecuencia, esto puede dañar los sistemas de archivos del disco. Google Cloud recomienda restablecer una VM solo si el SO invitado falló y no tienes otras opciones. Si deseas volver a inicializar una VM y realizar un apagado limpio, consulta Reinicia una VM en este documento.
Cuando restableces una VM, sucede lo siguiente:
Cuando restableces una VM, no se cambia ninguna de sus propiedades de VM. La VM conserva las IP efímeras, las IP externas estáticas, los discos persistentes, los discos SSD locales (si existen) y el tipo de máquina.
Console
Para restablecer una o más VMs en ejecución, haz lo siguiente:
gcloud
Para restablecer una VM en ejecución, usa el comando
gcloud compute instances reset
.gcloud compute instances reset VM_NAME \ --project=PROJECT_ID \ --zone=ZONE
Reemplaza lo siguiente:
Go
Java
Node.js
PHP
Python
REST
Para restablecer una VM en ejecución, realiza una solicitud
POST
al métodoinstances.reset
.POST https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/reset
Reemplaza lo siguiente:
Reiniciar una VM
Cuando reinicias una VM desde el SO invitado, sucede lo siguiente:
En comparación con restablecer una VM, reiniciarla desde el SO invitado espera a que la VM finalice todas las tareas en ejecución antes de enviar la señal de cierre de ACPI a la VM. Esto permite que la VM realice un cierre ordenado.
Reiniciar una VM no cambia ninguna de sus propiedades de la VM. La VM conserva las IP efímeras, las IP externas estáticas, los discos persistentes, los discos SSD locales (si existen) y el tipo de máquina.
Linux
Para restablecer una VM de Linux, reinicia el SO invitado con el siguiente comando:
sudo reboot
Windows
Para restablecer una VM de Windows, reinicia el SO invitado con el siguiente comando:
shutdown /r /t 0
De manera opcional, para supervisar el proceso de cierre y reinicio de la VM, habilita el menú del administrador de arranque de Windows.
Facturación
Después de que se detiene una VM y Compute Engine establece su estado en
TERMINATED
, ya no se generarán cargos por el uso de CPU. Sin embargo, se seguirán generando cargos por los recursos conectados a la VM, como los discos persistentes y las direcciones IP externas.Para dejar de generar cargos por los recursos conectados a una VM, realiza una de las siguientes acciones:
¿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: 2024-09-03 (UTC)
-