Limiter l'exécution d'une VM

Ce document explique comment limiter la durée d'exécution d'instances de machines virtuelles (VM) nouvelles ou existantes, et comment surveiller la durée d'exécution de ces VM. Pour les groupes d'instances gérés (MIG), consultez plutôt Limiter la durée d'exécution d'un MIG.

Lorsque vous limitez la durée d'exécution d'un VM, vous pouvez programmer son arrêt automatiquement (arrêté ou supprimé) lorsqu'il atteint une limite de temps spécifique (durée ou heure). Utilisez des limites de temps pour optimiser les charges de travail temporaires. En limitant automatiquement les durées d'exécution des VM, vous pouvez réduire les coûts et libérer des quotas.

Pour savoir comment arrêter immédiatement une VM, consultez la section Arrêter ou redémarrer une VM. Pour savoir comment supprimer immédiatement une VM, consultez la section Supprimer une VM.

Avant de commencer

  • Pour obtenir les autorisations nécessaires pour limiter la durée d'exécution d'une VM, 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.

    Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

  • Si ce n'est pas déjà fait, configurez l'authentification. L'authentification permet de valider votre identité pour accéder aux services et aux API Google Cloud . 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

    1. Installez la Google Cloud CLI. Une fois l'installation terminée, initialisez la Google Cloud CLI en exécutant la commande suivante : 

      gcloud init

      Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

    2. Set a default region and zone.

    REST

    Pour utiliser les exemples API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à la gcloud CLI.

      Installez la Google Cloud CLI. Une fois l'installation terminée, initialisez la Google Cloud CLI en exécutant la commande suivante : 

      gcloud init

      Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

    Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Google Cloud .

Restrictions

La limitation de la durée d'exécution d'une VM est soumise aux restrictions suivantes :

  • L'action d'arrêt automatique doit être "arrêter" ou "supprimer". Vous ne pouvez pas configurer une VM pour qu'elle soit automatiquement suspendue lorsque la limite de temps est atteinte.

  • Le délai minimal est de 30 secondes et le délai maximal est de 120 jours.

  • L'arrêt automatique peut nécessiter jusqu'à 30 secondes de plus que la durée ou l'heure que vous spécifiez pour déclencher l'arrêt ou la suppression effectifs de la VM.

  • Vous ne pouvez pas utiliser de limites de temps avec les anciennes VM préemptives. Utilisez plutôt des limites de temps avec les VM Spot.

  • Les données des SSD locaux d'une VM ne peuvent pas être conservées lorsque la VM est arrêtée automatiquement en raison d'une limite de temps. Pour en savoir plus, consultez Arrêter une VM avec un SSD local.

Limiter l'exécution d'une nouvelle VM

Les sections suivantes expliquent comment configurer un délai lors de la création d'une VM. Vous pouvez spécifier la limite de temps, c'est-à-dire le moment où vous souhaitez qu'une VM s'arrête automatiquement, sous la forme d'une durée (maxRunDuration) ou d'une heure (terminationTime).

Lorsque vous choisissez le type de limite de temps pour une VM, tenez compte du fait qu'elle peut être interrompue, par exemple par une demande utilisateur ou un événement hôte. Le comportement d'une limite de temps varie en fonction du type d'interruption et du type de limite de temps :

  • Le code temporel d'arrêt d'une VM (terminationTimestamp) est un champ en lecture seule qui représente l'heure prévue pour l'arrêt automatique. Il est automatiquement défini par Compute Engine chaque fois qu'une VM a une limite de temps et passe à l'état RUNNING.

  • L'horodatage de l'arrêt est automatiquement effacé dès qu'une VM est arrêtée ou suspendue. Toutefois, un code temporel de fin ne change pas lorsque vous réinitialisez ou redémarrez la VM.

  • L'horodatage de fin est automatiquement redéfini chaque fois que la VM est redémarrée ou reprise en fonction du type de limite de temps que vous avez défini :

    • Si vous définissez une durée pour la VM, l'horodatage de fin est recalculé en ajoutant cette durée à la dernière heure de début de la VM.
    • Si vous définissez une heure pour la VM, l'horodatage de fin est défini sur cette heure. Toutefois, l'heure doit être future. Sinon, toute demande de création ou de réexécution de la VM échouera jusqu'à ce que vous mettiez à jour ou supprimiez l'heure.

