Modifier les requêtes de réservation future


Ce document explique comment modifier les demandes de réservations futures.

Vous pouvez modifier une demande de réservation future à tout moment avant son heure de début, à condition qu'elle n'ait pas été annulée ni en attente d'approbation. Modifier une demande de réservation future est utile lorsque vos besoins en capacité changent, par exemple lorsque vous souhaitez augmenter le nombre d'instances de machine virtuelle (VM) réservées ou modifier la période de réservation. Si vous souhaitez modifier une requête de réservation future partagée, vous devez modifier la requête à l'aide du projet propriétaire.

Pour modifier une réservation créée automatiquement après la fin de sa période de réservation, consultez Modifier les réservations.

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 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. Install the Google Cloud CLI, then initialize it by running the following command:

      gcloud init
    2. Set a default region and zone.
    3. 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 l'autorisation nécessaire pour modifier les futures demandes de réservation, demandez à votre administrateur de vous accorder sur le projet le rôle IAM Administrateur des réservations futures Compute (roles/compute.futureReservationAdmin). 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.futureReservations.update, qui est requise pour modifier les demandes de réservation future.

Vous pouvez également obtenir cette autorisation avec des rôles personnalisés ou d'autres rôles prédéfinis.

Propriétés modifiables

Une requête de réservation future comporte plusieurs propriétés qui définissent la réservation, déterminent son comportement et spécifient les ressources à réserver. Vous pouvez modifier ces propriétés comme décrit dans les sections suivantes.

Après la création

Une fois la requête de réservation future créée, vous ne pouvez pas modifier les propriétés suivantes :

  • Le nom de la requête de réservation future.

  • Le projet dans lequel la requête de réservation future a été créée.

  • La zone dans laquelle se situe la demande de réservation future.

  • Le modèle d'instance à utiliser et les propriétés de VM spécifiées dans le modèle d'instance.

Pour modifier l'une de ces propriétés avant qu'une requête de réservation future n'atteigne son délai de verrouillage, créez une requête.

Avant la soumission

Avant d'envoyer une requête de réservation future à Google Cloud pour examen, ou après avoir envoyé une requête de réservation future pour examen et que celle-ci a été refusée, vous pouvez modifier les propriétés suivantes :

  • Option de suppression automatique

  • Description

  • GPU et type de GPU

  • Disques SSD locaux et type d'interface des disques

  • Série de machines et type de machine

  • Configuration minimale de la plate-forme du CPU

  • Préfixe de nom

  • Paramètres de partage

  • Heure de début et de fin de la période de réservation

  • Nombre total (nombre de VM)

La modification de l'état d'une requête de réservation future en brouillon est immédiate, et le nombre de modifications est illimité. Si vous modifiez une requête de réservation future refusée (DECLINED), vous ne pouvez le faire que si vous la renvoyez pour examen.

Après approbation

Une fois qu'une réservation future a été approuvée par Google Cloud, vous pouvez la modifier avant qu'elle n'atteigne l'état d'approvisionnement "Provisioning" (Provisionnement) (PROVISIONING). Plus précisément, vous pouvez modifier les propriétés suivantes :

  • En modifiant la réservation future à tout moment :

    • Option de suppression automatique

    • Description

    • Préfixe de nom

  • En envoyant une demande de modification au moins 72 heures avant l'heure de début :

    • GPU et type de GPU*

    • Disques SSD locaux et type d'interface des disques*

    • Série de machines et type de machine*

    • Configuration minimale de la plate-forme du CPU*

    • Paramètres de partage

    • Heure de début et de fin de la période de réservation

    • Nombre total (nombre de VM)*

* Si vous demandez à modifier des propriétés de VM ou à augmenter ou diminuer considérablement le nombre total dans les 14 jours à compter de l'heure de début de la réservation future, Google Cloud est susceptible de refuser votre demande.

Modifier les requêtes de réservation future

Avant de modifier une requête de réservation future, examinez les propriétés que vous pouvez modifier, si vous ne l'avez pas déjà fait.

Si vous souhaitez modifier une requête de réservation future à projet unique créée à l'aide d'un modèle d'instance en une requête de réservation future partagée, vous ne pouvez pas utiliser le même modèle pour créer des VM pouvant consommer les réservations créées automatiquement en dehors du projet qui a créé la requête de réservation future partagée. Pour les projets avec lesquels la réservation future est partagée, vous devez créer des modèles d'instances similaires dans ces projets ou créer des VM en spécifiant directement les propriétés.

