Cómo ver el cierre elegante en una instancia de Compute Engine

En este documento, se explica cómo ver la configuración y el progreso de un cierre ordenado en una instancia de Compute Engine.

Cuando ves los detalles de una instancia de procesamiento, puedes hacer lo siguiente:

  • Ver la configuración del cierre ordenado: Verifica si el cierre ordenado está habilitado y, si es así, consulta su duración máxima.

  • Supervisa un cierre ordenado: Si hay un cierre ordenado en curso, puedes verificar el tiempo restante y si Compute Engine está deteniendo o borrando la instancia de procesamiento.

Para obtener más información sobre los requisitos y las limitaciones que se aplican cuando cierras de forma ordenada una instancia de procesamiento, consulta Acerca del cierre ordenado.

Antes de comenzar

  • Si aún no lo hiciste, configura la autenticación. La autenticación verifica tu identidad para acceder a los servicios y las APIs de Cloud de Confiance by S3NS . Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:

    Selecciona la pestaña según cómo planeas usar las muestras de esta página:

    Console

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

    gcloud

    1. Instala Google Cloud CLI y, luego, accede a gcloud CLI con tu identidad federada. Después de acceder, inicializa Google Cloud CLI con el siguiente comando: 

      gcloud init
  • Configura una región y una zona predeterminadas.

    • 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 y, luego, accede a gcloud CLI con tu identidad federada.

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

Roles obligatorios

Para obtener los permisos que necesitas para ver el cierre ordenado de una instancia de procesamiento, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para ver el cierre ordenado de 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 ver el cierre ordenado de una instancia de procesamiento:

  • Para ver los detalles de una instancia de procesamiento: compute.instances.get en el proyecto
  • Para ver una lista de instancias de procesamiento, usa compute.instances.list en el proyecto.
  • Para ver una lista de las operaciones de Compute Engine de forma global, ejecuta compute.globalOperations.list en el proyecto.
  • Para ver una lista de las operaciones de Compute Engine en una región, haz lo siguiente: compute.regionOperations.list en el proyecto
  • Para ver una lista de las operaciones de Compute Engine en una zona, se necesita lo siguiente: compute.zoneOperations.list en el proyecto
  • Para ver una lista de registros: logging.logEntries.list en el proyecto

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

Visualiza la configuración de cierre ordenado

Para ver la configuración de cierre ordenado en una instancia de procesamiento, selecciona una de las siguientes opciones:

Console

  1. En la consola de Cloud de Confiance , ve a la página Instancias de VM.

    Ir a Instancias de VM

  2. En la columna Nombre, haz clic en el nombre de tu instancia de procesamiento. Se abrirá la página de detalles de la instancia de procesamiento en la pestaña Detalles.

  3. Para verificar la configuración de cierre ordenado, en la sección Políticas de disponibilidad, verifica el valor del campo Duración máxima del cierre ordenado. En este campo, se muestra el período de cierre ordenado. Si se muestra un guion (-), significa que el cierre ordenado está inhabilitado.

gcloud

Para ver la configuración de cierre ordenado en una instancia de procesamiento, usa el comando gcloud compute instances describe:

gcloud compute instances describe INSTANCE_NAME \
    --zone=ZONE

Reemplaza lo siguiente:

  • INSTANCE_NAME: Es el nombre de la instancia de procesamiento.

  • ZONE: Es la zona en la que existe la instancia de procesamiento.

Si el cierre ordenado está habilitado, el resultado es similar al siguiente:

...
scheduling:
  ...
  gracefulShutdown:
    enabled: true
    maxDuration:
      seconds: 'MAX_DURATION'
  ...
...

El resultado incluye el valor MAX_DURATION, que indica la duración máxima del cierre ordenado en segundos. Si no especificaste una duración personalizada cuando habilitaste el cierre ordenado, Compute Engine omite el campo maxDuration y usa una duración predeterminada de 10 minutos.

REST

Para ver la configuración de cierre ordenado en una instancia de procesamiento, realiza una solicitud GET al método instances.get:

GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME

Reemplaza lo siguiente:

  • PROJECT_ID: el ID del proyecto en el que creaste la instancia de procesamiento.

  • ZONE: Es la zona en la que existe la instancia de procesamiento.

  • INSTANCE_NAME: Es el nombre de la instancia de procesamiento.

Si el cierre ordenado está habilitado, el resultado es similar al siguiente:

{
  ...
  "scheduling": {
    ...
    "gracefulShutdown": {
      "enabled": true,
      "maxDuration": {
        "seconds": "MAX_DURATION"
      }
    }
  },
  ...
}

