Afficher les demandes de réservations futures

---

Preview

Ce produit ou cette fonctionnalité est soumis aux "Conditions des offres de pré-DG" dans la section "Conditions d'utilisation générales" des Conditions spécifiques au service. Les produits et fonctionnalités pré-DG sont disponibles "en l'état" et peuvent bénéficier d'une assistance limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

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

Pour afficher d'autres réservations, y compris celles créées automatiquement pour une réservation future afin de provisionner les ressources réservées, consultez plutôt 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 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

     Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
  2. Set a default region and zone.

  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 section Gérer les accès.

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

Pour afficher les demandes de réservations futures dans un projet spécifié, sélectionnez l'une des méthodes suivantes :

• Afficher la liste des demandes de réservations futures.

  Cette section explique comment afficher la liste de toutes les demandes de réservations futures dans un projet spécifié, que ces demandes soient à l'état de brouillon ou qu'elles aient bien été soumises. Vous pouvez également utiliser des filtres pour affiner les résultats en fonction d'un ou de plusieurs attributs.

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

  Cette section explique comment afficher les détails d'une demande de réservation future, tels que les projets avec lesquels une réservation future partagée est partagée, ou bien l'heure de début de sa période de réservation.

Afficher la liste des demandes de réservations futures

Vous pouvez afficher la liste des requêtes de réservation futures dans un projet spécifié à l'aide de la console Google Cloud, de la gcloud CLI et de REST.

Console

Remarque : Si vous souhaitez utiliser des expressions de filtre plus avancées pour filtrer une liste de requêtes de réservation futures, vous devez utiliser la gcloud CLI ou REST.

Procédez comme suit pour afficher la liste des demandes de réservations futures :

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 \
    --project=PROJECT_ID

Remplacez PROJECT_ID par l'ID du projet dans lequel se trouvent une ou plusieurs demandes de réservations futures. Si vous omettez l'option --project, l'ID utilisé sera celui du projet actuel.

Le résultat ressemble à ce qui suit :

NAME          TOTAL_COUNT    START_TIME             END_TIME               PROCUREMENT_STATUS   ZONE
fr-04         100            2025-07-20T07:00:00Z   2025-08-05T07:00:00Z   FULFILLED            us-east1-a
fr-05         10             2025-11-15T00:00:00Z   2025-12-01T00:00:00Z   PENDING_APPROVAL     us-west1-c

Vous pouvez également spécifier l'option --filter pour afficher une liste filtrée de réservations futures, basée sur une expression de filtre.

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

Remplacez les éléments suivants :

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

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

• PROJECT_ID : facultatif. Il s'agit de l'ID du projet dans lequel se trouvent une ou plusieurs demandes de réservations futures. Si vous omettez l'option --project, l'ID utilisé sera celui du projet actuel.

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-04-11T18: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": {
        "startTime": "2025-07-20T07:00:00Z",
        "endTime": "2025-08-05T07:00:00Z"
      },
      "status": {
        "procurementStatus": "FULFILLED",
        "lockTime": "2025-05-04T07:00:00Z",
        "fulfilledCount": "100"
      },
      "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 également spécifier le paramètre de requête filter pour afficher une liste filtrée de réservations futures, basée sur 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 :

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

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

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

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

Vous pouvez afficher les détails d'une future requête de réservation à l'aide de la console Google Cloud, de la gcloud CLI et de REST.

Console

Procédez comme suit pour afficher les détails d'une demande de réservation future :

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 \
    --project=PROJECT_ID \
    --zone=ZONE

Remplacez les éléments suivants :

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

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

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

Le résultat ressemble à ce qui suit :

creationTimestamp: '2025-07-19T12:44:11.855-07:00'
id: '5212276518668495076'
kind: compute#futureReservation
name: fr-01
namePrefix: test-fr
selfLink: https://www.googleapis.com/compute/beta/projects/project-01/zones/us-central1-a/futureReservations/future-reservation-test-1
selfLinkWithId: https://www.googleapis.com/compute/beta/projects/project-01/zones/us-central1-a/futureReservations/5212276518668495076
shareSettings:
  projects:
  - 'project-02'
  shareType: SPECIFIC_PROJECTS
specificSkuProperties:
  instanceProperties:
    localSsds:
    - diskSizeGb: '375'
      interface: SCSI
    machineType: n1-standard-64
    minCpuPlatform: Intel Skylake
  totalCount: '800'
planningStatus: SUBMITTED
status:
  lockTime: '2025-08-25T00:00:00Z'
  procurementStatus: APPROVED
timeWindow:
  endTime: '2025-12-10T00:00:00Z'
  startTime: '2025-11-10T00:00:00Z'
zone: https://www.googleapis.com/compute/beta/projects/project-01/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/reservations/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 :

{
  "creationTimestamp": "2025-04-11T18:16:45.274-07:00",
  "id": "743865190848184978",
  "name": "fr-01",
  "namePrefix": "test-fr",
  "kind": "compute#futureReservation",
  "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",
  "specificSkuProperties": {
    "instanceProperties": {
      "machineType": "n1-standard-1"
    },
    "totalCount": "100"
  },
  "planningStatus": "SUBMITTED",
  "timeWindow": {
    "endTime": "2025-08-05T07:00:00Z",
    "startTime": "2025-07-20T07:00:00Z"
  },
  "status": {
    "fulfilledCount": "100"
    "lockTime": "2025-05-04T07:00:00Z",
    "procurementStatus": "FULFILLED",
  },
  "zone": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a"
}

Étapes suivantes

• Découvrez comment modifier, annuler ou supprimer des demandes de réservations futures.

• Après avoir atteint l'heure de début de votre période de réservation, découvrez comment utiliser les réservations créées automatiquement.

• Après l'heure de fin de votre période de réservation, découvrez comment effectuer les opérations suivantes :

  • Modifier les réservations créées automatiquement.

  • Supprimer les réservations créées automatiquement.