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 les clusters HPC avec des VM H4D et des fonctionnalités de gestion améliorées. 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é pour les clusters HPC avec des VM H4D et des fonctionnalités de gestion améliorées, consultez Choisir une option de consommation et obtenir de la capacité.

Une fois que Cloud de Confiance by S3NS 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 consulter la réservation pour planifier votre charge de travail. Plus tard, à l'heure de début demandée, 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.

Avant de commencer

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.

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.

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 Cloud de Confiance , 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": "h4d-standard-192-lssd",
          "localSsds": [
            {
              "diskSizeGb": "375",
              "interface": "NVME"
            },
            ...
          ]
        },
        "totalCount": "8"
      },
      "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/us-central1-a/futureReservations/example-draft-request",
      "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/futureReservations/7979651787097007552",
      "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
      "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 Cloud de Confiance , 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": "h4d-standard-192"
    },
    "totalCount": "8"
  },
  "kind": "compute#futureReservation",
  "id": "7201773389437194422",
  "creationTimestamp": "2025-11-27T11:14:58.305-08:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/futureReservations/example-draft-request",
  "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/futureReservations/7201773389437194422",
  "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
  "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": "GROUPED",
  "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 Cloud de Confiance , 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-west4-b/futureReservations",
  "items": [
    {
      "specificSkuProperties": {
        "instanceProperties": {
          "machineType": "h4d-highmem-192-lssd",
          "localSsds": [
            {
              "diskSizeGb": "375",
              "interface": "NVME"
            }
          ]
        },
        "totalCount": "8"
      },
      "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-west4-b/futureReservations/example-draft-request",
      "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west4-b/futureReservations/7979651787097007552",
      "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west4-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": "GROUPED",
      "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
    }
    ...
  ],
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west4-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.

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 Cloud de Confiance , 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: HIGHLY_AVAILABLE_CAPACITY
creationTimestamp: '2025-11-20T15:49:02.541-07:00'
deleteAtTime: '2026-01-31T07:00:00Z'
deploymentType: DENSE
id: '5555834036379788721'
kind: compute#reservation
name: example-res1
reservationSharingPolicy:
  serviceShareType: DISALLOW_ALL
resourceStatus:
  reservationBlockCount: 1
  reservationMaintenance:
    schedulingType: GROUPED
schedulingType: GROUPED
selfLink: https://www.s3nsapis.fr/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1
shareSettings:
  shareType: LOCAL
specificReservation:
  assuredCount: '8'
  count: '8'
  inUseCount: '0'
  instanceProperties:
    machineType: h4d-highmem-192
    minCpuPlatform: Any CPU Platform
specificReservationRequired: true
status: READY
zone: https://www.s3nsapis.fr/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.
  • 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": "h4d-highmem-192-lssd",
      "minCpuPlatform": "Any CPU Platform",
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        }
      ]
    },
    "count": "8",
    "inUseCount": "0",
    "assuredCount": "8"
  },
  "kind": "compute#reservation",
  "id": "5555834036379788721",
  "creationTimestamp": "2025-11-20T15:49:02.541-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": "LOCAL"
  },
  "resourceStatus": {
    "reservationMaintenance": {
      "schedulingType": "INDEPENDENT"
    },
    "reservationBlockCount": 1
  },
  "reservationSharingPolicy": {
    "serviceShareType": "DISALLOW_ALL"
  },
  "deploymentType": "DENSE",
  "advancedDeploymentControl": {
    "reservationOperationalMode": "HIGHLY_AVAILABLE_CAPACITY"
  },
  "schedulingType": "INDEPENDENT",
  "deleteAtTime": "2026-01-31T07: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é réduite des VM.
  • name : nom de 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 du cluster H4D.

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.
  • 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 Cloud de Confiance , 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 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'
  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.
  • 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 de la 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
  }
}

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 Afficher la topologie du cluster H4D, 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 VM.
      • block : ID spécifique à l'organisation du bloc dans lequel se trouve cette VM.
  • 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.

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.

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'
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.
  • 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"
    }
  }
}

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

Étapes suivantes