Afficher les demandes de réservations futures

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

L'affichage des requêtes de réservation futures est utile pour obtenir une vue d'ensemble de toutes les requêtes de réservation futures de votre projet et pour examiner les détails de configuration d'une requête de réservation future. Si vous souhaitez afficher une requête de réservation future partagée, vous ne pouvez le faire qu'à l'aide du projet propriétaire.

Pour afficher les réservations créées automatiquement et provisionnées pour une réservation future, consultez la section Afficher les réservations.

Avant de commencer

  • Si ce n'est pas déjà fait, configurez l'authentification. L'authentification est le processus permettant de valider votre identité pour accéder aux services et aux API Google Cloud. Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine en sélectionnant l'une des options suivantes:

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

    Console

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

    gcloud

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

      gcloud init
    2. Set a default region and zone.

      3. REST

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

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

        gcloud init

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

Rôles requis

Pour obtenir les autorisations nécessaires pour afficher les demandes de réservations futures, demandez à votre administrateur de vous accorder sur le projet le rôle IAM Lecteur de réservation future Compute (roles/compute.futureReservationViewer). 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 afficher les demandes de réservations futures. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Vous devez disposer des autorisations suivantes pour afficher les demandes de réservations futures :

  • Pour afficher la liste des réservations futures : compute.futureReservations.list sur le projet
  • Pour afficher les détails d'une réservation future : compute.futureReservations.get sur le projet

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

Afficher vos demandes de réservations futures

En fonction des informations que vous souhaitez afficher dans une requête de réservation future, utilisez l'une des méthodes suivantes :

Afficher la liste des demandes de réservations futures

Lorsque vous consultez la liste de vos demandes de réservations futures, vous pouvez utiliser des expressions de filtre pour affiner vos résultats. Pour des expressions de filtre plus avancées, utilisez la gcloud CLI ou REST.

Pour afficher la liste des demandes de réservation future dans votre projet, 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.

    Dans le tableau, chaque ligne décrit une demande de réservation future et chaque colonne décrit une propriété. Par exemple, la colonne Total décrit la capacité réservée de chaque demande de réservation future.

  3. Facultatif : pour filtrer les demandes de réservations futures affichées dans le tableau, effectuez l'une des opérations suivantes, ou les deux :

    • Dans le champ Filtre, saisissez une expression de filtre.

      Par exemple, pour n'afficher que les demandes de réservations futures qui ont été créées dans la zone us-central1-a, ou que celles qui ont réservé plus de 10 ressources, spécifiez l'expression suivante :

      Zone:us-central1-a OR Total Count>10

    • Cliquez sur Options d'affichage des colonnes, puis sélectionnez les valeurs selon lesquelles vous souhaitez filtrer le tableau.

gcloud

Pour afficher la liste des demandes de réservations futures, utilisez la commande gcloud beta compute future-reservations list.

gcloud beta compute future-reservations list

Le résultat ressemble à ce qui suit :

NAME: fr-04
TOTAL_COUNT: 100
START_TIME: 2025-07-20T07:00:00Z
END_TIME: 2025-08-05T07:00:00Z
PROCUREMENT_STATUS: FULFILLED
ZONE: us-east1-a

NAME: fr-05
TOTAL_COUNT: 10
START_TIME: 2025-07-20T07:00:00Z
END_TIME: 2025-12-01T00:00:00Z
PROCUREMENT_STATUS: PENDING_APPROVAL
ZONE: us-west1-c

Vous pouvez éventuellement inclure l'option --filter pour filtrer vos demandes de réservation futures en fonction d'une expression de filtre.

gcloud beta compute future-reservations list \
    --filter="FILTER_EXPRESSION"

Remplacez FILTER_EXPRESSION par une expression de filtre.

Par exemple, pour n'afficher que les demandes de réservations futures qui ont été créées dans la zone us-central1-a, qui spécifient un type de machine n2-standard-4 et qui ont réservé plus de 10 ressources, spécifiez l'expression de filtre suivante :

zone=us-central1-a AND specificSkuProperties.instanceProperties.machineType=n2-standard-4 AND specificSkuProperties.totalCount>10

REST

Pour afficher la liste des demandes de réservations futures, envoyez une requête GET à la méthode beta.futureResevations.list.

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet dans lequel se trouvent une ou plusieurs demandes de réservations futures.

  • ZONE : zone dans laquelle se situent une ou plusieurs demandes de réservations futures.

Le résultat ressemble à ce qui suit :