El resultado incluye el valor MAX_DURATION, que indica la duración máxima del cierre ordenado en segundos. Si no especificaste una duración personalizada cuando habilitaste el cierre ordenado, Compute Engine omite el campo maxDuration y usa una duración predeterminada de 10 minutos.

Supervisa el cierre ordenado

Para supervisar un cierre ordenado en curso en una instancia de procesamiento, usa uno de los siguientes métodos:

Supervisa el cierre ordenado con la consola de Cloud de Confiance , gcloud CLI o la API de REST

Después de que Compute Engine detiene o borra una instancia de procesamiento y se inicia un cierre ordenado, puedes ver los detalles de la instancia de procesamiento para supervisar cuándo se inicia y se completa el cierre ordenado.

Para supervisar un cierre ordenado en curso en una instancia de procesamiento con la consola deCloud de Confiance , gcloud CLI o la API de REST, selecciona una de las siguientes opciones:

Console

  1. En la consola de Cloud de Confiance , ve a la página Instancias de VM.

    Ir a Instancias de VM

  2. En la columna Nombre, haz clic en el nombre de tu instancia de procesamiento. Se abrirá la página de detalles de la instancia de procesamiento en la pestaña Detalles.

  3. Si hay un cierre ordenado en curso, verifica los siguientes campos en la sección Información básica:

    • Estado: Muestra el estado de tu instancia de procesamiento. Durante un cierre ordenado, se muestra Detención pendiente con un temporizador de cuenta regresiva que indica cuándo finaliza el cierre ordenado.

    • Estado de destino: Muestra si Compute Engine está deteniendo (Detenida) o borrando (Borrada) la instancia de procesamiento.

gcloud

Para supervisar un cierre ordenado en curso en una instancia de procesamiento, usa el comando gcloud compute instances describe:

gcloud compute instances describe INSTANCE_NAME \
    --zone=ZONE

Reemplaza lo siguiente:

  • INSTANCE_NAME: Es el nombre de la instancia de procesamiento.

  • ZONE: Es la zona en la que existe la instancia de procesamiento.

Si hay un cierre ordenado en curso, el resultado es similar al siguiente:

...
resourceStatus:
  ...
  shutdownDetails:
    maxDuration:
      seconds: 'MAX_DURATION'
    requestTimestamp: 'REQUEST_TIMESTAMP'
    stopState: STOP_STATE
    targetState: TARGET_STATE
...
status: PENDING_STOP
...

En esta salida, se incluyen los siguientes valores:

  • MAX_DURATION: Es la duración máxima del cierre ordenado, en segundos. Cuando STOP_STATE cambia a STOPPING, Compute Engine borra el campo maxDuration.

  • REQUEST_TIMESTAMP: Es la marca de tiempo que indica cuándo comenzó el STOP_STATE.

  • STOP_STATE: Es la fase de detención de la instancia de procesamiento. El valor puede ser uno de los siguientes:

    • PENDING_STOP: Compute Engine inició el cierre ordenado. La instancia de procesamiento permanece en este estado hasta que finalices manualmente el cierre ordenado o venza el temporizador.

    • STOPPING: El cierre ordenado finalizó y Compute Engine continúa con la operación de detención o eliminación.

  • TARGET_STATE: indica si Compute Engine detiene (STOPPED) o borra (DELETED) la instancia de procesamiento.

Cuando Compute Engine termina de detener la instancia de procesamiento, cambia su estado a TERMINATE y borra el campo shutdownDetails.

REST

Para supervisar un cierre ordenado en curso en una instancia de procesamiento, realiza una solicitud GET al método instances.get:

GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME

Reemplaza lo siguiente:

  • PROJECT_ID: el ID del proyecto en el que creaste la instancia de procesamiento.

  • ZONE: Es la zona en la que existe la instancia de procesamiento.

  • INSTANCE_NAME: Es el nombre de la instancia de procesamiento.

Si hay un cierre ordenado en curso, el resultado es similar al siguiente:

{
  ...
  "resourceStatus": {
    ...
    "shutdownDetails": {
      "maxDuration": {
        "seconds": "MAX_DURATION"
      },
      "requestTimestamp": "REQUEST_TIMESTAMP",
      "stopState": "STOP_STATE",
      "targetState": "TARGET_STATE"
    }
  },
  ...
  "status": "PENDING_STOP",
  ...
}