Pour modifier une demande de réservation future, sélectionnez l'une des options suivantes :

Console

  1. Dans la console Google Cloud, accédez à la page Réservations.

    Accéder à la page "Réservations"

  2. Cliquez sur l'onglet Réservations futures.

  3. Dans la colonne Nom, cliquez sur le nom de la requête de réservation future à modifier.

    La page d'informations de la requête de réservation future sélectionnée s'affiche.

  4. Si vous souhaitez modifier l'option de suppression automatique, la description ou le préfixe du nom d'une réservation future approuvée, effectuez l'une ou plusieurs des opérations suivantes :

    • Pour modifier l'option de suppression automatique, sur la ligne Heure de suppression automatique des réservations créées, cliquez sur Modifier, puis procédez comme suit :

      1. Indiquez si vous souhaitez activer, désactiver ou modifier l'option de suppression automatique en procédant comme suit :

        • Pour activer l'option de suppression automatique ou modifier l'heure à laquelle Compute Engine supprime automatiquement les réservations créées automatiquement, procédez comme suit :

          1. Cliquez sur le bouton Activer la suppression automatique pour l'activer.

          2. Facultatif : Pour l'Heure de suppression automatique, saisissez une date et une heure à laquelle supprimer les réservations créées automatiquement. La date et l'heure doivent être postérieures à l'heure de fin de la période de réservation. Si vous laissez ce champ vide, les réservations créées automatiquement sont supprimées dans les deux heures suivant l'heure de fin de la période de réservation.

        • Sinon, cliquez sur le bouton Activer la suppression automatique pour le désactiver.

      2. Cliquez sur Envoyer.

    • Pour modifier le préfixe du nom, sur la ligne Préfixe, cliquez sur Modifier, puis procédez comme suit :

      1. Dans le champ Préfixe, saisissez un préfixe de nom.

      2. Cliquez sur Envoyer.

    • Pour modifier la description, sur la ligne Description, cliquez sur Modifier, puis procédez comme suit :

      1. Dans le champ Description, saisissez une description.

      2. Cliquez sur Envoyer.

  5. Cliquez sur Modifier ou sur Modifier le brouillon.

    La page permettant de modifier la future demande de réservation future sélectionnée s'affiche.

  6. Pour modifier une demande de réservation future et l'envoyer à Google Cloud pour examen, ou enregistrer le brouillon de la demande, procédez comme suit :

    • Dans le champ Préfixe, saisissez un nouveau préfixe de nom pour les réservations créées automatiquement provisionnées pour cette requête de réservation future.

    • Dans le champ Description, saisissez une description.

    • Modifiez l'heure de début ou l'heure de fin de votre demande de réservation future. Assurez-vous que :

      • L'heure de début ne peut pas être ultérieure d'un an à la date et heure à laquelle vous envoyez une demande de réservation future pour examen.

      • Spécifiez une valeur recommandée pour l'heure de début afin de vous assurer que vous avez suffisamment de temps avant que votre réservation future n'entre en heure de verrouillage.

      • Spécifiez une période de réservation minimale recommandée pour augmenter la probabilité que Google Cloud approuve votre requête après son envoi pour examen.

    • Dans la section Type de partage, vous pouvez sélectionner Local ou Partagé. Si vous sélectionnez Partagé, vous pouvez ajouter ou supprimer des projets avec lesquels partager la requête de réservation future. Vous pouvez inclure jusqu'à 100 projets.

    • Pour Nombre d'instances de VM, saisissez le nombre total de VM que vous souhaitez réserver.

    • Si vous modifiez une réservation future qui n'a pas été créée à l'aide d'un modèle d'instance, vous pouvez modifier les éléments suivants dans la section Configuration de la machine :

      • Série et type de machine utilisés dans les VM réservées.

      • GPU à associer aux VM réservées.

      • Les disques SSD locaux et le type d'interface de disque des VM réservées.

    • Dans la section Suppression automatique des réservations générées automatiquement, vous pouvez activer ou désactiver la suppression automatique des réservations créées automatiquement pour votre demande de réservation future.

  7. Selon l'état d'approvisionnement de la requête de réservation future que vous modifiez, effectuez l'une des opérations suivantes :

    • Si vous modifiez un brouillon de requête de réservation future, procédez comme suit :

      • Pour enregistrer vos modifications, cliquez sur Enregistrer le brouillon

      • Pour envoyer la demande de réservation future brouillon à Google Cloud pour examen, cliquez sur Envoyer.

    • Sinon, cliquez sur Envoyer.

