Afficher la capacité réservée

Ce document explique comment afficher vos demandes de capacité réservée et votre capacité réservée pour AI Hypercomputer. En consultant la disponibilité, les propriétés et la topologie de votre capacité réservée et de vos demandes, vous pouvez planifier la capacité réservée pour vos charges de travail.

Le champ d'application de ce document est limité aux charges de travail qui utilisent une option de capacité mentionnant les réservations futures. Pour en savoir plus sur les options de capacité d'AI Hypercomputer, consultez Présentation de la capacité.

Une fois que Google Cloud a approuvé une requête de réservation future, Compute Engine crée automatiquement (auto-crée) une réservation vide pour les ressources demandées. Vous pouvez ensuite afficher la réservation pour planifier votre charge de travail. Plus tard, à l'heure de début demandée, les événements suivants se produisent :

• Compute Engine ajoute vos instances de machines virtuelles (VM) réservées à la réservation. Vous pouvez ensuite commencer à utiliser la réservation en créant des VM qui y correspondent.
• Vous pouvez modifier la réservation pour autoriser les jobs d'entraînement ou de prédiction Vertex AI à l'utiliser. Pour obtenir des instructions, consultez Modifier la règle de partage d'une réservation.

Limites

Vous ne pouvez afficher une réservation partagée ou une requête de réservation future partagée que dans le projet dans lequel Google l'a créée.

Avant de commencer

