Créer des demandes de réservations futures partagées


Ce document explique comment créer des demandes de réservation futures partagées.

Si Google Cloud approuve votre requête de réservation future partagée, à l'heure de début spécifiée dans votre requête, Compute Engine crée automatiquement des réservations qui sont partagées sur plusieurs projets. Ces réservations partagées créées automatiquement sont utilisées par les VM correspondantes et les réservations existantes dans le projet qui héberge la réservation future (projet propriétaire) et les projets avec lesquels la réservation future est partagée (projets clients). Pour en savoir plus sur le fonctionnement et l'utilisation des réservations partagées créées automatiquement, consultez la section Créer des réservations partagées.

Avant de commencer

  • Si ce n'est pas déjà fait :
  • 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 :

    Sélectionnez l'onglet correspondant à la façon dont vous prévoyez d'utiliser les exemples de cette page :

    Console

    Lorsque vous utilisez la console Google Cloud pour accéder aux services et aux API Google Cloud, vous n'avez pas besoin de configurer l'authentification.

    gcloud

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

      gcloud init
    2. Définissez une région et une zone par défaut.

    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

Rôles requis

Pour obtenir les autorisations nécessaires pour créer des requêtes de réservation futures partagées, demandez à votre administrateur de vous accorder le rôle IAM d'utilisateur des réservations Compute futures (roles/compute.futureReservationUser) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

Ce rôle prédéfini contient les autorisations requises pour créer des demandes de réservation futures partagées. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Vous devez disposer des autorisations suivantes pour créer des demandes de réservation futures partagées :

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

Restrictions

Outre les restrictions générales relatives aux réservations futures, la création de demandes de réservation futures partagées présente les restrictions suivantes :

  • Le projet que vous utilisez pour créer des requêtes de réservation futures partagées (le projet propriétaire) doit être ajouté à la liste d'autorisation pour la contrainte de règle d'administration Projets propriétaires de réservations partagées (compute.sharedReservationsOwnerProjects) par un administrateur des règles d'administration. Pour en savoir plus, consultez la section Autoriser et restreindre la création et la modification de réservations partagées pour des projets dans la documentation concernant les réservations Compute Engine.

  • Si vous déplacez un projet qui a créé une requête de réservation future partagée vers une autre organisation, la réservation future partagée est supprimée. Le projet n'est pas automatiquement supprimé de la contrainte de règle d'administration Projets de propriétaires de réservations partagées (compute.sharedReservationsOwnerProjects), mais vous pouvez supprimer le projet de cette contrainte si vous le souhaitez.

  • Chaque demande de réservation future peut être partagée avec un maximum de 100 projets clients.

  • Pour chaque organisation, vous pouvez créer jusqu'à 100 requêtes de réservation futures partagées pour chaque combinaison unique de propriétés de VM.

Créer une demande de réservation future partagée

Cette section explique comment créer une demande de réservation future partagée.

Une fois que vous avez créé une requête de réservation future partagée, celle-ci ne peut être annulée, supprimée ou modifiée que par le projet propriétaire. Toutefois, les réservations créées automatiquement peuvent être utilisées par le projet propriétaire et tout projet client avec lequel la requête de réservation future partagée est partagée.

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 que vous souhaitez demander à réserver en créant une requête de réservation future, sélectionnez l'une des méthodes suivantes :

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

    Cette section explique comment utiliser un modèle d'instance existant pour définir les propriétés d'une requête de réservation future partagée. En utilisant un modèle d'instance, vous pouvez définir les propriétés d'une requête de réservation future et les VM pouvant consommer les réservations créées automatiquement au même endroit. Toutefois, comme les modèles sont spécifiques à un projet, 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 ayant créé la requête de réservation future. Pour les projets avec lesquels la réservation future est partagée, vous devez créer des modèles similaires dans ces projets ou créer des VM en spécifiant directement les propriétés.

  • Spécifier les propriétés directement

    Cette section explique comment définir directement les propriétés d'une requête de réservation future partagée. 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 éviter qu'une VM utilise 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

Vous pouvez créer une réservation future partagée en spécifiant un modèle d'instance existant à l'aide de la console Google Cloud, de la gcloud CLI et de REST.

Console

