Modifier, annuler ou supprimer des demandes de réservations futures

Console

Pour demander à Google Cloud de modifier une requête de réservation future brouillon ou refusée créée en spécifiant un modèle d'instance, procédez comme suit :

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 que vous souhaitez modifier.

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

4. Pour modifier la demande de réservation future, cliquez sur edit Modifier ou sur edit Modifier le brouillon.

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

5. Effectuez l'une ou plusieurs des opérations suivantes :

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

   • Dans le champ Description, saisissez une nouvelle 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 demande après l'avoir envoyée 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 sélectionner jusqu'à 100 projets. Ces projets doivent appartenir à la même organisation que le projet dans lequel la demande de réservation future a été créée (le projet propriétaire). Ne spécifiez pas le projet propriétaire. Par défaut, il est déjà autorisé à consommer les réservations partagées créées automatiquement pour cette requête de réservation future.

   • Dans Nombre d'instances de VM saisissez le nombre total de VM que vous souhaitez réserver pour la période, la configuration de VM et le ou les projets spécifiés dans cette requête de réservation future.

     Lors du calcul du nombre de réservations à créer pour une réservation future approuvée, Compute Engine vérifie d'abord les réservations existantes. Si des réservations existantes correspondent à la réservation future approuvée, le nombre de réservations existantes est soustrait du nombre total de réservations demandé dans la requête pour déterminer le nombre de nouvelles réservations que Compute Engine crée. Pour en savoir plus, découvrez comment Compute Engine compte et provisionne les ressources 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.

     Facultatif. Si vous activez l'option de suppression automatique, vous pouvez spécifier la date et l'heure auxquelles Compute Engine supprime 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.

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

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

     • 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.

   • Dans le cas d'une demande de réservation future refusée, vous ne pouvez l'envoyer que pour examen en cliquant sur Envoyer.

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

gcloud

Pour demander à Google Cloud de modifier une requête de réservation future brouillon ou refusée créée en spécifiant un modèle d'instance, utilisez la commande gcloud beta compute future-reservations update.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --description="DESCRIPTION" \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --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 d'une demande de réservation future brouillon ou refusée existante.

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

• NAME_PREFIX : facultatif. Un nouveau préfixe de nom pour la requête de réservation future. Le nom de chaque réservation créée automatiquement pour cette requête de réservation future commence par le préfixe du nom. Pour vous aider à identifier les réservations créées automatiquement pour cette requête de réservation future, il est recommandé de spécifier un préfixe de nom unique.

• PLANNING_STATUS : état de planification de la requête de réservation future. Vous pouvez uniquement spécifier SUBMITTED, qui envoie la demande de réservation future à Google Cloud pour examen.

• PROJECT_ID : facultatif. ID du projet dans lequel la requête de réservation future a été créée. Si vous modifiez une requête de réservation future à un seul projet en une requête de réservation future partagée, ce projet devient le projet propriétaire de la requête de réservation future. Si vous omettez l'option --project, la valeur est définie sur l'ID du projet en cours.

• SHARE_SETTING : facultatif. Pour modifier le type de cette requête de réservation future, spécifiez l'une des valeurs suivantes :

  • Pour modifier une requête de réservation future à un seul projet en une requête de réservation future partagée, spécifiez projects. Veillez à spécifier au moins un projet client à l'aide de l'option --share-with. Sinon, la modification de la réservation future échouera.

  • Sinon, spécifiez local.

• CONSUMER_PROJECT_IDS : facultatif. Liste des ID de projets séparés par une virgule avec lesquels cette requête de réservation future peut être partagée. Par exemple, spécifiez project-1,project-2. Vous pouvez spécifier jusqu'à 100 projets. Ces projets doivent appartenir à la même organisation que le projet dans lequel la demande de réservation future a été créée (le projet propriétaire). Ne spécifiez pas le projet propriétaire. Par défaut, il est déjà autorisé à consommer les réservations partagées créées automatiquement pour cette requête de réservation future.

• START_TIME : facultatif. Nouvelle heure de début de la période de réservation au format de code temporel RFC 3339, qui doit être comme suit :

  YYYY-MM-DDTHH:MM:SSOFFSET
  

  Remplacez les éléments suivants :

  • YYYY-MM-DD : date respectant la syntaxe année à 4 chiffres, mois à 2 chiffres et jour du mois à 2 chiffres, séparés par des traits d'union (-).

  • HH:MM:SS : heure respectant la syntaxe heures à 2 chiffres sur 24 heures, minutes à 2 chiffres et secondes à 2 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), spécifiez -08:00. Sinon, pour n'utiliser aucun décalage, spécifiez Z.

  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. Pour disposer d'un délai suffisant pour éventuellement annuler, supprimer ou modifier une réservation future après son approbation ou avant son heure de verrouillage ; veillez à spécifier une heure de début recommandée.

• END_TIME : facultatif. Nouvelle heure de fin de la période de réservation, formatée comme 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, où END_DURATION correspond à la durée de la période de réservation 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, veillez à spécifier l'une des valeurs recommandées pour votre période de réservation.

• TOTAL_COUNT : facultatif. Nouveau 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.

  Lors du calcul du nombre de réservations à créer pour une réservation future approuvée, Compute Engine vérifie d'abord les réservations existantes. Si des réservations existantes correspondent à la réservation future approuvée, le nombre de réservations existantes est soustrait du nombre total de réservations demandé dans la requête pour déterminer le nombre de nouvelles réservations que Compute Engine crée. Pour en savoir plus, découvrez comment Compute Engine compte et provisionne les ressources réservées.

  Attention : Assurez-vous de disposer d'un quota suffisant pour les ressources que vous demandez à réserver. Sinon, Google Cloud refuse votre demande de réservation future.

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

Vous pouvez également modifier si et quand Compute Engine supprime automatiquement les réservations créées automatiquement pour une requête de réservation future en effectuant l'une des opérations suivantes :

• 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), spécifiez l'option --auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations update example-future-reservation \
        --auto-delete-auto-created-reservations
    

  • 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, spécifiez les options --auto-delete-auto-created-reservations et --auto-created-reservations-delete-time.

    gcloud beta compute future-reservations update example-future-reservation \
        --auto-delete-auto-created-reservations \
        --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
    

    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, spécifiez les options --auto-delete-auto-created-reservations et --auto-created-reservations-duration.

    gcloud beta compute future-reservations update example-future-reservation \
        --auto-delete-auto-created-reservations \
        --auto-created-reservations-duration=DURATION_BEFORE_DELETE
    

    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 désactiver Compute Engine afin de supprimer automatiquement les réservations créées automatiquement, spécifiez l'option --no-auto-delete-auto-created-reservations.

  gcloud beta compute future-reservations update example-future-reservation \
      --no-auto-delete-auto-created-reservations
  

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 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 approbation.

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 \
    --project=example-project \
    --total-count=100 \
    --zone=us-central1-a

REST

Pour demander à Google Cloud de modifier une demande de réservation future brouillon ou refusée créée en spécifiant un modèle d'instance, effectuez une requête PATCH à la méthode beta.futureReservations.update. Dans le paramètre de requête updateMask, spécifiez chaque champ que vous souhaitez mettre à jour. Si vous devez supprimer un champ facultatif de votre réservation, incluez-le dans le paramètre de requête updateMask et omettez-le dans le corps de la requête.

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": {
    "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 d'une demande de réservation future brouillon ou refusée existante. Vous ne pouvez pas modifier le nom d'une requête de réservation future.

• UPDATE_FIELDS : liste de champs à mettre à jour dans cette requête PATCH, séparés par une virgule. Vous devez encoder chaque virgule en tant que %2C. Par exemple, si vous souhaitez mettre à jour les champs autoDeleteAutoCreatedReservations, totalCount et endTime dans votre future requête de réservation, spécifiez ce qui suit :

  autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
  

• AUTO_DELETE_AUTO_CREATED_RESERVATIONS : facultatif. Si vous définissez ce champ sur true, Compute Engine supprime automatiquement les réservations créées automatiquement pour cette requête de réservation future. Par défaut, l'heure de suppression est comprise 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 à une heure spécifique après l'heure de 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/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime
    
    {
      "autoDeleteAutoCreatedReservations": "true",
      "autoCreatedReservationsDeleteTime": "DELETE_TIME"
    }
    

    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, qui doit être comme suit :

    YYYY-MM-DDTHH:MM:SSOFFSET
    

    Remplacez les éléments suivants :

    • YYYY-MM-DD : date respectant la syntaxe année à 4 chiffres, mois à 2 chiffres et jour du mois à 2 chiffres, séparés par des traits d'union (-).

    • HH:MM:SS : heure respectant la syntaxe heures à 2 chiffres sur 24 heures, minutes à 2 chiffres et secondes à 2 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), spécifiez -08:00. Sinon, pour n'utiliser aucun décalage, spécifiez Z.

  • 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/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration
    
    {
      "autoDeleteAutoCreatedReservations": "true",
      "autoCreatedReservationsDuration": {
        "seconds": "DURATION_BEFORE_DELETE"
      }
    }
    

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