En esta salida, se incluyen los siguientes valores:

  • MAX_DURATION: Es la duración máxima del cierre ordenado, en segundos. Cuando STOP_STATE cambia a STOPPING, Compute Engine borra el campo maxDuration.

  • REQUEST_TIMESTAMP: Es la marca de tiempo que indica cuándo comenzó el STOP_STATE.

  • STOP_STATE: Es la fase de detención de la instancia de procesamiento. El valor puede ser uno de los siguientes:

    • PENDING_STOP: Compute Engine inició el cierre ordenado. La instancia de procesamiento permanece en este estado hasta que finalices manualmente el cierre ordenado o venza el temporizador.

    • STOPPING: El cierre ordenado finalizó y Compute Engine continúa con la operación de detención o eliminación.

  • TARGET_STATE: indica si Compute Engine detiene (STOPPED) o borra (DELETED) la instancia de procesamiento.

Cuando Compute Engine termina de detener la instancia de procesamiento, cambia su estado a TERMINATE y borra el campo shutdownDetails.

Supervisa el cierre ordenado consultando el servidor de metadatos

Para supervisar un cierre ordenado en curso consultando el servidor de metadatos, usa una de las siguientes opciones. Para obtener más información sobre cómo ver y consultar los metadatos de una instancia de procesamiento, consulta Visualiza y consulta metadatos de VM.

Linux

  1. Conéctate a tu instancia de procesamiento de Linux.

  2. Para consultar la clave de metadatos shutdown-details, ejecuta el siguiente comando con la herramienta de curl:

    user@myinst:~$ curl -s -H "Metadata-Flavor: Google" http://metadata.google.internal/computeMetadata/v1/instance/shutdown-details

    Si hay un cierre ordenado en curso, el resultado es similar al siguiente:

    {
  "maxDuration": "MAX_DURATION",
  "requestTimestamp": "REQUEST_TIMESTAMP",
  "stopState": "STOP_STATE",
  "targetState": "TARGET_STATE"
}

    El resultado incluye los siguientes valores:

    • MAX_DURATION: Es la duración del período de cierre ordenado en segundos. Después de que Compute Engine establece STOP_STATE en STOPPING, borra el campo maxDuration.

    • REQUEST_TIMESTAMP: Es la marca de tiempo en la que se inició el STOP_STATE.

    • STOP_STATE: Es la fase de detención de la instancia de procesamiento. El valor puede ser uno de los siguientes:

      • PENDING_STOP: Compute Engine inició el cierre ordenado. La instancia de procesamiento permanece en este estado hasta que finalices manualmente el cierre ordenado o venza el temporizador.

      • STOPPING: El cierre ordenado finalizó y Compute Engine continúa con la operación de detención o eliminación.

    • TARGET_STATE: indica si Compute Engine detiene (STOPPED) o borra (DELETED) la instancia de procesamiento.

Windows

  1. Conéctate a tu instancia de Windows Compute.

  2. Para consultar la clave de metadatos shutdown-details, usa el cmdlet Invoke-RestMethod:

    PS C:\> 
$value = (Invoke-RestMethod `
        -Headers @{'Metadata-Flavor' = 'Google'} `
        -Uri "http://metadata.google.internal/computeMetadata/v1/instance/shutdown-details")
$value

    Si hay un cierre ordenado en curso, el resultado es similar al siguiente:

    {
  "maxDuration": "MAX_DURATION",
  "requestTimestamp": "REQUEST_TIMESTAMP",
  "stopState": "STOP_STATE",
  "targetState": "TARGET_STATE"
}

    El resultado incluye los siguientes valores:

    • MAX_DURATION: Es la duración del período de cierre ordenado en segundos. Después de que Compute Engine establece STOP_STATE en STOPPING, borra el campo maxDuration.

    • REQUEST_TIMESTAMP: Es la marca de tiempo en la que se inició el STOP_STATE.

    • STOP_STATE: Es la fase de detención de la instancia de procesamiento. El valor puede ser uno de los siguientes:

      • PENDING_STOP: Compute Engine inició el cierre ordenado. La instancia de procesamiento permanece en este estado hasta que finalices manualmente el cierre ordenado o venza el temporizador.

      • STOPPING: El cierre ordenado finalizó y Compute Engine continúa con la operación de detención o eliminación.

    • TARGET_STATE: indica si Compute Engine detiene (STOPPED) o borra (DELETED) la instancia de procesamiento.

Supervisa el cierre ordenado con los registros de auditoría

Después de que Compute Engine detiene o borra una instancia de procesamiento y se inicia un cierre ordenado, Compute Engine crea Registros de auditoría de Cloud para hacer un seguimiento del cierre ordenado. Puedes revisar estos registros para hacer un seguimiento de cuándo comienza y se completa un cierre ordenado.

