Visualizza l'arresto normale in un'istanza Compute Engine

Console

1. Nella console Cloud de Confiance , vai alla pagina Istanze VM.

   Vai a Istanze VM

2. Nella colonna Nome, fai clic sul nome dell'istanza di computing. La pagina dei dettagli dell'istanza di computing si apre nella scheda Dettagli.

3. Per controllare le impostazioni di arresto normale, nella sezione Policy di disponibilità, controlla il valore del campo Durata massima dell'arresto normale. Questo campo mostra la durata dell'arresto normale. Se viene visualizzato un trattino (-), significa che l'arresto normale è disattivato.

gcloud

Per visualizzare le impostazioni di arresto normale in un'istanza di computing, utilizza il comando gcloud compute instances describe:

gcloud compute instances describe INSTANCE_NAME \
    --zone=ZONE

Sostituisci quanto segue:

• INSTANCE_NAME: il nome dell'istanza di computing.

• ZONE: la zona in cui si trova l'istanza di computing.

Se l'arresto normale è abilitato, l'output è simile al seguente:

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

L'output include il valore MAX_DURATION, che indica la durata massima dell'arresto normale in secondi. Se non hai specificato una durata personalizzata quando hai attivato l'arresto normale, Compute Engine omette il campo maxDuration e utilizza una durata predefinita di 10 minuti.

REST

Per visualizzare le impostazioni di arresto normale in un'istanza di computing, effettua una richiesta GET al metodo instances.get:

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

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto in cui hai creato l'istanza di computing

• ZONE: la zona in cui si trova l'istanza di computing.

• INSTANCE_NAME: il nome dell'istanza di computing.

Se l'arresto normale è abilitato, l'output è simile al seguente:

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

L'output include il valore MAX_DURATION, che indica la durata massima dell'arresto normale in secondi. Se non hai specificato una durata personalizzata quando hai attivato l'arresto normale, Compute Engine omette il campo maxDuration e utilizza una durata predefinita di 10 minuti.

Console

1. Nella console Cloud de Confiance , vai alla pagina Istanze VM.

   Vai a Istanze VM

2. Nella colonna Nome, fai clic sul nome dell'istanza di computing. La pagina dei dettagli dell'istanza di computing si apre nella scheda Dettagli.

3. Se è in corso un arresto normale, controlla i seguenti campi nella sezione Informazioni di base:

   • Stato: mostra lo stato dell'istanza di computing. Durante un arresto normale, viene visualizzato Arresto in attesa con un timer conto alla rovescia che indica quando termina l'arresto normale.

   • Stato target: indica se Compute Engine sta interrompendo (Arrestato) o eliminando (Eliminato) l'istanza di computing.

gcloud

Per monitorare un arresto normale in corso in un'istanza di computing, utilizza il comando gcloud compute instances describe:

gcloud compute instances describe INSTANCE_NAME \
    --zone=ZONE

Sostituisci quanto segue:

• INSTANCE_NAME: il nome dell'istanza di computing.

• ZONE: la zona in cui si trova l'istanza di computing.

Se è in corso un arresto normale, l'output è simile al seguente:

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

Questo output include i seguenti valori:

• MAX_DURATION: la durata massima dell'arresto normale, in secondi. Quando STOP_STATE cambia in STOPPING, Compute Engine elimina il campo maxDuration.

• REQUEST_TIMESTAMP: il timestamp che indica l'inizio di STOP_STATE

• STOP_STATE: la fase di arresto dell'istanza di computing. Il valore può essere uno dei seguenti:

  • PENDING_STOP: Compute Engine ha avviato l'arresto normale. L'istanza di computing rimane in questo stato finché non interrompi manualmente l'arresto normale o finché non scade il timer.

  • STOPPING: l'arresto normale è terminato e Compute Engine continua con l'operazione di arresto o eliminazione.

• TARGET_STATE: indica se Compute Engine sta interrompendo (STOPPED) o eliminando (DELETED) l'istanza di computing.

Quando Compute Engine termina l'arresto dell'istanza di computing, ne modifica lo stato in TERMINATE ed elimina il campo shutdownDetails.

REST

Per monitorare un arresto normale in corso in un'istanza di computing, effettua una richiesta GET al metodo instances.get:

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

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto in cui hai creato l'istanza di computing

• ZONE: la zona in cui si trova l'istanza di computing.

• INSTANCE_NAME: il nome dell'istanza di computing.

Se è in corso un arresto normale, l'output è simile al seguente:

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

Questo output include i seguenti valori:

• MAX_DURATION: la durata massima dell'arresto normale, in secondi. Quando STOP_STATE cambia in STOPPING, Compute Engine elimina il campo maxDuration.

• REQUEST_TIMESTAMP: il timestamp che indica l'inizio di STOP_STATE

• STOP_STATE: la fase di arresto dell'istanza di computing. Il valore può essere uno dei seguenti:

  • PENDING_STOP: Compute Engine ha avviato l'arresto normale. L'istanza di computing rimane in questo stato finché non interrompi manualmente l'arresto normale o finché non scade il timer.

  • STOPPING: l'arresto normale è terminato e Compute Engine continua con l'operazione di arresto o eliminazione.

• TARGET_STATE: indica se Compute Engine sta interrompendo (STOPPED) o eliminando (DELETED) l'istanza di computing.