• DESCRIPTION : facultatif. Pour mettre à jour la description de cette requête de réservation future, effectuez l'une des opérations suivantes :

  • Pour ajouter ou mettre à jour une description, spécifiez une description.

  • Pour supprimer la description, supprimez le champ description du corps de la requête et spécifiez-le dans UPDATE_FIELDS.

• NAME_PREFIX : facultatif. Un nouveau préfixe de nom pour la requête de réservation future. Le nom de chaque réservation créée automatiquement pour cette requête de réservation future commence par le préfixe du nom. Pour vous aider à identifier les réservations créées automatiquement pour cette réservation future, il est recommandé de spécifier un préfixe de nom unique.

• PLANNING_STATUS : état de planification de la requête de réservation future. Vous pouvez uniquement spécifier SUBMITTED, qui envoie la demande de réservation future à Google Cloud pour examen.

• SHARE_TYPE : facultatif. Pour modifier le type de partage de cette requête de réservation future, spécifiez l'une des valeurs suivantes :

  • Pour modifier une requête de réservation future à un seul projet en une requête de réservation future partagée, spécifiez SPECIFIC_PROJECTS. En outre, vous devez spécifier au moins un projet client dans le champ projects. Sinon, la modification de la requête de réservation future échouera.

  • Sinon, spécifiez LOCAL. De plus, vous devez supprimer le champ projects du corps de la requête et le spécifier dans UPDATE_FIELDS. Sinon, la modification de la requête de réservation future échouera.

• CONSUMER_PROJECT_ID_1 et CONSUMER_PROJECT_ID_2 : facultatifs. Les ID de projet des projets avec lesquels une requête de réservation future partagée peut être partagée. Vous pouvez spécifier jusqu'à 100 projets. Ces projets doivent appartenir à la même organisation que le projet dans lequel la demande de réservation future a été créée (le projet propriétaire). Ne spécifiez pas le projet propriétaire. Par défaut, il est déjà autorisé à consommer les réservations partagées créées automatiquement pour cette requête de réservation future.

• TOTAL_COUNT : facultatif. Nouveau 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.

  Lors du calcul du nombre de réservations à créer pour une réservation future approuvée, Compute Engine vérifie d'abord les réservations existantes. Si des réservations existantes correspondent à la réservation future approuvée, le nombre de réservations existantes est soustrait du nombre total de réservations demandé dans la requête pour déterminer le nombre de nouvelles réservations que Compute Engine crée. Pour en savoir plus, découvrez comment Compute Engine compte et provisionne les ressources réservées.

• START_TIME : facultatif. 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 l'heure auxquelles vous souhaitez envoyer une demande de réservation future. En outre, veillez à spécifier une heure de début recommandée pour vous assurer que vous avez suffisamment de temps avant qu'une réservation future n'entre en heure de verrouillage.

• END_TIME : facultatif. Nouvelle heure de fin de la période de réservation, formatée comme 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 :

  "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, veillez à spécifier l'une des valeurs recommandées pour votre période de réservation.

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 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 approbation.

Pour modifier fr-03, envoyez la requête PATCH suivante :

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"
  }
}

Console

Pour demander à Google Cloud de modifier une requête de réservation future brouillon ou refusée créée en spécifiant directement des propriétés, procédez comme suit :

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 que vous souhaitez modifier.

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

4. Pour modifier la demande de réservation future, cliquez sur edit Modifier ou sur edit Modifier le brouillon.

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

5. Effectuez l'une ou plusieurs des opérations suivantes :

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

   • Dans le champ Description, saisissez une nouvelle 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 demande après l'avoir envoyée 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 sélectionner jusqu'à 100 projets. Ces projets doivent appartenir à la même organisation que le projet dans lequel la demande de réservation future a été créée (le projet propriétaire). Ne spécifiez pas le projet propriétaire. Par défaut, il est déjà autorisé à consommer les réservations partagées créées automatiquement pour cette requête de réservation future.

   • Dans Nombre d'instances de VM saisissez le nombre total de VM que vous souhaitez réserver pour la période, la configuration de VM et le ou les projets spécifiés dans cette requête de réservation future.

     Lors du calcul du nombre de réservations à créer pour une réservation future approuvée, Compute Engine vérifie d'abord les réservations existantes. Si des réservations existantes correspondent à la réservation future approuvée, le nombre de réservations existantes est soustrait du nombre total de réservations demandé dans la requête pour déterminer le nombre de nouvelles réservations que Compute Engine crée. Pour en savoir plus, découvrez comment Compute Engine compte et provisionne les ressources réservées.

   • Dans la section Configuration de la machine, vous pouvez modifier les éléments suivants :

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

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

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

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

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

     • 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.

   • Dans le cas d'une demande de réservation future refusée, vous ne pouvez l'envoyer que pour examen en cliquant sur Envoyer.

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

gcloud

Pour demander à Google Cloud de modifier une demande de réservation future brouillon ou refusée créée en spécifiant directement des propriétés, 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_1 \
    --local-ssd=size=375,interface=INTERFACE_2 \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform=MIN_CPU_PLATFORM \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --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 d'une demande de réservation future brouillon ou refusée existante.

• Facultatif. Effectuez l'une des opérations suivantes :

  • Pour ajouter des processeurs graphiques (GPU) à chaque VM réservée, spécifiez 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 type de machine que vous spécifiez dans la requête de réservation future est compatible avec les types de GPU que vous spécifiez et que le GPU est disponible dans la zone où vous souhaitez réserver des ressources. Sinon, vous rencontrerez des erreurs.

  • Pour supprimer tous les GPU de cette requête de réservation future, remplacez l'option --accelerator par l'option --clear-accelerator.

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

• Facultatif. Effectuez l'une des opérations suivantes :

  • Pour ajouter ou modifier le type d'interface que les disques SSD locaux doivent utiliser pour chaque VM, remplacez INTERFACE_1 et INTERFACE_2. La valeur doit correspondre à l'un des éléments suivants :

    • Si votre image de disque de démarrage inclut des pilotes optimisés pour NVMe, spécifiez nvme.

    • Sinon, spécifiez scsi.

    La capacité de chaque disque SSD local est de 375 Go. Répétez l'option --local-ssd pour chaque disque SSD local que vous souhaitez ajouter. Vous pouvez spécifier jusqu'à 24 disques SSD locaux.

  • Pour supprimer tous les disques SSD locaux de cette réservation de requête future, supprimez toutes les options --local-ssd et spécifiez l'option --clear-local-ssd.

• MACHINE_TYPE : facultatif. Un type de machine prédéfini ou personnalisé à utiliser pour chaque VM. Avant de spécifier un type de machine personnalisé, examinez les limites applicables aux VM avec des types de machines personnalisés.

• MINIMUM_CPU_PLATFORM : facultatif. Configuration minimale de la plate-forme du processeur à utiliser pour chaque VM. Si vous omettez l'option --min-cpu-platform, sa valeur est définie sur la plate-forme de processeur par défaut de la zone.

• NAME_PREFIX : facultatif. Un nouveau préfixe de nom pour la requête de réservation future. Le nom de chaque réservation créée automatiquement pour cette requête de réservation future commence par le préfixe du nom. Pour vous aider à identifier les réservations créées automatiquement pour cette requête de réservation future, il est recommandé de spécifier un préfixe de nom unique.

• PLANNING_STATUS : état de planification de la requête de réservation future. Vous pouvez uniquement spécifier SUBMITTED, qui envoie la demande de réservation future à Google Cloud pour examen.

• PROJECT_ID : facultatif. ID du projet dans lequel la requête de réservation future a été créée. Si vous modifiez une requête de réservation future à un seul projet en une requête de réservation future partagée, ce projet devient le projet propriétaire de la requête de réservation future. Si vous omettez l'option --project, la valeur est définie sur l'ID du projet en cours.

• SHARE_SETTING : facultatif. Pour modifier le type de cette requête de réservation future, spécifiez l'une des valeurs suivantes :

  • Pour modifier une requête de réservation future à un seul projet en une requête de réservation future partagée, spécifiez projects. Veillez à spécifier au moins un projet client à l'aide de l'option --share-with. Sinon, la modification de la réservation future échouera.

  • Sinon, spécifiez local.

• CONSUMER_PROJECT_IDS : facultatif. Liste des ID de projets séparés par une virgule avec lesquels cette requête de réservation future peut être partagée. Par exemple, spécifiez project-1,project-2. Vous pouvez spécifier jusqu'à 100 projets. Ces projets doivent appartenir à la même organisation que le projet dans lequel la demande de réservation future a été créée (le projet propriétaire). Ne spécifiez pas le projet propriétaire. Par défaut, il est déjà autorisé à consommer les réservations partagées créées automatiquement pour cette requête de réservation future.

