Créer des demandes de réservation futures pour un seul projet

Ce document explique comment créer des requêtes de réservation futures à un seul projet.

Si Google Cloud approuve votre requête de réservation future à un seul projet, à l'heure de début spécifiée dans votre requête, Compute Engine crée automatiquement des réservations qui ne peuvent être utilisées que par des instances de VM créées dans le même projet.

Avant de commencer

  • Si vous ne l'avez pas déjà fait, consultez la section Fonctionnement des réservations futures.
  • Pour vous assurer que vous disposez d'un quota suffisant pour les ressources que vous souhaitez réserver, vérifiez votre quota.
  • Si ce n'est pas déjà fait, configurez l'authentification. L'authentification est le processus permettant de valider votre identité pour accéder aux services et aux API Google Cloud. Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine comme suit :

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

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

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

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

Rôles requis

Pour obtenir les autorisations nécessaires pour créer des requêtes de réservations futures à un seul projet, demandez à votre administrateur de vous accorder le rôle IAM Compute Future Reservation User (roles/compute.futureReservationUser) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient les autorisations requises pour créer des requêtes de réservation future à un seul projet. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour créer des requêtes de réservation future à un seul projet :

  • Pour créer une requête de réservation future : compute.futureReservations.create sur le projet
  • Pour permettre à Compute Engine de créer automatiquement des réservations : compute.reservations.create sur le projet
  • Pour spécifier un modèle d'instance : compute.instanceTemplates.useReadOnly sur le modèle d'instance

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

Créer un brouillon de requête

Lorsque vous créez une requête de réservation future, vous pouvez l'enregistrer en tant que brouillon et l'envoyer ultérieurement à Google Cloud pour examen, ou bien l'envoyer directement pour examen. Google vous recommande de créer d'abord un brouillon de requête, car cela vous permet de déterminer le nombre de VM que Compute Engine va provisionner pour votre requête, au lieu d'estimer manuellement ce nombre, et éventuellement de modifier le nombre de VM réservées dans la requête avant de l'envoyer pour examen.

Pour utiliser une réservation créée automatiquement pour une réservation future, une VM doit avoir des propriétés qui correspondent exactement à cette réservation. Pour spécifier les propriétés des VM dont vous souhaitez demander la réservation en créant une requête de réservation future, vous avez le choix parmi les méthodes suivantes :

  • Option recommandée : spécifier un modèle d'instance

    Vous pouvez utiliser un modèle d'instance existant pour définir les propriétés d'une requête de réservation future. En utilisant un modèle d'instance, vous pouvez définir les propriétés d'une réservation future et les VM pouvant utiliser les réservations créées automatiquement au même endroit.

  • Spécifier une VM existante

    Vous pouvez utiliser une VM existante pour définir les propriétés d'une requête de réservation future. En utilisant les propriétés d'une VM existante, vous pouvez utiliser les réservations créées automatiquement qui ont été provisionnées pour la réservation future, en créant des VM dont les propriétés correspondent à la VM de référence.

  • Spécifier les propriétés directement

    Vous pouvez définir directement les propriétés d'une requête de réservation future. Cette méthode nécessite de vous assurer manuellement que les propriétés de vos VM et des réservations créées automatiquement correspondent exactement. Toute propriété non concordante empêche l'utilisation.

Une réservation créée automatiquement pour une réservation future peut être automatiquement utilisée par toutes les VM ayant des propriétés correspondantes. Si vous souhaitez empêcher une VM d'utiliser l'une de ces réservations créées automatiquement, découvrez comment créer des VM sans consommer de réservations.

Spécifier un modèle d'instance

