Questo documento spiega come arrestare o riavviare un'istanza Compute Engine. Per scoprire di più sulla sospensione, sull'arresto o sul ripristino di un'istanza, consulta Sospendi, arresta o ripristina le istanze Compute Engine.
L'arresto di un'istanza è utile quando non la utilizzi più o per modificarne le proprietà, ad esempio per cambiare il tipo di macchina o rimuovere i dischi collegati e montati. Dopo aver arrestato l'istanza, puoi:
Riavvia per riprendere il carico di lavoro.
Eliminalo se non ti serve più.
Per automatizzare l'arresto o il riavvio di un'istanza, consulta invece quanto segue:
Prima di iniziare
-
Se non l'hai ancora fatto, configura l'autenticazione.
L'autenticazione è
il processo mediante il quale la tua identità viene verificata per l'accesso ai Google Cloud servizi e alle API.
Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su
Compute Engine selezionando una delle seguenti opzioni:
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
- Set a default region and zone.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
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.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
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.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
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.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
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.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
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.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
-
Per arrestare un'istanza:
compute.instances.stop
sull'istanza -
Per arrestare un'istanza dal sistema operativo guest:
compute.instances.setMetadata
sull'istanza se utilizza chiavi SSH pubbliche a livello di istanza. -
Per riavviare un'istanza:
compute.instances.start
sull'istanza -
Per riavviare un'istanza che utilizza chiavi di crittografia:
compute.instances.startWithEncryptionKey
sull'istanza Arresta un'istanza senza dischi SSD locali
Puoi arrestare una o più istanze contemporaneamente a cui non sono collegati dischi SSD locali. L'esecuzione di tutti gli script di arresto in un'istanza deve terminare entro il periodo di arresto predefinito.
Arresta un'istanza con dischi SSD locali
Quando arresti una o più istanze contemporaneamente a cui sono collegati dischi SSD locali, puoi scegliere di eliminare o conservare (anteprima) i dati su questi dischi. L'esecuzione di tutti gli script di arresto nell'istanza deve terminare entro il periodo di arresto predefinito.
Arrestare un'istanza dal sistema operativo guest
Questo approccio ti consente di arrestare una singola istanza solo dopo il termine dell'esecuzione degli script di arresto oppure, se hai attivato l'arresto normale, di arrestare l'istanza senza arrestarla in modo normale o di terminare un arresto normale in corso. A meno che tu non esegua manualmente il backup dei dati da eventuali dischi SSD locali collegati a un volume di archiviazione durevole, l'arresto di un'istanza dal suo sistema operativo guest comporta l'eliminazione di tutti i dati su questi dischi.
Se hai attivato l'arresto normale nell'istanza, puoi arrestarla senza arrestarla in modo normale o terminare un arresto normale in corso utilizzando la console Google Cloud , gcloud CLI o l'API REST.
Per arrestare più istanze contemporaneamente, utilizza la console Google Cloud o, per le istanze che si trovano nella stessa zona, gcloud CLI.
Nella console Google Cloud , vai alla pagina Istanze VM.
Seleziona le istanze in esecuzione da arrestare.
Fai clic su
Interrompi. Se non è presente l'opzione Arresta, fai clic su Altre azioni > Arresta.Nella finestra di dialogo, procedi nel seguente modo:
(Facoltativo) Per arrestare le istanze senza arrestarle in modo normale o terminare un arresto normale in corso, seleziona la casella di controllo Salta arresto normale (se applicabile).
Per confermare, fai clic su Interrompi.
INSTANCE_NAMES
: un elenco di nomi di istanze separati da spazi, ad esempioinstance-01 instance-02 instance-03
.ZONE
: la zona in cui si trovano le istanze.INSTANCE_NAME
: il nome dell'istanzaPROJECT_ID
: l'ID del progetto in cui si trova l'istanzaZONE
: la zona in cui si trova l'istanzaSe hai attivato l'arresto controllato nell'istanza, puoi arrestare l'istanza senza arrestarla in modo controllato o terminare un arresto controllato in corso utilizzando la console Google Cloud , gcloud CLI o l'API REST.
Per conservare i dati dei dischi SSD locali collegati a un'istanza (esclusi i tipi di macchina che utilizzano Titanium SSD), arresta l'istanza utilizzando gcloud CLI o l'API REST.
Per arrestare più istanze contemporaneamente, utilizza la console Google Cloud o, per le istanze che si trovano nella stessa zona, gcloud CLI.
Nella console Google Cloud , vai alla pagina Istanze VM.
Seleziona le istanze in esecuzione da arrestare.
Fai clic su
Interrompi. Se non è presente l'opzione Arresta, fai clic su Altre azioni > Arresta.Nella finestra di dialogo, procedi nel seguente modo:
(Facoltativo) Per arrestare le istanze senza arrestarle in modo normale o terminare un arresto normale in corso, seleziona la casella di controllo Salta arresto normale (se applicabile).
Per confermare, fai clic su Interrompi.
Per eliminare i dati dell'SSD locale, utilizza il comando
gcloud compute instances stop
con il flag--discard-local-ssd=true
:gcloud compute instances stop INSTANCE_NAMES \ --discard-local-ssd=true \ --zone=ZONE
Per conservare i dati dell'SSD locale, utilizza il comando
gcloud beta compute instances stop
con il flag--discard-local-ssd=false
:gcloud beta compute instances stop INSTANCE_NAMES \ --discard-local-ssd=false \ --zone=ZONE
INSTANCE_NAMES
: un elenco di nomi di istanze separati da spazi, ad esempioinstance-01 instance-02 instance-03
.ZONE
: la zona in cui si trovano le istanze.Per eliminare i dati dell'SSD locale, invia una richiesta
POST
al metodoinstances.stop
. Nell'URL della richiesta, includi il parametro di querydiscardLocalSsd
impostato sutrue
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/stop?discardLocalSsd=true
Per conservare i dati dell'SSD locale, invia una richiesta
POST
al metodobeta.instances.stop
. Nell'URL della richiesta, includi il parametro di querydiscardLocalSsd
impostato sufalse
:POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/stop?discardLocalSsd=false
PROJECT_ID
: l'ID del progetto in cui si trova l'istanzaZONE
: la zona in cui si trova l'istanzaINSTANCE_NAME
: il nome dell'istanzaSe non l'hai ancora fatto, connettiti all'istanza.
Per arrestare l'istanza, seleziona uno dei seguenti metodi:
Per un arresto pulito che consenta all'istanza di eseguire gli script di arresto prima di arrestare il sistema operativo guest, esegui questo comando:
sudo shutdown -h now
Altrimenti, per forzare l'arresto, esegui questo comando:
sudo poweroff
Se non l'hai già fatto, connettiti all'istanza utilizzando uno dei seguenti metodi:
Per arrestare l'istanza, seleziona uno dei seguenti metodi:
Per arrestare correttamente l'istanza e consentire l'esecuzione degli script di arresto prima dell'arresto del sistema operativo guest, esegui questo comando:
shutdown /s
Per forzare l'arresto, esegui questo comando:
shutdown /f
Se alla tua istanza non sono collegati dischi criptati, consulta Riavviare un'istanza senza dischi criptati.
In caso contrario, consulta Riavviare un'istanza con dischi criptati.
Nella console Google Cloud , vai alla pagina Istanze VM.
Seleziona una o più istanze.
Fai clic su
Avvia / Riprendi.INSTANCE_NAMES
: un elenco di nomi di istanze separati da spazi, ad esempioinstance-01 instance-02 instance-03
.ZONE
: la zona in cui si trovano le istanze.INSTANCE_NAME
: il nome dell'istanza da riavviare.PROJECT_ID
: l'ID del progetto in cui si trova l'istanzaZONE
: la zona in cui si trova l'istanzaNella console Google Cloud , vai alla pagina Istanze VM.
Seleziona le istanze da riavviare.
Fai clic su
Avvia / Riprendi.Specifica le chiavi di crittografia per ciascuno dei dischi criptati collegati alle istanze, quindi fai clic su Avvia.
INSTANCE_NAMES
: un elenco di nomi di istanze separati da spazi, ad esempioinstance-01 instance-02 instance-03
.ENCRYPTION_KEY_FILE
: il percorso relativo al file JSON contenente la chiave di crittografia fornita dal cliente. Puoi riavviare più istanze contemporaneamente solo se utilizzano la stessa chiave di crittografia fornita dal cliente.ZONE
: la zona in cui si trovano le istanze.PROJECT_ID
: l'ID del progetto in cui si trova l'istanzaZONE
: la zona in cui si trova l'istanzaINSTANCE_NAME
: il nome dell'istanzaDISK_URL
: l'URL della risorsa corrispondente al nome completo della risorsa del disco collegato criptato con una chiave di crittografia fornita dal cliente.ENCRYPTION_TYPE
: il tipo di crittografia del disco che stai utilizzando, che può essere uno dei seguenti:rawKey
,kmsKeyName
, orsaEncryptedKey
. Se utilizzi il tiporsaEncryptedKey
, invia una richiestaPOST
al metodobeta.instances.startWithEncryptionKey
.ENCRYPTION_KEY
: la chiave di crittografia utilizzata per criptare i dischi permanenti collegati all'istanza. I tastirawKey
orsaEncryptedKey
devono essere codificati in base64. Inoltre, per preparare una chiaversaEncryptedKey
, consulta la sezione Wrapping delle chiavi RSA.
Vai
Per utilizzare gli esempi di Go questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura le Credenziali predefinite dell'applicazione con le tue credenziali utente.
Per ulteriori informazioni, vedi Set up authentication for a local development environment.
Java
Per utilizzare gli esempi di Java questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura le Credenziali predefinite dell'applicazione con le tue credenziali utente.
Per ulteriori informazioni, vedi Set up authentication for a local development environment.
Node.js
Per utilizzare gli esempi di Node.js questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura le Credenziali predefinite dell'applicazione con le tue credenziali utente.
Per ulteriori informazioni, vedi Set up authentication for a local development environment.
PHP
Per utilizzare gli esempi di PHP questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura le Credenziali predefinite dell'applicazione con le tue credenziali utente.
Per ulteriori informazioni, vedi Set up authentication for a local development environment.
Python
Per utilizzare gli esempi di Python questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura le Credenziali predefinite dell'applicazione con le tue credenziali utente.
Per ulteriori informazioni, vedi Set up authentication for a local development environment.
REST
Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
Per saperne di più, consulta la sezione Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per arrestare o riavviare un'istanza di computing, chiedi all'amministratore di concederti il ruolo IAM Compute Instance Admin (v1) (
roles/compute.instanceAdmin.v1
) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.Questo ruolo predefinito contiene le autorizzazioni necessarie per arrestare o riavviare un'istanza di computing. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per arrestare o riavviare un'istanza di calcolo sono necessarie le seguenti autorizzazioni:
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Arresta un'istanza
Quando arresti un'istanza di computing o Compute Engine lo fa per un'azione pianificata, l'istanza conserva le risorse collegate, le impostazioni di configurazione, gli indirizzi IP interni, gli indirizzi MAC e i metadati. Tuttavia, l'istanza perde i dati in memoria e lo stato dell'applicazione. Se devi conservare questi stati, sospendi l'istanza.
Puoi arrestare un'istanza utilizzando i seguenti metodi, a seconda che l'istanza abbia dischi SSD locali collegati e di come vuoi gestire gli script di arresto:
Arresta un'istanza senza dischi SSD locali
A seconda di cosa vuoi fare quando arresti un'istanza, utilizza le seguenti opzioni:
Per arrestare una o più istanze, seleziona una delle seguenti opzioni:
Console
gcloud
Per arrestare una o più istanze nella stessa zona, utilizza il comando
gcloud compute instances stop
:gcloud compute instances stop INSTANCE_NAMES \ --zone=ZONE
Sostituisci quanto segue:
(Facoltativo) Se hai attivato l'arresto normale in una o più istanze, puoi arrestarle senza arrestarle in modo normale o terminare manualmente un arresto normale in corso. Per farlo, utilizza il comando
gcloud beta compute instances stop
con il flag--no-graceful-shutdown
:gcloud beta compute instances stop INSTANCE_NAMES \ --no-graceful-shutdown \ --zone=ZONE
Vai
Java
Node.js
PHP
Python
REST
Per arrestare un'istanza, invia una richiesta
POST
al metodoinstances.stop
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/stop
Sostituisci quanto segue:
(Facoltativo) Se hai attivato l'arresto normale in un'istanza, puoi arrestare l'istanza senza arrestarla in modo normale o terminare manualmente un arresto normale in corso. Per farlo, invia una richiesta
POST
al metodoinstances.stop
. Nell'URL della richiesta, includi il parametro di querynoGracefulShutdown=true
:POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/stop?noGracefulShutdown=true
Arresta un'istanza con dischi SSD locali
A seconda di cosa vuoi fare quando arresti un'istanza di calcolo, utilizza le seguenti opzioni:
Per arrestare una o più istanze a cui sono collegati dischi SSD locali, seleziona una delle seguenti opzioni:
Console
gcloud
Quando arresti una o più istanze nella stessa zona a cui sono collegati dischi SSD locali, specifica se ignorare o conservare i dati degli SSD locali nel seguente modo:
Sostituisci quanto segue:
(Facoltativo) Se hai attivato l'arresto normale in una o più istanze, puoi arrestarle senza arrestarle in modo normale o terminare un arresto normale in corso. Per farlo, utilizza il comando
gcloud beta compute instances stop
con il flag--no-graceful-shutdown
:gcloud beta compute instances stop INSTANCE_NAMES \ --discard-local-ssd=DISCARD_LOCAL_SSD \ --no-graceful-shutdown \ --zone=ZONE
Sostituisci
DISCARD_LOCAL_SSD
contrue
per eliminare i dati nei dischi SSD locali ofalse
per conservarli.REST
Quando arresti un'istanza a cui sono collegati dischi SSD locali, specifica se ignorare o conservare i dati dell'SSD locale nel seguente modo:
Sostituisci quanto segue:
(Facoltativo) Se hai attivato l'arresto normale in un'istanza, puoi arrestare l'istanza senza arrestarla in modo normale o terminare manualmente un arresto normale in corso. Per farlo, invia una richiesta
POST
al metodoinstances.stop
. Nell'URL della richiesta, includi il parametro di querynoGracefulShutdown=true
:POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/stop?discardLocalSsd=DISCARD_LOCAL_SSD&noGracefulShutdown=true
Sostituisci
DISCARD_LOCAL_SSD
contrue
per eliminare i dati nei dischi SSD locali ofalse
per conservarli.Arresta un'istanza dal sistema operativo guest
Se a un'istanza di computing sono collegati dischi SSD locali, l'arresto del sistema operativo guest elimina automaticamente i dati dell'SSD locale. Per conservare questi dati, copiali manualmente in un'opzione di archiviazione permanente prima di arrestare l'istanza.
Per arrestare un'istanza dal sistema operativo guest, seleziona una delle seguenti opzioni:
Linux
Windows
Riavvia un'istanza
Puoi riavviare un'istanza di computing completamente arrestata, ovvero quando il relativo stato è
TERMINATED
.Se hai scelto di conservare i dati dei dischi SSD locali quando hai arrestato l'istanza, potresti dover rimontare i dischi SSD locali dopo averla riavviata. Per saperne di più su come montare i dischi SSD locali, consulta Formattare e montare un dispositivo SSD locale.
Per riavviare un'istanza, utilizza uno dei seguenti metodi a seconda che l'istanza abbia dischi criptati collegati:
Riavvia un'istanza senza dischi criptati
Puoi riavviare più istanze di computing contemporaneamente o singole istanze. Per più istanze, utilizza la console Google Cloud o, per le istanze situate nella stessa zona, gcloud CLI. Per le singole istanze, seleziona una delle seguenti opzioni:
Console
gcloud
Per riavviare una o più istanze nella stessa zona, utilizza il comando
gcloud compute instances start
:gcloud compute instances start INSTANCE_NAMES \ --zone=ZONE
Sostituisci quanto segue:
Vai
Java
Node.js
PHP
Python
REST
Per riavviare un'istanza, invia una richiesta
POST
al metodoinstances.start
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/start
Sostituisci quanto segue:
Riavvia un'istanza con dischi criptati
Quando riavvii un'istanza di calcolo arrestata a cui sono collegati dischi criptati utilizzando chiavi di crittografia fornite dal cliente, devi fornire le informazioni sulla chiave di crittografia.
Puoi riavviare più istanze contemporaneamente o singole istanze. Per più istanze, utilizza la console Google Cloud o, per le istanze che si trovano nella stessa zona, gcloud CLI. Per le singole istanze, seleziona una delle seguenti opzioni:
Console
gcloud
Per riavviare una o più istanze che utilizzano dischi criptati nella stessa zona, utilizza il comando
gcloud compute instances start
con il flag--csek-key-file
. Se utilizzi una chiave RSA, utilizza il comandogcloud beta compute instances start
con il flag--csek-key-file
:gcloud compute instances start INSTANCE_NAMES \ --csek-key-file=ENCRYPTION_KEY_FILE \ --zone=ZONE
Sostituisci quanto segue:
Vai
Java
Node.js
PHP
Python
REST
Per riavviare un'istanza che utilizza dischi criptati, invia una richiesta
POST
al metodoinstances.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" } } ] }
Sostituisci quanto segue:
Passaggi successivi
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-09 UTC.
-