Si vous envoyez une demande de modification, la page Réservations s'ouvre. Sinon, la page d'informations de la réservation future s'affiche.

gcloud

Pour modifier une requête de réservation future, utilisez la commande gcloud beta compute future-reservations update.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
    --description="DESCRIPTION" \
    --local-ssd=size=375,interface=INTERFACE \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform=MIN_CPU_PLATFORM \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --share-setting=SHARE_SETTING \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Remplacez les éléments suivants :

  • FUTURE_RESERVATION_NAME : nom de la requête de réservation future.

  • PLANNING_STATUS : état de planification de la requête de réservation future. Spécifiez une des valeurs suivantes :

    • Pour modifier une requête de réservation future brouillon sans l'envoyer pour examen : DRAFT.

    • Pour envoyer la requête de réservation future pour examen : SUBMITTED.

  • ZONE : zone dans laquelle se situe la demande de réservation future.

Remplacez un ou plusieurs des espaces réservés suivants, ou supprimez-les avec les indicateurs correspondants :

  • Pour permettre à Compute Engine de supprimer automatiquement les réservations créées automatiquement après l'heure de fin de la période de réservation, sélectionnez l'une des méthodes suivantes :

    • Pour supprimer les réservations dans les deux heures suivant l'heure de fin (par défaut), incluez l'option --auto-delete-auto-created-reservations.

      gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
          --auto-delete-auto-created-reservations \
          --planning-status=PLANNING_STATUS \
          --zone=ZONE
      
    • Pour supprimer les réservations créées automatiquement à une heure spécifique après l'heure de fin de la période de réservation, incluez les options --auto-delete-auto-created-reservations et --auto-created-reservations-delete-time.

      gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
          --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
          --auto-delete-auto-created-reservations \
          --planning-status=PLANNING_STATUS \
          --zone=ZONE
      

      Remplacez AUTO_CREATED_RESERVATIONS_DELETE_TIME par une date et une heure au format de code temporel RFC 3339.

    • Pour supprimer les réservations créées automatiquement après une durée spécifique après l'heure de fin de la période de réservation, incluez les options --auto-delete-auto-created-reservations et --auto-created-reservations-duration.

      gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
          --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
          --auto-delete-auto-created-reservations \
          --planning-status=PLANNING_STATUS \
          --zone=ZONE
      

      Remplacez DURATION_BEFORE_DELETE par une durée en jours, heures, minutes ou secondes. Par exemple, spécifiez 30m pour 30 minutes ou 1d2h3m4s pour 1 jour, 2 heures, 3 minutes et 4 secondes.

  • Pour empêcher Compute Engine de supprimer automatiquement les réservations créées automatiquement provisionnées pour cette requête de réservation future, incluez l'option --no-auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
        --no-auto-delete-auto-created-reservations \
        --planning-status=PLANNING_STATUS \
        --zone=ZONE
    
  • Pour ajouter ou supprimer des GPU associés à des VM N1 réservées, ou pour mettre à jour le type de GPU, procédez comme suit :

    • Pour modifier le nombre et le type de GPU, remplacez les éléments suivants :

      • NUMBER_OF_ACCELERATORS : nombre de GPU à ajouter par VM réservée.

      • ACCELERATOR_TYPE : type de GPU à ajouter aux VM réservées. Assurez-vous que le GPU est disponible dans la zone où se trouve la requête de réservation future. Sinon, la modification de la requête échoue.

    • Pour supprimer tous les GPU associés aux VM N1 réservées, remplacez l'indicateur --accelerator par --clear-accelerator.

  • DESCRIPTION : nouvelle description de la requête de réservation future.

  • Pour ajouter ou supprimer des disques SSD locaux de vos VM réservées, ou pour modifier le type d'interface du disque SSD local, procédez comme suit :

    • Pour ajouter des disques SSD locaux ou modifier le type d'interface de disque, remplacez INTERFACE par l'une des valeurs suivantes :

      Incluez l'indicateur --local-ssd pour autant de disques SSD locaux que vous souhaitez ajouter. Vous pouvez spécifier jusqu'à 24 disques SSD locaux.

    • Pour supprimer tous les disques SSD locaux associés aux VM réservées, supprimez toutes les options --local-ssd et incluez l'option --clear-local-ssd.

  • MACHINE_TYPE : nouveau type de machine à utiliser pour chaque VM réservée. Si vous modifiez le type de machine, veillez également à spécifier une période de réservation minimale recommandée pour la nouvelle série de machines. Sinon, Google Cloud est susceptible de refuser votre demande de modification.

  • MINIMUM_CPU_PLATFORM : nouvelle plate-forme de processeur minimale à utiliser pour chaque VM réservée.

  • NAME_PREFIX : nouveau préfixe de nom pour les réservations créées automatiquement et provisionnées pour votre requête de réservation future.

  • SHARE_SETTING : nouveau type de partage pour votre future demande de réservation. Spécifiez une des valeurs suivantes :

    • Pour une requête de réservation future à un seul projet : local. Pour éviter les erreurs, vous devez également remplacer l'option --share-with par l'option --clear-share-settings.

    • Pour une demande de réservation future partagée : projects. Pour éviter les erreurs, vous devez également spécifier au moins un projet client dans l'option --share-with.

  • CONSUMER_PROJECT_IDS : liste des identifiants des projets avec lesquels vous souhaitez partager votre demande de réservation future, séparés par une virgule (par exemple, project-1,project-2). Vous pouvez spécifier jusqu'à 100 projets clients.

  • START_TIME : nouvelle heure de début de la période de réservation, formatée comme code temporel RFC 3339. L'heure de début ne peut pas être ultérieure d'un an à la date et heure à laquelle vous envoyez la demande de modification pour examen. Pour disposer d'un délai suffisant pour annuler, supprimer ou modifier une réservation future après son approbation et avant qu'elle ne bascule dans le délai de verrouillage, spécifiez une heure de début recommandée.

  • END_TIME : heure de fin de la période de réservation au format de code temporel RFC 3339. La période de réservation doit durer au moins 24 heures. Vous pouvez également remplacer l'option --end-time par l'option --duration=END_DURATION. Remplacez END_DURATION par la durée de la période de réservation en secondes. Pour augmenter la probabilité que Google Cloud approuve une demande de réservation future après l'avoir envoyée pour examen, spécifiez une période de réservation recommandée.

    .
  • TOTAL_COUNT : nombre total de VM que vous souhaitez réserver pour la période, la configuration de VM et les projets spécifiés dans votre requête de réservation future. Si vous souhaitez augmenter le nombre total, assurez-vous de disposer d'un quota suffisant pour les ressources que vous réservez. Sinon, Google Cloud refuse votre demande de modification.