Définir une durée

Une durée représente la durée d'exécution totale souhaitée pour une VM. Pour créer une VM qui est arrêtée automatiquement après qu'elle a été exécutée pendant une durée spécifique, utilisez la console Google Cloud , Google Cloud CLI, Terraform ou l'API Compute Engine.

Console

  1. Dans la console Google Cloud , accédez à la page Créer une instance.

    Accéder à la page Créer une instance

  2. Dans la section Règles de disponibilité, développez Paramètres avancés du modèle de provisionnement de VM.

  3. Cochez la case Définir une limite de temps pour la VM. Le champ Type de délai s'affiche.

  4. Dans le champ Type de délai, sélectionnez Par heure (par défaut) pour spécifier le délai sous la forme d'une durée. Dans le champ suivant, saisissez la durée en heures.

  5. Dans la liste À l'arrêt de la VM, sélectionnez ce qui doit se passer lorsque l'exécution de la VM atteint le délai spécifié :

    • Pour arrêter automatiquement la VM, sélectionnez Arrêter (valeur par défaut).
    • Pour supprimer la VM, sélectionnez Supprimer.

  6. Facultatif : spécifiez d'autres options de VM. Pour en savoir plus, consultez la page Créer et démarrer une instance de VM.

  7. Pour créer et démarrer la VM, cliquez sur Créer.

gcloud

Pour créer une VM à partir de la CLI gcloud, utilisez la commande gcloud compute instances create.

  • Pour créer une VM qui doit s'arrêter automatiquement après une durée spécifique, vous devez inclure l'option --max-run-duration.
  • Pour spécifier l'action d'arrêt, incluez l'option --instance-termination-action.
  • Configurez l'option --discard-local-ssds-at-termination-timestamp :
    • Si la VM dispose de disques SSD locaux et que l'action d'arrêt (TERMINATION_ACTION) est l'arrêt (STOP), vous devez inclure l'option --discard-local-ssds-at-termination-timestamp=true.
    • Sinon, omettez l'option --discard-local-ssds-at-termination-timestamp.
gcloud compute instances create VM_NAME \
    --max-run-duration=DURATION \
    --instance-termination-action=TERMINATION_ACTION

Remplacez les éléments suivants :

  • VM_NAME : nom de la nouvelle VM.
  • DURATION : durée pendant laquelle vous souhaitez que cette VM s'exécute avant d'être automatiquement arrêtée. Formatez la durée en nombre de jours, d'heures, de minutes et de secondes, suivis respectivement de d, h, m et s. Par exemple, spécifiez 30m pour définir une durée de 30 minutes ou 1d2h3m4s pour une durée d'un jour, deux heures, trois minutes et quatre secondes. La durée minimale est de 30 secondes (30s) et la durée maximale est de 120 jours (120d).
  • TERMINATION_ACTION : action d'arrêt pour cette VM, qui peut être soit arrêtée (STOP), soit supprimée (DELETE). Le caractère obligatoire de ce champ, ou bien l'adoption d'une valeur par défaut, dépend du modèle de provisionnement de la VM :
    • S'il s'agit d'une VM Spot (si la VM utilise l'option --provisioning-model=SPOT), l'option --instance-termination-action=TERMINATION_ACTION est facultative. Si cette option est ignorée, l'action d'arrêt par défaut est l'arrêt.
    • Sinon (par défaut), l'option --instance-termination-action=TERMINATION_ACTION est obligatoire.

Pour en savoir plus sur les options que vous pouvez spécifier lors de la création d'une VM, consultez la page Créer et démarrer une instance de VM.

Terraform