• START_TIME : facultatif. Nouvelle heure de début de la période de réservation au format de code temporel RFC 3339, qui doit être comme suit :

  YYYY-MM-DDTHH:MM:SSOFFSET
  

  Remplacez les éléments suivants :

  • YYYY-MM-DD : date respectant la syntaxe année à 4 chiffres, mois à 2 chiffres et jour du mois à 2 chiffres, séparés par des traits d'union (-).

  • HH:MM:SS : heure respectant la syntaxe heures à 2 chiffres sur 24 heures, minutes à 2 chiffres et secondes à 2 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), spécifiez -08:00. Sinon, pour n'utiliser aucun décalage, spécifiez Z.

  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. Pour disposer d'un délai suffisant pour éventuellement annuler, supprimer ou modifier une réservation future après son approbation ou avant son heure de verrouillage ; veillez à spécifier une heure de début recommandée.

• END_TIME : facultatif. Nouvelle heure de fin de la période de réservation, formatée comme 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, où END_DURATION correspond à la durée de la période de réservation 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, veillez à spécifier l'une des valeurs recommandées pour votre période de réservation.

• TOTAL_COUNT : facultatif. Nouveau 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.

  Lors du calcul du nombre de réservations à créer pour une réservation future approuvée, Compute Engine vérifie d'abord les réservations existantes. Si des réservations existantes correspondent à la réservation future approuvée, le nombre de réservations existantes est soustrait du nombre total de réservations demandé dans la requête pour déterminer le nombre de nouvelles réservations que Compute Engine crée. Pour en savoir plus, découvrez comment Compute Engine compte et provisionne les ressources réservées.

  Attention : Assurez-vous de disposer d'un quota suffisant pour les ressources que vous demandez à réserver. Sinon, Google Cloud refuse votre demande de réservation future.

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

Vous pouvez également modifier si et quand Compute Engine supprime automatiquement les réservations créées automatiquement pour une requête de réservation future en effectuant l'une des opérations suivantes :

• 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), spécifiez l'option --auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations update example-future-reservation \
        --auto-delete-auto-created-reservations
    

  • 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, spécifiez les options --auto-delete-auto-created-reservations et --auto-created-reservations-delete-time.

    gcloud beta compute future-reservations update example-future-reservation \
        --auto-delete-auto-created-reservations \
        --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
    

    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, spécifiez les options --auto-delete-auto-created-reservations et --auto-created-reservations-duration.

    gcloud beta compute future-reservations update example-future-reservation \
        --auto-delete-auto-created-reservations \
        --auto-created-reservations-duration=DURATION_BEFORE_DELETE
    

    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 désactiver Compute Engine afin de supprimer automatiquement les réservations créées automatiquement, spécifiez l'option --no-auto-delete-auto-created-reservations.

  gcloud beta compute future-reservations update example-future-reservation \
      --no-auto-delete-auto-created-reservations
  

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 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 approbation.

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 \
    --project=example-project \
    --total-count=100 \
    --zone=us-central1-a

REST

Pour demander à Google Cloud de modifier une demande de réservation future brouillon ou refusée créée en spécifiant directement des propriétés, effectuez une requête PATCH à la méthode beta.futureReservations.update. Dans le paramètre de requête updateMask, spécifiez chaque champ que vous souhaitez mettre à jour. Si vous devez supprimer un champ facultatif de votre réservation, incluez-le dans le paramètre de requête updateMask et omettez-le dans le corps de la requête.

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 d'une demande de réservation future brouillon ou refusée existante. Vous ne pouvez pas modifier le nom d'une requête de réservation future.

• UPDATE_FIELDS : liste de champs à mettre à jour dans cette requête PATCH, séparés par une virgule. Vous devez encoder chaque virgule en tant que %2C. Par exemple, si vous souhaitez mettre à jour les champs autoDeleteAutoCreatedReservations, totalCount et endTime dans votre future requête de réservation, spécifiez ce qui suit :

  autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
  

• AUTO_DELETE_AUTO_CREATED_RESERVATIONS : facultatif. Si vous définissez ce champ sur true, Compute Engine supprime automatiquement les réservations créées automatiquement pour cette requête de réservation future. Par défaut, l'heure de suppression est comprise 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 à une heure spécifique après l'heure de 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/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime
    
    {
      "autoDeleteAutoCreatedReservations": "true",
      "autoCreatedReservationsDeleteTime": "DELETE_TIME"
    }
    

    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, qui doit être comme suit :

    YYYY-MM-DDTHH:MM:SSOFFSET
    

    Remplacez les éléments suivants :

    • YYYY-MM-DD : date respectant la syntaxe année à 4 chiffres, mois à 2 chiffres et jour du mois à 2 chiffres, séparés par des traits d'union (-).

    • HH:MM:SS : heure respectant la syntaxe heures à 2 chiffres sur 24 heures, minutes à 2 chiffres et secondes à 2 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), spécifiez -08:00. Sinon, pour n'utiliser aucun décalage, spécifiez Z.

  • 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/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration
    
    {
      "autoDeleteAutoCreatedReservations": "true",
      "autoCreatedReservationsDuration": {
        "seconds": "DURATION_BEFORE_DELETE"
      }
    }
    

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

• DESCRIPTION : facultatif. Pour mettre à jour la description de cette requête de réservation future, effectuez l'une des opérations suivantes :

  • Pour ajouter ou mettre à jour une description, spécifiez une description.

  • Pour supprimer la description, supprimez le champ description du corps de la requête et spécifiez-le dans UPDATE_FIELDS.

• NAME_PREFIX : facultatif. Un nouveau préfixe de nom pour la requête de réservation future. Le nom de chaque réservation créée automatiquement pour cette requête de réservation future commence par le préfixe du nom. Pour vous aider à identifier les réservations créées automatiquement pour cette réservation future, il est recommandé de spécifier un préfixe de nom unique.

• PLANNING_STATUS : état de planification de la requête de réservation future. Vous pouvez uniquement spécifier SUBMITTED, qui envoie la demande de réservation future à Google Cloud pour examen.

• SHARE_TYPE : facultatif. Pour modifier le type de partage de cette requête de réservation future, spécifiez l'une des valeurs suivantes :

  • Pour modifier une requête de réservation future à un seul projet en une requête de réservation future partagée, spécifiez SPECIFIC_PROJECTS. En outre, vous devez spécifier au moins un projet client dans le champ projects. Sinon, la modification de la requête de réservation future échouera.

  • Sinon, spécifiez LOCAL. De plus, vous devez supprimer le champ projects du corps de la requête et le spécifier dans UPDATE_FIELDS. Sinon, la modification de la requête de réservation future échouera.

• CONSUMER_PROJECT_ID_1 et CONSUMER_PROJECT_ID_2 : facultatifs. Les ID de projet des projets avec lesquels une requête de réservation future partagée peut être partagée. Vous pouvez spécifier jusqu'à 100 projets. Ces projets doivent appartenir à la même organisation que le projet dans lequel la demande de réservation future a été créée (le projet propriétaire). Ne spécifiez pas le projet propriétaire. Par défaut, il est déjà autorisé à consommer les réservations partagées créées automatiquement pour cette requête de réservation future.

• Facultatif. Pour mettre à jour les processeurs graphiques (GPU) associés à chaque VM réservée, effectuez l'une des opérations suivantes :

  • Pour ajouter ou modifier des GPU, spécifiez 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 type de machine que vous spécifiez dans la requête de réservation future est compatible avec les types de GPU que vous spécifiez et que le GPU est disponible dans la zone où vous souhaitez réserver des ressources. Sinon, vous rencontrerez des erreurs.

  • Pour supprimer tous les GPU de cette requête de réservation future, omettez le champ guestAccelerators dans le corps de la requête et spécifiez-le dans UPDATE_FIELDS.

• Facultatif. Pour mettre à jour les disques SSD locaux associés à chaque VM réservée, effectuez l'une des opérations suivantes :

  • Pour ajouter ou modifier le type d'interface que les disques SSD locaux doivent utiliser pour chaque VM, remplacez INTERFACE_1 et INTERFACE_2. La valeur doit correspondre à l'un des éléments suivants :

    • Si votre image de disque de démarrage inclut des pilotes optimisés pour NVMe, spécifiez NVME.

    • Sinon, spécifiez SCSI.

    Répétez les champs diskSizeGb et interface pour chaque disque SSD local que vous souhaitez ajouter ou mettre à jour. Vous pouvez spécifier jusqu'à 24 disques SSD locaux.

  • Pour supprimer tous les disques SSD locaux de cette requête de réservation future, supprimez le champ localSsds du corps de la requête et spécifiez-le dans UPDATE_FIELDS.