Lorsque vous créez une requête de réservation future en spécifiant un modèle d'instance, tenez compte des points suivants :

  • Vous devez créer votre requête de réservation future dans la même région et la même zone que les ressources du modèle d'instance. Toutes les ressources régionales ou zonales spécifiées dans un modèle d'instance (telles qu'un type de machine ou un Persistent Disk) limitent l'utilisation du modèle aux emplacements où ces ressources se trouvent. Par exemple, si votre modèle d'instance spécifie un disque Persistent Disk existant dans la zone us-central1-a, vous devez créer votre réservation future dans la même zone. Sinon, la création de la requête de réservation future échoue.

    Pour vérifier si un modèle existant spécifie des ressources qui l'associent à une région ou à une zone spécifique, affichez les détails du modèle et recherchez des références à des ressources régionales ou zonales qu'il contient.

  • Si vous souhaitez associer les réservations créées automatiquement et provisionnées pour une réservation future à un engagement, vous devez désactiver l'option de suppression automatique. Pour en savoir plus, consultez la section Restrictions après la création.

Une fois que vous avez créé une requête de réservation future, vous ne pouvez plus la modifier pour remplacer les propriétés de la VM du modèle ni spécifier un autre modèle. À la place, vous devez créer une requête de réservation future.

Pour créer une réservation future pour un projet unique en spécifiant un modèle d'instance existant, 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. Cliquez sur Créer une réservation future.

    La page Créer une réservation future s'ouvre.

  4. Dans le champ Nom, saisissez le nom de la requête de réservation future.

  5. Dans le champ Préfixe, saisissez un préfixe de nom. Le nom de chaque réservation créée automatiquement à partir de cette requête de réservation commence par ce préfixe.

  6. Pour les champs Région et Zone, sélectionnez la région et la zone dans lesquelles vous souhaitez réserver des ressources.

  7. Dans Heure de début, saisissez une heure de début pour la période de réservation. L'heure de début ne peut pas être ultérieure d'un an à la date et heure à laquelle vous envoyez une requête de réservation future pour examen. Pour disposer d'un temps suffisant pour potentiellement modifier, annuler ou supprimer la réservation future avant qu'elle ne bascule dans le délai de verrouillage, spécifiez une valeur recommandée pour l'heure de début.

  8. Dans le champ Heure de fin, saisissez une heure de fin pour la période de réservation. La période de réservation doit durer au moins 24 heures.

    Dans la section Résumé de la durée, vous pouvez voir la durée de la période de réservation. Pour augmenter la probabilité que Google Cloud approuve votre demande de réservation future après l'avoir envoyée pour examen, veillez à spécifier une valeur recommandée pour la période de réservation.

  9. Dans la section Type de partage, sélectionnez Local si ce n'est pas déjà fait.

  10. Pour 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 les projets spécifiés dans cette requête de réservation future.

  11. Dans la section Configuration de la machine, procédez comme suit :

    1. Sélectionnez Utiliser un modèle d'instance.

    2. Dans Modèle d'instance, sélectionnez le modèle d'instance de votre choix. Si vous sélectionnez un modèle d'instance régional, vous ne pouvez réserver que des ressources situées dans la même région que celle du modèle.

  12. Dans la section Heure de suppression automatique des réservations générées automatiquement, 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 définir l'activation, si ce n'est pas déjà fait.

      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.

  13. Pour terminer la création du brouillon de requête de réservation future, cliquez sur Enregistrer le brouillon.

La page Réservations s'affiche. La création de la requête de réservation future peut prendre jusqu'à une minute.

gcloud

Pour créer une requête de réservation future à un seul projet en spécifiant un modèle d'instance, utilisez la commande gcloud beta compute future-reservations create.

Pour créer un brouillon de requête de réservation future en spécifiant un modèle d'instance sans option facultative et supprimer automatiquement la réservation créée automatiquement à la fin de la période de réservation, exécutez la commande suivante :

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Remplacez les éléments suivants :

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

  • MACHINE_TYPE : type de machine à utiliser pour chaque VM réservée.

  • PROJECT_ID : ID du projet dans lequel vous souhaitez réserver des ressources et où se trouve le modèle d'instance.

  • LOCATION : emplacement du modèle d'instance. Spécifiez l'une des valeurs suivantes :

    • Pour un modèle d'instance régional : regions/REGION. Remplacez REGION par la région dans laquelle se trouve le modèle d'instance. Si vous spécifiez un modèle d'instance régional, vous ne pouvez créer la requête de réservation future que dans la même région que celle du modèle.

    • Pour un modèle d'instance global : global

  • INSTANCE_TEMPLATE_NAME : nom d'un modèle d'instance existant.

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

    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 requête de réservation future pour examen. Pour disposer d'un temps suffisant pour annuler, supprimer ou modifier une requête de réservation future après son approbation et avant qu'elle ne soit arrivée, spécifiez une valeur recommandée pour l'heure de début.

  • END_TIME : heure de fin de la période de réservation au format de code temporel RFC 3339. La période de réservation doit durer au moins 24 heures. Vous pouvez également remplacer l'option --end-time par l'option --duration=END_DURATION. Remplacez END_DURATION par la durée de la période de réservation en secondes. Par exemple, spécifiez 1209600 pour 1 209 600 secondes (14 jours).

    Pour augmenter la probabilité que Google Cloud approuve une requête de réservation future après l'avoir envoyée pour examen, spécifiez une durée minimale recommandée.

  • TOTAL_COUNT : nombre total de VM que vous souhaitez réserver.

  • ZONE : la zone dans laquelle vous devez réserver des ressources.

Par exemple, supposons que vous souhaitiez créer un brouillon de requête de réservation future nommée fr-01 dans la zone us-central1-a avec les propriétés suivantes :

  • Une période de réservation qui commence à minuit le 10 novembre 2024 et se termine à minuit le 10 décembre 2024 UTC.

  • Nombre total de VM : 80.

  • Un modèle d'instance régional de la région us-central1
  • L'option de suppression automatique activée. Les réservations créées automatiquement sont supprimées à la fin de la période de réservation.

Pour créer fr-01, exécutez la commande suivante :

gcloud beta compute future-reservations create fr-01 \
    --auto-delete-auto-created-reservations \
    --source-instance-template=projects/example-project/regions/us-central1/instanceTemplates/example-template \
    --start-time=2024-11-10T00:00:00Z \
    --end-time=2024-12-10T00:00:00Z \
    --total-count=80 \
    --zone=us-central1-a

Vous pouvez éventuellement effectuer une ou plusieurs des opérations suivantes :

  • Pour supprimer 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 créées automatiquement à une date et une heure spécifiques après l'heure de fin de la période de réservation, incluez l'option --auto-created-reservations-delete-time.

      gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
    --auto-delete-auto-created-reservations \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

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

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

      gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
    --auto-delete-auto-created-reservations \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

      Remplacez DURATION_BEFORE_DELETE par une durée en jours, heures, minutes ou secondes. Par exemple, spécifiez 30m pour 30 minutes ou 1d2h3m4s pour un jour, deux heures, trois minutes et quatre secondes.

  • Pour désactiver l'option de suppression automatique pour les réservations créées automatiquement, remplacez l'option --auto-delete-auto-created-reservations par l'option --no-auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --no-auto-delete-auto-created-reservations \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

  • Pour spécifier un préfixe de nom pour les réservations créées automatiquement, incluez l'indicateur --name-prefix.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --name-prefix=NAME_PREFIX \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

    Remplacez NAME_PREFIX par le préfixe du nom de chaque réservation créée automatiquement. Pour vous aider à identifier les réservations créées automatiquement pour cette requête de réservation future, Google Cloud vous recommande de spécifier un préfixe de nom unique.

REST

Pour créer une requête de réservation future à un seul projet en spécifiant un modèle d'instance, effectuez une requête POST à la méthode beta.futureReservations.insert.

Pour créer un brouillon de requête de réservation future en spécifiant un modèle d'instance sans champs facultatifs, envoyez une requête POST comme suit :

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

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

Remplacez les éléments suivants :

  • PROJECT_ID : l'ID du projet dans lequel vous souhaitez réserver des ressources et où se trouve le modèle d'instance.

  • ZONE : la zone dans laquelle vous devez réserver des ressources.

  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS : si vous définissez ce champ sur true, Compute Engine supprime automatiquement les réservations créées automatiquement pour cette réservation future dans les deux heures suivant l'heure de fin de la période de réservation. Si vous souhaitez associer vos réservations créées automatiquement à un engagement, définissez ce champ sur false.

  • LOCATION : emplacement du modèle d'instance. Spécifiez l'une des valeurs suivantes :

    • Pour un modèle d'instance régional : regions/REGION. Remplacez REGION par la région dans laquelle se trouve le modèle d'instance. Si vous spécifiez un modèle d'instance régional, vous ne pouvez créer la requête de réservation future que dans la même région que celle du modèle.

    • Pour un modèle d'instance global : global

  • INSTANCE_TEMPLATE_NAME : nom d'un modèle d'instance existant.

  • TOTAL_COUNT : nombre total de VM que vous souhaitez réserver.

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

    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 requête de réservation future pour examen. Pour disposer d'un temps suffisant pour annuler, supprimer ou modifier une requête de réservation future après son approbation et avant qu'elle ne soit arrivée, spécifiez une valeur recommandée pour l'heure de début.

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

    "duration": {
  "seconds": END_DURATION
}

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

    Pour augmenter la probabilité que Google Cloud approuve une demande de réservation future après l'avoir envoyée pour examen, spécifiez l'une des valeurs recommandées pour votre période de réservation.

Par exemple, supposons que vous souhaitiez créer un brouillon de requête de réservation future nommée fr-01 dans la zone us-central1-a avec les propriétés suivantes :

  • Une période de réservation qui commence à minuit le 10 novembre 2024 et se termine à minuit le 10 décembre 2024 UTC.

  • Nombre total de VM : 80.

  • Un modèle d'instance régional de la région us-central1
  • L'option de suppression automatique activée. Les réservations créées automatiquement sont supprimées à la fin de la période de réservation.

Pour créer fr-01, envoyez une requête POST comme suit :

POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations

{
  "autoDeleteAutoCreatedReservations": true,
  "name": "fr-01",
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/example-project/regions/us-central1/instanceTemplates/example-template",
    "totalCount": 80
  },
  "timeWindow": {
    "startTime": "2024-11-10T00:00:00Z",
    "endTime": "2024-12-10T00:00:00Z"
  }
}