1. Réservez de la capacité : si ce n'est pas déjà fait, réservez de la capacité pour AI Hypercomputer en utilisant l'une des options suivantes :
   • Réserver de la capacité auprès de l'équipe chargée de votre compte
   • Créer une demande de réservation future en mode Agenda

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

   In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

   REST

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

   Installez la Google Cloud CLI. Une fois que la Google Cloud CLI est installée, initialisez-la en exécutant la commande suivante :

   gcloud init

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

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

   Rôles requis

   Pour obtenir les autorisations nécessaires pour afficher les réservations, demandez à votre administrateur de vous accorder le rôle IAM Utilisateur de réservation future Compute (roles/compute.futureReservationUser) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

   Ce rôle prédéfini contient les autorisations requises pour afficher les réservations. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

   Autorisations requises

   Les autorisations suivantes sont requises pour afficher les réservations :

   • Pour afficher les détails d'une demande de réservation future : compute.futureReservations.get sur le projet
   • Pour afficher les détails d'une réservation : compute.reservations.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 capacité réservée

   Pour afficher vos demandes de réservations futures, utilisez une ou plusieurs des méthodes suivantes :

   • Pour obtenir un aperçu de toutes les demandes de réservations futures dans votre projet, affichez la liste de vos demandes de réservations futures.
   • Pour afficher tous les détails d'une seule demande de réservation future, affichez les détails de la demande de réservation future.

   Afficher la liste de vos demandes de réservations futures

   Vous pouvez afficher la liste de vos demandes de réservations futures pour consulter la période de réservation, l'état et la zone de vos demandes.

   Pour afficher la liste de vos demandes 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. Le tableau liste chaque demande de réservation future, et chaque colonne décrit une propriété.
   3. Facultatif : Pour affiner la liste des demandes, dans le champ Filtrer, sélectionnez les propriétés selon lesquelles vous souhaitez filtrer les demandes.

   gcloud

   Pour afficher la liste de vos demandes de réservations futures, utilisez la commande gcloud compute future-reservations list :

   gcloud compute future-reservations list
   

   Le résultat ressemble à celui de l'exemple ci-dessous.

   NAME: fr-01
   TOTAL_COUNT: 100
   START_TIME: 2026-07-20T07:00:00Z
   END_TIME: 2026-08-05T07:00:00Z
   PROCUREMENT_STATUS: FULFILLED
   ZONE: us-west4-b
   
   NAME: fr-02
   TOTAL_COUNT: 10
   START_TIME: 2026-07-20T07:00:00Z
   END_TIME: 2026-12-01T00:00:00Z
   PROCUREMENT_STATUS: PENDING_APPROVAL
   ZONE: us-west4-b
   

   Si vous souhaitez affiner la liste des demandes de réservations futures, utilisez la même commande avec l'option --filter.

   REST

   Pour afficher la liste de vos demandes de réservations futures, envoyez une requête GET à l'une des méthodes suivantes :

   • Pour afficher la liste des requêtes dans toutes les zones : méthode futureReservations.aggregatedList
   • Pour afficher la liste des requêtes dans une zone spécifique : méthode futureReservations.list

   Par exemple, pour afficher la liste des requêtes dans toutes les zones, envoyez une requête GET comme suit :

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/futureReservations
   

   Remplacez PROJECT_ID par l'ID du projet dans lequel se trouvent les requêtes.

   Le résultat pour une liste de demandes de réservations futures dans une seule zone ressemble à ce qui suit :

   {
     "id": "projects/example-project/aggregated/futureReservations",
     "items": [
       {
         "specificSkuProperties": {
           "instanceProperties": {
             "machineType": "a3-ultragpu-8g",
             "guestAccelerators": [
               {
                 "acceleratorType": "nvidia-h200-141gb",
                 "acceleratorCount": 8
               }
             ],
             "localSsds": [
               {
                 "diskSizeGb": "375",
                 "interface": "NVME"
               },
               ...
             ]
           },
           "totalCount": "2"
         },
         "kind": "compute#futureReservation",
         "id": "7979651787097007552",
         "creationTimestamp": "2025-11-27T11:14:58.305-08:00",
         "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/example-draft-request",
         "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/7979651787097007552",
         "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b",
         "name": "example-draft-request",
         "timeWindow": {
           "startTime": "2026-01-27T19:20:00Z",
           "endTime": "2026-02-10T19:20:00Z"
         },
         "status": {
           "procurementStatus": "DRAFTING",
           "lockTime": "2026-01-27T19:15:00Z"
         },
         "planningStatus": "DRAFT",
         "specificReservationRequired": true,
         "reservationName": "example-reservation",
         "deploymentType": "DENSE",
         "schedulingType": "INDEPENDENT",
         "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
       },
       ...
     ],
     "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/aggregated/futureReservations",
     "etag": "AnzKY34l-cvvV-JnniESJ0dtQvQ=/hvc4jaHpxFAZmOt1FVtKNgzZu-M=",
     "kind": "compute#futureReservationsListResponse"
   }
   

   Si vous souhaitez affiner la liste des demandes de réservations futures, envoyez la même requête et incluez le paramètre de requête filter dans l'URL de la requête.

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

   Vous pouvez afficher les détails d'une demande de réservation future pour examiner les propriétés et la période de réservation de vos ressources réservées.

   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. Le tableau liste chaque demande de réservation future, et chaque colonne décrit une propriété.
   3. Pour afficher les détails d'une demande, cliquez sur son nom dans la colonne Nom. Une page indiquant les détails de la demande de réservation future s'affiche.

   gcloud

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

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

   Remplacez les éléments suivants :

   • FUTURE_RESERVATION_NAME : nom de la demande de réservation future.
   • ZONE : zone dans laquelle se trouve la demande de réservation future.

   Le résultat ressemble à celui de l'exemple ci-dessous.

   autoCreatedReservationsDeleteTime: '2026-02-10T19:20:00Z'
   creationTimestamp: '2025-11-27T11:14:58.305-08:00'
   deploymentType: DENSE
   id: '7979651787097007552'
   kind: compute#futureReservation
   name: example-draft-request
   planningStatus: DRAFT
   reservationName: example-reservation
   schedulingType: INDEPENDENT
   selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/example-draft-request
   selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/7979651787097007552
   specificReservationRequired: true
   specificSkuProperties:
     instanceProperties:
       guestAccelerators:
       -   acceleratorCount: 8
         acceleratorType: nvidia-h200-141gb
       localSsds:
       -   diskSizeGb: '375'
         interface: NVME
       ...
     machineType: a3-ultragpu-8g
   totalCount: '2'
   status:
     autoCreatedReservations:
     -   https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/reservations/example-reservation
     fulfilledCount: '2'
     lockTime: '2026-01-27T19:15:00Z'
     procurementStatus: DRAFTING
   timeWindow:
     endTime: '2026-02-10T19:20:00Z'
     startTime: '2026-01-27T19:20:00Z'
   zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b
   

   REST

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

   GET https://compute.googleapis.com/compute/v1/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 trouve la demande de réservation future.
   • FUTURE_RESERVATION_NAME : nom de la demande de réservation future.

   Le résultat ressemble à ce qui suit :

   {
     "specificSkuProperties": {
       "instanceProperties": {
         "machineType": "a3-ultragpu-8g",
         "guestAccelerators": [
           {
             "acceleratorType": "nvidia-h200-141gb",
             "acceleratorCount": 8
           }
         ],
         "localSsds": [
           {
             "diskSizeGb": "375",
             "interface": "NVME"
           },
           ...
         ]
       },
       "totalCount": "2"
     },
     "kind": "compute#futureReservation",
     "id": "7979651787097007552",
     "creationTimestamp": "2025-11-27T11:14:58.305-08:00",
     "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/example-draft-request",
     "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/7979651787097007552",
     "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b",
     "name": "example-draft-request",
     "timeWindow": {
       "startTime": "2026-01-27T19:20:00Z",
       "endTime": "2026-02-10T19:20:00Z"
     },
     "status": {
       "procurementStatus": "DRAFTING",
       "lockTime": "2026-01-27T19:15:00Z"
     },
     "planningStatus": "DRAFT",
     "specificReservationRequired": true,
     "reservationName": "example-reservation",
     "deploymentType": "DENSE",
     "schedulingType": "INDEPENDENT",
     "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
   }
   

   Afficher votre capacité réservée

   Affichez votre capacité réservée lorsque vous souhaitez effectuer une ou plusieurs des opérations suivantes :

   • Identifiez une réservation, un bloc et un sous-bloc que vous souhaitez utiliser pour déployer une charge de travail.
   • Comprenez les propriétés, l'utilisation et la topologie de votre capacité réservée.

   Pour afficher votre capacité réservée, utilisez une ou plusieurs des méthodes suivantes :

   • Pour obtenir un aperçu de toute la capacité réservée de votre projet et vérifier si une partie de cette capacité n'est pas utilisée, affichez la liste de vos réservations.
   • Pour consulter les propriétés et la disponibilité de toutes les VM réservées pour une réservation, affichez les détails d'une réservation.
   • Pour comprendre comment les blocs et sous-blocs de capacité d'une réservation sont organisés, par exemple pour l'intégration à votre outil de planification ou de programmation, affichez la topologie d'une réservation.

   Afficher la liste de vos réservations

   Vous pouvez afficher la liste des réservations de votre projet pour voir toute la capacité réservée dans votre projet et rechercher une réservation à utiliser pour déployer votre charge de travail.

   Pour afficher la liste de vos réservations, 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"

      Dans l'onglet Réservations à la demande (par défaut), le tableau liste chaque réservation et chaque colonne décrit une propriété.

   2. Facultatif : Pour affiner votre liste de réservations, dans le champ Filtrer, sélectionnez les propriétés selon lesquelles vous souhaitez filtrer les réservations.

   gcloud

   Pour afficher la liste de vos réservations, utilisez la commande gcloud compute reservations list :

   gcloud compute reservations list
   

   Le résultat ressemble à ce qui suit :

   NAME: r-01
   IN_USE_COUNT: 0
   COUNT: 5
   ZONE: europe-west4-b
   SHARE_TYPE: LOCAL
   
   NAME: r-02
   IN_USE_COUNT: 3
   COUNT: 10
   ZONE: europe-west4-b
   SHARE_TYPE: LOCAL
   

   Si vous souhaitez affiner la liste de vos réservations, utilisez la même commande avec l'option --filter.

   REST

   Pour afficher la liste de vos réservations, envoyez une requête GET à l'une des méthodes suivantes :

   • Pour afficher la liste de vos réservations dans toutes les zones : méthode reservations.aggregatedList
   • Pour afficher la liste de vos réservations dans une seule zone : Méthode reservations.list

   Par exemple, pour afficher la liste de vos réservations dans toutes les zones, envoyez une requête GET comme suit :

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/reservations
   

   Remplacez PROJECT_ID par l'ID du projet dans lequel se trouvent les réservations.

   La sortie pour une liste de réservations dans une seule zone ressemble à ce qui suit :

   {
     "id": "projects/example-project/zones/europe-west1-b/futureReservations",
     "items": [
       {
         "specificSkuProperties": {
           "instanceProperties": {
             "machineType": "a3-ultragpu-8g",
             "guestAccelerators": [
               {
                 "acceleratorType": "nvidia-h200-141gb",
                 "acceleratorCount": 8
               }
             ],
             "localSsds": [
               {
                 "diskSizeGb": "375",
                 "interface": "NVME"
               },
               ...
             ]
           },
           "totalCount": "2"
         },
         "kind": "compute#futureReservation",
         "id": "7979651787097007552",
         "creationTimestamp": "2025-11-27T11:14:58.305-08:00",
         "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/example-draft-request",
         "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/7979651787097007552",
         "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b",
         "name": "example-draft-request",
         "timeWindow": {
           "startTime": "2026-01-27T19:20:00Z",
           "endTime": "2026-02-10T19:20:00Z"
         },
         "status": {
           "procurementStatus": "DRAFTING",
           "lockTime": "2026-01-27T19:15:00Z"
         },
         "planningStatus": "DRAFT",
         "specificReservationRequired": true,
         "reservationName": "example-reservation",
         "deploymentType": "DENSE",
         "schedulingType": "INDEPENDENT",
         "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
       }
       ...
     ],
     "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations",
     "etag": "AnzKY34l-cvvV-JnniESJ0dtQvQ=/hvc4jaHpxFAZmOt1FVtKNgzZu-M=",
     "kind": "compute#futureReservationsListResponse"
   }
   

   Si vous souhaitez affiner votre liste de réservations, envoyez la même requête et incluez le paramètre de requête filter dans l'URL de la requête.

   Afficher les détails d'une réservation

   Vous pouvez afficher les détails d'une réservation dans votre projet pour comprendre des informations telles que les suivantes :

   • Types de VM inclus dans la réservation.
   • Nombre de VM réservées et disponibles dans la réservation.
   • État de la réservation, y compris le nombre de blocs opérationnels. (Disponible uniquement avec la gcloud CLI ou REST)

   Si vous souhaitez comprendre les blocs et sous-blocs d'une réservation, consultez plutôt Afficher la topologie d'une réservation.

   Pour afficher les détails d'une réservation, 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. Dans le tableau Réservations à la demande, cliquez sur le nom de la réservation dont vous souhaitez afficher les détails dans la colonne Nom. Une page indiquant les détails de la réservation s'affiche.

   gcloud

   Pour afficher les détails d'une réservation, utilisez la commande gcloud compute reservations describe :

   gcloud compute reservations describe RESERVATION_NAME \
       --zone=ZONE
   

   Remplacez les éléments suivants :

   • RESERVATION_NAME : nom de la réservation.
   • ZONE : zone où se trouve la réservation.

   Le résultat ressemble à celui de l'exemple ci-dessous.

   advancedDeploymentControl:
     reservationOperationalMode: ALL_CAPACITY
   creationTimestamp: '2025-07-18T13:23:22.191-07:00'
   deleteAtTime: '2026-06-19T00:00:00Z'
   deploymentType: DENSE
   enableEmergentMaintenance: false
   id: '4298354039694234582'
   kind: compute#reservation
   name: example-res1
   reservationSharingPolicy:
     serviceShareType: DISALLOW_ALL
   resourceStatus:
     healthInfo:
       degradedBlockCount: 0
       healthStatus: HEALTHY
       healthyBlockCount: 1
     reservationBlockCount: 1
     reservationMaintenance:
       schedulingType: GROUPED
   schedulingType: GROUPED
   selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1
   selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/4298354039694234582
   shareSettings:
     shareType: LOCAL
   specificReservation:
     assuredCount: '18'
     count: '18'
     inUseCount: '2'
     instanceProperties:
       guestAccelerators:
       -   acceleratorCount: 4
         acceleratorType: nvidia-gb200
       localSsds:
       -   diskSizeGb: '3000'
         interface: NVME
       -   diskSizeGb: '3000'
         interface: NVME
       -   diskSizeGb: '3000'
         interface: NVME
       -   diskSizeGb: '3000'
         interface: NVME
       machineType: a4x-highgpu-4g
   specificReservationRequired: true
   status: READY
   zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a
   

   Le résultat inclut les champs suivants pour la réservation :

   • name : nom de la réservation.
   • healthInfo : informations sur l'état de santé pour la réservation, comme suit :
     • degradedBlockCount : nombre de blocs dégradés dans la réservation.
     • healthStatus : état de santé global de la réservation.
     • healthyBlockCount : nombre de blocs sains dans la réservation.
   • reservationBlockCount : nombre total de blocs dans la réservation.
   • assuredCount : nombre total de VM pouvant être déployées à l'aide de la réservation. Si cette valeur est inférieure à count, découvrez comment résoudre les problèmes liés à la disponibilité d'un nombre réduit de VM.
   • inUseCount : nombre de VM déjà déployées dans la réservation.
   • instanceProperties : propriétés des VM pouvant être déployées dans la réservation.

   REST

   Pour afficher les détails d'une réservation, envoyez une requête GET à la méthode reservations.get :

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME
   

   Remplacez les éléments suivants :

   • PROJECT_ID : ID du projet dans lequel se trouve la réservation.
   • ZONE : zone où se trouve la réservation.
   • RESERVATION_NAME : nom de la réservation.

   Le résultat ressemble à ce qui suit :

   {
     "specificReservation": {
       "instanceProperties": {
         "machineType": "a4x-highgpu-4g",
         "guestAccelerators": [
           {
             "acceleratorType": "nvidia-gb200",
             "acceleratorCount": 4
           }
         ],
         "localSsds": [
           {
             "diskSizeGb": "3000",
             "interface": "NVME"
           },
           {
             "diskSizeGb": "3000",
             "interface": "NVME"
           },
           {
             "diskSizeGb": "3000",
             "interface": "NVME"
           },
           {
             "diskSizeGb": "3000",
             "interface": "NVME"
           }
         ]
       },
       "count": "36",
       "inUseCount": "35",
       "assuredCount": "33"
     },
     "kind": "compute#reservation",
     "id": "6823689647457870910",
     "creationTimestamp": "2025-08-04T13:40:50.496-07:00",
     "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1",
     "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
     "name": "example-res1",
     "specificReservationRequired": true,
     "status": "READY",
     "shareSettings": {
       "shareType": "SPECIFIC_PROJECTS"
     },
     "resourceStatus": {
       "reservationMaintenance": {
         "upcomingGroupMaintenance": {
           "type": "SCHEDULED",
           "canReschedule": false,
           "maintenanceStatus": "ONGOING"
         },
         "maintenanceOngoingCount": 2,
         "maintenancePendingCount": 34,
         "schedulingType": "GROUPED",
         "subblockInfraMaintenanceOngoingCount": 0,
         "subblockInfraMaintenancePendingCount": 0,
         "instanceMaintenanceOngoingCount": 3,
         "instanceMaintenancePendingCount": 32
       },
       "reservationBlockCount": 1,
       "healthInfo": {
         "healthStatus": "DEGRADED",
         "healthyBlockCount": 0,
         "degradedBlockCount": 1
       }
     },
     "reservationSharingPolicy": {
       "serviceShareType": "DISALLOW_ALL"
     },
     "deploymentType": "DENSE",
     "advancedDeploymentControl": {
       "reservationOperationalMode": "ALL_CAPACITY"
     },
     "enableEmergentMaintenance": false,
     "schedulingType": "GROUPED",
     "deleteAtTime": "2025-10-01T00:00:00Z"
   }
   

   Le résultat inclut les champs suivants pour la réservation :

   • instanceProperties : propriétés des VM pouvant être déployées dans la réservation.
   • inUseCount : nombre de VM déjà déployées dans la réservation.
   • assuredCount : nombre total de VM pouvant être déployées à l'aide de la réservation. Si cette valeur est inférieure à count, découvrez comment résoudre les problèmes liés à la disponibilité d'un nombre réduit de VM.
   • name : nom de la réservation.
   • healthInfo : informations sur l'état de santé pour la réservation, comme suit :
     • healthStatus : état de santé global de la réservation.
     • healthyBlockCount : nombre de blocs sains dans la réservation.
     • degradedBlockCount : nombre de blocs dégradés dans la réservation.

   Afficher la topologie d'une réservation

   Vous pouvez afficher des informations détaillées sur la topologie d'une réservation pour vous aider à décider où créer des VM dans les blocs et sous-blocs réservés. Pour en savoir plus sur l'emplacement des VM réservées déjà déployées, consultez Afficher la topologie d'une instance de calcul.

   Si vous souhaitez afficher d'autres détails sur une réservation, consultez plutôt Afficher les détails d'une réservation.

   Afficher les blocs réservés

   Pour lister et décrire les blocs disponibles dans une réservation, utilisez l'une des méthodes suivantes. Cette tâche vous aide à déterminer les éléments suivants :

   • Blocs de capacité inclus dans la réservation.
   • Capacité disponible dans chaque bloc.
   • L'état de chaque bloc, y compris le nombre de sous-blocs opérationnels. (Disponible uniquement avec la gcloud CLI ou REST)
   • Nom, bloc et sous-bloc de toutes les VM déployées dans le bloc. (Disponible uniquement lorsque vous affichez un bloc spécifique à l'aide de la gcloud CLI ou de REST.)

   Console

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

      Accéder à la page "Réservations"

   2. Dans le tableau Réservations à la demande, cliquez sur le nom de la réservation dont vous souhaitez afficher les détails dans la colonne Nom. La page d'informations de la réservation sélectionnée s'affiche.
   3. Dans la section Topologie des ressources, vous pouvez afficher des informations sur vos blocs réservés. Ces informations incluent les éléments suivants pour chaque bloc :
      • ID du bloc : nom du bloc.
      • Nombre : nombre total de VM pouvant être déployées dans le bloc.
      • En cours d'utilisation : nombre de VM déjà déployées dans le bloc.

   gcloud

   Vous pouvez afficher les blocs d'une réservation à l'aide des commandes suivantes :

   • Pour afficher tous les blocs disponibles dans une réservation, utilisez la commande gcloud compute reservations blocks list :

     gcloud compute reservations blocks list RESERVATION_NAME \
         --zone=ZONE
     

   • Pour afficher un bloc spécifique dans une réservation, utilisez la commande gcloud compute reservations blocks describe. Pour afficher également le nom et la topologie de toutes les VM déployées dans le bloc, ajoutez l'indicateur --full-view=BLOCK_VIEW_FULL.

     gcloud compute reservations blocks describe RESERVATION_NAME \
         --zone=ZONE \
         --block-name=BLOCK_NAME \
         --full-view=BLOCK_VIEW_FULL
     

   Remplacez les éléments suivants :

   • RESERVATION_NAME : nom de la réservation.
   • ZONE : zone où se trouve la réservation.
   • BLOCK_NAME : nom du bloc.

   Le résultat de chaque bloc est semblable à l'exemple suivant :

   resource:
     count: 36
     creationTimestamp: '2025-08-04T15:15:07.074-07:00'
     healthInfo:
       degradedSubBlockCount: 2
       healthStatus: DEGRADED
       healthySubBlockCount: 0
     id: '4360924059555106309'
     inUseCount: 35
     kind: compute#reservationBlock
     name: example-res1-block-0001
     physicalTopology:
       block: 1acd074d42cd3be9e4486b524db2e9ab
       cluster: us-central1-cluster-dnkc
       instances:
       -   instanceId: '5815586279631866288'
         physicalHostTopology:
           host: c229b308380a83e0ca345d4a0de05aa7
           subBlock: c02af6bdaeccacef571e0adbe79e8c28
         projectId: 'PROJECT_NUMBER'
       ...
       -   instanceId: '8389759878923049076'
         physicalHostTopology:
           host: '3ac534f00c20e6e0c87c3aaff2705be6'
           subBlock: 'c081876ba0aa2857d608eb30a5b2fa40'
         projectId: 'PROJECT_NUMBER'
     reservationMaintenance:
       instanceMaintenanceOngoingCount: 3
       instanceMaintenancePendingCount: 32
       maintenanceOngoingCount: 2
       maintenancePendingCount: 34
       schedulingType: GROUPED
       subblockInfraMaintenanceOngoingCount: 0
       subblockInfraMaintenancePendingCount: 0
       upcomingGroupMaintenance:
         canReschedule: false
         maintenanceReasons:
         -   PLANNED_UPDATE
         maintenanceStatus: ONGOING
         type: SCHEDULED
         windowEndTime: '2025-09-08T17:00:00.000-07:00'
         windowStartTime: '2025-09-08T13:00:00.000-07:00'
     reservationSubBlockCount: 2
     reservationSubBlockInUseCount: 2
     selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001
     selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/4360924059555106309
     status: READY
     zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a
   

   Le résultat inclut les champs suivants pour chaque bloc :

   • count : nombre total de VM pouvant être déployées dans le bloc.
   • healthInfo : informations sur l'état du bloc, comme suit :
     • degradedSubBlockCount : nombre de sous-blocs dégradés dans le bloc.
     • healthStatus : état de santé global du bloc.
     • healthySubBlockCount : nombre de sous-blocs en bon état dans le bloc.
   • inUseCount : nombre de VM déjà déployées dans le bloc.
   • name : nom du bloc.
   • physicalTopology : emplacement physique du bloc, qui apparaît également dans la topologie des VM, comme suit :
     • block : ID du bloc spécifique à l'organisation.
     • cluster : nom global du cluster.
     • instances : liste des noms et des emplacements physiques de toutes les VM du bloc, comme suit. (Ce champ ne s'affiche que lorsque vous incluez l'indicateur --full-view=BLOCK_VIEW_FULL.)
       • instanceId : ID d'une instance.
       • subBlock : ID spécifique à l'organisation du sous-bloc dans lequel se trouve cette instance.
       • block : ID spécifique à l'organisation du bloc dans lequel se trouve cette instance.
   • reservationSubBlockCount : nombre de sous-blocs dans le bloc.
   • reservationSubBlockInUseCount : nombre de sous-blocs dans le bloc avec au moins une VM déjà déployée.

   REST

   Vous pouvez afficher les blocs d'une réservation à l'aide des méthodes suivantes :

   • Pour afficher tous les blocs disponibles dans une réservation, envoyez une requête GET à la méthode reservationBlocks.list :

     GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks
     

   • Pour afficher un bloc spécifique dans une réservation, envoyez une requête GET à la méthode reservationBlocks.get. Pour afficher également le nom et la topologie de toutes les VM déployées dans le bloc, ajoutez le paramètre de requête ?view=FULL.

     GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME?view=FULL
     

   Remplacez les éléments suivants :

   • PROJECT_ID : ID du projet dans lequel se trouve la réservation.
   • ZONE : zone où se trouve la réservation.
   • RESERVATION_NAME : nom de la réservation.
   • BLOCK_NAME : nom du bloc.

   Le résultat de chaque bloc ressemble à ce qui suit :

   {
     "resource": {
       "kind": "compute#reservationBlock",
       "id": "4360924059555106309",
       "creationTimestamp": "2025-08-04T15:15:07.074-07:00",
       "name": "example-res1-block-0001",
       "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
       "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001",
       "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/4360924059555106309",
       "count": 36,
       "inUseCount": 35,
       "reservationMaintenance": {
         "upcomingGroupMaintenance": {
           "type": "SCHEDULED",
           "canReschedule": false,
           "windowStartTime": "2025-09-08T13:00:00.000-07:00",
           "windowEndTime": "2025-09-08T17:00:00.000-07:00",
           "maintenanceStatus": "ONGOING",
           "maintenanceReasons": [
             "PLANNED_UPDATE"
           ]
         },
         "maintenanceOngoingCount": 2,
         "maintenancePendingCount": 34,
         "schedulingType": "GROUPED",
         "subblockInfraMaintenanceOngoingCount": 0,
         "subblockInfraMaintenancePendingCount": 0,
         "instanceMaintenanceOngoingCount": 3,
         "instanceMaintenancePendingCount": 32
       },
       "status": "READY",
       "physicalTopology": {
         "cluster": "us-central1-cluster-dnkc",
         "block": "1acd074d42cd3be9e4486b524db2e9ab",
         "instances": [
           {
             "instanceId": "5815586279631866288",
             "projectId": "PROJECT_NUMBER",
             "physicalHostTopology": {
               "subBlock": "c02af6bdaeccacef571e0adbe79e8c28",
               "host": "c229b308380a83e0ca345d4a0de05aa7"
             }
           },
           ...
           {
             "instanceId": "8389759878923049076",
             "projectId": "PROJECT_NUMBER",
             "physicalHostTopology": {
               "subBlock": "c081876ba0aa2857d608eb30a5b2fa40",
               "host": "3ac534f00c20e6e0c87c3aaff2705be6"
             }
           }
         ]
       },
       "reservationSubBlockCount": 2,
       "reservationSubBlockInUseCount": 2,
       "healthInfo": {
         "healthStatus": "DEGRADED",
         "healthySubBlockCount": 0,
         "degradedSubBlockCount": 2
       }
     }
   }
   

   Le résultat inclut les champs suivants pour chaque bloc :

   • name : nom du bloc.
   • count : nombre total de VM pouvant être déployées dans le bloc.
   • inUseCount : nombre de VM déjà déployées dans le bloc.
   • physicalTopology : emplacement physique du bloc, qui apparaît également dans la topologie de la VM, comme suit :
     • cluster : nom global du cluster.
     • block : ID du bloc spécifique à l'organisation.
     • instances : liste des noms et des emplacements physiques de toutes les VM du bloc, comme suit. (Ce champ ne s'affiche que lorsque vous incluez le paramètre de requête ?view=FULL.)
       • instanceId : ID d'une instance.
       • subBlock : ID spécifique à l'organisation du sous-bloc dans lequel se trouve cette instance.
       • block : ID spécifique à l'organisation du bloc dans lequel se trouve cette instance.
   • reservationSubBlockCount : nombre de sous-blocs dans le bloc.
   • reservationSubBlockInUseCount : nombre de sous-blocs dans le bloc avec au moins une VM déjà déployée.
   • healthInfo : informations sur l'état du bloc, comme suit :
     • healthStatus : état de santé global du bloc.
     • healthySubBlockCount : nombre de sous-blocs en bon état dans le bloc.
     • degradedSubBlockCount : nombre de sous-blocs dégradés dans le bloc.

   Afficher les sous-blocs réservés

   Pour lister et décrire les sous-blocs disponibles dans un bloc d'une réservation, utilisez la Google Cloud CLI ou l'API REST. Cette tâche vous aide à déterminer les éléments suivants :

   • Sous-blocs de capacité inclus dans le bloc réservé.
   • Capacité disponible dans chaque sous-bloc.
   • État de chaque sous-bloc, y compris le nombre de machines hôtes opérationnelles et le nombre d'interconnexions d'accélérateurs opérationnelles.

   gcloud

   Vous pouvez afficher les sous-blocs d'une réservation à l'aide des commandes suivantes :

   • Pour afficher tous les sous-blocs disponibles dans un bloc d'une réservation, utilisez la commande gcloud compute reservations sub-blocks list :

     gcloud compute reservations sub-blocks list RESERVATION_NAME \
         --zone=ZONE \
         --block-name=BLOCK_NAME
     

   • Pour afficher un sous-bloc spécifique dans un bloc d'une réservation, utilisez la commande gcloud compute reservations sub-blocks describe :

     gcloud compute reservations sub-blocks describe RESERVATION_NAME \
         --zone=ZONE \
         --block-name=BLOCK_NAME \
         --sub-block-name=SUB-BLOCK_NAME
     

   Remplacez les éléments suivants :

   • RESERVATION_NAME : nom de la réservation.
   • ZONE : zone où se trouve la réservation.
   • BLOCK_NAME : nom du bloc.
   • SUB-BLOCK_NAME : nom du sous-bloc.

   Le résultat de chaque sous-bloc est semblable à ce qui suit :

   count: 18
   creationTimestamp: '2025-07-18T14:50:01.652-07:00'
   healthInfo:
     degradedHostCount: 0
     degradedInfraCount: 0
     healthStatus: HEALTHY
     healthyHostCount: 18
     healthyInfraCount: 1
   id: '6848013619223297894'
   inUseCount: 2
   kind: compute#reservationSubBlock
   name: example-res1-block-0001-subblock-0001
   physicalTopology:
     block: 2b6aa63faa2b60b7ecd3b87ec337f270
     cluster: us-central1-cluster-xvhj
     subBlock: 556a310b49a0b247bc109cc7f997cea2
   reservationSubBlockMaintenance:
     schedulingType: GROUPED
   selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001/reservationSubBlocks/example-res1-block-0001-subblock-0001
   selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001/reservationSubBlocks/6848013619223297894
   status: READY
   zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a
   

   La sortie inclut les champs suivants pour chaque sous-bloc :

   • count : nombre total de VM pouvant être déployées dans le sous-bloc.
   • healthInfo : informations sur l'état du sous-bloc, comme suit :
     • degradedHostCount : nombre de machines hôtes dégradées dans le sous-bloc.
     • degradedInfraCount : nombre d'interconnexions d'accélérateurs dégradées dans le sous-bloc.
     • healthStatus : état de santé global du sous-bloc.
     • healthyHostCount : nombre de machines hôtes saines dans le sous-bloc.
     • healthyInfraCount : nombre d'interconnexions d'accélérateurs en bon état dans le sous-bloc.
   • inUseCount : nombre de VM déjà déployées dans le sous-bloc.
   • name : nom du sous-bloc.
   • physicalTopology : emplacement physique du sous-bloc, qui apparaît également dans la topologie de la VM, comme suit :
     • block : ID du bloc spécifique à l'organisation.
     • cluster : nom global du cluster.
     • subblock : ID spécifique à l'organisation du sous-bloc.

   REST

   Vous pouvez afficher les sous-blocs d'une réservation à l'aide des méthodes suivantes :

   • Pour afficher tous les sous-blocs disponibles dans un bloc d'une réservation, envoyez une requête GET à la méthode reservationSubBlocks.list :

     GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME/reservationSubBlocks
     

   • Pour afficher un sous-bloc spécifique dans un bloc d'une réservation, envoyez une requête GET à la méthode reservationSubBlocks.get :

     GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME/reservationSubBlocks/SUB-BLOCK_NAME
     

   Remplacez les éléments suivants :

   • PROJECT_ID : ID du projet dans lequel se trouve la réservation.
   • ZONE : zone où se trouve la réservation.
   • RESERVATION_NAME : nom de la réservation.
   • BLOCK_NAME : nom du bloc.
   • SUB-BLOCK_NAME : nom du sous-bloc.

   Le résultat de chaque sous-bloc est semblable à ce qui suit :

   {
     "resource": {
       "kind": "compute#reservationSubBlock",
       "id": "5679680646666817028",
       "creationTimestamp": "2025-08-04T15:15:07.625-07:00",
       "name": "example-res1-block-0001-subblock-0001",
       "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
       "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001/reservationSubBlocks/example-res1-block-0001-subblock-0001",
       "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001/reservationSubBlocks/5679680646666817028",
       "count": 18,
       "inUseCount": 18,
       "reservationSubBlockMaintenance": {
         "upcomingGroupMaintenance": {
           "type": "SCHEDULED",
           "canReschedule": false,
           "windowStartTime": "2025-09-08T13:00:00.000-07:00",
           "windowEndTime": "2025-09-08T17:00:00.000-07:00",
           "maintenanceStatus": "ONGOING",
           "maintenanceReasons": [
             "PLANNED_UPDATE"
           ]
         },
         "maintenanceOngoingCount": 2,
         "maintenancePendingCount": 16,
         "schedulingType": "GROUPED",
         "subblockInfraMaintenanceOngoingCount": 0,
         "subblockInfraMaintenancePendingCount": 0,
         "instanceMaintenanceOngoingCount": 3,
         "instanceMaintenancePendingCount": 15
       },
       "status": "READY",
       "physicalTopology": {
         "cluster": "us-central1-cluster-dnkc",
         "block": "1acd074d42cd3be9e4486b524db2e9ab",
         "subBlock": "c081876ba0aa2857d608eb30a5b2fa40"
       },
       "healthInfo": {
         "healthStatus": "DEGRADED",
         "healthyHostCount": 16,
         "degradedHostCount": 2,
         "healthyInfraCount": 1,
         "degradedInfraCount": 0
       }
     }
   }
   

   La sortie inclut les champs suivants pour chaque sous-bloc :

   • name : nom du sous-bloc.
   • count : nombre total de VM pouvant être déployées dans le sous-bloc.
   • inUseCount : nombre de VM déjà déployées dans le sous-bloc.
   • physicalTopology : emplacement physique du sous-bloc, qui apparaît également dans la topologie de la VM, comme suit :
     • cluster : nom global du cluster.
     • block : ID du bloc spécifique à l'organisation.
     • subblock : ID spécifique à l'organisation du sous-bloc.
   • healthInfo : informations sur l'état du sous-bloc, comme suit :
     • healthStatus : état de santé global du sous-bloc.
     • healthyHostCount : nombre de machines hôtes saines dans le sous-bloc.
     • degradedHostCount : nombre de machines hôtes dégradées dans le sous-bloc.
     • healthyInfraCount : nombre d'interconnexions d'accélérateurs en bon état dans le sous-bloc.
     • degradedInfraCount : nombre d'interconnexions d'accélérateurs dégradées dans le sous-bloc.

   Étapes suivantes

   • Présentation de la création de VM et de clusters
   • Afficher la consommation de réservations
   Envoyer des commentaires