Pour créer une VM à l'aide de Terraform, utilisez la ressource google_compute_instance.

  • Pour créer une VM qui doit s'arrêter automatiquement après une durée spécifique, vous devez inclure l'option l'argument max_run_duration.
  • Pour spécifier l'action d'arrêt, incluez l'argument instance_termination_action. Vous devez inclure l'argument instance_termination_action, sauf si vous créez une VM Spot (définissez l'argument provisioning_model sur SPOT), dont la valeur par défaut est la suivante : arrêter (STOP).
  • Configurez l'argument on_instance_stop_action :
    • Si la VM dispose de disques SSD locaux et que l'action d'arrêt (argument instance_termination_action) est l'arrêt (STOP), vous devez définir l'argument on_instance_stop_action sur "true" (true).
    • Sinon, omettez l'argument on_instance_stop_action.

Pour en savoir plus, consultez la documentation Terraform de la ressource google_compute_instance.

REST

Pour créer une VM à partir de l'API Compute Engine, utilisez la méthode instances.insert. Vous devez spécifier un nom, un type de machine et un disque de démarrage pour la VM.

Pour créer une VM qui s'arrête automatiquement après une durée spécifique, vous devez inclure le champ maxRunDuration. Pour spécifier l'action d'arrêt, incluez le champ instanceTerminationAction, qui est facultatif pour les VM Spot.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
  "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
  "name": "VM_NAME",
  "disks": [
    {
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
      },
      "boot": true
    }
  ]
  "scheduling":
  {
    "maxRunDuration":
    {
      "seconds": DURATION
    },
    "instanceTerminationAction": "TERMINATION_ACTION"
  },
}

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet dans lequel créer la VM.
  • ZONE : zone dans laquelle créer la VM. La zone doit également accepter le type de machine à utiliser pour la nouvelle VM.
  • MACHINE_TYPE : type de machine prédéfini ou personnalisé pour la nouvelle VM.
  • VM_NAME : nom de la nouvelle VM.
  • IMAGE_PROJECT : projet contenant l'image. Par exemple, si vous spécifiez family/debian-10 comme image, spécifiez debian-cloud comme projet d'image.
  • IMAGE : image de la nouvelle VM. Vous pouvez spécifier une version spécifique d'une image publique ou une famille d'images. Par exemple, si vous spécifiez family/debian-10 comme image et debian-cloud comme projet d'image, Compute Engine crée une VM à partir de la dernière version de l'image d'OS dans la famille d'images Debian 10.
  • DURATION : durée en secondes pendant laquelle vous souhaitez que cette VM s'exécute avant d'être automatiquement arrêtée. La durée minimale est de 30 secondes (30s) et la durée maximale est de 120 jours (120d).
  • TERMINATION_ACTION : action d'arrêt pour cette VM, qui peut être soit arrêtée (STOP), soit supprimée (DELETE). Le caractère obligatoire de ce champ, ou bien l'adoption d'une valeur par défaut, dépend du modèle de provisionnement de la VM :
    • S'il s'agit d'une VM Spot (si la VM utilise le champ "provisioningModel": "SPOT"), le champ "instanceTerminationAction": "TERMINATION_ACTION" est facultatif. Si ce champ est ignoré, l'action d'arrêt par défaut est l'arrêt.
    • Sinon (par défaut), le champ "instanceTerminationAction": "TERMINATION_ACTION" est obligatoire.

Pour en savoir plus sur les options que vous pouvez spécifier lors de la création d'une VM, consultez la page Créer et démarrer une instance de VM.

Définir une heure

Une heure représente la date, l'heure et le fuseau horaire auxquels vous souhaitez qu'une VM soit arrêtée. Pour créer une VM qui est arrêtée automatiquement à une heure spécifique, utilisez la console Google Cloud , Google Cloud CLI ou l'API Compute Engine.

Console

  1. Dans la console Google Cloud , accédez à la page Créer une instance.

    Accéder à la page Créer une instance

  2. Dans la section Règles de disponibilité, développez Paramètres avancés du modèle de provisionnement de VM.

  3. Cochez la case Définir une limite de temps pour la VM. Le champ Type de délai s'affiche.

  4. Dans le champ Type de délai, sélectionnez Par date pour spécifier le délai sous la forme d'un code temporel (date et heure). Dans le champ suivant, cliquez sur Sélectionner une date et une heure, puis sélectionnez la date, l'heure et le fuseau horaire pour le délai.

  5. Dans la liste À l'arrêt de la VM, sélectionnez ce qui doit se passer lorsque l'exécution de la VM atteint le délai spécifié :

    • Pour arrêter automatiquement la VM, sélectionnez Arrêter (valeur par défaut).
    • Pour supprimer la VM, sélectionnez Supprimer.

  6. Facultatif : spécifiez d'autres options de VM. Pour en savoir plus, consultez la page Créer et démarrer une instance de VM.

  7. Pour créer et démarrer la VM, cliquez sur Créer.

gcloud