{
  "id": "projects/my-project/zones/us-east1-a/futureReservations",
  "items": [
    {
      "id": "743865190848184978",
      "creationTimestamp": "2025-03-23T18:16:45.274-07:00",
      "selfLink": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a/futureReservations/fr-base",
      "selfLinkWithId": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a/futureReservations/743865190848184978",
      "zone": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a",
      "name": "fr-base",
      "specificSkuProperties": {
        "instanceProperties": {
          "machineType": "n1-standard-1"
        },
        "totalCount": "100"
      },
      "planningStatus": "SUBMITTED",
      "timeWindow": {
        "endTime": "2025-05-02T01:00:00Z",
        "startTime": "2025-04-30T17:30:00Z"
      },
      "status": {
        "procurementStatus": "FULFILLED",
        "lockTime": "2025-03-30T07:00:00Z",
        "existingMatchingUsageInfo": {
          "count": "3",
          "timestamp": "2025-03-30T01:00:00Z"
        }
      },
      "kind": "compute#futureReservation"
    },
    ...
  ],
  "selfLink": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a/futureReservations",
  "etag": "AnzKY34l-cvvV-JnniESJ0dtQvQ=/hvc4jaHpxFAZmOt1FVtKNgzZu-M=",
  "kind": "compute#futureReservationsListResponse"
}

Vous pouvez éventuellement inclure le paramètre de requête filter pour filtrer vos demandes de réservation futures en fonction d'une expression de filtre.

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/aggregated/futureReservations?filter=FILTER_EXPRESSION

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet dans lequel se trouvent une ou plusieurs demandes de réservations futures.

  • FILTER_EXPRESSION : une expression de filtre qui utilise l'encodage d'URL.

    Par exemple, pour n'afficher que les demandes de réservations futures qui ont été créées dans la zone us-central1-a, et qui ont réservé un type de machine n2-standard-4 et plus de 10 ressources, spécifiez l'expression de filtre suivante :

    zone=us-central1-a%20AND%20specificSkuProperties.instanceProperties.machineType=n2-standard-4%20AND%20specificSkuProperties.totalCount%3E10

    Notez que l'expression de filtre encodée au format URL correspond à l'expression de filtre décodée ci-après :

    zone=us-central1-a AND specificSkuProperties.instanceProperties.machineType=n2-standard-4 AND specificSkuProperties.totalCount>10

Afficher les détails d'une demande de réservation future

Pour afficher les détails d'une demande de réservation future, sélectionnez l'une des options suivantes :

Console

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

    Accéder à la page "Réservations"

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

  3. Dans la colonne Nom, cliquez sur le nom de la demande de réservation future pour dont vous souhaitez afficher les détails.

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

gcloud

Pour afficher les détails d'une demande de réservation future, utilisez la commande gcloud beta compute future-reservations describe.

gcloud beta compute future-reservations describe FUTURE_RESERVATION_NAME \
    --zone=ZONE

Remplacez les éléments suivants :

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

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

Le résultat ressemble à ce qui suit :

autoCreatedReservationsDeleteTime: '2025-05-02T01:00:00Z'
creationTimestamp: '2025-03-23T10:08:31.613-07:00'
id: '5212276518668495076'
kind: compute#futureReservation
name: fr-01
planningStatus: SUBMITTED
selfLink: https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-01
selfLinkWithId: https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/5212276518668495076
shareSettings:
  shareType: LOCAL
specificSkuProperties:
  instanceProperties:
    machineType: n1-standard-64
  totalCount: '800'
status:
  existingMatchingUsageInfo:
    count: '3'
    timestamp: '2025-03-30T01:00:00Z'
  lockTime: '2025-03-30T17:09:59.297799Z'
  procurementStatus: APPROVED
timeWindow:
  endTime: '2025-05-02T01:00:00Z'
  startTime: '2025-04-30T17:30:00Z'
zone: https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a

REST

Pour afficher les détails d'une demande de réservation future, envoyez une requête GET à la méthode beta.futureReservations.get.

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

Remplacez les éléments suivants :

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

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

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

Le résultat ressemble à ce qui suit :