Pour créer une requête de réservation future partagé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. 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.

    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.

  6. Facultatif : Dans le champ Description, saisissez une description de votre requête de réservation future.

  7. Dans le champ Région, sélectionnez la région dans laquelle vous souhaitez réserver des ressources.

  8. Dans le champ Zone, sélectionnez la zone dans laquelle vous souhaitez réserver des ressources.

  9. Dans le champ 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 demande de réservation future pour examen.

    Veillez à spécifier 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.

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

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

    1. Pour spécifier une demande 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. Ne sélectionnez pas le projet actuel. Par défaut, il est déjà autorisé à utiliser les réservations créées automatiquement pour cette requête de réservation future.

  12. Dans le champ 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 nouvelles réservations à créer pour une requête de réservation futures approuvée peu de temps avant l'heure de début, Compute Engine soustrait toutes les réservations existantes qui correspondent à la requête de ce total. Pour en savoir plus, découvrez comment Compute Engine compte et provisionne les ressources réservées.

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

    1. Pour spécifier les propriétés de vos VM à partir d'un modèle d'instance existant, sélectionnez Utiliser un modèle d'instance.

    2. Dans le champ 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 se trouvant dans la même région que le modèle d'instance.

  14. 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 l'activer (par défaut).

      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.

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

    • Pour créer une demande de réservation future et l'envoyer pour examen à Google Cloud, cliquez sur Envoyer.

    • Pour créer une demande de réservation future brouillon, cliquez sur Enregistrer le brouillon.

    • Pour quitter sans enregistrer, cliquez sur Annuler.

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 demande de réservation future partagée en spécifiant un modèle d'instance, utilisez la commande gcloud beta compute future-reservations create avec --source-instance-template.

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --description="DESCRIPTION" \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --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 à créer.
  • DESCRIPTION : facultatif. Description de la requête de réservation future.
  • NAME_PREFIX : préfixe du nom de 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 : facultatif. État de planification de la requête de réservation future, qui doit être l'un des suivants :

    • Pour créer le brouillon d'une requête de réservation future, spécifiez DRAFT.

    • Pour créer la requête de réservation future et la soumettre pour approbation à Google Cloud, spécifiez SUBMITTED.

    Si vous omettez l'option --planning-status, sa valeur est définie sur DRAFT.

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

  • CONSUMER_PROJECT_IDS : liste des identifiants des projets avec lesquels cette requête de réservation future peut être partagée, séparés par une virgule. 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 requête de réservation future est créée (le projet propriétaire). N'incluez pas le projet propriétaire. Par défaut, il est déjà autorisé à utiliser les réservations créées automatiquement pour cette requête de réservation future.
  • LOCATION : emplacement du modèle d'instance. Spécifiez l'une des valeurs suivantes :

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

    • 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 réserver que des VM se trouvant dans la même région que le modèle d'instance.

  • INSTANCE_TEMPLATE_NAME : nom d'un modèle d'instance existant. Si vous spécifiez un modèle d'instance, vous ne pouvez pas remplacer ses propriétés lors de la création de la requête de réservation future. Sinon, vous rencontrerez des erreurs.

  • START_TIME : heure de début de la période de réservation au format de code temporel RFC 3339, qui doit être le 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 demande de réservation future pour examen. Pour disposer d'un temps suffisant pour annuler, supprimer ou modifier une demande de réservation future après son approbation ou avant qu'elle ne soit arrivée, vérifiez que vous 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, 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 : 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.

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

Lorsque vous spécifiez l'option --auto-delete-auto-created-reservations, Compute Engine supprime automatiquement les réservations créées automatiquement pour votre 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. Vous pouvez éventuellement modifier ce paramètre en effectuant l'une 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 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 create 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 create 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. Vous devez désactiver l'option de suppression automatique si vous souhaitez associer votre réservation créée automatiquement à un engagement.

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

Par exemple, la commande suivante crée un brouillon de requête de réservation future basé sur le modèle d'instance global example-template pour 80 VM. La requête de réservation future est partagée avec project-1 et project-2. La période de réservation commence à minuit le 10 novembre 2023 et se termine à minuit le 10 décembre 2023 UTC. Les réservations créées automatiquement pour la réservation future sont créées dans la zone us-central1-a, portent un nom commençant par fr-02-reservation et sont automatiquement supprimées le 13 décembre 2023 à minuit, UTC.