Vous pouvez éventuellement effectuer une ou plusieurs des opérations suivantes :

  • Pour spécifier un préfixe de nom pour les réservations créées automatiquement, incluez le champ namePrefix.

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

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

    Remplacez NAME_PREFIX par le préfixe du nom de chaque réservation créée automatiquement. Pour vous aider à identifier les réservations créées automatiquement pour cette requête de réservation future, Google Cloud vous recommande de spécifier un préfixe de nom unique.

  • Pour supprimer 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 créées automatiquement après une période spécifique après la fin de votre période de réservation, définissez autoDeleteAutoCreatedReservations sur true et incluez le champ autoCreatedReservationsDeleteTime.

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

{
  "autoCreatedReservationsDeleteTime": "DELETE_TIME",
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

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

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

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

{
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  },
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

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

Après avoir créé un brouillon de requête de réservation future, vous pouvez déterminer le nombre de VM que Compute Engine va provisionner pour la requête.

Spécifier une VM existante

Vous ne pouvez créer un brouillon de requête de réservation future que sur la base d'une VM existante, située dans la même zone que la VM.

Une fois que la requête de réservation future est approuvée par Google Cloud et qu'elle entre dans sa période de réservation, vous pouvez utiliser ses réservations créées automatiquement en créant des VM dont les propriétés correspondent à la VM de référence. Pour ce faire :

Procédez comme suit pour créer une requête de réservation future pour un projet unique, qui utilise les propriétés d'une VM existante :

  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. Cliquez sur Créer une réservation future.

    La page Créer une réservation future s'ouvre.

  4. Dans le champ Nom, saisissez le nom de la requête de réservation future.

  5. Dans le champ Préfixe, saisissez un préfixe de nom. Le nom de chaque réservation créée automatiquement à partir de cette requête de réservation commence par ce préfixe.

  6. Pour les champs Région et Zone, sélectionnez la région et la zone dans lesquelles vous souhaitez réserver des ressources.

  7. Dans Heure de début, saisissez une heure de début pour la période de réservation. L'heure de début ne peut pas être ultérieure d'un an à la date et heure à laquelle vous envoyez une requête de réservation future pour examen. Pour disposer d'un temps suffisant pour potentiellement modifier, annuler ou supprimer la réservation future avant qu'elle ne bascule dans le délai de verrouillage, spécifiez une valeur recommandée pour l'heure de début.

  8. Dans le champ Heure de fin, saisissez une heure de fin pour la période de réservation. La période de réservation doit durer au moins 24 heures.

    Dans la section Résumé de la durée, vous pouvez voir la durée de la période de réservation. Pour augmenter la probabilité que Google Cloud approuve votre demande de réservation future après l'avoir envoyée pour examen, veillez à spécifier une valeur recommandée pour la période de réservation.

  9. Dans la section Type de partage, procédez comme suit :

    1. Pour spécifier une requête de réservation future partagée, cliquez sur Partagé.

    2. Cliquez sur Ajouter des projets, puis sélectionnez les projets de l'organisation du projet actuel avec lesquels vous souhaitez partager la requête de réservation future. Vous pouvez sélectionner jusqu'à 100 projets.

  10. Pour 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 les projets spécifiés dans cette requête de réservation future.

  11. Dans la section Configuration de la machine, procédez comme suit :

    1. Sélectionnez Utiliser une VM existante.

    2. Pour VM existante, sélectionnez la VM dont vous souhaitez utiliser les propriétés pour créer la réservation.

  12. Dans la section Heure de suppression automatique des réservations générées automatiquement, 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 définir l'activation, si ce n'est pas déjà fait.

      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.

  13. Pour terminer la création du brouillon de requête de réservation future, cliquez sur Enregistrer le brouillon.

La page Réservations s'affiche. La création de la requête de réservation future peut prendre jusqu'à une minute.

Après avoir créé un brouillon de requête de réservation future, vous pouvez déterminer le nombre de VM que Compute Engine va provisionner pour la requête.

Spécifier les propriétés directement

Si vous souhaitez associer les réservations créées automatiquement et provisionnées pour une réservation future à un engagement, vous devez désactiver l'option de suppression automatique. Pour en savoir plus, consultez la section Restrictions après la création.

Pour créer une réservation future pour un projet unique en spécifiant directement les propriétés, 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. Cliquez sur Créer une réservation future.

    La page Créer une réservation future s'ouvre.

  4. Dans le champ Nom, saisissez le nom de la requête de réservation future.

  5. Dans le champ Préfixe, saisissez un préfixe de nom. Le nom de chaque réservation créée automatiquement à partir de cette requête de réservation commence par ce préfixe.

  6. Pour les champs Région et Zone, sélectionnez la région et la zone dans lesquelles vous souhaitez réserver des ressources.

  7. Dans Heure de début, saisissez une heure de début pour la période de réservation. L'heure de début ne peut pas être ultérieure d'un an à la date et heure à laquelle vous envoyez une requête de réservation future pour examen. Pour disposer d'un temps suffisant pour potentiellement modifier, annuler ou supprimer la réservation future avant qu'elle ne bascule dans le délai de verrouillage, spécifiez une valeur recommandée pour l'heure de début.

  8. Dans le champ Heure de fin, saisissez une heure de fin pour la période de réservation. La période de réservation doit durer au moins 24 heures.

    Dans la section Résumé de la durée, vous pouvez voir la durée de la période de réservation. Pour augmenter la probabilité que Google Cloud approuve votre demande de réservation future après l'avoir envoyée pour examen, veillez à spécifier une valeur recommandée pour la période de réservation.

  9. Dans la section Type de partage, sélectionnez Local si ce n'est pas déjà fait.

  10. Pour 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 les projets spécifiés dans cette requête de réservation future.

  11. Dans la section Configuration de la machine, procédez comme suit :

    1. Sélectionnez Spécifier un type de machine, si ce n'est pas déjà fait.

    2. Spécifiez le type de machine à utiliser pour les VM réservées.

  12. Dans la section Heure de suppression automatique des réservations générées automatiquement, 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 définir l'activation, si ce n'est pas déjà fait.

      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.

  13. Pour terminer la création du brouillon de requête de réservation future, cliquez sur Enregistrer le brouillon.

La page Réservations s'affiche. La création de la requête de réservation future peut prendre jusqu'à une minute.

gcloud

Pour créer une requête de réservation future à un seul projet en spécifiant directement des propriétés, utilisez la commande gcloud beta compute future-reservations create.

Pour créer un brouillon de requête de réservation future en spécifiant directement les propriétés, sans inclure d'options facultatives, et supprimer automatiquement la réservation créée automatiquement à la fin de la période de réservation, exécutez la commande suivante :

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Remplacez les éléments suivants :

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

  • MACHINE_TYPE : type de machine à utiliser pour chaque VM réservée.

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

    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 requête de réservation future pour examen. Pour disposer d'un temps suffisant pour annuler, supprimer ou modifier une requête de réservation future après son approbation et avant qu'elle ne soit arrivée, spécifiez une valeur recommandée pour l'heure de début.

  • END_TIME : heure de fin de la période de réservation au format de code temporel RFC 3339. La période de réservation doit durer au moins 24 heures. Vous pouvez également remplacer l'option --end-time par l'option --duration=END_DURATION. Remplacez END_DURATION par la durée de la période de réservation en secondes. Par exemple, spécifiez 1209600 pour 1 209 600 secondes (14 jours).

    Pour augmenter la probabilité que Google Cloud approuve une requête de réservation future après l'avoir envoyée pour examen, spécifiez une durée minimale recommandée.

  • TOTAL_COUNT : nombre total de VM que vous souhaitez réserver.

  • ZONE : la zone dans laquelle vous devez réserver des ressources.

Par exemple, supposons que vous souhaitiez créer un brouillon de requête de réservation future nommée fr-01 dans la zone us-central1-a avec les propriétés suivantes :

  • Une période de réservation qui commence à minuit le 10 novembre 2024 et se termine à minuit le 10 décembre 2024 UTC.

  • Nombre total de VM : 80.

  • Type de machine prédéfini N2 doté de quatre processeurs virtuels.
  • L'option de suppression automatique activée. Les réservations créées automatiquement sont supprimées à la fin de la période de réservation.

Pour créer fr-01, exécutez la commande suivante :

gcloud beta compute future-reservations create fr-01 \
    --auto-delete-auto-created-reservations \
    --machine-type=n2-standard-4 \
    --start-time=2024-11-10T00:00:00Z \
    --end-time=2024-12-10T00:00:00Z \
    --total-count=80 \
    --zone=us-central1-a

Vous pouvez éventuellement effectuer une ou plusieurs des opérations suivantes :

  • Pour associer des GPU à vos VM N1 réservées, incluez l'option --accelerator.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --accelerator=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

    Remplacez les éléments suivants :

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

    • ACCELERATOR_TYPE : modèle de GPU compatible avec les VM N1. Pour éviter les erreurs, assurez-vous que le modèle de GPU choisi est disponible dans la zone dans laquelle vous créez la requête de réservation future.

  • Pour supprimer 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 créées automatiquement à une date et une heure spécifiques après l'heure de fin de la période de réservation, incluez l'option --auto-created-reservations-delete-time.

      gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

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

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

      gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

      Remplacez DURATION_BEFORE_DELETE par une durée en jours, heures, minutes ou secondes. Par exemple, spécifiez 30m pour 30 minutes ou 1d2h3m4s pour un jour, deux heures, trois minutes et quatre secondes.

  • Pour désactiver l'option de suppression automatique pour les réservations créées automatiquement, remplacez l'option --auto-delete-auto-created-reservations par l'option --no-auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --no-auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

  • Pour ajouter un ou plusieurs disques SSD locaux à chaque VM réservée, incluez une ou plusieurs options --local-ssd. Vous pouvez spécifier jusqu'à 24 disques SSD locaux. La capacité de chaque disque SSD local est de 375 Go.

    Par exemple, pour spécifier deux disques SSD locaux lors de la création d'un brouillon de requête de réservation future, incluez deux options --local-ssd comme suit :

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --local-ssd=size=375,interface=INTERFACE_1 \
    --local-ssd=size=375,interface=INTERFACE_2 \
    --machine-type=MACHINE_TYPE \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

    Remplacez INTERFACE_1 et INTERFACE_2 par le type d'interface que le disque SSD local doit utiliser comme suit :

    Assurez-vous que le type de machine que vous spécifiez pour les VM réservées est compatible avec les interfaces de disque choisies. Sinon, la création de la requête de réservation future échoue. Pour en savoir plus, découvrez comment choisir une interface de disque.

  • Pour que les VM réservées utilisent une plate-forme CPU minimale spécifique au lieu de la plate-forme CPU par défaut de la zone, incluez l'option --min-cpu-platform.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform="MIN_CPU_PLATFORM" \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

    Remplacez MIN_CPU_PLATFORM par une plate-forme CPU minimale. Pour vous assurer qu'une plate-forme CPU est disponible dans la zone où vous réservez des ressources, affichez les plates-formes CPU disponibles par zone.

  • Pour spécifier un préfixe de nom pour les réservations créées automatiquement, incluez l'indicateur --name-prefix.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --name-prefix=NAME_PREFIX \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

    Remplacez NAME_PREFIX par le préfixe du nom de chaque réservation créée automatiquement. Pour vous aider à identifier les réservations créées automatiquement pour cette requête de réservation future, Google Cloud vous recommande de spécifier un préfixe de nom unique.

REST

Pour créer une requête de réservation future à un seul projet en spécifiant directement les propriétés, envoyez une requête POST à la méthode beta.futureReservations.insert.

Pour créer une requête de réservation future brouillon en spécifiant directement les propriétés sans inclure de champs facultatifs, effectuez une requête POST comme suit :

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

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet dans lequel vous souhaitez réserver des ressources.

  • ZONE : la zone dans laquelle vous devez réserver des ressources.

  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS : si vous définissez ce champ sur true, Compute Engine supprime automatiquement les réservations créées automatiquement pour cette réservation future dans les deux heures suivant l'heure de fin de la période de réservation. Si vous souhaitez associer vos réservations créées automatiquement à un engagement, définissez ce champ sur false.

  • TOTAL_COUNT : nombre total de VM que vous souhaitez réserver.

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

    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 requête de réservation future pour examen. Pour disposer d'un temps suffisant pour annuler, supprimer ou modifier une requête de réservation future après son approbation et avant qu'elle ne soit arrivée, spécifiez une valeur recommandée pour l'heure de début.

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

    "duration": {
  "seconds": END_DURATION
}

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

    Pour augmenter la probabilité que Google Cloud approuve une demande de réservation future après l'avoir envoyée pour examen, spécifiez l'une des valeurs recommandées pour votre période de réservation.

Par exemple, supposons que vous souhaitiez créer un brouillon de requête de réservation future nommée fr-01 dans la zone us-central1-a avec les propriétés suivantes :

  • Une période de réservation qui commence à minuit le 10 novembre 2024 et se termine à minuit le 10 décembre 2024 UTC.

  • Nombre total de VM : 80.

  • Type de machine prédéfini N2 doté de quatre processeurs virtuels.
  • L'option de suppression automatique activée. Les réservations créées automatiquement sont supprimées à la fin de la période de réservation.

Pour créer fr-01, envoyez une requête POST comme suit :

POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations

{
  "autoDeleteAutoCreatedReservations": true,
  "name": "fr-01",
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "n2-standard-4"
    },
    "totalCount": 80
  },
  "timeWindow": {
    "startTime": "2024-11-10T00:00:00Z",
    "endTime": "2024-12-10T00:00:00Z"
  }
}