• MACHINE_TYPE : facultatif. Un type de machine prédéfini ou personnalisé à utiliser pour chaque VM. Avant de spécifier un type de machine personnalisé, examinez les limites applicables aux VM avec des types de machines personnalisés.

• MINIMUM_CPU_PLATFORM : facultatif. Pour mettre à jour la configuration minimale de la plate-forme du processeur à utiliser pour chaque VM, effectuez l'une des opérations suivantes :

  • Pour ajouter ou mettre à jour la configuration minimale de la plate-forme du processeur, spécifiez une configuration minimale.

  • Pour revenir à la plate-forme de processeur par défaut de la zone, supprimez le champ minCpuPlatform du corps de la requête et spécifiez-le dans UPDATE_FIELDS.

• TOTAL_COUNT : facultatif. Nouveau 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.

  Lors du calcul du nombre de réservations à créer pour une réservation future approuvée, Compute Engine vérifie d'abord les réservations existantes. Si des réservations existantes correspondent à la réservation future approuvée, le nombre de réservations existantes est soustrait du nombre total de réservations demandé dans la requête pour déterminer le nombre de nouvelles réservations que Compute Engine crée. Pour en savoir plus, découvrez comment Compute Engine compte et provisionne les ressources réservées.

• START_TIME : facultatif. 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 l'heure auxquelles vous souhaitez envoyer une demande de réservation future. En outre, veillez à spécifier une heure de début recommandée pour vous assurer que vous avez suffisamment de temps avant qu'une réservation future n'entre en heure de verrouillage.

• END_TIME : facultatif. Nouvelle heure de fin de la période de réservation, formatée comme 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 :

  "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, veillez à spécifier l'une des valeurs recommandées pour votre période de réservation.

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 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 approbation.

Pour modifier fr-03, envoyez la requête PATCH suivante :

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"
  }
}

Console

Pour modifier une réservation future approuvée ou en cours d'acquisition, procédez comme suit :

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 réservation future que vous souhaitez modifier.

   La page d'informations de la réservation future sélectionnée s'ouvre.

4. Si vous souhaitez modifier l'option de suppression automatique et la description d'une réservation future, effectuez l'une ou plusieurs des opérations suivantes :

   • Sur la ligne Heure de suppression automatique des réservations créées, cliquez sur edit Modifier, puis procédez comme suit :

     1. Effectuez l'une des opérations suivantes :

        • Pour permettre à Compute Engine de supprimer automatiquement les réservations créées automatiquement pour votre requête de réservation future, procédez comme suit :

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

          2. Facultatif : dans le champ Heure de suppression automatique, saisissez une nouvelle date et une nouvelle 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 Submit (Envoyer).

   • Sur la ligne Préfixe, cliquez sur edit Modifier, puis procédez comme suit :

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

     2. Cliquez sur Submit (Envoyer).

   • Sur la ligne Description, cliquez sur edit Modifier, puis procédez comme suit :

     1. Dans le champ Description, saisissez une nouvelle description.

     2. Cliquez sur Submit (Envoyer).

gcloud

Pour modifier une réservation approuvée ou en cours d'acquisition sans examen, utilisez la commande gcloud beta compute future-reservations update.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --description="DESCRIPTION" \
    --name-prefix=NAME_PREFIX \
    --project=PROJECT_ID \
    --zone=ZONE

Remplacez les éléments suivants :

• FUTURE_RESERVATION_NAME : nom d'une réservation future approuvée ou en cours d'acquisition existante.

• DESCRIPTION : facultatif. Une nouvelle description pour la réservation future.

• NAME_PREFIX : facultatif. Un nouveau préfixe de nom pour la réservation future. Le nom de chaque réservation créée automatiquement pour cette réservation future commence par le préfixe du nom. Pour vous aider à identifier les réservations créées automatiquement pour cette réservation future, il est recommandé de spécifier un préfixe de nom unique.

• PROJECT_ID : facultatif. ID du projet dans lequel la réservation future a été créée.

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

Vous pouvez également modifier si et quand Compute Engine supprime automatiquement les réservations créées automatiquement pour une réservation future en effectuant l'une des opérations suivantes :

• 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), spécifiez l'option --auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations update example-future-reservation \
        --auto-delete-auto-created-reservations
    

  • 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, spécifiez les options --auto-delete-auto-created-reservations et --auto-created-reservations-delete-time.

    gcloud beta compute future-reservations update example-future-reservation \
        --auto-delete-auto-created-reservations \
        --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
    

    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, spécifiez les options --auto-delete-auto-created-reservations et --auto-created-reservations-duration.

    gcloud beta compute future-reservations update example-future-reservation \
        --auto-delete-auto-created-reservations \
        --auto-created-reservations-duration=DURATION_BEFORE_DELETE
    

    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 désactiver Compute Engine afin de supprimer automatiquement les réservations créées automatiquement, spécifiez l'option --no-auto-delete-auto-created-reservations.

  gcloud beta compute future-reservations update example-future-reservation \
      --no-auto-delete-auto-created-reservations
  

Par exemple, considérons une réservation future approuvée nommée fr-04 et située dans la zone us-central1-a. Supposons que vous souhaitiez modifier cette réservation future en apportant les modifications suivantes :

• Activez l'option de suppression automatique.

• Supprimez automatiquement les réservations créées automatiquement après 864 000 secondes (10 jours).

• Spécifiez un nouveau préfixe de nom.

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

gcloud beta compute future-reservations update fr-04 \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-duration=864000 \
    --name-prefix=new-prefix \
    --project=example-project \
    --zone=us-central1-a

REST

Pour modifier une réservation future approuvée ou en cours d'acquisition sans examen, effectuez une requête PATCH à la méthode beta.futureReservations.update. Dans le paramètre de requête updateMask, spécifiez chaque champ que vous souhaitez mettre à jour. Si vous devez supprimer un champ facultatif de votre réservation, incluez-le dans le paramètre de requête updateMask et omettez-le dans le corps de la requête.

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"
}

Remplacez les éléments suivants :

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

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

• FUTURE_RESERVATION_NAME : nom d'une réservation future approuvée ou en cours d'acquisition existante. Vous ne pouvez pas modifier le nom d'une réservation future.

• UPDATE_FIELDS : liste de champs à mettre à jour dans cette requête PATCH, séparés par une virgule. Vous devez encoder chaque virgule en tant que %2C. Par exemple, si vous souhaitez mettre à jour les champs description et namePrefix dans votre réservation ultérieure, spécifiez les éléments suivants :

  description%2CnamePrefix
  

• AUTO_DELETE_AUTO_CREATED_RESERVATIONS : facultatif. Si vous définissez ce champ sur true, Compute Engine supprime automatiquement les réservations créées automatiquement pour cette requête de réservation future. Par défaut, l'heure de suppression est comprise 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 à une heure spécifique après l'heure de 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/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime
    
    {
      "autoDeleteAutoCreatedReservations": "true",
      "autoCreatedReservationsDeleteTime": "DELETE_TIME"
    }
    

    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, qui doit être comme suit :

    YYYY-MM-DDTHH:MM:SSOFFSET
    

    Remplacez les éléments suivants :

    • YYYY-MM-DD : date respectant la syntaxe année à 4 chiffres, mois à 2 chiffres et jour du mois à 2 chiffres, séparés par des traits d'union (-).

    • HH:MM:SS : heure respectant la syntaxe heures à 2 chiffres sur 24 heures, minutes à 2 chiffres et secondes à 2 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), spécifiez -08:00. Sinon, pour n'utiliser aucun décalage, spécifiez Z.

  • 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/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration
    
    {
      "autoDeleteAutoCreatedReservations": "true",
      "autoCreatedReservationsDuration": {
        "seconds": "DURATION_BEFORE_DELETE"
      }
    }
    

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

• DESCRIPTION : facultatif. Pour mettre à jour la description de cette réservation future, effectuez l'une des opérations suivantes :

  • Pour ajouter ou mettre à jour une description, spécifiez une description.

  • Pour supprimer la description, supprimez le champ description du corps de la requête et spécifiez-le dans UPDATE_FIELDS.

• NAME_PREFIX : facultatif. Un nouveau préfixe de nom pour la réservation future. Le nom de chaque réservation créée automatiquement pour cette réservation future commence par le préfixe du nom. Pour vous aider à identifier les réservations créées automatiquement pour cette réservation future, il est recommandé de spécifier un préfixe de nom unique.

Par exemple, considérons une réservation future approuvée nommée fr-04 et située dans la zone us-central1-a. Supposons que vous souhaitiez modifier cette réservation future en apportant les modifications suivantes :

• Activez l'option de suppression automatique.

• Supprimez automatiquement les réservations créées automatiquement après 864 000 secondes (10 jours).

