Conferir o desligamento suave em uma instância do Compute Engine

Console

1. No console do Cloud de Confiance , acesse a página Instâncias de VM.

   Acessar instâncias de VM

2. Na coluna Nome, clique no nome da instância de computação. A página de detalhes da instância de computação é aberta na guia Detalhes.

3. Para verificar as configurações de encerramento completo, na seção Políticas de disponibilidade, verifique o valor do campo Duração máxima do encerramento completo. Este campo mostra o período de encerramento completo. Se um hífen (-) for exibido, o encerramento completo estará desativado.

gcloud

Para conferir as configurações de encerramento completo em uma instância de computação, use o comando gcloud compute instances describe:

gcloud compute instances describe INSTANCE_NAME \
    --zone=ZONE

Substitua:

• INSTANCE_NAME: o nome da instância de computação.

• ZONE: a zona em que a instância de computação está.

Se o encerramento completo estiver ativado, a saída será semelhante a esta:

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

A saída inclui o valor MAX_DURATION, que indica a duração máxima do encerramento completo em segundos. Se você não especificou uma duração personalizada ao ativar o encerramento completo, o Compute Engine omite o campo maxDuration e usa uma duração padrão de 10 minutos.

REST

Para conferir as configurações de encerramento completo em uma instância de computação, faça uma solicitação GET para o método instances.get:

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

Substitua:

• PROJECT_ID: o ID do projeto em que você criou a instância de computação.

• ZONE: a zona em que a instância de computação está.

• INSTANCE_NAME: o nome da instância de computação.

Se o encerramento completo estiver ativado, a saída será semelhante a esta:

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

A saída inclui o valor MAX_DURATION, que indica a duração máxima do encerramento completo em segundos. Se você não especificou uma duração personalizada ao ativar o encerramento completo, o Compute Engine omite o campo maxDuration e usa uma duração padrão de 10 minutos.

Console

1. No console do Cloud de Confiance , acesse a página Instâncias de VM.

   Acessar instâncias de VM

2. Na coluna Nome, clique no nome da instância de computação. A página de detalhes da instância de computação é aberta na guia Detalhes.

3. Se um encerramento completo estiver em andamento, verifique os seguintes campos na seção Informações básicas:

   • Status: mostra o estado da instância de computação. Durante um encerramento completo, ele exibe Interrupção pendente com um timer de contagem regressiva indicando quando o encerramento completo termina.

   • Estado de destino: mostra se o Compute Engine está interrompendo (Interrompido) ou excluindo (Excluído) a instância de computação.

gcloud

Para monitorar um encerramento completo em andamento em uma instância de computação, use o comando gcloud compute instances describe:

gcloud compute instances describe INSTANCE_NAME \
    --zone=ZONE

Substitua:

• INSTANCE_NAME: o nome da instância de computação.

• ZONE: a zona em que a instância de computação está.

Se um encerramento completo estiver em andamento, a saída será semelhante a esta:

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

Esta saída inclui os seguintes valores:

• MAX_DURATION: a duração máxima do encerramento completo, em segundos. Quando STOP_STATE muda para STOPPING, o Compute Engine exclui o campo maxDuration.

• REQUEST_TIMESTAMP: o carimbo de data/hora que indica quando o STOP_STATE começou.

• STOP_STATE: a fase de interrupção da instância de computação. O papel pode ser um dos seguintes:

  • PENDING_STOP: o Compute Engine iniciou o encerramento completo. A instância de computação permanece nesse estado até que você encerre manualmente o encerramento completo ou o timer expire.

  • STOPPING: o encerramento completo terminou, e o Compute Engine continua com a operação de interrupção ou exclusão.

• TARGET_STATE: se o Compute Engine está interrompendo (STOPPED) ou excluindo (DELETED) a instância de computação.

Quando o Compute Engine termina de interromper a instância de computação, ele altera o estado dela para TERMINATE e exclui o campo shutdownDetails.

REST

Para monitorar um encerramento completo em andamento em uma instância de computação, faça uma solicitação GET para o método instances.get:

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

Substitua:

• PROJECT_ID: o ID do projeto em que você criou a instância de computação.

• ZONE: a zona em que a instância de computação está.

• INSTANCE_NAME: o nome da instância de computação.

Se um encerramento completo estiver em andamento, a saída será semelhante a esta:

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

Esta saída inclui os seguintes valores:

• MAX_DURATION: a duração máxima do encerramento completo, em segundos. Quando STOP_STATE muda para STOPPING, o Compute Engine exclui o campo maxDuration.

• REQUEST_TIMESTAMP: o carimbo de data/hora que indica quando o STOP_STATE começou.

• STOP_STATE: a fase de interrupção da instância de computação. O papel pode ser um dos seguintes:

  • PENDING_STOP: o Compute Engine iniciou o encerramento completo. A instância de computação permanece nesse estado até que você encerre manualmente o encerramento completo ou o timer expire.

  • STOPPING: o encerramento completo terminou, e o Compute Engine continua com a operação de interrupção ou exclusão.

• TARGET_STATE: se o Compute Engine está interrompendo (STOPPED) ou excluindo (DELETED) a instância de computação.

