Modifier les requêtes de réservation future (original) (raw)

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

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

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

Avant de commencer

REST

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

Installez la Google Cloud CLI.

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

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

Rôles requis

Pour obtenir l'autorisation nécessaire pour modifier les futures demandes de réservation, demandez à votre administrateur de vous accorder sur le projet le rôle IAM Administrateur des réservations futures Compute (roles/compute.futureReservationAdmin). Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient l'autorisation compute.futureReservations.update, qui est requise pour modifier les demandes de réservation future.

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

Propriétés modifiables

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

Après la création

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

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

Avant la soumission

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

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

Après approbation

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

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

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

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

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

Console

  1. Dans la console Google Cloud , accédez à la page Réservations.
    Accéder à la page "Réservations"
  2. Cliquez sur l'onglet Réservations futures.
  3. Dans la colonne Nom, cliquez sur le nom de la requête de réservation future à modifier.
    La page d'informations de la requête de réservation future sélectionnée s'affiche.
  4. Si vous souhaitez modifier l'option de suppression automatique, la description ou le préfixe du nom d'une réservation future approuvée, effectuez l'une ou plusieurs des opérations suivantes :
    • Pour modifier l'option de suppression automatique, sur la ligne Heure de suppression automatique des réservations créées, cliquez sur Modifier, puis procédez comme suit :
      1. Indiquez si vous souhaitez activer, désactiver ou modifier l'option de suppression automatique en procédant comme suit :
      * Pour activer l'option de suppression automatique ou modifier l'heure à laquelle Compute Engine supprime automatiquement les réservations créées automatiquement, procédez comme suit :
      1. Cliquez sur le bouton Activer la suppression automatique pour l'activer.
      2. Facultatif : Pour l'Heure de suppression automatique, saisissez une date et une heure à laquelle supprimer les réservations créées automatiquement. La date et l'heure doivent être postérieures à l'heure de fin de la période de réservation. Si vous laissez ce champ vide, les réservations créées automatiquement sont supprimées dans les deux heures suivant l'heure de fin de la période de réservation.
      * Sinon, cliquez sur le bouton Activer la suppression automatique pour le désactiver.
      2. Cliquez sur Envoyer.
    • Pour modifier le préfixe du nom, sur la ligne Préfixe, cliquez sur Modifier, puis procédez comme suit :
      1. Dans le champ Préfixe, saisissez un préfixe de nom.
      2. Cliquez sur Envoyer.
    • Pour modifier la description, sur la ligne Description, cliquez sur Modifier, puis procédez comme suit :
      1. Dans le champ Description, saisissez une description.
      2. Cliquez sur Envoyer.
  5. Cliquez sur Modifier ou sur Modifier le brouillon.
    La page permettant de modifier la future demande de réservation future sélectionnée s'affiche.
  6. Pour modifier une demande de réservation future et l'envoyer àGoogle Cloud pour examen, ou enregistrer le brouillon de la demande, procédez comme suit :
    • Dans le champ Préfixe, saisissez un nouveau préfixe de nom pour les réservations créées automatiquement provisionnées pour cette requête de réservation future.
    • Dans le champ Description, saisissez une description.
    • Modifiez l'heure de début ou l'heure de fin de votre demande de réservation future. Assurez-vous que :
      * L'heure de début ne peut pas être ultérieure d'un an à la date et heure à laquelle vous envoyez une demande de réservation future pour examen.
      * Spécifiez une valeur recommandée pour l'heure de début afin de vous assurer que vous avez suffisamment de temps avant que votre réservation future n'entre en heure de verrouillage.
      * Spécifiez une période de réservation minimale recommandée pour augmenter la probabilité que Google Cloud approuve votre requête après son envoi pour examen.
    • Dans la section Type de partage, vous pouvez sélectionner Local ou Partagé. Si vous sélectionnez Partagé, vous pouvez ajouter ou supprimer des projets avec lesquels partager la requête de réservation future. Vous pouvez inclure jusqu'à 100 projets.
    • Pour Nombre d'instances de VM, saisissez le nombre total de VM que vous souhaitez réserver.
    • Si vous modifiez une réservation future qui n'a pas été créée à l'aide d'un modèle d'instance, vous pouvez modifier les éléments suivants dans la section Configuration de la machine :
      * Série et type de machine utilisés dans les VM réservées.
      * GPU à associer aux VM réservées.
      * Les disques SSD locaux et le type d'interface de disque des VM réservées.
    • Dans la section Suppression automatique des réservations générées automatiquement, vous pouvez activer ou désactiver la suppression automatique des réservations créées automatiquement pour votre demande de réservation future.
  7. Selon l'état d'approvisionnement de la requête de réservation future que vous modifiez, effectuez l'une des opérations suivantes :
    • Si vous modifiez un brouillon de requête de réservation future, procédez comme suit :
      * Pour enregistrer vos modifications, cliquez sur Enregistrer le brouillon.
      * Pour envoyer la demande de réservation future brouillon àGoogle Cloud pour examen, cliquez sur Envoyer.
    • Sinon, cliquez sur Envoyer.

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

gcloud

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

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

Remplacez les éléments suivants :

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

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

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 :

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

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

REST

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

PATCH https://compute.googleapis.com/compute/v1/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 :

autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime

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

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

Remplacez END_DURATION par une durée en secondes. Par exemple, spécifiez 1209600 pour 1 209 600 secondes (14 jours).
.

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 :

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

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

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

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

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

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

  1. Pour empêcher la requête de réservation future de restreindre le type de requête de réservation future que vous pouvez créer dans votre projet ou dans les projets avec lesquels la demande de réservation future est partagée, supprimez la demande de réservation future.
  2. Créez une requête de réservation à un seul projet ou une requête de réservation future partagée avec les mises à jour souhaitées.

Résoudre les problèmes

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

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

Étapes suivantes