• Spécifiez un nouveau préfixe de nom.

Pour modifier fr-04, envoyez la requête PATCH suivante :

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-04?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration%2CnamePrefix

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDuration": {
    "seconds": "864000"
  },
  "name": "fr-04",
  "namePrefix": "new-prefix"
}

Console

Pour demander à Google Cloud de modifier une réservation future approuvée ou en cours d'acquisition en spécifiant un modèle d'instance, procédez comme suit :

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 réservation future que vous souhaitez modifier.

   La page d'informations de la réservation future sélectionnée s'ouvre.

4. Si vous souhaitez modifier l'option de suppression automatique et la description d'une réservation future, effectuez l'une ou plusieurs des opérations suivantes :

   • Sur la ligne Heure de suppression automatique des réservations créées, cliquez sur edit Modifier, puis procédez comme suit :

     1. Effectuez l'une des opérations suivantes :

        • Pour permettre à Compute Engine de supprimer automatiquement les réservations créées automatiquement pour votre requête de réservation future, procédez comme suit :

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

          2. Facultatif : dans le champ Heure de suppression automatique, saisissez une nouvelle date et une nouvelle 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 Submit (Envoyer).

   • Sur la ligne Préfixe, cliquez sur edit Modifier, puis procédez comme suit :

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

     2. Cliquez sur Submit (Envoyer).

   • Sur la ligne Description, cliquez sur edit Modifier, puis procédez comme suit :

     1. Dans le champ Description, saisissez une nouvelle description.

     2. Cliquez sur Submit (Envoyer).

5. Cliquez sur edit Modifier.

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

6. Si vous souhaitez modifier d'autres propriétés, effectuez une ou plusieurs des opérations suivantes :

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

     • L'heure de début ne peut pas être ultérieure à un an à compter de la date et de l'heure auxquelles vous souhaitez envoyer une réservation future.

     • 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 demande après l'avoir envoyée 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 réservation future.

     Vous pouvez sélectionner jusqu'à 100 projets. Ces projets doivent appartenir à la même organisation que le projet dans lequel la réservation future a été créée (le projet propriétaire). Ne spécifiez pas le projet propriétaire. Par défaut, il est déjà autorisé à consommer les réservations partagées créées automatiquement pour cette future réservation.

   • Dans Nombre d'instances de VM saisissez le nombre total de VM que vous souhaitez réserver pour la période, la configuration de VM et le ou les projets spécifiés dans cette réservation future.

     Lors du calcul du nombre de réservations à créer pour une réservation future approuvée, Compute Engine vérifie d'abord les réservations existantes. Si des réservations existantes correspondent à la réservation future approuvée, le nombre de réservations existantes est soustrait du nombre total de réservations demandé dans la requête pour déterminer le nombre de nouvelles réservations que Compute Engine crée. Pour en savoir plus, découvrez comment Compute Engine compte et provisionne les ressources réservées.

7. Pour envoyer une demande de modification à Google Cloud pour examen, cliquez sur Envoyer.

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

gcloud

Pour demander à Google Cloud de modifier une réservation future approuvée ou en cours d'acquisition en créant un modèle d'instance, utilisez la commande suivante commande gcloud beta compute future-reservations update.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --description="DESCRIPTION" \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --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 d'une réservation future approuvée ou en cours d'acquisition existante.

• DESCRIPTION : facultatif. Une nouvelle description pour la réservation future.

• NAME_PREFIX : facultatif. Un nouveau préfixe de nom pour la réservation future. Le nom de chaque réservation créée automatiquement pour cette réservation future commence par le préfixe du nom. Pour vous aider à identifier les réservations créées automatiquement pour cette réservation future, il est recommandé de spécifier un préfixe de nom unique.

• PLANNING_STATUS : état de planification de la réservation future. Vous ne pouvez spécifier que SUBMITTED, qui envoie la réservation future à Google Cloud pour examen.

• PROJECT_ID : facultatif. ID du projet dans lequel la réservation future a été créée. Si vous modifiez une réservation future à un seul projet en une réservation future partagée, ce projet devient le projet propriétaire de la réservation future. Si vous omettez l'option --project, la valeur est définie sur l'ID du projet en cours.

• SHARE_SETTING : facultatif. Pour modifier le type de cette réservation future, spécifiez l'une des valeurs suivantes :

  • Pour modifier une réservation future à un seul projet en une réservation future partagée, spécifiez projects. Veillez à spécifier au moins un projet client à l'aide de l'option --share-with. Sinon, la modification de la requête de réservation future échouera.

  • Sinon, spécifiez local.

• CONSUMER_PROJECT_IDS : facultatif. Liste des ID de projets séparés par une virgule avec lesquels cette réservation future peut être partagée. Par exemple, spécifiez project-1,project-2. Vous pouvez spécifier jusqu'à 100 projets. Ces projets doivent appartenir à la même organisation que le projet dans lequel cette réservation future a été créée (le projet propriétaire). Ne spécifiez pas le projet propriétaire. Par défaut, il est déjà autorisé à consommer les réservations partagées créées automatiquement pour cette future réservation.

• START_TIME : facultatif. Nouvelle heure de début de la période de réservation au format de code temporel RFC 3339, qui doit être comme suit :

  YYYY-MM-DDTHH:MM:SSOFFSET
  

  Remplacez les éléments suivants :

  • YYYY-MM-DD : date respectant la syntaxe année à 4 chiffres, mois à 2 chiffres et jour du mois à 2 chiffres, séparés par des traits d'union (-).

  • HH:MM:SS : heure respectant la syntaxe heures à 2 chiffres sur 24 heures, minutes à 2 chiffres et secondes à 2 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), spécifiez -08:00. Sinon, pour n'utiliser aucun décalage, spécifiez Z.

  L'heure de début ne peut pas être ultérieure à un an à partir de la date et de l'heure auxquelles vous souhaitez envoyer une réservation ultérieure. Pour disposer d'un délai suffisant pour éventuellement annuler, supprimer ou modifier une réservation future après son approbation ou avant son heure de verrouillage ; veillez à spécifier une heure de début recommandée.

• END_TIME : facultatif. Nouvelle heure de fin de la période de réservation, formatée comme 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, où END_DURATION correspond à la durée de la période de réservation 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, veillez à spécifier l'une des valeurs recommandées pour votre période de réservation.

• TOTAL_COUNT : facultatif. Nouveau 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.

  Lors du calcul du nombre de réservations à créer pour une réservation future approuvée, Compute Engine vérifie d'abord les réservations existantes. Si des réservations existantes correspondent à la réservation future approuvée, le nombre de réservations existantes est soustrait du nombre total de réservations demandé dans la requête pour déterminer le nombre de nouvelles réservations que Compute Engine crée. Pour en savoir plus, découvrez comment Compute Engine compte et provisionne les ressources réservées.

  Attention : Si vous souhaitez augmenter le nombre de VM à réserver, assurez-vous de disposer d'un quota suffisant pour les ressources supplémentaires que vous demandez à réserver. Sinon, Google Cloud refuse votre demande de modification.

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

Vous pouvez également modifier si et quand Compute Engine supprime automatiquement les réservations créées automatiquement pour une réservation future en effectuant l'une des opérations suivantes :

• 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), spécifiez l'option --auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations update example-future-reservation \
        --auto-delete-auto-created-reservations
    

  • 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, spécifiez les options --auto-delete-auto-created-reservations et --auto-created-reservations-delete-time.

    gcloud beta compute future-reservations update example-future-reservation \
        --auto-delete-auto-created-reservations \
        --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
    

    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, spécifiez les options --auto-delete-auto-created-reservations et --auto-created-reservations-duration.

    gcloud beta compute future-reservations update example-future-reservation \
        --auto-delete-auto-created-reservations \
        --auto-created-reservations-duration=DURATION_BEFORE_DELETE
    

    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 désactiver Compute Engine afin de supprimer automatiquement les réservations créées automatiquement, spécifiez l'option --no-auto-delete-auto-created-reservations.

  gcloud beta compute future-reservations update example-future-reservation \
      --no-auto-delete-auto-created-reservations
  

Par exemple, considérons une réservation future approuvée nommée fr-05 et située dans la zone us-central1-a. Supposons que vous souhaitiez demander à Google Cloud de modifier cette réservation future en apportant les modifications suivantes :

• Remplacez l'heure de fin de sa période de réservation par minuit du 31 décembre 2023 UTC.

• Réservez 10 VM.

• Spécifiez un nouveau préfixe de nom.

Pour demander à Google Cloud de modifier fr-05, exécutez la commande suivante :

gcloud beta compute future-reservations update fr-05 \
    --end-time=2024-12-31T00:00:00Z \
    --name-prefix=new-prefix \
    --planning-status=SUBMITTED \
    --project=example-project \
    --total-count=10 \
    --zone=us-central1-a