gcloud beta compute future-reservations create fr-02 \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-delete-time=2023-12-13T00:00:00Z \
    --name-prefix=fr-02-reservation \
    --planning-status=DRAFT \
    --project=example-project \
    --share-setting=projects \
    --share-with=project-1,project-2 \
    --source-instance-template=projects/example-project/global/instanceTemplates/example-template \
    --start-time=2023-11-10T00:00:00Z \
    --end-time=2023-12-10T00:00:00Z \
    --total-count=80 \
    --zone=us-central1-a

REST

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

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

{
  "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": "SPECIFIC_PROJECTS"
  },
  "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 : 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 souhaitez 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 requête de réservation future, qu'elles soient entièrement utilisées ou non. Définissez ce champ sur false si vous souhaitez associer votre réservation créée automatiquement à un engagement.

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

      POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDeleteTime": "DELETE_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, 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 fuseau horaire UTC (temps universel coordonné). Par exemple, pour utiliser le fuseau horaire PST (heure normale du Pacifique), 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.

      POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations
      
      {
        "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. Description de la requête de réservation future.

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

  • NAME_PREFIX : préfixe du nom de 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.

  • CONSUMER_PROJECT_ID_1 et CONSUMER_PROJECT_ID_2 : ID des projets avec lesquels cette requête de réservation future 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 requête de réservation future est créée (le projet propriétaire). N'incluez pas le projet propriétaire. Par défaut, il est déjà autorisé à utiliser les réservations créées automatiquement pour cette requête de réservation future.
  • PLANNING_STATUS : facultatif. État de planification de la requête de réservation future, qui doit être l'un des suivants :

    • Pour créer le brouillon d'une requête de réservation future, spécifiez DRAFT.

    • Pour créer la requête de réservation future et la soumettre pour approbation à Google Cloud, spécifiez SUBMITTED.

    Si vous omettez le champ planningStatus, sa valeur est définie sur DRAFT.

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

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

    • 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 réserver que des VM se trouvant dans la même région que le modèle d'instance.

  • INSTANCE_TEMPLATE_NAME : nom d'un modèle d'instance existant. Si vous spécifiez un modèle d'instance, vous ne pouvez pas remplacer ses propriétés lors de la création de la requête de réservation future. Sinon, vous rencontrerez des erreurs.

  • TOTAL_COUNT : nombre total de VM que vous souhaitez réserver pour la période, la configuration de VM et les projets spécifiés dans cette requête de réservation future.

    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 : heure de début de la période de réservation au format de code temporel RFC 3339. 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 demande de réservation future. En outre, veillez à spécifier une valeur recommandée pour l'heure de début afin de vous assurer que vous avez suffisamment de temps avant qu'une réservation future n'entre en heure de verrouillage.

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

Par exemple, la commande suivante crée une requête de réservation future brouillon basée sur le modèle d'instance global example-template pour 80 VM. La requête de réservation future est partagée avec project-1 et project-2. La période de réservation commence à minuit le 10 novembre 2023 et se termine à minuit le 10 décembre 2023 UTC. Les réservations créées automatiquement pour la réservation future sont créées dans la zone us-central1-a, portent un nom commençant par fr-02-reservation et sont automatiquement supprimées le 13 décembre 2023 à minuit, UTC.

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

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDeleteTime": "2023-12-13T00:00:00Z",
  "name": "fr-02",
  "namePrefix": "fr-02-reservation",
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/example-project/global/instanceTemplates/example-template",
    "totalCount": "80"
  },
  "planningStatus": "DRAFT",
  "shareSettings": {
    "projects": [
      "project-1",
      "project-2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "timeWindow": {
    "startTime": "2023-11-10T00:00:00Z",
    "endTime": "2023-12-10T00:00:00Z"
  }
}

Spécifier les propriétés de la VM directement

Vous pouvez créer une requête de réservation future partagée en spécifiant les propriétés directement à l'aide de la console Google Cloud, de la gcloud CLI et de REST.

Console

