Detén o reinicia una instancia de Compute Engine (original) (raw)

Ir al contenido principal

Detén o reinicia una instancia de Compute Engine

Linux Windows

Puedes detener manualmente una instancia de Compute Engine cuando ya no la uses o para modificar sus propiedades, por ejemplo, para cambiar su tipo de máquina o quitar los discos adjuntos y activados. Después de que se detenga la instancia, puedes reiniciarla para reanudar tu carga de trabajo o borrarla si ya no la necesitas.

En este documento, se explica cómo detener o reiniciar una instancia de forma manual. Para automatizar el reinicio o la detención de una instancia, consulta los siguientes recursos:

Limitaciones

Cuando detienes una instancia de procesamiento, se aplican las siguientes limitaciones:

Antes de comenzar

Console

Cuando usas la consola de Google Cloud para acceder a los servicios y las APIs de Google Cloud , no necesitas configurar la autenticación.

gcloud

  1. Instala Google Cloud CLI. Después de la instalación,inicializa Google Cloud CLI con el siguiente comando:
    gcloud init
    Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

Go

Para usar las muestras de Go de esta página en un entorno de desarrollo local, instala e inicializa la gcloud CLI y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.

  1. Instala Google Cloud CLI.
  2. Si usas un proveedor de identidad (IdP) externo, primero debes acceder a gcloud CLI con tu identidad federada.
  3. Si usas un shell local, crea credenciales de autenticación locales para tu cuenta de usuario:
    gcloud auth application-default login
    No es necesario que lo hagas si usas Cloud Shell.
    Si se devuelve un error de autenticación y usas un proveedor de identidad (IdP) externo, confirma que accediste a la gcloud CLI con tu identidad federada.

Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.

Java

Para usar las muestras de Java de esta página en un entorno de desarrollo local, instala e inicializa la gcloud CLI y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.

  1. Instala Google Cloud CLI.
  2. Si usas un proveedor de identidad (IdP) externo, primero debes acceder a gcloud CLI con tu identidad federada.
  3. Si usas un shell local, crea credenciales de autenticación locales para tu cuenta de usuario:
    gcloud auth application-default login
    No es necesario que lo hagas si usas Cloud Shell.
    Si se devuelve un error de autenticación y usas un proveedor de identidad (IdP) externo, confirma que accediste a la gcloud CLI con tu identidad federada.

Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.

Node.js

Para usar las muestras de Node.js de esta página en un entorno de desarrollo local, instala e inicializa la gcloud CLI y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.

  1. Instala Google Cloud CLI.
  2. Si usas un proveedor de identidad (IdP) externo, primero debes acceder a gcloud CLI con tu identidad federada.
  3. Si usas un shell local, crea credenciales de autenticación locales para tu cuenta de usuario:
    gcloud auth application-default login
    No es necesario que lo hagas si usas Cloud Shell.
    Si se devuelve un error de autenticación y usas un proveedor de identidad (IdP) externo, confirma que accediste a la gcloud CLI con tu identidad federada.

Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.

PHP

Para usar las muestras de PHP de esta página en un entorno de desarrollo local, instala e inicializa la gcloud CLI y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.

  1. Instala Google Cloud CLI.
  2. Si usas un proveedor de identidad (IdP) externo, primero debes acceder a gcloud CLI con tu identidad federada.
  3. Si usas un shell local, crea credenciales de autenticación locales para tu cuenta de usuario:
    gcloud auth application-default login
    No es necesario que lo hagas si usas Cloud Shell.
    Si se devuelve un error de autenticación y usas un proveedor de identidad (IdP) externo, confirma que accediste a la gcloud CLI con tu identidad federada.

Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.

Python

Para usar las muestras de Python de esta página en un entorno de desarrollo local, instala e inicializa la gcloud CLI y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.

  1. Instala Google Cloud CLI.
  2. Si usas un proveedor de identidad (IdP) externo, primero debes acceder a gcloud CLI con tu identidad federada.
  3. Si usas un shell local, crea credenciales de autenticación locales para tu cuenta de usuario:
    gcloud auth application-default login
    No es necesario que lo hagas si usas Cloud Shell.
    Si se devuelve un error de autenticación y usas un proveedor de identidad (IdP) externo, confirma que accediste a la gcloud CLI con tu identidad federada.

Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.

REST

Para usar las muestras de la API de REST incluidas en esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la gcloud CLI.

Instala Google Cloud CLI.

Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

Para obtener más información, consultaAutentícate para usar REST en la documentación de autenticación de Google Cloud .

Roles obligatorios

Para obtener los permisos que necesitas para detener o reiniciar una instancia de procesamiento, pídele a tu administrador que te otorgue el rol de IAM Administrador de instancias de Compute (v1) (roles/compute.instanceAdmin.v1) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para detener o reiniciar una instancia de procesamiento. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para detener o reiniciar una instancia de procesamiento:

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Detener una instancia