REST

Pour demander à Google Cloud de modifier une réservation future approuvée ou en cours d'acquisition en créant un modèle d'instance, envoyez une requête PATCH à la méthode beta.futureReservations.update. Dans le paramètre de requête updateMask, spécifiez chaque champ que vous souhaitez mettre à jour. Si vous devez supprimer un champ facultatif de votre réservation, incluez-le dans le paramètre de requête updateMask et omettez-le dans le corps de la requête.

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": {
    "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 réservation future.

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

• FUTURE_RESERVATION_NAME : nom d'une réservation future approuvée ou en cours d'acquisition existante. Vous ne pouvez pas modifier le nom d'une réservation future.

• UPDATE_FIELDS : liste de champs à mettre à jour dans cette requête PATCH, séparés par une virgule. Vous devez encoder chaque virgule en tant que %2C. Par exemple, si vous souhaitez mettre à jour les champs autoDeleteAutoCreatedReservations, totalCount et endTime dans votre réservation ultérieure, spécifiez l'élément suivantes :

  autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
  

• AUTO_DELETE_AUTO_CREATED_RESERVATIONS : facultatif. Si vous définissez ce champ sur true, Compute Engine supprime automatiquement les réservations créées automatiquement pour cette requête de réservation future. Par défaut, l'heure de suppression est comprise 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 à une heure spécifique après l'heure de 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/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime
    
    {
      "autoDeleteAutoCreatedReservations": "true",
      "autoCreatedReservationsDeleteTime": "DELETE_TIME"
    }
    

    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, qui doit être comme suit :

    YYYY-MM-DDTHH:MM:SSOFFSET
    

    Remplacez les éléments suivants :

    • YYYY-MM-DD : date respectant la syntaxe année à 4 chiffres, mois à 2 chiffres et jour du mois à 2 chiffres, séparés par des traits d'union (-).

    • HH:MM:SS : heure respectant la syntaxe heures à 2 chiffres sur 24 heures, minutes à 2 chiffres et secondes à 2 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), spécifiez -08:00. Sinon, pour n'utiliser aucun décalage, spécifiez Z.

  • 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/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration
    
    {
      "autoDeleteAutoCreatedReservations": "true",
      "autoCreatedReservationsDuration": {
        "seconds": "DURATION_BEFORE_DELETE"
      }
    }
    

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

• DESCRIPTION : facultatif. Pour mettre à jour la description de cette réservation future, effectuez l'une des opérations suivantes :

  • Pour ajouter ou mettre à jour une description, spécifiez une description.

  • Pour supprimer la description, supprimez le champ description du corps de la requête et spécifiez-le dans UPDATE_FIELDS.

• NAME_PREFIX : facultatif. Un nouveau préfixe de nom pour la réservation future. Le nom de chaque réservation créée automatiquement pour cette réservation future commence par le préfixe du nom. Pour vous aider à identifier les réservations créées automatiquement pour cette réservation future, il est recommandé de spécifier un préfixe de nom unique.

• PLANNING_STATUS : état de planification de la réservation future. Vous ne pouvez spécifier que SUBMITTED, qui envoie la réservation future à Google Cloud pour examen.

• SHARE_TYPE : facultatif. Pour modifier le type de partage de cette réservation future, spécifiez l'une des valeurs suivantes :

  • Pour modifier une réservation future à un seul projet en une réservation future partagée, spécifiez SPECIFIC_PROJECTS. En outre, vous devez spécifier au moins un projet client dans le champ projects. Sinon, la modification de la réservation future échouera.

  • Sinon, spécifiez LOCAL. De plus, vous devez supprimer le champ projects du corps de la requête et le spécifier dans UPDATE_FIELDS. Sinon, la modification de la réservation future échouera.

• CONSUMER_PROJECT_ID_1 et CONSUMER_PROJECT_ID_2 : facultatifs. Les ID de projet avec lesquels une réservation future partagée peut être partagée. Vous pouvez spécifier jusqu'à 100 projets. Ces projets doivent appartenir à la même organisation que le projet dans lequel la réservation future a été créée (le projet propriétaire). Ne spécifiez pas le projet propriétaire. Par défaut, il est déjà autorisé à consommer les réservations partagées créées automatiquement pour cette future réservation.

• TOTAL_COUNT : facultatif. Nouveau 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.

  Lors du calcul du nombre de réservations à créer pour une réservation future approuvée, Compute Engine vérifie d'abord les réservations existantes. Si des réservations existantes correspondent à la réservation future approuvée, le nombre de réservations existantes est soustrait du nombre total de réservations demandé dans la requête pour déterminer le nombre de nouvelles réservations que Compute Engine crée. Pour en savoir plus, découvrez comment Compute Engine compte et provisionne les ressources réservées.

• START_TIME : facultatif. 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 postérieure d'un an à la date et l'heure auxquelles vous souhaitez envoyer une réservation future. En outre, veillez à spécifier une heure de début recommandée pour vous assurer que vous avez suffisamment de temps avant qu'une réservation future n'entre en heure de verrouillage.

• END_TIME : facultatif. Nouvelle heure de fin de la période de réservation, formatée comme 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 :

  "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, veillez à spécifier l'une des valeurs recommandées pour votre période de réservation.

Par exemple, considérons une réservation future approuvée nommée fr-05 et située dans la zone us-central1-a. Supposons que vous souhaitiez demander à Google Cloud de modifier cette réservation future en apportant les modifications suivantes :

• Remplacez l'heure de fin de sa période de réservation par minuit du 31 décembre 2023 UTC.

• Réservez 10 VM.

• Spécifiez un nouveau préfixe de nom.

Pour demander à Google Cloud de modifier fr-05, envoyez la requête PATCH suivante :

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-05?updateMask=namePrefix%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime

{
  "name": "fr-05",
  "namePrefix": "new-prefix",
  "planningStatus": "SUBMITTED",
  "specificSkuProperties": {
    "totalCount": "10"
  },
  "timeWindow": {
    "endTime": "2023-12-31T00:00:00Z"
  }
}

Console

Pour demander à Google Cloud de modifier une réservation future approuvée ou en cours d'acquisition en spécifiant directement des propriétés, procédez comme suit :

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 réservation future que vous souhaitez modifier.

   La page d'informations de la réservation future sélectionnée s'ouvre.

4. Si vous souhaitez modifier l'option de suppression automatique et la description d'une réservation future, effectuez l'une ou plusieurs des opérations suivantes :

   • Sur la ligne Heure de suppression automatique des réservations créées, cliquez sur edit Modifier, puis procédez comme suit :

     1. Effectuez l'une des opérations suivantes :

        • Pour permettre à Compute Engine de supprimer automatiquement les réservations créées automatiquement pour votre requête de réservation future, procédez comme suit :

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

          2. Facultatif : dans le champ Heure de suppression automatique, saisissez une nouvelle date et une nouvelle 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 Submit (Envoyer).

   • Sur la ligne Préfixe, cliquez sur edit Modifier, puis procédez comme suit :

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

     2. Cliquez sur Submit (Envoyer).

   • Sur la ligne Description, cliquez sur edit Modifier, puis procédez comme suit :

     1. Dans le champ Description, saisissez une nouvelle description.

     2. Cliquez sur Submit (Envoyer).

5. Cliquez sur edit Modifier.

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

6. Si vous souhaitez modifier d'autres propriétés, effectuez une ou plusieurs des opérations suivantes :

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

     • L'heure de début ne peut pas être ultérieure à un an à compter de la date et de l'heure auxquelles vous souhaitez envoyer une réservation future.

     • 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 demande après l'avoir envoyée 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 réservation future.

     Vous pouvez sélectionner jusqu'à 100 projets. Ces projets doivent appartenir à la même organisation que le projet dans lequel la réservation future a été créée (le projet propriétaire). Ne spécifiez pas le projet propriétaire. Par défaut, il est déjà autorisé à consommer les réservations partagées créées automatiquement pour cette future réservation.

   • Dans Nombre d'instances de VM saisissez le nombre total de VM que vous souhaitez réserver pour la période, la configuration de VM et le ou les projets spécifiés dans cette réservation future.

     Lors du calcul du nombre de réservations à créer pour une réservation future approuvée, Compute Engine vérifie d'abord les réservations existantes. Si des réservations existantes correspondent à la réservation future approuvée, le nombre de réservations existantes est soustrait du nombre total de réservations demandé dans la requête pour déterminer le nombre de nouvelles réservations que Compute Engine crée. Pour en savoir plus, découvrez comment Compute Engine compte et provisionne les ressources réservées.

   • Dans la section Configuration de la machine, vous pouvez modifier les éléments suivants :

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

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

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

7. Pour envoyer une demande de modification à Google Cloud pour examen, cliquez sur Envoyer.

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

