Ce document explique comment afficher les paramètres et la progression d'un arrêt progressif dans une instance Compute Engine. Pour en savoir plus sur l'arrêt progressif, consultez Présentation de l'arrêt progressif.
Lorsque vous affichez les détails d'une instance, vous pouvez effectuer les opérations suivantes :
Afficher les paramètres d'arrêt progressif Vous pouvez vérifier si l'arrêt progressif est activé et combien de temps il dure.
Surveillez l'arrêt progressif. Lorsqu'un arrêt progressif est en cours, vous pouvez vérifier les éléments suivants :
Lorsque le délai du processus d'arrêt progressif est dépassé.
Si une opération d'arrêt ou de suppression est en cours.
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 services et aux API Trusted Cloud by S3NS .
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 Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.
gcloud
-
Installez la Google Cloud CLI, puis connectez-vous à la gcloud CLI avec votre identité fédérée. Après vous être connecté, initialisez Google Cloud CLI en exécutant la commande suivante :
gcloud init
- Set a default region and zone.
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.
Installez la Google Cloud CLI, puis connectez-vous à la gcloud CLI avec votre identité fédérée. Après vous être connecté, initialisez Google Cloud CLI en exécutant la commande suivante :
gcloud init
Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Trusted Cloud .
Rôles requis
Pour obtenir l'autorisation dont vous avez besoin pour afficher l'arrêt progressif d'une instance de calcul, demandez à votre administrateur de vous accorder le rôle IAM Administrateur d'instances Compute (v1) (
roles/compute.instanceAdmin.v1
) sur votre 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 l'autorisation
compute.instances.get
on the projectVous pouvez également obtenir cette autorisation avec des rôles personnalisés ou d'autres rôles prédéfinis.
Afficher les paramètres d'arrêt progressif
Pour afficher les paramètres d'arrêt progressif dans une instance de calcul, sélectionnez l'une des options suivantes :
Console
Dans la console Trusted Cloud , accédez à la page Instances de VM.
Dans la colonne Nom, cliquez sur le nom de votre instance.
La page des détails de l'instance s'ouvre dans l'onglet Détails.
Pour vérifier les paramètres d'arrêt progressif, dans la section Règles de disponibilité, vérifiez la valeur du champ Durée maximale de l'arrêt progressif. Ce champ indique la période d'arrêt progressif. Si un trait d'union (-) s'affiche, cela signifie que l'arrêt progressif est désactivé.
gcloud
Pour afficher les paramètres d'arrêt progressif dans une instance, utilisez la commande
gcloud beta compute instances describe
:gcloud beta compute instances describe INSTANCE_NAME \ --zone=ZONE
Remplacez les éléments suivants :
INSTANCE_NAME
: nom de l'instance.ZONE
: zone où se trouve l'instance.
Si l'arrêt progressif est activé, le résultat est semblable à ce qui suit :
... scheduling: ... gracefulShutdown: enabled: true maxDuration: seconds: 'MAX_DURATION' ... ...
Le résultat inclut la valeur
MAX_DURATION
. Cette valeur indique la durée de la période d'arrêt progressif en secondes. Si vous n'avez pas spécifié de période d'arrêt personnalisée lorsque vous avez activé l'arrêt progressif dans l'instance, Compute Engine omet le champmaxDuration
et définit la période d'arrêt progressif sur 10 minutes.REST
Pour afficher les paramètres d'arrêt progressif dans une instance, envoyez une requête
GET
à la méthodeinstances.get
de la version bêta :GET https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME
Remplacez les éléments suivants :
PROJECT_ID
: ID du projet dans lequel vous avez créé l'instance.ZONE
: zone où se trouve l'instance.INSTANCE_NAME
: nom de l'instance.
Si l'arrêt progressif est activé, le résultat est semblable à ce qui suit :
{ ... "scheduling": { ... "gracefulShutdown": { "enabled": true, "maxDuration": { "seconds": "MAX_DURATION" } } }, ... }
Le résultat inclut la valeur
MAX_DURATION
. Cette valeur indique la durée de la période d'arrêt progressif en secondes. Si vous n'avez pas spécifié de période d'arrêt personnalisée lorsque vous avez activé l'arrêt progressif dans l'instance, Compute Engine omet le champmaxDuration
et définit la période d'arrêt progressif sur 10 minutes.Surveiller l'arrêt progressif
Pour surveiller un arrêt progressif en cours dans une instance de calcul, sélectionnez l'une des options suivantes :
Console
Dans la console Trusted Cloud , accédez à la page Instances de VM.
Dans la colonne Nom, cliquez sur le nom de votre instance.
La page des détails de l'instance s'ouvre dans l'onglet Détails.
Si un arrêt progressif est en cours, vérifiez les champs suivants dans la section Informations de base :
État : ce champ indique l'état de votre instance. Lors d'un arrêt progressif, ce champ affiche Arrêt en attente et un compte à rebours. Le minuteur décompte le temps jusqu'à la fin de l'arrêt progressif.
État cible : ce champ indique si Compute Engine arrête (Arrêtée) ou supprime (Supprimée) l'instance.
gcloud
Pour surveiller un arrêt progressif en cours dans une instance, utilisez la commande
gcloud beta compute instances describe
:gcloud beta compute instances describe INSTANCE_NAME \ --zone=ZONE
Remplacez les éléments suivants :
INSTANCE_NAME
: nom de l'instance.ZONE
: zone où se trouve l'instance.
Si un arrêt progressif est en cours, le résultat est semblable à ce qui suit :
... resourceStatus: ... shutdownDetails: maxDuration: seconds: 'MAX_DURATION' requestTimestamp: 'REQUEST_TIMESTAMP' stopState: STOP_STATE targetState: TARGET_STATE ... status: PENDING_STOP ...
Ce résultat inclut les valeurs suivantes :
MAX_DURATION
: durée de la période d'arrêt progressif en secondes. Une fois que Compute Engine a définiSTOP_STATE
surSTOPPING
, il supprime le champmaxDuration
.REQUEST_TIMESTAMP
: code temporel du début de l'STOP_STATE
.STOP_STATE
: phase d'arrêt de l'instance. La valeur peut être l'une des suivantes :PENDING_STOP
: Compute Engine a commencé l'arrêt progressif. L'instance reste dans cet état jusqu'à ce que vous mettiez fin manuellement à l'arrêt progressif ou que la période d'arrêt progressif expire.STOPPING
: l'arrêt progressif est terminé et Compute Engine poursuit l'opération d'arrêt ou de suppression.
TARGET_STATE
: indique si Compute Engine arrête (STOPPED
) ou supprime (DELETED
) l'instance.
Si une opération d'arrêt est en cours d'exécution, Compute Engine supprime le champ
shutdownDetails
après avoir défini le champstatus
surTERMINATE
.REST
Pour surveiller un arrêt progressif en cours dans une instance, envoyez une requête
GET
à la méthode bêtainstances.get
:GET https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME
Remplacez les éléments suivants :
PROJECT_ID
: ID du projet dans lequel vous avez créé l'instance.ZONE
: zone où se trouve l'instance.INSTANCE_NAME
: nom de l'instance.
Si un arrêt progressif est en cours, le résultat est semblable à ce qui suit :
{ ... "resourceStatus": { ... "shutdownDetails": { "maxDuration": { "seconds": "MAX_DURATION" }, "requestTimestamp": "REQUEST_TIMESTAMP", "stopState": "STOP_STATE", "targetState": "TARGET_STATE" } }, ... "status": "PENDING_STOP", ... }
Ce résultat inclut les valeurs suivantes :
MAX_DURATION
: durée de la période d'arrêt progressif en secondes. Une fois que Compute Engine a définiSTOP_STATE
surSTOPPING
, il supprime le champmaxDuration
.REQUEST_TIMESTAMP
: code temporel du début de l'STOP_STATE
.STOP_STATE
: phase d'arrêt de l'instance. La valeur peut être l'une des suivantes :PENDING_STOP
: Compute Engine a commencé l'arrêt progressif. L'instance reste dans cet état jusqu'à ce que vous mettiez fin manuellement à l'arrêt progressif ou que la période d'arrêt progressif expire.STOPPING
: l'arrêt progressif est terminé et Compute Engine poursuit l'opération d'arrêt ou de suppression.
TARGET_STATE
: indique si Compute Engine arrête (STOPPED
) ou supprime (DELETED
) l'instance.
Si une opération d'arrêt est en cours d'exécution, Compute Engine supprime le champ
shutdownDetails
après avoir défini le champstatus
surTERMINATE
.Serveur de métadonnées
Se connecter à l'instance
Interrogez le serveur de métadonnées :
curl "http://metadata.google.internal/computeMetadata/v1/instance/shutdown-details/?recursive=true?alt=json" \-H "Metadata-Flavor: Google"
Si un arrêt progressif est en cours, le résultat est semblable à ce qui suit :
{ "maxDuration": "MAX_DURATION", "requestTimestamp": "REQUEST_TIMESTAMP", "stopState": "STOP_STATE", "targetState": "TARGET_STATE" }
Le résultat inclut les valeurs suivantes :
MAX_DURATION
: durée de la période d'arrêt progressif en secondes. Une fois que Compute Engine a définiSTOP_STATE
surSTOPPING
, il supprime le champmaxDuration
.REQUEST_TIMESTAMP
: code temporel du début de l'STOP_STATE
.STOP_STATE
: phase d'arrêt de l'instance. Les valeurs possibles sont les suivantes :PENDING_STOP
: Compute Engine a commencé l'arrêt progressif. L'instance reste dans cet état jusqu'à ce que vous mettiez fin manuellement à l'arrêt progressif ou que la période d'arrêt progressif expire.STOPPING
: l'arrêt progressif est terminé et Compute Engine poursuit l'opération d'arrêt ou de suppression.
TARGET_STATE
: indique si Compute Engine arrête (STOPPED
) ou supprime (DELETED
) l'instance.
Étapes suivantes
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/08/18 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/18 (UTC)."],[[["\u003cp\u003eThis document guides you through viewing the settings and progress of a graceful shutdown in a Compute Engine instance, detailing how to check if it's enabled and its duration.\u003c/p\u003e\n"],["\u003cp\u003eYou can monitor a graceful shutdown in progress to determine when it will time out and whether a stop or delete operation is currently active.\u003c/p\u003e\n"],["\u003cp\u003eThe graceful shutdown feature is a pre-GA offering, which means it is subject to the "Pre-GA Offerings Terms", with the possibility of having limited support.\u003c/p\u003e\n"],["\u003cp\u003eViewing the graceful shutdown settings and monitoring the progress can be done using the Google Cloud Console, gcloud CLI, or REST API, with specific steps provided for each method.\u003c/p\u003e\n"],["\u003cp\u003eAccessing the metadata server allows for the retrieval of details regarding graceful shutdown, including the maximum duration, request timestamp, stop state, and the target state of the instance.\u003c/p\u003e\n"]]],[],null,[]] -