Pour créer une requête de réservation future partagée en spécifiant directement les 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. 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.

    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.

  6. Facultatif : Dans le champ Description, saisissez une description de votre requête de réservation future.

  7. Dans le champ Région, sélectionnez la région dans laquelle vous souhaitez réserver des ressources.

  8. Dans le champ Zone, sélectionnez la zone dans laquelle vous souhaitez réserver des ressources.

  9. Dans le champ 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 demande de réservation future pour examen.

    Veillez à spécifier 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.

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

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

    1. Pour spécifier une demande 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. Ne sélectionnez pas le projet actuel. Par défaut, il est déjà autorisé à utiliser les réservations créées automatiquement pour cette requête de réservation future.

  12. Dans le champ 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 nouvelles réservations à créer pour une requête de réservation futures approuvée peu de temps avant l'heure de début, Compute Engine soustrait toutes les réservations existantes qui correspondent à la requête de ce total. Pour en savoir plus, découvrez comment Compute Engine compte et provisionne les ressources réservées.

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

    1. Sélectionnez Spécifier un type de machine (par défaut).

    2. Sélectionnez l'une des options suivantes :

      • Pour les charges de travail courantes, sélectionnez l'onglet Usage général (par défaut).

      • Pour les charges de travail exigeantes en performances, sélectionnez l'onglet Optimisé pour le calcul.

      • Pour les charges de travail nécessitant des ratios mémoire/vCPU élevés, sélectionnez l'onglet À mémoire optimisée.

      • Pour les charges de travail utilisant des processeurs graphiques (GPU), sélectionnez l'onglet GPU.

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

      • Si vous avez spécifié Usage général, Optimisé pour le calcul ou Mémoire optimisée à l'étape précédente, procédez comme suit :

        1. Dans le menu Séries, sélectionnez une série de machines.

        2. Dans le menu Type de machine, sélectionnez un type de machine.

        3. Facultatif : Pour personnaliser davantage la machine pour les VM que vous demandez à réserver, développez les configurations avancées et suivez les instructions.

      • Si vous avez spécifié des GPU à l'étape précédente, procédez comme suit :

        1. Dans le menu Type de GPU, sélectionnez un type de GPU.

        2. Dans le menu Nombre de GPU, sélectionnez le nombre de GPU.

        3. Facultatif : Si le type de GPU le permet et que vous souhaitez utiliser les ressources réservées pour exécuter des charges de travail exigeantes en ressources graphiques, cochez la case Activer le poste de travail virtuel (NVIDIA GRID).

        4. Dans le menu Type de machine, sélectionnez un type de machine.

        5. Dans la liste Plate-forme de processeur, sélectionnez une plate-forme de processeur pour les VM que vous demandez à réserver.

    4. Facultatif : si le type de machine le permet et que vous souhaitez ajouter des disques SSD locaux, procédez comme suit :

      1. Dans le champ Nombre de disques, sélectionnez le nombre de disques pour vos disques SSD locaux.

      2. Dans la section Type d'interface, sélectionnez l'une des interfaces suivantes :

        • SCSI (par défaut)

        • NVMe

  14. 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 l'activer (par défaut).

      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.

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

    • Pour créer une demande de réservation future et l'envoyer pour examen à Google Cloud, cliquez sur Envoyer.

    • Pour créer une demande de réservation future brouillon, cliquez sur Enregistrer le brouillon.

    • Pour quitter sans enregistrer, cliquez sur Annuler.

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 partagée en spécifiant directement les propriétés, utilisez la commande gcloud beta compute future-reservations create.

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
    --auto-delete-auto-created-reservations \
    --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=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Remplacez les éléments suivants :

  • FUTURE_RESERVATION_NAME : nom de la requête de réservation future à créer.
  • Facultatif : 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.

  • DESCRIPTION : facultatif. Description de la requête de réservation future.
  • INTERFACE_1 et INTERFACE_2 : facultatifs. Le type d'interface que les disques SSD locaux doivent utiliser pour chaque VM. La valeur doit correspondre à l'un des éléments suivants :

    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.

  • MACHINE_TYPE : un type de machine à utiliser pour chaque VM. Spécifiez l'une des valeurs suivantes :

    • Pour un type de machine prédéfini : MACHINE_FAMILY-standard-CPUS.

    • Pour un type de machine personnalisé : MACHINE_FAMILY-custom-CPUS-MEMORY. Avant de spécifier un type de machine personnalisé, examinez les limites applicables aux VM avec des types de machines personnalisés.

    Remplacez les éléments suivants :

    • MACHINE_FAMILY : la famille de machines.

    • CPUS : le nombre de processeurs virtuels.

    • MEMORY : la mémoire totale d'une VM réservée. La mémoire doit être un multiple de 256 Mo et doit être exprimée en Mo.

    Par exemple, pour spécifier un type de machine personnalisé N2 doté de 4 processeurs virtuels et de 5 Go de mémoire, soit 5 120 Mo, spécifiez n2-custom-4-5120.

  • 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 : préfixe du nom de 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 : facultatif. État de planification de la requête de réservation future, qui doit être l'un des suivants :

    • Pour créer le brouillon d'une requête de réservation future, spécifiez DRAFT.

    • Pour créer la requête de réservation future et la soumettre pour approbation à Google Cloud, spécifiez SUBMITTED.

    Si vous omettez l'option --planning-status, sa valeur est définie sur DRAFT.

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

  • CONSUMER_PROJECT_IDS : liste des identifiants des projets avec lesquels cette requête de réservation future peut être partagée, séparés par une virgule. 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 requête de réservation future est créée (le projet propriétaire). N'incluez pas le projet propriétaire. Par défaut, il est déjà autorisé à utiliser les réservations créées automatiquement pour cette requête de réservation future.
  • START_TIME : heure de début de la période de réservation au format de code temporel RFC 3339, qui doit être le 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 demande de réservation future pour examen. Pour disposer d'un temps suffisant pour annuler, supprimer ou modifier une demande de réservation future après son approbation ou avant qu'elle ne soit arrivée, vérifiez que vous 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, 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 : 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.

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