gcloud

Pour demander à Google Cloud de modifier une réservation future approuvée ou en cours d'acquisition créée en spécifiant directement les propriétés, 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_1 \
    --local-ssd=size=375,interface=INTERFACE_2 \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform=MIN_CPU_PLATFORM \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --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 d'une réservation future approuvée ou en cours d'acquisition existante.

• Facultatif. Effectuez l'une des opérations suivantes :

  • Pour ajouter des processeurs graphiques (GPU) à chaque VM réservée, spécifiez 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 type de machine que vous spécifiez dans la réservation future est compatible avec les types de GPU que vous spécifiez et que le GPU est disponible dans la zone où vous souhaitez réserver des ressources. Sinon, vous rencontrerez des erreurs.

  • Pour supprimer tous les GPU de cette requête future, remplacez l'option --accelerator par l'option --clear-accelerator.

• DESCRIPTION : facultatif. Une nouvelle description pour la réservation future.

• Facultatif. Effectuez l'une des opérations suivantes :

  • Pour ajouter ou modifier le type d'interface que les disques SSD locaux doivent utiliser pour chaque VM, remplacez INTERFACE_1 et INTERFACE_2. La valeur doit correspondre à l'un des éléments suivants :

    • Si votre image de disque de démarrage inclut des pilotes optimisés pour NVMe, spécifiez nvme.

    • Sinon, spécifiez scsi.

    La capacité de chaque disque SSD local est de 375 Go. Répétez l'option --local-ssd pour chaque disque SSD local que vous souhaitez ajouter. Vous pouvez spécifier jusqu'à 24 disques SSD locaux.

  • Pour supprimer tous les disques SSD locaux de cette réservation future, supprimez toutes les options --local-ssd et spécifiez l'option --clear-local-ssd.

• MACHINE_TYPE : facultatif. Un type de machine prédéfini ou personnalisé à utiliser pour chaque VM. Avant de spécifier un type de machine personnalisé, examinez les limites applicables aux VM avec des types de machines personnalisés.

• MINIMUM_CPU_PLATFORM : facultatif. Configuration minimale de la plate-forme du processeur à utiliser pour chaque VM. Si vous omettez l'option --min-cpu-platform, sa valeur est définie sur la plate-forme de processeur par défaut de la zone.

• NAME_PREFIX : facultatif. Un nouveau préfixe de nom pour la réservation future. Le nom de chaque réservation créée automatiquement pour cette réservation future commence par le préfixe du nom. Pour vous aider à identifier les réservations créées automatiquement pour cette réservation future, il est recommandé de spécifier un préfixe de nom unique.

• PLANNING_STATUS : état de planification de la réservation future. Vous ne pouvez spécifier que SUBMITTED, qui envoie la réservation future à Google Cloud pour examen.

• PROJECT_ID : facultatif. ID du projet dans lequel la réservation future a été créée. Si vous modifiez une réservation future à un seul projet en une réservation future partagée, ce projet devient le projet propriétaire de la réservation future. Si vous omettez l'option --project, la valeur est définie sur l'ID du projet en cours.

• SHARE_SETTING : facultatif. Pour modifier le type de cette réservation future, spécifiez l'une des valeurs suivantes :

  • Pour modifier une réservation future à un seul projet en une réservation future partagée, spécifiez projects. Veillez à spécifier au moins un projet client à l'aide de l'option --share-with. Sinon, la modification de la requête de réservation future échouera.

  • Sinon, spécifiez local.

• CONSUMER_PROJECT_IDS : facultatif. Liste des ID de projets séparés par une virgule avec lesquels cette réservation future peut être partagée. Par exemple, spécifiez project-1,project-2. Vous pouvez spécifier jusqu'à 100 projets. Ces projets doivent appartenir à la même organisation que le projet dans lequel cette réservation future a été créée (le projet propriétaire). Ne spécifiez pas le projet propriétaire. Par défaut, il est déjà autorisé à consommer les réservations partagées créées automatiquement pour cette future réservation.

• START_TIME : facultatif. Nouvelle heure de début de la période de réservation au format de code temporel RFC 3339, qui doit être comme suit :

  YYYY-MM-DDTHH:MM:SSOFFSET
  

  Remplacez les éléments suivants :

  • YYYY-MM-DD : date respectant la syntaxe année à 4 chiffres, mois à 2 chiffres et jour du mois à 2 chiffres, séparés par des traits d'union (-).

  • HH:MM:SS : heure respectant la syntaxe heures à 2 chiffres sur 24 heures, minutes à 2 chiffres et secondes à 2 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), spécifiez -08:00. Sinon, pour n'utiliser aucun décalage, spécifiez Z.

  L'heure de début ne peut pas être ultérieure à un an à partir de la date et de l'heure auxquelles vous souhaitez envoyer une réservation ultérieure. Pour disposer d'un délai suffisant pour éventuellement annuler, supprimer ou modifier une réservation future après son approbation ou avant son heure de verrouillage ; veillez à spécifier une heure de début recommandée.

• END_TIME : facultatif. Nouvelle heure de fin de la période de réservation, formatée comme 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, où END_DURATION correspond à la durée de la période de réservation 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, veillez à spécifier l'une des valeurs recommandées pour votre période de réservation.

• TOTAL_COUNT : facultatif. Nouveau 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.

  Lors du calcul du nombre de réservations à créer pour une réservation future approuvée, Compute Engine vérifie d'abord les réservations existantes. Si des réservations existantes correspondent à la réservation future approuvée, le nombre de réservations existantes est soustrait du nombre total de réservations demandé dans la requête pour déterminer le nombre de nouvelles réservations que Compute Engine crée. Pour en savoir plus, découvrez comment Compute Engine compte et provisionne les ressources réservées.

  Attention : Si vous souhaitez augmenter le nombre de VM à réserver, assurez-vous de disposer d'un quota suffisant pour les ressources supplémentaires que vous demandez à réserver. Sinon, Google Cloud refuse votre demande de modification.

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

Vous pouvez également modifier si et quand Compute Engine supprime automatiquement les réservations créées automatiquement pour une réservation future en effectuant l'une des opérations suivantes :

• 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), spécifiez l'option --auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations update example-future-reservation \
        --auto-delete-auto-created-reservations
    

  • 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, spécifiez les options --auto-delete-auto-created-reservations et --auto-created-reservations-delete-time.

    gcloud beta compute future-reservations update example-future-reservation \
        --auto-delete-auto-created-reservations \
        --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
    

    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, spécifiez les options --auto-delete-auto-created-reservations et --auto-created-reservations-duration.

    gcloud beta compute future-reservations update example-future-reservation \
        --auto-delete-auto-created-reservations \
        --auto-created-reservations-duration=DURATION_BEFORE_DELETE
    

    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 désactiver Compute Engine afin de supprimer automatiquement les réservations créées automatiquement, spécifiez l'option --no-auto-delete-auto-created-reservations.

  gcloud beta compute future-reservations update example-future-reservation \
      --no-auto-delete-auto-created-reservations
  

Par exemple, considérons une réservation future approuvée nommée fr-05 et située dans la zone us-central1-a. Supposons que vous souhaitiez demander à Google Cloud de modifier cette réservation future en apportant les modifications suivantes :

• Remplacez l'heure de fin de sa période de réservation par minuit du 31 décembre 2023 UTC.

• Réservez 10 VM.

• Spécifiez un nouveau préfixe de nom.

Pour demander à Google Cloud de modifier fr-05, exécutez la commande suivante :

gcloud beta compute future-reservations update fr-05 \
    --end-time=2024-12-31T00:00:00Z \
    --name-prefix=new-prefix \
    --planning-status=SUBMITTED \
    --project=example-project \
    --total-count=10 \
    --zone=us-central1-a

REST

Pour demander à Google Cloud de modifier une réservation future approuvée ou en cours d'acquisition créée en spécifiant directement les propriétés, effectuez une requête PATCH à la méthode beta.futureReservations.update. Dans le paramètre de requête updateMask, spécifiez chaque champ que vous souhaitez mettre à jour. Si vous devez supprimer un champ facultatif de votre réservation, incluez-le dans le paramètre de requête updateMask et omettez-le dans le corps de la requête.

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 réservation future.

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

• FUTURE_RESERVATION_NAME : nom d'une réservation future approuvée ou en cours d'acquisition existante. Vous ne pouvez pas modifier le nom d'une réservation future.

• UPDATE_FIELDS : liste de champs à mettre à jour dans cette requête PATCH, séparés par une virgule. Vous devez encoder chaque virgule en tant que %2C. Par exemple, si vous souhaitez mettre à jour les champs autoDeleteAutoCreatedReservations, totalCount et endTime dans votre réservation ultérieure, spécifiez l'élément suivantes :

  autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
  