Para supervisar un cierre ordenado con los registros de auditoría de Cloud, selecciona una de las siguientes opciones:

Console

  1. En la consola de Cloud de Confiance , accede a la página Explorador de registros.

    Ve al Explorador de registros

  2. En el panel de consultas, ingresa la siguiente consulta:

    resource.type="gce_instance"
protoPayload.serviceName="compute.googleapis.com"
protoPayload.methodName:"compute.instances.gracefulShutdown"

  3. Haz clic en Ejecutar consulta.

gcloud

Para ver los registros de auditoría de Cloud después de que se inicia un cierre ordenado, usa uno de los siguientes comandos de gcloud logging read:

  • Para supervisar el cierre ordenado de todas las instancias de procesamiento que se cierran de forma ordenada, ejecuta el siguiente comando:

    gcloud logging read 'resource.type="gce_instance" AND protoPayload.serviceName="compute.googleapis.com" AND protoPayload.methodName:"compute.instances.gracefulShutdown"'

  • Para supervisar el cierre ordenado de una sola instancia de procesamiento, ejecuta el siguiente comando:

    gcloud logging read 'resource.type="gce_instance" AND protoPayload.serviceName="compute.googleapis.com" AND protoPayload.methodName:"compute.instances.gracefulShutdown" AND "INSTANCE_NAME"'

    Reemplaza INSTANCE_NAME por el nombre de la instancia de procesamiento.

El resultado es similar a lo siguiente:

insertId: -gvb9n5drmdg
labels:
  compute.googleapis.com/root_trigger_id: e23093bc-2c55-4ee4-b7cf-ea8b295f0d9a
logName: projects/example-project/logs/cloudaudit.googleapis.com%2Fsystem_event
operation:
  id: gracefulShutdown-1783417965660-656025a544aa5-0eefacb0-38dc7152
  last: true
  producer: compute.instances.gracefulShutdown
protoPayload:
  '@type': type.googleapis.com/google.cloud.audit.AuditLog
  authenticationInfo:
    principalEmail: system@google.com
  methodName: compute.instances.gracefulShutdown
  request:
    '@type': type.googleapis.com/compute.instances.gracefulShutdown
  resourceName: projects/example-project/zones/us-central1-a/instances/vm-01
  serviceName: compute.googleapis.com
  status:
    message: Instance graceful shutdown completed.
receiveTimestamp: '2026-07-07T10:04:06.109088155Z'
resource:
  labels:
    instance_id: '4210316577417032387'
    project_id: example-project
    zone: us-central1-a
  type: gce_instance
severity: INFO
timestamp: '2026-07-07T10:04:05.846992Z'

REST

Para ver los registros de auditoría de Cloud después de que se inicia un cierre ordenado, realiza una solicitud POST al método entries.list:

POST https://logging.googleapis.com/v2/entries:list

{
  "resourceNames": [
    "projects/PROJECT_ID"
  ],
  "filter": "resource.type=\"gce_instance\" AND protoPayload.serviceName=\"compute.googleapis.com\" AND protoPayload.methodName:\"compute.instances.gracefulShutdown\""
}

Reemplaza PROJECT_ID por el ID del proyecto en el que existe tu instancia de procesamiento.

El resultado es similar a lo siguiente:

{
  "insertId": "-gvb9n5drmdg",
  "labels": {
    "compute.googleapis.com/root_trigger_id": "e23093bc-2c55-4ee4-b7cf-ea8b295f0d9a"
  },
  "logName": "projects/example-project/logs/cloudaudit.googleapis.com%2Fsystem_event",
  "operation": {
    "id": "gracefulShutdown-1783417965660-656025a544aa5-0eefacb0-38dc7152",
    "last": true,
    "producer": "compute.instances.gracefulShutdown"
  },
  "protoPayload": {
    "@type": "type.googleapis.com/google.cloud.audit.AuditLog",
    "authenticationInfo": {
      "principalEmail": "system@google.com"
    },
    "methodName": "compute.instances.gracefulShutdown",
    "request": {
      "@type": "type.googleapis.com/compute.instances.gracefulShutdown"
    },
    "resourceName": "projects/example-project/zones/us-central1-a/instances/vm-01",
    "serviceName": "compute.googleapis.com",
    "status": {
      "message": "Instance graceful shutdown completed."
    }
  },
  "receiveTimestamp": "2026-07-07T10:04:06.109088155Z",
  "resource": {
    "labels": {
      "instance_id": "4210316577417032387",
      "project_id": "example-project",
      "zone": "us-central1-a"
    },
    "type": "gce_instance"
  },
  "severity": "INFO",
  "timestamp": "2026-07-07T10:04:05.846992Z"
}