Cuando detienes una instancia de procesamiento o Compute Engine lo hace por una acción programada, la instancia conserva sus discos conectados, la configuración, las direcciones IP, las direcciones MAC y los metadatos de la instancia. Si también quieres retener los datos en la memoria y el estado de la aplicación, suspende la instancia.

Según si la instancia tiene discos SSD locales conectados y cómo deseas controlar las secuencias de comandos de apagado, detén la instancia con uno de los siguientes métodos:

Detén una instancia sin discos SSD locales

Según lo que quieras hacer cuando detengas una instancia, usa las siguientes opciones:

Para detener una o más instancias, selecciona una de las siguientes opciones:

Console

  1. En la consola de Google Cloud , ve a la página Instancias de VM.
    Ir a Instancias de VM
  2. Selecciona las instancias en ejecución que deseas detener.
  3. Haz clic en Detener. Si no hay una opción de Detener, haz clic en Más acciones > Detener.
  4. En el cuadro de diálogo que aparece, haz lo siguiente:
    1. Opcional: Para detener las instancias sin cerrarlas de forma ordenada o finalizar un cierre ordenado en curso, selecciona la casilla de verificación Omitir el cierre ordenado (si corresponde).
    2. Para confirmar la acción, haz clic en Detener.

gcloud

Para detener una o más instancias en la misma zona, usa el comando gcloud compute instances stop:

gcloud compute instances stop INSTANCE_NAMES \
    --zone=ZONE

Reemplaza lo siguiente:

De manera opcional, si habilitaste el cierre ordenado en una o más instancias, puedes detenerlas sin cerrarlas de forma ordenada o finalizar manualmente un cierre ordenado en curso. Para ello, usa el comando gcloud beta compute instances stop con la marca --no-graceful-shutdown:

gcloud beta compute instances stop INSTANCE_NAMES \
    --no-graceful-shutdown \
    --zone=ZONE

Go

Java

Node.js

PHP

Python

REST

Para detener una instancia, realiza una solicitud POST al método instances.stop:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/stop

Reemplaza lo siguiente:

De manera opcional, si habilitaste el cierre ordenado en una instancia, puedes detenerla sin cerrarla de forma ordenada o finalizar manualmente un cierre ordenado en curso. Para ello, realiza una solicitud POST al método instances.stop. En la URL de la solicitud, incluye el parámetro de consulta noGracefulShutdown=true:

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/stop?noGracefulShutdown=true

Detén una instancia con discos SSD locales

Según lo que quieras hacer cuando detengas una instancia de procesamiento, usa las siguientes opciones:

Para detener una o más instancias que tengan discos SSD locales conectados, selecciona una de las siguientes opciones:

Console

  1. En la consola de Google Cloud , ve a la página Instancias de VM.
    Ir a Instancias de VM
  2. Selecciona las instancias en ejecución que deseas detener.
  3. Haz clic en Detener. Si no hay una opción de Detener, haz clic en Más acciones > Detener.
  4. En el cuadro de diálogo, haz lo siguiente:
    1. Opcional: Para detener las instancias sin realizar un cierre ordenado, o finalizar un cierre ordenado en curso, selecciona la casilla de verificación Omitir el cierre ordenado (si corresponde).
    2. Para confirmar la acción, haz clic en Detener.

gcloud

Cuando detengas una o más instancias en la misma zona que tengan discos SSD locales conectados, especifica si deseas descartar o conservar los datos de SSD locales de la siguiente manera:

gcloud compute instances stop INSTANCE_NAMES \  
    --discard-local-ssd=true \  
    --zone=ZONE  
gcloud beta compute instances stop INSTANCE_NAMES \  
    --discard-local-ssd=false \  
    --zone=ZONE

Reemplaza lo siguiente:

De manera opcional, si habilitaste el cierre ordenado en una o más instancias, puedes detenerlas sin cerrarlas de forma ordenada o finalizar un cierre ordenado en curso. Para ello, usa el comando gcloud beta compute instances stop con la marca --no-graceful-shutdown:

gcloud beta compute instances stop INSTANCE_NAMES \
    --discard-local-ssd=DISCARD_LOCAL_SSD \
    --no-graceful-shutdown \
    --zone=ZONE

Reemplaza DISCARD_LOCAL_SSD por true para descartar los datos de los discos SSD locales o por false para conservarlos.

REST

Cuando detengas una instancia que tenga discos SSD locales conectados, especifica si deseas descartar o conservar los datos de SSD locales de la siguiente manera:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/stop?discardLocalSsd=true  
POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/stop?discardLocalSsd=false

Reemplaza lo siguiente:

De manera opcional, si habilitaste el cierre ordenado en una instancia, puedes detenerla sin cerrarla de forma ordenada o finalizar manualmente un cierre ordenado en curso. Para ello, realiza una solicitud POST al método instances.stop. En la URL de la solicitud, incluye el parámetro de consulta noGracefulShutdown=true:

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/stop?discardLocalSsd=DISCARD_LOCAL_SSD&noGracefulShutdown=true