• AUTO_DELETE_AUTO_CREATED_RESERVATIONS : facultatif. Si vous définissez ce champ sur true, Compute Engine supprime automatiquement les réservations créées automatiquement pour cette requête de réservation future. Par défaut, l'heure de suppression est comprise 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 à une heure spécifique après l'heure de 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/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime
    
    {
      "autoDeleteAutoCreatedReservations": "true",
      "autoCreatedReservationsDeleteTime": "DELETE_TIME"
    }
    

    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, qui doit être comme suit :

    YYYY-MM-DDTHH:MM:SSOFFSET
    

    Remplacez les éléments suivants :

    • YYYY-MM-DD : date respectant la syntaxe année à 4 chiffres, mois à 2 chiffres et jour du mois à 2 chiffres, séparés par des traits d'union (-).

    • HH:MM:SS : heure respectant la syntaxe heures à 2 chiffres sur 24 heures, minutes à 2 chiffres et secondes à 2 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), spécifiez -08:00. Sinon, pour n'utiliser aucun décalage, spécifiez Z.

  • 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/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration
    
    {
      "autoDeleteAutoCreatedReservations": "true",
      "autoCreatedReservationsDuration": {
        "seconds": "DURATION_BEFORE_DELETE"
      }
    }
    

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

• DESCRIPTION : facultatif. Pour mettre à jour la description de cette réservation future, effectuez l'une des opérations suivantes :

  • Pour ajouter ou mettre à jour une description, spécifiez une description.

  • Pour supprimer la description, supprimez le champ description du corps de la requête et spécifiez-le dans UPDATE_FIELDS.

• NAME_PREFIX : facultatif. Un nouveau préfixe de nom pour la réservation future. Le nom de chaque réservation créée automatiquement pour cette réservation future commence par le préfixe du nom. Pour vous aider à identifier les réservations créées automatiquement pour cette réservation future, il est recommandé de spécifier un préfixe de nom unique.

• PLANNING_STATUS : état de planification de la réservation future. Vous ne pouvez spécifier que SUBMITTED, qui envoie la réservation future à Google Cloud pour examen.

• SHARE_TYPE : facultatif. Pour modifier le type de partage de cette réservation future, spécifiez l'une des valeurs suivantes :

  • Pour modifier une réservation future à un seul projet en une réservation future partagée, spécifiez SPECIFIC_PROJECTS. En outre, vous devez spécifier au moins un projet client dans le champ projects. Sinon, la modification de la réservation future échouera.

  • Sinon, spécifiez LOCAL. De plus, vous devez supprimer le champ projects du corps de la requête et le spécifier dans UPDATE_FIELDS. Sinon, la modification de la réservation future échouera.

• CONSUMER_PROJECT_ID_1 et CONSUMER_PROJECT_ID_2 : facultatifs. Les ID de projet avec lesquels une réservation future partagée peut être partagée. Vous pouvez spécifier jusqu'à 100 projets. Ces projets doivent appartenir à la même organisation que le projet dans lequel la réservation future a été créée (le projet propriétaire). Ne spécifiez pas le projet propriétaire. Par défaut, il est déjà autorisé à consommer les réservations partagées créées automatiquement pour cette future réservation.

• Facultatif. Pour mettre à jour les processeurs graphiques (GPU) associés à chaque VM réservée, effectuez l'une des opérations suivantes :

  • Pour ajouter ou modifier des GPU, spécifiez 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 type de machine que vous spécifiez dans la réservation future est compatible avec les types de GPU que vous spécifiez et que le GPU est disponible dans la zone où vous souhaitez réserver des ressources. Sinon, vous rencontrerez des erreurs.

  • Pour supprimer tous les GPU de cette requête future, omettez le champ guestAccelerators dans le corps de la requête et spécifiez-le dans UPDATE_FIELDS.

• Facultatif. Pour mettre à jour les disques SSD locaux associés à chaque VM réservée, effectuez l'une des opérations suivantes :

  • Pour ajouter ou modifier le type d'interface que les disques SSD locaux doivent utiliser pour chaque VM, remplacez INTERFACE_1 et INTERFACE_2. La valeur doit correspondre à l'un des éléments suivants :

    • Si votre image de disque de démarrage inclut des pilotes optimisés pour NVMe, spécifiez NVME.

    • Sinon, spécifiez SCSI.

    Répétez les champs diskSizeGb et interface pour chaque disque SSD local que vous souhaitez ajouter ou mettre à jour. Vous pouvez spécifier jusqu'à 24 disques SSD locaux.

  • Pour supprimer tous les disques SSD locaux de cette réservation future, supprimez le champ localSsds du corps de la requête et spécifiez-le dans UPDATE_FIELDS.

• MACHINE_TYPE : facultatif. Un type de machine prédéfini ou personnalisé à utiliser pour chaque VM. Avant de spécifier un type de machine personnalisé, examinez les limites applicables aux VM avec des types de machines personnalisés.

• MINIMUM_CPU_PLATFORM : facultatif. Pour mettre à jour la configuration minimale de la plate-forme du processeur à utiliser pour chaque VM, effectuez l'une des opérations suivantes :

  • Pour ajouter ou mettre à jour la configuration minimale de la plate-forme du processeur, spécifiez une configuration minimale.

  • Pour revenir à la plate-forme de processeur par défaut de la zone, supprimez le champ minCpuPlatform du corps de la requête et spécifiez-le dans UPDATE_FIELDS.

• TOTAL_COUNT : facultatif. Nouveau 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.

  Lors du calcul du nombre de réservations à créer pour une réservation future approuvée, Compute Engine vérifie d'abord les réservations existantes. Si des réservations existantes correspondent à la réservation future approuvée, le nombre de réservations existantes est soustrait du nombre total de réservations demandé dans la requête pour déterminer le nombre de nouvelles réservations que Compute Engine crée. Pour en savoir plus, découvrez comment Compute Engine compte et provisionne les ressources réservées.

• START_TIME : facultatif. 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 postérieure d'un an à la date et l'heure auxquelles vous souhaitez envoyer une réservation future. En outre, veillez à spécifier une heure de début recommandée pour vous assurer que vous avez suffisamment de temps avant qu'une réservation future n'entre en heure de verrouillage.

• END_TIME : facultatif. Nouvelle heure de fin de la période de réservation, formatée comme 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 :

  "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, veillez à spécifier l'une des valeurs recommandées pour votre période de réservation.

Par exemple, considérons une réservation future approuvée nommée fr-05 et située dans la zone us-central1-a. Supposons que vous souhaitiez demander à Google Cloud de modifier cette réservation future en apportant les modifications suivantes :

• Remplacez l'heure de fin de sa période de réservation par minuit du 31 décembre 2023 UTC.

• Réservez 10 VM.

• Spécifiez un nouveau préfixe de nom.

Pour demander à Google Cloud de modifier fr-05, envoyez la requête PATCH suivante :

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-05?updateMask=namePrefix%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime

{
  "name": "fr-05",
  "namePrefix": "new-prefix",
  "planningStatus": "SUBMITTED",
  "specificSkuProperties": {
    "totalCount": "10"
  },
  "timeWindow": {
    "endTime": "2023-12-31T00:00:00Z"
  }
}

gcloud

Pour annuler une requête de réservation ultérieure, utilisez la commande gcloud beta compute future-reservations cancel.

gcloud beta compute future-reservations cancel FUTURE_RESERVATION_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

Remplacez les éléments suivants :

• FUTURE_RESERVATION_NAME : nom d'une demande de réservation future existante.

• PROJECT_ID : facultatif. Il s'agit de l'ID du projet dans lequel se trouve la demande de réservation future. Si vous omettez l'option --project, l'ID utilisé sera celui du projet actuel.

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

REST

Pour annuler une requête de réservation future, envoyez une requête POST à la méthode beta.futureReservations.cancel.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME/cancel

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 d'une demande de réservation future existante.

Console

Pour supprimer une demande de réservation future, procédez comme suit :

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. Cochez la case en regard de chaque requête de réservation future que vous souhaitez supprimer.

4. Cliquez sur delete Supprimer la réservation.

5. Pour confirmer l'opération, cliquez sur Supprimer.

   La suppression d'une requête de réservation future peut prendre jusqu'à une minute.

gcloud

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

gcloud beta compute future-reservations delete FUTURE_RESERVATION_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

Remplacez les éléments suivants :

• FUTURE_RESERVATION_NAME : nom d'une demande de réservation future existante.

• PROJECT_ID : facultatif. Il s'agit de l'ID du projet dans lequel se trouve la demande de réservation future. Si vous omettez l'option --project, l'ID utilisé sera celui du projet actuel.

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

REST

Pour supprimer une requête de réservation future, envoyez une requête DELETE à la méthode beta.futureReservations.delete.

DELETE https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME

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 d'une demande de réservation future existante.