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 Compute Engine réservées à la réservation. Vous pouvez ensuite commencer à utiliser la réservation en créant des instances de calcul 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 :

  2. 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 Google Cloud et aux API, vous n'avez pas besoin de configurer l'authentification.

    gcloud

    Dans la console Google Cloud , activez Cloud Shell.

    Activer Cloud Shell

    En bas de la console Google Cloud , une session Cloud Shell démarre et affiche une invite de ligne de commande. Cloud Shell est un environnement shell dans lequel Google Cloud CLI est déjà installé, et dans lequel des valeurs sont déjà définies pour votre projet actuel. L'initialisation de la session peut prendre quelques secondes.

    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.

      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 des réservations futures 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 :

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éservations futures, 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 :

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

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 requête 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'ouvre.

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 sur laquelle porte 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.
  • Comprendre 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 :

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 votre liste de 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 :

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 d'instances de calcul inclus dans la réservation.
  • Nombre d'instances de calcul 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é réduite des 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 instances de calcul pouvant être déployées dans la réservation.
  • inUseCount : nombre d'instances de calcul déjà déployées dans la réservation.
  • assuredCount : nombre total d'instances de calcul 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é réduite des 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 instances de calcul dans les blocs et sous-blocs réservés. Pour en savoir plus sur l'emplacement des instances de calcul 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 instances de calcul 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. Pour chaque bloc, ces informations incluent les éléments suivants :
    • ID du bloc : nom du bloc.
    • Nombre : nombre total d'instances de calcul pouvant être déployées dans le bloc.
    • En cours d'utilisation : nombre d'instances de calcul 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 instances de calcul 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 d'instances de calcul 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 d'instances de calcul 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 instances de calcul, 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 instances de calcul 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 instance de calcul 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 instances de calcul 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 d'instances de calcul pouvant être déployées dans le bloc.
  • inUseCount : nombre d'instances de calcul déjà déployées dans le bloc.
  • physicalTopology : emplacement physique du bloc, qui apparaît également dans la topologie des instances de calcul, 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 instances de calcul 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 de calcul.
      • block : ID spécifique à l'organisation du bloc dans lequel se trouve cette instance de calcul.
  • reservationSubBlockCount : nombre de sous-blocs dans le bloc.
  • reservationSubBlockInUseCount : nombre de sous-blocs dans le bloc avec au moins une instance de calcul 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 sains 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.
  • L'é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 :

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 d'instances de calcul 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 d'instances de calcul 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 des instances de calcul, 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 d'instances de calcul pouvant être déployées dans le sous-bloc.
  • inUseCount : nombre d'instances de calcul déjà déployées dans le sous-bloc.
  • physicalTopology : emplacement physique du sous-bloc, qui apparaît également dans la topologie des instances de calcul, 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