Quando Compute Engine termina l'arresto dell'istanza di computing, cambia lo stato dell'istanza di computing in TERMINATE ed elimina il campo shutdownDetails.

Linux

1. Connettiti all'istanza di computing Linux.

2. Per eseguire una query sulla chiave dei metadati shutdown-details, esegui il seguente comando utilizzando lo strumento curl:

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

   Se è in corso un arresto normale, l'output è simile al seguente:

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

   L'output include i seguenti valori:

   • MAX_DURATION: la durata del periodo di arresto normale in secondi. Dopo che Compute Engine ha impostato STOP_STATE su STOPPING, elimina il campo maxDuration.

   • REQUEST_TIMESTAMP: il timestamp dell'inizio di STOP_STATE

   • STOP_STATE: la fase di arresto dell'istanza di computing. Il valore può essere uno dei seguenti:

     • PENDING_STOP: Compute Engine ha avviato l'arresto normale. L'istanza di computing rimane in questo stato finché non interrompi manualmente l'arresto normale o finché non scade il timer.

     • STOPPING: l'arresto normale è terminato e Compute Engine continua con l'operazione di arresto o eliminazione.

   • TARGET_STATE: indica se Compute Engine sta interrompendo (STOPPED) o eliminando (DELETED) l'istanza di computing.

Windows

1. Connettiti all'istanza di computing Windows.

2. Per eseguire una query sulla chiave dei metadati shutdown-details, utilizza il cmdlet Invoke-RestMethod:

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

   Se è in corso un arresto normale, l'output è simile al seguente:

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

   L'output include i seguenti valori:

   • MAX_DURATION: la durata del periodo di arresto normale in secondi. Dopo che Compute Engine ha impostato STOP_STATE su STOPPING, elimina il campo maxDuration.

   • REQUEST_TIMESTAMP: il timestamp dell'inizio di STOP_STATE

   • STOP_STATE: la fase di arresto dell'istanza di computing. Il valore può essere uno dei seguenti:

     • PENDING_STOP: Compute Engine ha avviato l'arresto normale. L'istanza di computing rimane in questo stato finché non interrompi manualmente l'arresto normale o finché non scade il timer.

     • STOPPING: l'arresto normale è terminato e Compute Engine continua con l'operazione di arresto o eliminazione.

   • TARGET_STATE: indica se Compute Engine sta interrompendo (STOPPED) o eliminando (DELETED) l'istanza di computing.

Console

1. Nella console Cloud de Confiance , vai alla pagina Esplora log.

   Vai a Esplora log

2. Nel riquadro delle query, inserisci la seguente query:

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

3. Fai clic su Esegui query.

gcloud

Per visualizzare i log di Cloud Audit Logs dopo l'avvio di un arresto normale, utilizza uno dei seguenti comandi gcloud logging read:

• Per monitorare l'arresto normale di tutte le istanze di computing in fase di arresto normale, esegui questo comando:

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

• Per monitorare l'arresto normale di una singola istanza di computing, esegui il seguente comando:

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

  Sostituisci INSTANCE_NAME con il nome dell'istanza di computing.

L'output è simile al seguente:

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

Per visualizzare i log di Cloud Audit Logs dopo l'avvio di un arresto normale, effettua una richiesta POST al metodo 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\""
}

Sostituisci PROJECT_ID con l'ID del progetto in cui si trova l'istanza di computing.

L'output è simile al seguente:

{
  "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. Nella console Cloud de Confiance , vai alla pagina Operazioni.

   Vai a Operazioni

2. (Facoltativo) Per perfezionare l'elenco delle operazioni in modo da visualizzare solo gli arresti normali in corso in una regione o zona specifica, nel campo filter_list Filtro inserisci uno dei seguenti filtri:

   • Per visualizzare tutte le operazioni in una regione, utilizza il seguente filtro:

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

   • Per visualizzare tutte le operazioni in una singola zona, utilizza il seguente filtro:

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

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID del progetto in cui si trovano le istanze di computing.

   • REGION: la regione in cui si trovano le istanze di computing.

   • ZONE: la zona in cui si trovano le istanze di computing.

3. Per visualizzare i dettagli di un'operazione specifica, fai clic sul riepilogo dell'operazione nella colonna Riepilogo operazione. Viene visualizzata una pagina con i dettagli dell'operazione.

gcloud

Per visualizzare tutti gli arresti normali in corso o completati tra le istanze di computing nel progetto, utilizza il seguente comando gcloud compute operations list:

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

L'output è simile al seguente:

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 vuoi visualizzare gli arresti normali in corso in regioni o zone specifiche, utilizza lo stesso comando con il flag --regions o --zones.

REST

Per visualizzare tutti gli arresti normali in corso o completati tra le istanze di computing del progetto, effettua una delle seguenti richieste:

• Per visualizzare tutti gli arresti normali in corso o completati in tutte le regioni e zone, invia una richiesta GET al metodo globalOperations.list:

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

• Per visualizzare tutti gli arresti normali in corso o completati in una regione, invia una richiesta GET al metodo regionOperations.list:

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

• Per visualizzare tutti gli arresti normali in corso o completati in una singola zona, invia una richiesta GET al metodo zoneOperations.list:

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

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto in cui si trovano le istanze di computing.

• REGION: la regione in cui si trovano le istanze di computing.

• ZONE: la zona in cui si trovano le istanze di computing.

L'output è simile al seguente:

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