Pour créer une VM à partir de la CLI gcloud, utilisez la commande gcloud compute instances create.

  • Pour créer une VM qui est arrêtée automatiquement à une heure spécifique, vous devez inclure l'option --termination-time.
  • Pour spécifier l'action d'arrêt, incluez l'option --instance-termination-action, qui est facultative pour les VM Spot.
  • Configurez l'option --discard-local-ssds-at-termination-timestamp :
    • Si la VM dispose de disques SSD locaux et définit l'action d'arrêt (TERMINATION_ACTION) sur "stop" (STOP), vous devez inclure l'option --discard-local-ssds-at-termination-timestamp=true.
    • Sinon, omettez l'option --discard-local-ssds-at-termination-timestamp.
gcloud compute instances create VM_NAME \
    --termination-time=TIME \
    --instance-termination-action=TERMINATION_ACTION

Remplacez les éléments suivants :

  • VM_NAME : nom de la nouvelle VM.

  • TIME : heure à laquelle cette VM doit être arrêtée automatiquement. L'heure que vous spécifiez doit être une heure à venir, comprise entre 30 secondes et 120 jours par rapport à l'heure active. Formatez l'heure sous la forme d'un code temporel RFC 3339 :

    YYYY-MM-DDTHH:MM:SSOFFSET

    Remplacez les éléments suivants :

    • YYYY-MM-DD : date respectant la syntaxe année (valeur à quatre chiffres), mois à deux chiffres et jour à deux chiffres du mois, séparés par des traits d'union.
    • HH:MM:SS : heure respectant la syntaxe heures au format 2 chiffres sur 24 heures, minutes à deux chiffres et secondes à deux chiffres, séparés par des signes deux-points.
    • OFFSET : fuseau horaire mis en forme en tant que décalage par rapport au temps universel coordonné (UTC). Par exemple, pour utiliser l'heure normale du Pacifique (PST), soit huit heures avant l'heure UTC, spécifiez -08:00. Pour utiliser un décalage (UTC+0), spécifiez Z.

  • TERMINATION_ACTION : action d'arrêt pour cette VM, qui peut être soit arrêtée (STOP), soit supprimée (DELETE). Le caractère obligatoire de ce champ, ou bien l'adoption d'une valeur par défaut, dépend du modèle de provisionnement de la VM :

    • S'il s'agit d'une VM Spot (si la VM utilise l'option --provisioning-model=SPOT), l'option --instance-termination-action=TERMINATION_ACTION est facultative. Si cette option est ignorée, l'action d'arrêt par défaut est l'arrêt.
    • Sinon (par défaut), l'option --instance-termination-action=TERMINATION_ACTION est obligatoire.

Pour en savoir plus sur les options que vous pouvez spécifier lors de la création d'une VM, consultez la page Créer et démarrer une instance de VM.

REST

Pour créer une VM à partir de l'API Compute Engine, utilisez la méthode instances.insert. Vous devez spécifier un nom, un type de machine et un disque de démarrage pour la VM.

