Ce document explique comment arrêter ou redémarrer une instance Compute Engine. Pour en savoir plus sur la suspension, l'arrêt ou la réinitialisation d'une instance, consultez la section Suspendre, arrêter ou réinitialiser des instances Compute Engine.
Arrêter une instance est utile lorsque vous ne l'utilisez plus ou pour modifier ses propriétés (par exemple, pour modifier son type de machine ou supprimer les disques associés et montés). Une fois l'instance arrêtée, vous pouvez effectuer les opérations suivantes:
Redémarrez-le pour reprendre votre charge de travail.
Supprimez-le si vous n'en avez plus besoin.
Pour automatiser l'arrêt ou le redémarrage d'une instance, consultez plutôt les articles suivants:
Avant de commencer
-
Si ce n'est pas déjà fait, configurez l'authentification.
L'authentification est le processus permettant de valider votre identité pour accéder aux Google Cloud services et aux API.
Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine en sélectionnant l'une des options suivantes:
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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
- Install the Google Cloud CLI.
-
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.
- Install the Google Cloud CLI.
-
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.
- Install the Google Cloud CLI.
-
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.
- Install the Google Cloud CLI.
-
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.
- Install the Google Cloud CLI.
-
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.
-
Pour arrêter une instance :
compute.instances.stop
sur l'instance -
Pour arrêter une instance à partir de l'OS invité :
compute.instances.setMetadata
sur l'instance si elle utilise des clés SSH publiques au niveau de l'instance. -
Pour redémarrer une instance :
compute.instances.start
sur l'instance -
Pour redémarrer une instance qui utilise des clés de chiffrement :
compute.instances.startWithEncryptionKey
sur l'instance Arrêter une instance sans disques SSD locaux
Vous pouvez arrêter simultanément une ou plusieurs instances auxquelles aucun disque SSD local n'est associé. L'exécution de tous les scripts d'arrêt d'une instance doit se terminer pendant la période d'arrêt par défaut.
Arrêter une instance avec des disques SSD locaux
Lorsque vous arrêtez simultanément une ou plusieurs instances associées à des disques SSD locaux, vous pouvez choisir de supprimer ou de conserver (Aperçu) les données de ces disques. Tous les scripts d'arrêt de l'instance doivent s'exécuter pendant la période d'arrêt par défaut.
Arrêter une instance à partir de l'OS invité
Cette approche vous permet d'arrêter une seule instance uniquement une fois l'exécution de vos scripts d'arrêt terminée. Si vous avez activé l'arrêt correct, vous pouvez également arrêter l'instance sans l'arrêter correctement ou mettre fin à un arrêt correct en cours. Sauf si vous sauvegardez manuellement les données de tous les disques SSD locaux associés sur un volume de stockage durable, l'arrêt d'une instance à partir de son OS hôte supprime toutes les données de ces disques.
Si vous avez activé l'arrêt correct dans l'instance, vous pouvez arrêter l'instance sans l'arrêter correctement ou mettre fin à un arrêt correct en cours à l'aide de la console Google Cloud, de la CLI gcloud ou de l'API REST.
Pour arrêter plusieurs instances simultanément, utilisez la console Google Cloud ou, pour les instances situées dans la même zone, la CLI gcloud.
Dans la console Google Cloud, accédez à la page Instances de VM.
Sélectionnez les instances en cours d'exécution à arrêter.
Cliquez sur
Arrêter.Dans la boîte de dialogue, procédez comme suit:
Facultatif: Pour arrêter les instances sans les arrêter correctement ou pour mettre fin à un arrêt correct en cours, cochez la case Ignorer l'arrêt correct (le cas échéant).
Pour confirmer, cliquez sur Arrêter.
INSTANCE_NAMES
: liste de noms d'instances séparés par des espaces (par exemple,instance-01 instance-02 instance-03
).ZONE
: zone où se trouvent les instancesINSTANCE_NAME
: nom de l'instance.PROJECT_ID
: ID du projet dans lequel se trouve l'instance.ZONE
: zone où se trouve l'instanceSi vous avez activé l'arrêt correct dans l'instance, vous pouvez arrêter l'instance sans l'arrêter correctement ou mettre fin à un arrêt correct en cours à l'aide de la console Google Cloud, de la gcloud CLI ou de l'API REST.
Pour conserver les données des disques SSD locaux associés à une instance (à l'exception des instances Z3), arrêtez l'instance à l'aide de la gcloud CLI ou de l'API REST.
Pour arrêter plusieurs instances simultanément, utilisez la console Google Cloud ou, pour les instances situées dans la même zone, la CLI gcloud.
Dans la console Google Cloud, accédez à la page Instances de VM.
Sélectionnez les instances en cours d'exécution à arrêter.
Cliquez sur
Arrêter.Dans la boîte de dialogue, procédez comme suit:
Facultatif: Pour arrêter les instances sans les arrêter correctement ou pour mettre fin à un arrêt correct en cours, cochez la case Ignorer l'arrêt correct (le cas échéant).
Pour confirmer, cliquez sur Arrêter.
Pour supprimer les données de SSD local, exécutez la commande
gcloud compute instances stop
avec l'option--discard-local-ssd=true
:gcloud compute instances stop INSTANCE_NAMES \ --discard-local-ssd=true \ --zone=ZONE
Pour conserver les données du SSD local, utilisez la commande
gcloud beta compute instances stop
avec l'option--discard-local-ssd=false
:gcloud beta compute instances stop INSTANCE_NAMES \ --discard-local-ssd=false \ --zone=ZONE
INSTANCE_NAMES
: liste de noms d'instances séparés par des espaces (par exemple,instance-01 instance-02 instance-03
).ZONE
: zone où se trouvent les instancesPour supprimer les données de SSD locaux, envoyez une requête
POST
à la méthodeinstances.stop
. Dans l'URL de la requête, incluez le paramètre de requêtediscardLocalSsd
défini surtrue
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/stop?discardLocalSsd=true
Pour conserver les données du SSD local, envoyez une requête
POST
à la méthodebeta.instances.stop
. Dans l'URL de la requête, incluez le paramètre de requêtediscardLocalSsd
défini surfalse
:POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/stop?discardLocalSsd=false
PROJECT_ID
: ID du projet dans lequel se trouve l'instance.ZONE
: zone où se trouve l'instanceINSTANCE_NAME
: nom de l'instance.Si ce n'est pas déjà fait, connectez-vous à l'instance.
Pour arrêter l'instance, sélectionnez l'une des méthodes suivantes:
Pour un arrêt normal permettant à l'instance d'exécuter des scripts d'arrêt avant d'arrêter l'OS invité, exécutez la commande suivante:
sudo shutdown -h now
Sinon, pour forcer l'arrêt, exécutez la commande suivante :
sudo poweroff
Si vous ne l'avez pas déjà fait, connectez-vous à l'instance à l'aide de l'une des méthodes suivantes:
Pour arrêter l'instance, sélectionnez l'une des méthodes suivantes:
Pour arrêter correctement l'instance et lui permettre d'exécuter des scripts d'arrêt avant d'arrêter le système d'exploitation invité, exécutez la commande suivante:
shutdown /s
Pour forcer l'arrêt, exécutez la commande suivante:
shutdown /f
Si votre instance n'est pas associée à des disques chiffrés, consultez la section Redémarrer une instance sans disques chiffrés.
Sinon, consultez la section Redémarrer une instance avec des disques chiffrés.
Dans la console Google Cloud, accédez à la page Instances de VM.
Sélectionnez une ou plusieurs instances.
Cliquez sur
Démarrer/Réactiver.INSTANCE_NAMES
: liste de noms d'instances séparés par des espaces (par exemple,instance-01 instance-02 instance-03
).ZONE
: zone où se trouvent les instancesINSTANCE_NAME
: nom de l'instance à redémarrer.PROJECT_ID
: ID du projet dans lequel se trouve l'instance.ZONE
: zone où se trouve l'instanceDans la console Google Cloud, accédez à la page Instances de VM.
Sélectionnez les instances à redémarrer.
Cliquez sur
Démarrer/Réactiver.Spécifiez la clé de chiffrement de chaque disque chiffré associé aux instances, puis cliquez sur Démarrer.
INSTANCE_NAMES
: liste de noms d'instances séparés par des espaces (par exemple,instance-01 instance-02 instance-03
).ENCRYPTION_KEY_FILE
: chemin relatif au fichier JSON contenant la clé de chiffrement fournie par le client. Vous ne pouvez redémarrer plusieurs instances simultanément que si elles utilisent la même clé de chiffrement fournie par le client.ZONE
: zone où se trouvent les instancesPROJECT_ID
: ID du projet dans lequel se trouve l'instance.ZONE
: zone où se trouve l'instanceINSTANCE_NAME
: nom de l'instance.DISK_URL
: URL de la ressource correspondant au nom complet de la ressource du disque associé qui est chiffré avec une clé de chiffrement fournie par le client.ENCRYPTION_TYPE
: type de chiffrement de disque que vous utilisez, à savoirrawKey
,kmsKeyName
oursaEncryptedKey
. Si vous utilisez le typersaEncryptedKey
, envoyez une requêtePOST
à la méthodebeta.instances.startWithEncryptionKey
.ENCRYPTION_KEY
: clé de chiffrement utilisée pour chiffrer les disques persistants associés à l'instance. Les clésrawKey
oursaEncryptedKey
doivent être encodées en base64. En outre, pour préparer une clérsaEncryptedKey
, consultez la section Encapsuler une clé RSA.
Go
Pour utiliser les exemples Go de cette page dans un environnement de développement local, installez et initialisez gcloud CLI, puis configurez le service Identifiants par défaut de l'application à l'aide de vos identifiants utilisateur.
Pour en savoir plus, consultez Set up authentication for a local development environment.
Java
Pour utiliser les exemples Java de cette page dans un environnement de développement local, installez et initialisez gcloud CLI, puis configurez le service Identifiants par défaut de l'application à l'aide de vos identifiants utilisateur.
Pour en savoir plus, consultez Set up authentication for a local development environment.
Node.js
Pour utiliser les exemples Node.js de cette page dans un environnement de développement local, installez et initialisez gcloud CLI, puis configurez le service Identifiants par défaut de l'application à l'aide de vos identifiants utilisateur.
Pour en savoir plus, consultez Set up authentication for a local development environment.
PHP
Pour utiliser les exemples PHP de cette page dans un environnement de développement local, installez et initialisez gcloud CLI, puis configurez le service Identifiants par défaut de l'application à l'aide de vos identifiants utilisateur.
Pour en savoir plus, consultez Set up authentication for a local development environment.
Python
Pour utiliser les exemples Python de cette page dans un environnement de développement local, installez et initialisez gcloud CLI, puis configurez le service Identifiants par défaut de l'application à l'aide de vos identifiants utilisateur.
Pour en savoir plus, consultez Set up authentication for a local development environment.
REST
Pour utiliser les exemples d'API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à gcloud CLI.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Google Cloud.
Rôles requis
Pour obtenir les autorisations nécessaires pour arrêter ou redémarrer une instance Compute, demandez à votre administrateur de vous accorder le rôle IAM Administrateur d'instances Compute (v1) (
roles/compute.instanceAdmin.v1
) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.Ce rôle prédéfini contient les autorisations requises pour arrêter ou redémarrer une instance de calcul. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :
Autorisations requises
Vous devez disposer des autorisations suivantes pour arrêter ou redémarrer une instance Compute Engine:
Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.
Arrêter une instance
Lorsque vous arrêtez une instance de calcul ou que Compute Engine le fait pour une action planifiée, l'instance conserve ses ressources associées, ses paramètres de configuration, ses adresses IP internes, ses adresses MAC et ses métadonnées. Toutefois, l'instance perd ses données en mémoire et son état d'application. Si vous devez conserver ces états, suspendez plutôt l'instance.
Vous pouvez arrêter une instance à l'aide des méthodes suivantes, selon que des disques SSD locaux sont associés à l'instance et comment vous souhaitez gérer les scripts de fermeture:
Arrêter une instance sans disques SSD locaux
Selon ce que vous souhaitez faire lorsque vous arrêtez une instance, utilisez les options suivantes:
Pour arrêter une ou plusieurs instances, sélectionnez l'une des options suivantes:
Console
gcloud
Pour arrêter une ou plusieurs instances dans la même zone, utilisez la commande
gcloud compute instances stop
:gcloud compute instances stop INSTANCE_NAMES \ --zone=ZONE
Remplacez les éléments suivants :
Si vous avez activé l'arrêt progressif dans une ou plusieurs instances, vous pouvez les arrêter sans les arrêter correctement ou mettre fin manuellement à un arrêt progressif en cours. Pour ce faire, exécutez la commande
gcloud beta compute instances stop
avec l'option--no-graceful-shutdown
:gcloud beta compute instances stop INSTANCE_NAMES \ --no-graceful-shutdown \ --zone=ZONE
Go
Java
Node.js
PHP
Python
REST
Pour arrêter une instance, envoyez une requête
POST
à la méthodeinstances.stop
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/stop
Remplacez les éléments suivants :
Si vous avez activé l'arrêt correct dans une instance, vous pouvez arrêter l'instance sans l'arrêter correctement ou mettre fin manuellement à un arrêt correct en cours. Pour ce faire, envoyez une requête
POST
à la méthodeinstances.stop
. Dans l'URL de la requête, incluez le paramètre de requêtenoGracefulShutdown=true
:POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/stop?noGracefulShutdown=true ```
Arrêter une instance avec des disques SSD locaux
Selon ce que vous souhaitez faire lorsque vous arrêtez une instance de calcul, utilisez les options suivantes:
Pour arrêter une ou plusieurs instances auxquelles des disques SSD locaux sont associés, sélectionnez l'une des options suivantes:
Console
gcloud
Lorsque vous arrêtez une ou plusieurs instances de la même zone associées à des disques SSD locaux, indiquez si vous souhaitez supprimer ou conserver les données des disques SSD locaux comme suit:
Remplacez les éléments suivants :
Si vous avez activé l'arrêt progressif dans une ou plusieurs instances, vous pouvez les arrêter sans les arrêter correctement ou mettre fin à un arrêt progressif en cours. Pour ce faire, exécutez la commande
gcloud beta compute instances stop
avec l'option--no-graceful-shutdown
:gcloud beta compute instances stop INSTANCE_NAMES \ --discard-local-ssd=DISCARD_LOCAL_SSD \ --no-graceful-shutdown \ --zone=ZONE
Remplacez
DISCARD_LOCAL_SSD
partrue
pour supprimer les données des disques SSD locaux ou parfalse
pour les conserver.REST
Lorsque vous arrêtez une instance à laquelle des disques SSD locaux sont associés, indiquez si vous souhaitez supprimer ou conserver les données des disques SSD locaux comme suit:
Remplacez les éléments suivants :
Si vous avez activé l'arrêt progressif dans une instance, vous pouvez l'arrêter sans l'arrêter correctement ou mettre fin manuellement à un arrêt progressif en cours. Pour ce faire, envoyez une requête
POST
à la méthodeinstances.stop
. Dans l'URL de la requête, incluez le paramètre de requêtenoGracefulShutdown=true
:POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/stop?discardLocalSsd=DISCARD_LOCAL_SSD&noGracefulShutdown=true ``` Replace `DISCARD_LOCAL_SSD` with `true` to discard the data in the Local SSD disks, or `false` to preserve the data.
Arrêter une instance à partir de l'OS invité
Si des disques SSD locaux sont associés à une instance de calcul, l'arrêt du système d'exploitation invité supprime automatiquement les données du disque SSD local. Pour conserver ces données, copiez-les manuellement vers une option de stockage persistant avant d'arrêter l'instance.
Pour arrêter une instance à partir du système d'exploitation invité, sélectionnez l'une des options suivantes:
Linux
Windows
Redémarrer une instance
Vous pouvez redémarrer une instance de calcul qui a été complètement arrêtée, c'est-à-dire lorsque son état est
TERMINATED
.Si vous avez choisi de conserver les données de vos disques SSD locaux lorsque vous avez arrêté l'instance, vous devrez peut-être les réinstaller après l'avoir redémarrée. Pour en savoir plus sur l'installation de disques SSD locaux, consultez la section Formater et installer un disque SSD local.
Pour redémarrer une instance, utilisez l'une des méthodes suivantes, selon que des disques chiffrés sont associés à l'instance:
Redémarrer une instance sans disques chiffrés
Vous pouvez redémarrer plusieurs instances de calcul simultanément ou des instances individuelles. Pour plusieurs instances, utilisez la console Google Cloud ou, pour les instances situées dans la même zone, la CLI gcloud. Pour les instances individuelles, sélectionnez l'une des options suivantes:
Console
gcloud
Pour redémarrer une ou plusieurs instances dans la même zone, exécutez la commande
gcloud compute instances start
:gcloud compute instances start INSTANCE_NAMES \ --zone=ZONE
Remplacez les éléments suivants :
Go
Java
Node.js
PHP
Python
REST
Pour redémarrer une instance, envoyez une requête
POST
à la méthodeinstances.start
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/start
Remplacez les éléments suivants :
Redémarrer une instance avec des disques chiffrés
Lorsque vous redémarrez une instance de calcul arrêtée dont les disques associés ont été chiffrés à l'aide de clés de chiffrement fournies par le client, vous devez fournir les informations de clé de chiffrement.
Vous pouvez redémarrer plusieurs instances simultanément ou des instances individuelles. Pour plusieurs instances, utilisez la console Google Cloud ou, pour les instances situées dans la même zone, la CLI gcloud. Pour des instances individuelles, sélectionnez l'une des options suivantes:
Console
gcloud
Pour redémarrer une ou plusieurs instances qui utilisent des disques chiffrés dans la même zone, exécutez la commande
gcloud compute instances start
avec l'option--csek-key-file
. Si vous utilisez une clé encapsulée en RSA, exécutez plutôt la commandegcloud beta compute instances start
avec l'indicateur--csek-key-file
:gcloud compute instances start INSTANCE_NAMES \ --csek-key-file=ENCRYPTION_KEY_FILE \ --zone=ZONE
Remplacez les éléments suivants :
Go
Java
Node.js
PHP
Python
REST
Pour redémarrer une instance qui utilise des disques chiffrés, envoyez une requête
POST
à la méthodeinstances.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" } } ] }
Remplacez les éléments suivants :
Étape suivante
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/01/31 (UTC).
-