Quando o Compute Engine termina de interromper a instância de computação, ele altera o estado dela para TERMINATE e exclui o campo shutdownDetails.

Linux

1. Conecte-se à instância de computação do Linux.

2. Para consultar a chave de metadados shutdown-details, execute o seguinte comando usando a ferramenta curl:

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

   Se um encerramento completo estiver em andamento, a saída será semelhante a esta:

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

   A saída inclui os seguintes valores:

   • MAX_DURATION: a duração do período de encerramento completo em segundos. Depois que o Compute Engine define STOP_STATE como STOPPING, ele exclui o campo maxDuration.

   • REQUEST_TIMESTAMP: o carimbo de data/hora de quando o STOP_STATE começou.

   • STOP_STATE: a fase de interrupção da instância de computação. O papel pode ser um dos seguintes:

     • PENDING_STOP: o Compute Engine iniciou o encerramento completo. A instância de computação permanece nesse estado até que você encerre manualmente o encerramento completo ou o timer expire.

     • STOPPING: o encerramento completo terminou, e o Compute Engine continua com a operação de interrupção ou exclusão.

   • TARGET_STATE: se o Compute Engine está interrompendo (STOPPED) ou excluindo (DELETED) a instância de computação.

Windows

1. Conecte-se à instância de computação do Windows.

2. Para consultar a chave de metadados shutdown-details, use o cmdlet Invoke-RestMethod:

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

   Se um encerramento completo estiver em andamento, a saída será semelhante a esta:

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

   A saída inclui os seguintes valores:

   • MAX_DURATION: a duração do período de encerramento completo em segundos. Depois que o Compute Engine define STOP_STATE como STOPPING, ele exclui o campo maxDuration.

   • REQUEST_TIMESTAMP: o carimbo de data/hora de quando o STOP_STATE começou.

   • STOP_STATE: a fase de interrupção da instância de computação. O papel pode ser um dos seguintes:

     • PENDING_STOP: o Compute Engine iniciou o encerramento completo. A instância de computação permanece nesse estado até que você encerre manualmente o encerramento completo ou o timer expire.

     • STOPPING: o encerramento completo terminou, e o Compute Engine continua com a operação de interrupção ou exclusão.

   • TARGET_STATE: se o Compute Engine está interrompendo (STOPPED) ou excluindo (DELETED) a instância de computação.

Console

1. No console do Cloud de Confiance , acesse a página Análise de registros.

   Acessar a Análise de registros

2. No painel de consulta, digite a seguinte consulta:

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

3. Clique em Executar consulta.

gcloud

Para conferir os registros de auditoria do Cloud após o início de um encerramento completo, use um dos seguintes comandos gcloud logging read:

• Para monitorar o encerramento completo de todas as instâncias de computação que estão sendo encerradas, execute o seguinte comando:

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

• Para monitorar o encerramento completo de uma única instância de computação, execute o seguinte comando:

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

  Substitua INSTANCE_NAME pelo nome da instância de computação.

O resultado será o seguinte:

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 os registros de auditoria do Cloud após o início de um encerramento completo, faça uma solicitação POST para o 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\""
}

Substitua PROJECT_ID pelo ID do projeto em que sua instância de computação está.

O resultado será o seguinte:

{
  "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"
}

Console

1. No console do Cloud de Confiance , acesse a página Operações.

   Acessar "Operações"

2. Opcional: para refinar a lista de operações e mostrar apenas os encerramentos completos em andamento em uma região ou zona específica, no campo filter_list Filtro, insira um dos seguintes filtros:

   • Para ver todas as operações em uma região, use o seguinte filtro:

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

   • Para ver todas as operações em uma única zona, use o seguinte filtro:

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

   Substitua:

   • PROJECT_ID: o ID do projeto em que as instâncias de computação estão.

   • REGION: a região em que as instâncias de computação estão.

   • ZONE: a zona em que as instâncias de computação estão.

3. Para ver os detalhes de uma operação específica, na coluna Resumo da operação, clique no resumo da operação. Uma página com os detalhes da operação será aberta.

gcloud

Para conferir todos os encerramentos completos em andamento ou concluídos entre as instâncias de computação no projeto, use o seguinte comando gcloud compute operations list:

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

O resultado será o seguinte:

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

Se você quiser ver os encerramentos completos em andamento em regiões ou zonas específicas, use o mesmo comando com a flag --regions ou --zones.

REST

Para conferir todos os encerramentos completos em andamento ou concluídos entre as instâncias de computação no seu projeto, faça uma das seguintes solicitações:

• Para conferir todos os encerramentos completos em andamento ou concluídos em todas as regiões e zonas, faça uma solicitação GET ao método globalOperations.list:

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

• Para conferir todos os encerramentos completos em andamento ou concluídos em uma região, faça uma solicitação GET ao método regionOperations.list:

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

• Para visualizar todos os encerramentos completos em andamento ou concluídos em uma única zona, faça uma solicitação GET ao método zoneOperations.list:

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

Substitua:

• PROJECT_ID: o ID do projeto em que as instâncias de computação estão.

• REGION: a região em que as instâncias de computação estão.

• ZONE: a zona em que as instâncias de computação estão.

O resultado será o seguinte:

{
  "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"
    },
    ...
  ]
}