Pour créer une VM qui est arrêtée automatiquement à une heure spécifique, vous devez inclure le champ terminationTime. Pour spécifier l'action d'arrêt, incluez le champ instanceTerminationAction, qui est facultatif pour les VM Spot.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
  "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
  "name": "VM_NAME",
  "disks": [
    {
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
      },
      "boot": true
    }
  ]
  "scheduling":
  {
    "terminationTime": "TIME",
    "instanceTerminationAction": "TERMINATION_ACTION"
  },
}

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet dans lequel créer la VM.
  • ZONE : zone dans laquelle créer la VM. La zone doit également accepter le type de machine à utiliser pour la nouvelle VM.
  • MACHINE_TYPE : type de machine prédéfini ou personnalisé pour la nouvelle VM.
  • VM_NAME : nom de la nouvelle VM.
  • IMAGE_PROJECT : projet contenant l'image. Par exemple, si vous spécifiez family/debian-10 comme image, spécifiez debian-cloud comme projet d'image.
  • IMAGE : image de la nouvelle VM. Vous pouvez spécifier une version spécifique d'une image publique ou une famille d'images. Par exemple, si vous spécifiez family/debian-10 comme image et debian-cloud comme projet d'image, Compute Engine crée une VM à partir de la dernière version de l'image d'OS dans la famille d'images Debian 10.

  • TIME : heure à laquelle cette VM doit être arrêtée automatiquement. L'heure que vous spécifiez doit être une heure à venir, comprise entre 30 secondes et 120 jours par rapport à l'heure active. Formatez l'heure sous la forme d'un code temporel RFC 3339 :

    YYYY-MM-DDTHH:MM:SSOFFSET

    Remplacez les éléments suivants :

    • YYYY-MM-DD : date respectant la syntaxe année (valeur à quatre chiffres), mois à deux chiffres et jour à deux chiffres du mois, séparés par des traits d'union.
    • HH:MM:SS : heure respectant la syntaxe heures au format 2 chiffres sur 24 heures, minutes à deux chiffres et secondes à deux chiffres, séparés par des signes deux-points.
    • OFFSET : fuseau horaire mis en forme en tant que décalage par rapport au temps universel coordonné (UTC). Par exemple, pour utiliser l'heure normale du Pacifique (PST), soit huit heures avant l'heure UTC, spécifiez -08:00. Pour utiliser un décalage (UTC+0), spécifiez Z.

  • TERMINATION_ACTION : action d'arrêt pour cette VM, qui peut être soit arrêtée (STOP), soit supprimée (DELETE). Le caractère obligatoire de ce champ, ou bien l'adoption d'une valeur par défaut, dépend du modèle de provisionnement de la VM :

    • S'il s'agit d'une VM Spot (si la VM utilise le champ "provisioningModel": "SPOT"), le champ "instanceTerminationAction": "TERMINATION_ACTION" est facultatif. Si ce champ est ignoré, l'action d'arrêt par défaut est l'arrêt.
    • Sinon (par défaut), le champ "instanceTerminationAction": "TERMINATION_ACTION" est obligatoire.

Pour en savoir plus sur les options que vous pouvez spécifier lors de la création d'une VM, consultez la page Créer et démarrer une instance de VM.

Limiter l'exécution d'une VM existante

Vous pouvez limiter l'exécution d'une VM existante en mettant à jour sa programmation. Si vous n'avez pas déjà étudié la configuration des paramètres de limites de temps, pensez à d'abord consulter les sections précédentes sur la limitation de la durée d'exécution d'une nouvelle VM.

Vous pouvez utiliser la console Google Cloud , Google Cloud CLI ou l'API Compute Engine pour mettre à jour les propriétés liées à la planification de la VM, comme décrit dans cette section. Cette méthode nécessite que vous arrêtiez d'abord votre VM, puis que vous mettiez à jour ses propriétés et que vous la redémarriez. Si vous souhaitez mettre à jour simultanément d'autres propriétés de VM, et arrêter et redémarrer automatiquement une VM, consultez la section Mettre à jour les propriétés d'une instance.

Console

  1. Dans la console Google Cloud , accédez à la page Instances de VM.

    Accéder à la page Instances de VM

  2. Dans la colonne Nom, cliquez sur le nom de la VM que vous souhaitez mettre à jour.

  3. Sur la page des détails de l'instance de VM, procédez comme suit :

    1. Si la VM est en cours d'exécution, cliquez sur Arrêter pour l'arrêter.
    2. Pour modifier la VM, cliquez sur Modifier.

    3. Sur la page Modifier l'instance, procédez comme suit :

      1. Dans la section Règles de disponibilité, cochez ou décochez la case Définir un délai pour la VM et modifiez tous les champs situés en dessous comme vous le souhaitez.

        Pour savoir comment configurer les propriétés des limites de temps, consultez Limiter la durée d'exécution d'une nouvelle VM.

      2. Pour enregistrer vos modifications, cliquez sur Enregistrer.

    4. Facultatif : si vous souhaitez commencer à exécuter la VM maintenant, cliquez sur Démarrer.

gcloud