Lorsque vous spécifiez l'option --auto-delete-auto-created-reservations, Compute Engine supprime automatiquement les réservations créées automatiquement pour votre 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. Vous pouvez éventuellement modifier ce paramètre en effectuant l'une 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 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 create 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 create 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. Vous devez désactiver l'option de suppression automatique si vous souhaitez associer votre réservation créée automatiquement à un engagement.

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

Par exemple, la commande suivante crée une demande de réservation future brouillon pour 80 VM. La requête de réservation future est partagée avec project-1 et project-2. La période de réservation commence à minuit le 10 novembre 2023 et se termine à minuit le 10 décembre 2023 UTC. Les VM réservées spécifient un type de machine n2-standard-4, une configuration minimale de plate-forme de processeur skylake et un disque SSD local avec l'interface scsi et 375 Go chacun. Les réservations créées automatiquement pour la réservation future sont créées dans la zone us-central1-a, portent un nom commençant par fr-02-reservation et sont automatiquement supprimées le 13 décembre 2023 à minuit, UTC.

gcloud beta compute future-reservations create fr-02 \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-delete-time=2023-12-13T00:00:00Z \
    --local-ssd=size=375,interface=scsi \
    --machine-type=n2-standard-4 \
    --min-cpu-platform=skylake \
    --name-prefix=fr-02-reservation \
    --planning-status=DRAFT \
    --project=example-project \
    --share-setting=projects \
    --share-with=project-1,project-2 \
    --start-time=2023-11-10T00:00:00Z \
    --end-time=2023-12-10T00:00:00Z \
    --total-count=80 \
    --zone=us-central1-a

REST

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

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