Reemplaza DISCARD_LOCAL_SSD por true para descartar los datos de los discos SSD locales o por false para conservarlos.

Detén una instancia desde el SO invitado

Si una instancia de procesamiento tiene discos SSD locales conectados, el cierre del SO invitado descarta automáticamente los datos de la SSD local. Para conservar estos datos, cópialos manualmente en una opción de almacenamiento persistente antes de detener la instancia.

Para detener una instancia desde el SO invitado, selecciona una de las siguientes opciones:

Linux

  1. Si aún no lo hiciste, conéctate a la instancia.
  2. Para detener la instancia, selecciona uno de los siguientes métodos:
    • Para obtener un cierre ordenado que permita a la instancia ejecutar secuencias de comandos de apagado antes de apagar el SO invitado, ejecuta el siguiente comando:
    sudo shutdown -h now
    • De lo contrario, para forzar un cierre, ejecuta el siguiente comando:
    sudo poweroff

Windows

  1. Si aún no lo hiciste, conéctate a la instancia con uno de los siguientes métodos:
  2. Para detener la instancia, selecciona uno de los siguientes métodos:
    • Para detener la instancia de forma ordenada y permitir que ejecute secuencias de comandos de apagado antes de cerrar el SO invitado, ejecuta el siguiente comando:
    shutdown /s
    • Para forzar un cierre, ejecuta el siguiente comando:
    shutdown /f

Puedes reiniciar una instancia de procesamiento que se haya detenido por completo, es decir, cuando el estado de la instancia sea TERMINATED.

Si elegiste conservar los datos de tus discos SSD locales cuando detuviste la instancia, es posible que debas volver a activar los discos SSD locales después de reiniciarla. Para obtener más información sobre cómo activar discos SSD locales, consulta Da formato a un dispositivo SSD local y actívalo.

Para reiniciar una instancia, usa uno de los siguientes métodos según si la instancia tiene discos encriptados con claves de encriptación proporcionadas por el cliente (CSEK):

Reinicia una instancia que no tiene discos encriptados con CSEK

Para reiniciar varias instancias simultáneamente en diferentes zonas, usa laGoogle Cloud consola. En el caso de las instancias ubicadas en la misma zona, puedes usar gcloud CLI. De lo contrario, para otros casos de reinicio, selecciona una de las siguientes opciones:

Console

  1. En la consola de Google Cloud , ve a la página Instancias de VM.
    Ir a Instancias de VM
  2. Selecciona una o más instancias.
  3. Haz clic en Iniciar/Reanudar.

gcloud

Para reiniciar una o más instancias en la misma zona, usa el comando gcloud compute instances start:

gcloud compute instances start INSTANCE_NAMES \
    --zone=ZONE

Reemplaza lo siguiente:

Go

Java

Node.js

PHP

Python

REST

Para reiniciar una instancia, realiza una solicitud POST al método instances.start:

 POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/start

Reemplaza lo siguiente:

Reinicia una instancia con discos encriptados con CSEK

Cuando reinicies una instancia de procesamiento detenida que tenga discos conectados encriptados con claves de encriptación proporcionadas por el cliente, debes proporcionar la información de la clave de encriptación.

Para reiniciar varias instancias simultáneamente en diferentes zonas, usa laGoogle Cloud consola. En el caso de las instancias ubicadas en la misma zona, puedes usar gcloud CLI. De lo contrario, para otros casos de reinicio, selecciona una de las siguientes opciones:

Console

  1. En la consola de Google Cloud , ve a la página Instancias de VM.
    Ir a Instancias de VM
  2. Selecciona las instancias que deseas reiniciar.
  3. Haz clic en Iniciar/Reanudar.
  4. Especifica las claves de encriptación para cada uno de los discos encriptados conectados a las instancias y, luego, haz clic en Iniciar.

gcloud

Para reiniciar una o más instancias que usan discos encriptados en la misma zona, usa el comando gcloud compute instances start con la marca --csek-key-file. Si usas una clave unida con RSA, usa el comando gcloud beta compute instances start con la marca --csek-key-file en su lugar:

gcloud compute instances start INSTANCE_NAMES \
    --csek-key-file=ENCRYPTION_KEY_FILE \
    --zone=ZONE

Reemplaza lo siguiente:

Go

Java

Node.js

PHP

Python

REST

Para reiniciar una instancia que usa discos encriptados, realiza una solicitud POST al método instances.startWithEncryptionKey:

POST  https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/startWithEncryptionKey

{
  "disks": [
    {
      "source": "DISK_URL",
      "diskEncryptionKey": {
        "ENCRYPTION_TYPE": "ENCRYPTION_KEY"
      }
    }
  ]
}

Reemplaza lo siguiente:

¿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: 2026-06-16 (UTC)