Pour mettre à jour le délai d'une VM à l'aide de la gcloud CLI, procédez comme suit :

  1. Si la VM est en cours d'exécution, arrêtez-la à l'aide de la commande gcloud compute instances stop :

    gcloud compute instances stop VM_NAME

    Remplacez VM_NAME par le nom de la VM que vous souhaitez mettre à jour.

  2. Mettez à jour le délai de la VM à l'aide de la commande gcloud compute instances set-scheduling.

    gcloud compute instances set-scheduling VM_NAME \
    --max-run-duration=DURATION \
    --termination-time=TIME \
    --instance-termination-action=TERMINATION_ACTION \
    --discard-local-ssds-at-termination-timestamp=true

    Configurez les options suivantes :

    • Vous devez omettre l'option --max-run-duration ou --termination-time pour définir le délai respectivement sous la forme d'une heure ou d'une durée.
    • Incluez l'option --instance-termination-action pour définir l'action d'arrêt.
    • Si la VM dispose de disques SSD locaux et définit l'action d'arrêt (TERMINATION_ACTION) sur "stop" (STOP), vous devez inclure l'option --discard-local-ssds-at-termination-timestamp=true. Sinon, omettez l'option --discard-local-ssds-at-termination-timestamp=true.

    Remplacez ensuite les éléments suivants :

    • VM_NAME : nom de la VM que vous souhaitez mettre à jour.
    • DURATION : durée pendant laquelle vous souhaitez que cette VM s'exécute avant d'être automatiquement arrêtée. Formatez la durée en nombre de jours, d'heures, de minutes et de secondes, suivis respectivement de d, h, m et s. Par exemple, spécifiez 30m pour définir une durée de 30 minutes ou 1d2h3m4s pour une durée d'un jour, deux heures, trois minutes et quatre secondes. La durée minimale est de 30 secondes (30s) et la durée maximale est de 120 jours (120d).

    • TIME : heure à laquelle cette VM doit être arrêtée automatiquement. L'heure que vous spécifiez doit être une heure à venir, comprise entre 30 secondes et 120 jours par rapport à l'heure active. Formatez l'heure sous la forme d'un code temporel RFC 3339 :

      YYYY-MM-DDTHH:MM:SSOFFSET

      Remplacez les éléments suivants :

      • YYYY-MM-DD : date respectant la syntaxe année (valeur à quatre chiffres), mois à deux chiffres et jour à deux chiffres du mois, séparés par des traits d'union.
      • HH:MM:SS : heure respectant la syntaxe heures au format 2 chiffres sur 24 heures, minutes à deux chiffres et secondes à deux chiffres, séparés par des signes deux-points.
      • OFFSET : fuseau horaire mis en forme en tant que décalage par rapport au temps universel coordonné (UTC). Par exemple, pour utiliser l'heure normale du Pacifique (PST), soit huit heures avant l'heure UTC, spécifiez -08:00. Pour utiliser un décalage (UTC+0), spécifiez Z.

    • TERMINATION_ACTION : action d'arrêt pour cette VM, qui peut être soit arrêtée (STOP), soit supprimée (DELETE). Le caractère obligatoire de ce champ, ou bien l'adoption d'une valeur par défaut, dépend du modèle de provisionnement de la VM :

      • S'il s'agit d'une VM Spot (si la VM utilise l'option --provisioning-model=SPOT), l'option --instance-termination-action=TERMINATION_ACTION est facultative. Si cette option est ignorée, l'action d'arrêt par défaut est l'arrêt.
      • Sinon (par défaut), l'option --instance-termination-action=TERMINATION_ACTION est obligatoire.

  3. Si vous souhaitez lancer l'exécution de la VM, démarrez-la en exécutant la commande gcloud compute instances start :

    gcloud compute instances start VM_NAME

    Remplacez VM_NAME par le nom de la VM.

REST