Para obtener más información, consulta Visualiza los registros de auditoría.

Supervisa el cierre ordenado con la visualización de las operaciones de Compute Engine

Después de que Compute Engine detiene o borra una instancia de procesamiento y se inicia un cierre ordenado, puedes ver las operaciones de detención o eliminación en ejecución para supervisar el cierre ordenado.

Para supervisar un cierre ordenado con la visualización de las operaciones de Compute Engine, selecciona una de las siguientes opciones:

Console

  1. En la consola de Cloud de Confiance , ve a la página Operaciones.

    Ir a Operaciones

  2. Opcional: Para definir mejor tu lista de operaciones y mostrar solo los cierres ordenados en curso en una región o zona específica, en el campo Filtro, ingresa uno de los siguientes filtros:

    • Para ver todas las operaciones en una región, usa el siguiente filtro:

      Target:https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION

    • Para ver todas las operaciones en una sola zona, usa el siguiente filtro:

      Target:https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE

    Reemplaza lo siguiente:

    • PROJECT_ID: Es el ID del proyecto en el que existen tus instancias de procesamiento.

    • REGION: Es la región en la que se encuentran tus instancias de procesamiento.

    • ZONE: Es la zona en la que existen tus instancias de procesamiento.

  3. Para ver los detalles de una operación específica, en la columna Resumen de la operación, haz clic en el resumen de la operación. Se abrirá una página con los detalles de la operación.

gcloud

Para ver todos los cierres ordenados en curso o completados entre las instancias de procesamiento de tu proyecto, usa el siguiente comando gcloud compute operations list:

gcloud compute operations list \
    --filter="operationType=compute.instances.gracefulShutdown"

El resultado es similar a lo siguiente:

NAME: operation-1782409401831-65517873d8fe0-76bb4c47-978a64be
TYPE: compute.instances.gracefulShutdown
TARGET: vm-01
HTTP_STATUS: 200
STATUS: RUNNING
TIMESTAMP: 2026-07-07T10:04:05.846992Z

NAME: operation-1783420590456-656035b8e9fa0-84dc2a39-1b9c83fe
TYPE: compute.instances.gracefulShutdown
TARGET: vm-02
HTTP_STATUS: 200
STATUS: RUNNING
TIMESTAMP: 2026-07-07T10:04:05.846992Z

Si deseas ver los cierres ordenados en curso en regiones o zonas específicas, usa el mismo comando con la marca --regions o --zones.

REST

Para ver todos los cierres ordenados en curso o completados entre las instancias de procesamiento de tu proyecto, realiza una de las siguientes solicitudes:

  • Para ver todos los cierres ordenados en curso o completados en todas las regiones y zonas, realiza una solicitud GET al método globalOperations.list:

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/operations?filter=operationType=compute.instances.gracefulShutdown

  • Para ver todos los cierres ordenados en curso o completados en una región, realiza una solicitud GET al método regionOperations.list:

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/operations?filter=operationType=compute.instances.gracefulShutdown

  • Para ver todos los cierres ordenados en curso o completados en una sola zona, realiza una solicitud GET al método zoneOperations.list:

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/operations?filter=operationType=compute.instances.gracefulShutdown

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto en el que existen tus instancias de procesamiento.

  • REGION: Es la región en la que existen tus instancias de procesamiento.

  • ZONE: Es la zona en la que se encuentran tus instancias de procesamiento.

El resultado es similar a lo siguiente:

{
  "kind": "compute#operationList",
  "id": "projects/example-project/zones/us-central1-a/operations",
  "items": [
    {
      "kind": "compute#operation",
      "id": "4210316577417032387",
      "name": "operation-1782409401831-65517873d8fe0-76bb4c47-978a64be",
      "operationType": "compute.instances.gracefulShutdown",
      "targetLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/vm-01",
      "status": "RUNNING",
      "user": "system@google.com",
      "progress": 0,
      "insertTime": "2026-07-07T10:04:05.846992Z",
      "startTime": "2026-07-07T10:04:05.846992Z",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/operations/operation-1782409401831-65517873d8fe0-76bb4c47-978a64be"
    },
    ...
  ]
}

Para obtener más información, consulta Visualiza las operaciones de Compute Engine.

¿Qué sigue?