{
  "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": "SPECIFIC_PROJECTS"
  },
  "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": {
    "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 souhaitez 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 requête de réservation future, qu'elles soient entièrement utilisées ou non. Définissez ce champ sur false si vous souhaitez associer votre réservation créée automatiquement à un engagement.

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

      POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDeleteTime": "DELETE_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, 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 fuseau horaire UTC (temps universel coordonné). Par exemple, pour utiliser le fuseau horaire PST (heure normale du Pacifique), 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.

      POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations
      
      {
        "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. Description de la requête de réservation future.

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

  • NAME_PREFIX : préfixe du nom de 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.

  • CONSUMER_PROJECT_ID_1 et CONSUMER_PROJECT_ID_2 : ID des projets avec lesquels cette requête de réservation future 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 requête de réservation future est créée (le projet propriétaire). N'incluez pas le projet propriétaire. Par défaut, il est déjà autorisé à utiliser les réservations créées automatiquement pour cette requête de réservation future.
  • PLANNING_STATUS : facultatif. État de planification de la requête de réservation future, qui doit être l'un des suivants :

    • Pour créer le brouillon d'une requête de réservation future, spécifiez DRAFT.

    • Pour créer la requête de réservation future et la soumettre pour approbation à Google Cloud, spécifiez SUBMITTED.

    Si vous omettez le champ planningStatus, sa valeur est définie sur DRAFT.

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

  • INTERFACE_1 et INTERFACE_2 : facultatifs. Le type d'interface que les disques SSD locaux doivent utiliser pour chaque VM. La valeur doit correspondre à l'un des éléments suivants :

    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.

  • MACHINE_TYPE : un type de machine à utiliser pour chaque VM. Spécifiez l'une des valeurs suivantes :

    • Pour un type de machine prédéfini : MACHINE_FAMILY-standard-CPUS.

    • Pour un type de machine personnalisé : MACHINE_FAMILY-custom-CPUS-MEMORY. Avant de spécifier un type de machine personnalisé, examinez les limites applicables aux VM avec des types de machines personnalisés.

    Remplacez les éléments suivants :

    • MACHINE_FAMILY : la famille de machines.

    • CPUS : le nombre de processeurs virtuels.

    • MEMORY : la mémoire totale d'une VM réservée. La mémoire doit être un multiple de 256 Mo et doit être exprimée en Mo.

    Par exemple, pour spécifier un type de machine personnalisé N2 doté de 4 processeurs virtuels et de 5 Go de mémoire, soit 5 120 Mo, spécifiez n2-custom-4-5120.

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

  • TOTAL_COUNT : nombre total de VM que vous souhaitez réserver pour la période, la configuration de VM et les projets spécifiés dans cette requête de réservation future.

    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 : heure de début de la période de réservation au format de code temporel RFC 3339. 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 demande de réservation future. En outre, veillez à spécifier une valeur recommandée pour l'heure de début afin de vous assurer que vous avez suffisamment de temps avant qu'une réservation future n'entre en heure de verrouillage.

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

Par exemple, la commande suivante crée une demande de réservation future brouillon pour 80 VM. La requête de réservation future est partagée avec project-1 et project-2. La période de réservation commence à minuit le 10 novembre 2023 et se termine à minuit le 10 décembre 2023 UTC. Les VM réservées spécifient un type de machine n2-standard-4, une configuration minimale de plate-forme de processeur skylake et un disque SSD local avec l'interface SCSI et 375 Go chacun. Les réservations créées automatiquement pour la réservation future sont créées dans la zone us-central1-a, portent un nom commençant par fr-02-reservation et sont automatiquement supprimées le 13 décembre 2023 à minuit, UTC.

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

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDeleteTime": "2023-12-13T00:00:00Z",
  "name": "fr-02",
  "namePrefix": "fr-02-reservation",
  "specificSkuProperties": { 
    "instanceProperties": {
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "SCSI"
        }
      ],
      "machineType": "n2-standard-4",
      "minCpuPlatform": "Skylake"
    },
    "totalCount": "80"
  },
  "planningStatus": "DRAFT",
  "shareSettings": {
    "projects": [
      "project-1",
      "project-2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "timeWindow": {
    "startTime": "2023-11-10T00:00:00Z",
    "endTime": "2023-12-10T00:00:00Z"
  }
}

Envoyer une requête de réservation future brouillon pour examen

Vous pouvez envoyer une demande de réservation future à Google Cloud pour examen à l'aide de la console Google Cloud, de la gcloud CLI et de REST. Si vous souhaitez également modifier une ou plusieurs propriétés lors de l'envoi de la requête de réservation future brouillon, consultez la section Modifier un brouillon ou une requête de réservation future refusée.

Console

Pour envoyer une requête de réservation future brouillon pour examen, 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 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 d'informations de requête de réservation future brouillon s'affiche.

  5. Pour envoyer la requête de réservation future brouillon 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 \
    --project=PROJECT_ID \
    --zone=ZONE

Remplacez les éléments suivants :

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

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

REST

Pour envoyer une requête de réservation future brouillon pour examen, envoyez une requête PATCH à la méthode beta.futureReservations.update en définissant le champ planningStatus 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