Pour mettre à jour le délai d'une VM à l'aide de l'API Compute Engine, procédez comme suit :

  1. Si la VM est en cours d'exécution, arrêtez-la à l'aide de la méthode instances.stop :

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/stop

    Remplacez les éléments suivants :

    • PROJECT_ID : ID du projet contenant la VM.
    • ZONE : zone contenant la VM.
    • VM_NAME : nom de la VM que vous souhaitez mettre à jour.

  2. Mettez à jour la propriété scheduling de la VM, y compris les champs pour le délai de la VM, à l'aide de la méthode instances.setScheduling. Incluez le champ maxRunDuration ou terminationTime pour définir le délai respectivement sous la forme d'une durée ou d'une heure :

    • Pour spécifier une durée, utilisez la requête suivante :

      POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/setScheduling
{
  "maxRunDuration":
  {
    "seconds": DURATION
  },
  "instanceTerminationAction": "TERMINATION_ACTION"
}

    • Pour spécifier une heure, utilisez la requête suivante :

      POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/setScheduling
{
  "terminationTime": "TIME",
  "instanceTerminationAction": "TERMINATION_ACTION"
}

    Remplacez les éléments suivants :

    • PROJECT_ID : ID du projet dans lequel créer la VM.
    • ZONE : zone dans laquelle créer la VM. La zone doit également accepter le type de machine à utiliser pour la nouvelle VM.
    • MACHINE_TYPE : type de machine prédéfini ou personnalisé pour la nouvelle VM.
    • VM_NAME : nom de la nouvelle VM.
    • IMAGE_PROJECT : projet contenant l'image. Par exemple, si vous spécifiez family/debian-10 comme image, spécifiez debian-cloud comme projet d'image.
    • IMAGE : image de la nouvelle VM. Vous pouvez spécifier une version spécifique d'une image publique ou une famille d'images. Par exemple, si vous spécifiez family/debian-10 comme image et debian-cloud comme projet d'image, Compute Engine crée une VM à partir de la dernière version de l'image d'OS dans la famille d'images Debian 10.
    • DURATION : durée en secondes pendant laquelle vous souhaitez que cette VM s'exécute avant d'être automatiquement arrêtée. La durée minimale est de 30 secondes (30s) et la durée maximale est de 120 jours (120d).

    • TIME : heure à laquelle cette VM doit être arrêtée automatiquement. L'heure que vous spécifiez doit être une heure à venir, comprise entre 30 secondes et 120 jours par rapport à l'heure active. Formatez l'heure sous la forme d'un code temporel RFC 3339 :

      YYYY-MM-DDTHH:MM:SSOFFSET

      Remplacez les éléments suivants :

      • YYYY-MM-DD : date respectant la syntaxe année (valeur à quatre chiffres), mois à deux chiffres et jour à deux chiffres du mois, séparés par des traits d'union.
      • HH:MM:SS : heure respectant la syntaxe heures au format 2 chiffres sur 24 heures, minutes à deux chiffres et secondes à deux chiffres, séparés par des signes deux-points.
      • OFFSET : fuseau horaire mis en forme en tant que décalage par rapport au temps universel coordonné (UTC). Par exemple, pour utiliser l'heure normale du Pacifique (PST), soit huit heures avant l'heure UTC, spécifiez -08:00. Pour utiliser un décalage (UTC+0), spécifiez Z.

    • TERMINATION_ACTION : action d'arrêt pour cette VM, qui peut être soit arrêtée (STOP), soit supprimée (DELETE). Le caractère obligatoire de ce champ, ou bien l'adoption d'une valeur par défaut, dépend du modèle de provisionnement de la VM :

      • S'il s'agit d'une VM Spot (si la VM utilise le champ "provisioningModel": "SPOT"), le champ "instanceTerminationAction": "TERMINATION_ACTION" est facultatif. Si ce champ est ignoré, l'action d'arrêt par défaut est l'arrêt.
      • Sinon (par défaut), le champ "instanceTerminationAction": "TERMINATION_ACTION" est obligatoire.

  3. Si vous souhaitez lancer l'exécution de la VM, démarrez-la à l'aide de la méthode instances.start :

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/start

    Remplacez les éléments suivants :

    • PROJECT_ID : ID du projet contenant la VM.
    • ZONE : zone contenant la VM.
    • VM_NAME : nom de la VM.

Surveiller l'exécution d'une VM

Vous pouvez surveiller la durée d'exécution d'une VM avec une limite de temps à l'aide des options suivantes :

  • Pour savoir quand une VM en cours d'exécution doit être arrêtée automatiquement, consultez son code temporel d'arrêt :

    1. Afficher les détails d'une VM
    2. Dans le résultat, consultez le champ de la VM pour le code temporel de l'arrêt :
      • Si vous utilisez la console Google Cloud , consultez le champ Durée maximale.
      • Si vous utilisez Google Cloud CLI ou l'API Compute Engine, consultez le champ terminationTimestamp.

  • Pour vérifier si une VM a été arrêtée automatiquement, consultez ses opérations :

    1. Afficher les opérations de VM

    2. Dans le résultat, vous pouvez identifier les opérations de VM provoquées par une limite de temps en recherchant les types d'opérations suivants :

      • compute.instances.deferredStop indique une action d'arrêt automatique
      • compute.instances.deferredDelete indique une action d'arrêt automatique de type suppression.

Étapes suivantes