{
  "autoCreatedReservationsDeleteTime": "2025-05-02T01:00:00Z",
  "creationTimestamp": "2025-03-23T10:08:31.613-07:00",
  "id": "5212276518668495076",
  "kind": "compute#futureReservation",
  "name": "fr-01",
  "planningStatus": "SUBMITTED",
  "selfLink": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-01",
  "selfLinkWithId": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/5212276518668495076",
  "shareSettings": {
    "shareType": "LOCAL"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "machineType": "n1-standard-64"
    },
    "totalCount": "800"
  },
  "status": {
    "lockTime": "2025-03-30T17:09:59.297799Z",
    "procurementStatus": "APPROVED",
    "existingMatchingUsageInfo": {
      "count": "3",
      "timestamp": "2025-03-30T01:00:00Z"
    }
  },
  "timeWindow": {
    "endTime": "2025-05-02T01:00:00Z",
    "startTime": "2025-04-30T17:30:00Z"
  },
  "zone": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a"
}

Déterminer le nombre de VM provisionnées

Une fois que vous avez créé une requête de réservation future, vous pouvez voir le nombre de VM en cours d'exécution et de réservations inutilisées dans votre projet, ou dans un projet avec lequel la requête de réservation future est partagée, qui correspondent aux propriétés de VM spécifiées dans votre requête. En soustrayant ce nombre au nombre total spécifié dans votre requête, vous pouvez déterminer le nombre de VM que Compute Engine provisionnera une fois votre requête approuvée et qu'elle aura atteint son heure de début.

Pour déterminer simultanément le nombre de VM provisionnées pour plusieurs futures demandes de réservation, utilisez la console Google Cloud. Sinon, pour déterminer le nombre de VM provisionnées pour une seule requête, 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. Pour chaque demande de réservation future, vous pouvez déterminer les éléments suivants :

    • Dans la colonne Nombre total, le nombre total de requêtes.

    • Dans la colonne Nombre de correspondances, le nombre de VM en cours d'exécution et de réservations dont les propriétés de VM correspondent à la requête.

    En soustrayant la valeur de la colonne Nombre de correspondances à la valeur de la colonne Nombre total, vous pouvez déterminer le nombre de VM que Compute Engine provisionnera pour une requête de réservation future à son heure de début. Si un avertissement s'affiche dans la colonne Nombre de correspondances, cela peut être dû à l'une des raisons suivantes :

    • La valeur de Nombre de correspondances est nulle. Dans ce cas, aucune VM en cours d'exécution ni aucune réservation ne correspond dans votre projet.

    • La valeur de Nombre de correspondances est égale à Nombre total. Dans ce cas, Compute Engine ne provisionne aucune VM réservée pour la requête de réservation future .

    Si vous modifiez la requête de réservation future, ou si vous créez des VM ou des réservations avec des propriétés de VM correspondant à la requête, Compute Engine met à jour la valeur dans la colonne Nombre de correspondances sous 30 minutes. Pour vérifier la date de la dernière mise à jour de la colonne Nombre de correspondances, affichez les détails de la requête, puis vérifiez la valeur dans la ligne Dernière évaluation de l'utilisation correspondante.

  4. Facultatif : Pour modifier le nombre de VM réservées dans une requête de réservation future, modifiez votre requête de réservation future.

gcloud

  1. Afficher les détails de la requête de réservation future.

  2. Dans le résultat, soustrayez la valeur du champ existingMatchingUsageInfo de celle du champ totalCount. Si la valeur de existingMatchingUsageInfo.count est égale à totalCount, Compute Engine ne provisionne aucune VM réservée pour la requête de réservation future.

    Si vous modifiez la requête de réservation future, ou si vous créez des VM ou des réservations avec des propriétés de VM correspondant à la requête, Compute Engine met à jour le champ existingMatchingUsageInfo sous 30 minutes. Pour vérifier la date de la dernière mise à jour du champ, vérifiez la valeur du champ existingMatchingUsageInfo.timestamp.

  3. Facultatif : Pour modifier le nombre de VM réservées dans votre requête de réservation future, modifiez votre requête de réservation future.

REST

  1. Afficher les détails de la requête de réservation future.

  2. Dans le résultat, soustrayez la valeur du champ existingMatchingUsageInfo de celle du champ totalCount. Si la valeur de existingMatchingUsageInfo.count est égale à totalCount, Compute Engine ne provisionne aucune VM réservée pour la requête de réservation future.

    Si vous modifiez la requête de réservation future, ou si vous créez des VM ou des réservations avec des propriétés de VM correspondant à la requête, Compute Engine met à jour le champ existingMatchingUsageInfo sous 30 minutes. Pour vérifier la date de la dernière mise à jour du champ, vérifiez la valeur du champ existingMatchingUsageInfo.timestamp.

  3. Facultatif : Pour modifier le nombre de VM réservées dans votre requête de réservation future, modifiez votre requête de réservation future.

Étape suivante