Par exemple, considérons une demande de réservation future partagée brouillon nommée fr-03 et située dans la zone us-central1-a. Supposons que vous souhaitiez modifier cette requête de réservation future partagée en apportant les modifications suivantes :

  • Convertissez la requête en une requête de réservation future à un seul projet.

  • Désactivez l'option de suppression automatique.

  • Réservez 100 VM.

  • Envoyez la demande de réservation future à Google Cloud pour examen.

Pour modifier fr-03, exécutez la commande suivante :

gcloud beta compute future-reservations update fr-03 \
    --clear-share-settings \
    --no-auto-delete-auto-created-reservations \
    --planning-status=SUBMITTED \
    --share-setting=local \
    --total-count=100 \
    --zone=us-central1-a

REST

Pour modifier une requête de réservation future, envoyez une requête PATCH à la méthode beta.futureReservations.update.

PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=UPDATE_FIELDS

{
  "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
  "description": "DESCRIPTION",
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "planningStatus": "PLANNING_STATUS",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SHARE_TYPE"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "guestAccelerators": [
        {
          "acceleratorCount": NUMBER_OF_ACCELERATORS,
          "acceleratorType": "ACCELERATOR_TYPE"
        }
      ],
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_1"
        },
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_2"
        }
      ],
      "machineType": "MACHINE_TYPE",
      "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
    },
    "totalCount": "TOTAL_COUNT"
  },
  "timeWindow": {
    "endTime": "END_TIME",
    "startTime": "START_TIME"
  }
}

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet dans lequel se trouve la demande de réservation future.

  • ZONE : zone dans laquelle se situe la demande de réservation future.

  • FUTURE_RESERVATION_NAME : nom de la requête de réservation future.

  • UPDATE_FIELDS : liste de champs à mettre à jour dans le corps de la requête, séparés par une virgule. Vous devez encoder chaque virgule en tant que %2C. Si vous spécifiez un champ dans le paramètre de requête updateMask et dans le corps de la requête, la valeur du champ est mise à jour. Sinon, si vous ne spécifiez le champ que dans le paramètre de requête updateMask, le champ est supprimé.

    Par exemple, pour mettre à jour les champs autoDeleteAutoCreatedReservations, totalCount et endTime dans votre future requête de réservation, spécifiez les éléments suivants :

    autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
    
  • PLANNING_STATUS : état de planification de la requête de réservation future. Spécifiez une des valeurs suivantes :

    • Pour modifier une requête de réservation future brouillon sans l'envoyer pour examen : DRAFT.

    • Pour envoyer la demande de modification à examiner : SUBMITTED.