Vous pouvez éventuellement effectuer une ou plusieurs des opérations suivantes :

  • Pour spécifier un préfixe de nom pour les réservations créées automatiquement, incluez le champ namePrefix.

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

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

    Remplacez NAME_PREFIX par le préfixe du nom de chaque réservation créée automatiquement. Pour vous aider à identifier les réservations créées automatiquement pour cette requête de réservation future, Google Cloud vous recommande de spécifier un préfixe de nom unique.

  • Pour associer des GPU à vos VM N1 réservées, incluez le champ guestAccelerators.

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

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "specificSkuProperties": {
    "instanceProperties": {
      "guestAccelerators": [
        {
          "acceleratorCount": NUMBER_OF_ACCELERATORS,
          "acceleratorType": "ACCELERATOR_TYPE"
        }
      ],
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

    Remplacez les éléments suivants :

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

    • ACCELERATOR_TYPE : modèle de GPU compatible avec les VM N1. Pour éviter les erreurs, assurez-vous que le modèle de GPU choisi est disponible dans la zone dans laquelle vous créez la requête de réservation future.

  • Pour ajouter un ou plusieurs disques SSD locaux à chaque VM réservée, incluez le champ localSsds. Vous pouvez spécifier jusqu'à 24 disques SSD locaux. La capacité de chaque disque SSD local est de 375 Go.

    Par exemple, pour spécifier deux disques SSD locaux lors de la création d'un brouillon de requête de réservation future, envoyez une requête POST comme suit :

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

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "specificSkuProperties": {
    "instanceProperties": {
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_1"
        },
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_2"
        }
      ],
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

    Remplacez INTERFACE_1 et INTERFACE_2 par le type d'interface que le disque SSD local doit utiliser :

    Assurez-vous que le type de machine que vous spécifiez pour les VM réservées est compatible avec les interfaces de disque choisies. Sinon, la création de la requête de réservation future échoue. Pour en savoir plus, découvrez comment choisir une interface de disque.

  • Pour que les VM réservées utilisent une plate-forme CPU minimale spécifique au lieu de la plate-forme CPU par défaut de la zone, incluez l'option minCpuPlatform.

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

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "specificSkuProperties": {
    "instanceProperties": {
      "machineType": "MACHINE_TYPE",
      "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

    Remplacez MIN_CPU_PLATFORM par une plate-forme CPU minimale. Pour vous assurer qu'une plate-forme CPU est disponible dans la zone où vous réservez des ressources, affichez les plates-formes CPU disponibles par zone.

  • Pour supprimer 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 créées automatiquement après une période spécifique après la fin de votre période de réservation, définissez autoDeleteAutoCreatedReservations sur true et incluez le champ autoCreatedReservationsDeleteTime.

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

{
  "autoCreatedReservationsDeleteTime": "DELETE_TIME",
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

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

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

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

{
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  },
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

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

Après avoir créé un brouillon de requête de réservation future, vous pouvez déterminer le nombre de VM que Compute Engine va provisionner pour la requête.

Envoyer un brouillon de requête

Une fois qu'une requête de réservation future a été envoyée, approuvée par Google Cloud et dont le délai de verrouillage est passé, vous ne pouvez supprimer la réservation future et ses réservations créées automatiquement qu'à l'issue de la période de réservation de la réservation future. Il est judicieux de supprimer une réservation future existante est utile si vous devez créer une autre réservation future avec les mêmes propriétés. Par conséquent, avant de créer une requête de réservation future, vérifiez les points suivants :

  • Toutes les réservations existantes ou futures d'un projet limitent les paramètres de partage des requêtes de réservation futures que vous pouvez créer. Pour vous assurer que vous pouvez créer une requête de réservation future et que celle-ci ne pose aucun problème dans les autres projets avec lesquels vous partagez des réservations ou des requêtes de réservations futures, consultez la section Restrictions.

  • Vous devez vous engager à payer pour les ressources réservées qui ont été provisionnées par Compute Engine pendant toute la période de réservation, que les réservations créées automatiquement aient été utilisées ou non. Pour en savoir plus, consultez Facturation.

Si vous souhaitez modifier une ou plusieurs propriétés lors de l'envoi du brouillon de requête de réservation future pour examen, consultez plutôt la section Modifier les requêtes de réservation future.

Pour envoyer un brouillon de requête de réservation future à Google Cloud pour examen, choisissez parmi l'une des méthodes 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 d'une requête de réservation future dont l'état d'achat est défini sur Brouillon.

    La page Réservations futures s'affiche, avec les détails de la demande de réservation future.

  4. Cliquez sur Modifier le brouillon.

    La page permettant de modifier le brouillon de la requête de réservation future s'affiche.

  5. Pour envoyer le brouillon de requête de réservation future pour examen, cliquez sur Envoyer.

La page Réservation s'affiche. Dans la colonne État de la requête de réservation future que vous venez d'envoyer, l'état d'achat est défini sur En attente d'approbation.

gcloud

Pour envoyer une requête de réservation future à des fins d'examen, utilisez la commande gcloud beta compute future-reservations update avec l'option --planning-status définie sur SUBMITTED.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --planning-status=SUBMITTED \
    --zone=ZONE

Remplacez les éléments suivants :

  • FUTURE_RESERVATION_NAME : nom d'une requête de réservation future brouillon existante.

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

REST

Pour envoyer une requête de réservation future brouillon pour examen, envoyez une requête PATCH à la méthode beta.futureReservations.update. Dans le corps de la requête, incluez le champ planningStatus et définissez-le sur SUBMITTED.

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

{
  "name": "FUTURE_RESERVATION_NAME",
  "planningStatus": "SUBMITTED"
}

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 requête de réservation future brouillon existante.

Après avoir envoyé un brouillon de requête de réservation future pour examen, vous pouvez effectuer les opérations suivantes :

Résoudre les problèmes

Si vous rencontrez des erreurs lors de la création 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 technique ou l'équipe commerciale.

Étapes suivantes