Remplacez un ou plusieurs des espaces réservés suivants, ou supprimez-les avec les champs correspondants :

  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS : si vous définissez ce champ sur true, Compute Engine supprime automatiquement les réservations créées automatiquement pour votre future demande de réservation. Par défaut, la suppression est effectuée dans les deux heures suivant l'heure de fin de la période de réservation. Pour modifier ce comportement, effectuez l'une des opérations suivantes :

    • Pour supprimer les réservations créées automatiquement après une période spécifique après la fin de votre période de réservation, définissez autoDeleteAutoCreatedReservations sur true et spécifiez le champ autoCreatedReservationsDeleteTime.

      PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime%2CplanningStatus
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDeleteTime": "DELETE_TIME",
        "name": "FUTURE_RESERVATION_NAME",
        "planningStatus": "PLANNING_STATUS"
      }
      

      Remplacez DELETE_TIME par une date et une heure auxquelles Compute Engine supprime les réservations. La date et l'heure doivent être mises en forme en tant que code temporel RFC 3339.

    • Pour supprimer les réservations créées automatiquement après une durée spécifique à partir de l'heure de début de la période de réservation, définissez autoDeleteAutoCreatedReservations sur true et spécifiez le champ autoCreatedReservationsDuration.

      PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration%2CplanningStatus
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDuration": {
          "seconds": "DURATION_BEFORE_DELETE"
        },
        "name": "FUTURE_RESERVATION_NAME",
        "planningStatus": "PLANNING_STATUS"
      }
      

      Remplacez DURATION_BEFORE_DELETE par une durée en secondes. Par exemple, spécifiez 604800 pour 604 800 secondes (7 jours).

  • DESCRIPTION : nouvelle description de la requête de réservation future.

  • NAME_PREFIX : nouveau préfixe de nom pour les réservations créées automatiquement et provisionnées pour votre requête de réservation future.

  • CONSUMER_PROJECT_ID_1 et CONSUMER_PROJECT_ID_2 : ID des projets avec lesquels vous souhaitez partager votre requête de réservation future. Les projets doivent appartenir à la même organisation que le projet propriétaire. Vous pouvez spécifier jusqu'à 100 projets clients.

  • SHARE_TYPE : nouveau type de partage pour votre future demande de réservation. Effectuez l'une des opérations suivantes :

    • Pour spécifier une requête de réservation future à un seul projet, procédez comme suit :

      • Spécifiez LOCAL.

      • Supprimez le champ shareSettings.projects.

    • Pour spécifier une demande de réservation future partagée, procédez comme suit :

      • Spécifiez SPECIFIC_PROJECTS.

      • Spécifiez au moins un projet client dans le champ shareSettings.projects. Les projets consommateurs doivent appartenir à la même organisation que le projet propriétaire. Vous pouvez spécifier jusqu'à 100 projets clients.

  • Pour modifier le nombre et le type de GPU à associer à vos VM N1 réservées, remplacez les éléments suivants :

    • NUMBER_OF_ACCELERATORS : nombre de GPU à ajouter par VM réservée.

    • ACCELERATOR_TYPE : type de GPU à ajouter aux VM réservées. Assurez-vous que le GPU est disponible dans la zone où se trouve la requête de réservation future. Sinon, la modification de la requête échoue.

  • INTERFACE_1 et INTERFACE_2 : type d'interface de disque pour les disques SSD locaux associés à chaque VM réservée. Spécifiez une des valeurs suivantes :

  • MACHINE_TYPE : nouveau type de machine à utiliser pour chaque VM réservée. Si vous modifiez le type de machine, veillez également à spécifier une période de réservation minimale recommandée pour la nouvelle série de machines. Sinon, Google Cloud risque de ne pas approuver votre demande de modification.

  • MINIMUM_CPU_PLATFORM : nouvelle plate-forme de processeur minimale à utiliser pour chaque VM réservée.

  • TOTAL_COUNT : nombre total de VM que vous souhaitez réserver pour la période, la configuration de VM et les projets spécifiés dans cette requête de réservation future. Si vous souhaitez augmenter le nombre total, assurez-vous de disposer d'un quota suffisant pour les ressources que vous réservez. Sinon, Google Cloud refuse votre demande de modification.

  • START_TIME : nouvelle heure de début de la période de réservation, formatée comme code temporel RFC 3339. L'heure de début ne peut pas être ultérieure d'un an à la date et heure à laquelle vous envoyez la demande de modification pour examen. Pour disposer d'un délai suffisant pour annuler, supprimer ou modifier une réservation future après son approbation et avant qu'elle ne bascule dans le délai de verrouillage, spécifiez une heure de début recommandée.

  • END_TIME : heure de fin de la période de réservation au format de code temporel RFC 3339. La période de réservation doit durer au moins 24 heures. Vous pouvez également remplacer le champ endTime par le champ duration pour spécifier une durée spécifique à partir de l'heure de début de la période de réservation :

    PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=timeWindow.duration%2CplanningStatus
    
    {
      "name": "FUTURE_RESERVATION_NAME",
      "planningStatus": "PLANNING_STATUS",
      "timeWindow": {
        "duration": {
          "seconds": "END_DURATION"
        }
      }
    }
    

    Remplacez END_DURATION par une durée en secondes. Par exemple, spécifiez 1209600 pour 1 209 600 secondes (14 jours). Pour augmenter la probabilité que Google Cloud approuve une demande de réservation future après l'avoir envoyée pour examen, spécifiez une période de réservation recommandée.

    .

Par exemple, considérons une demande de réservation future partagée brouillon nommée fr-03 et située dans la zone us-central1-a. Supposons que vous souhaitiez modifier cette requête de réservation future partagée en apportant les modifications suivantes :

  • Convertissez la requête en une requête de réservation future à un seul projet.

  • Désactivez l'option de suppression automatique.

  • Réservez 100 VM.

  • Envoyez la demande de réservation future à Google Cloud pour examen.

Pour modifier fr-03, envoyez une requête PATCH comme suit :

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-03?updateMask=autoDeleteAutoCreatedReservations%2CplanningStatus%2CshareSettings.shareType%2CspecificSkuProperties.totalCount

{
  "autoDeleteAutoCreatedReservations": false,
  "name": "fr-03",
  "planningStatus": "SUBMITTED",
  "shareSettings": {
    "shareType": "LOCAL"
  },
  "specificSkuProperties": {
    "totalCount": "100"
  }
}

Après avoir modifié une demande de réservation future, vous pouvez surveiller son état d'approvisionnement ou de mise à jour en affichant les détails de la demande de réservation future.

Modifier toute autre propriété dans une requête de réservation future

Pour modifier des propriétés que vous ne pouvez pas modifier après avoir créé une requête de réservation future, et avant que la requête ne soit approuvée et entre dans sa période de verrouillage, procédez comme suit :

  1. Pour empêcher la requête de réservation future de restreindre le type de requête de réservation future que vous pouvez créer dans votre projet ou dans les projets avec lesquels la demande de réservation future est partagée, supprimez la demande de réservation future.

  2. Créez une requête de réservation à un seul projet ou une requête de réservation future partagée avec les mises à jour souhaitées.

Résoudre les problèmes

Si vous rencontrez des erreurs lors de la modification d'une requête de réservation future, découvrez comment résoudre les problèmes liés aux requêtes de réservation futures.

Si vous rencontrez toujours des problèmes après le dépannage, contactez votre responsable de compte ou l'assistance Google Cloud.

Étape suivante