Visualizzare la capacità riservata

Questo documento spiega come visualizzare le richieste di capacità riservata e la capacità riservata per i cluster HPC con VM H4D e funzionalità di gestione avanzate. Visualizzando la disponibilità, le proprietà e la topologia della capacità e delle richieste riservate, puoi pianificare la capacità riservata per i tuoi carichi di lavoro.

L'ambito di questo documento è limitato ai workload che utilizzano un'opzione di capacità che menziona le prenotazioni future. Per saperne di più sulle opzioni di capacità per i cluster HPC con VM H4D e sulle funzionalità di gestione avanzate, consulta Scegli un'opzione di consumo e ottieni capacità.

Dopo che Google Cloud approva una richiesta di prenotazione futura, Compute Engine crea automaticamente (crea automaticamente) una prenotazione vuota per le risorse richieste. Puoi quindi visualizzare la prenotazione per pianificare il carico di lavoro. In un secondo momento, all'ora di inizio richiesta, Compute Engine aggiunge le istanze di macchine virtuali (VM) dedicate alla prenotazione. Puoi quindi iniziare a utilizzare la prenotazione creando VM che corrispondono alla prenotazione.

Prima di iniziare

  • Prenota capacità:se non l'hai già fatto, prenota la capacità per le istanze H4D utilizzando una delle seguenti opzioni:

  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione verifica la tua identità per l'accesso a Google Cloud servizi e API. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:

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

    Console

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

    gcloud

    1. Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il comando seguente: 

      gcloud init

      Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

    2. Set a default region and zone.

    REST

    Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali che fornisci a gcloud CLI.

      Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il comando seguente: 

      gcloud init

      Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

    Per saperne di più, consulta Autenticati per usare REST nella documentazione sull'autenticazione di Google Cloud .

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per visualizzare le prenotazioni, chiedi all'amministratore di concederti il ruolo IAM Compute Future Reservation User (roles/compute.futureReservationUser) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per visualizzare le prenotazioni. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare le prenotazioni sono necessarie le seguenti autorizzazioni:

  • Per visualizzare i dettagli di una richiesta di prenotazione futura: compute.futureReservations.get sul progetto
  • Per visualizzare i dettagli di una prenotazione: compute.reservations.get sul progetto

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Limitazioni

Puoi visualizzare una prenotazione condivisa o una richiesta di prenotazione futura condivisa solo nel progetto in cui è stata creata da Google.

Visualizzare le richieste di capacità riservata

Per visualizzare le tue richieste di prenotazione futura, utilizza uno o più dei seguenti metodi:

Visualizzare un elenco delle tue richieste di prenotazione futura

Puoi visualizzare un elenco delle tue richieste di prenotazione futura per vedere il periodo di prenotazione, lo stato e la zona delle tue richieste.

Per visualizzare un elenco delle tue richieste di prenotazione futura, seleziona una delle seguenti opzioni:

Console

  1. Nella console Google Cloud , vai alla pagina Prenotazioni.

    Vai a Prenotazioni

  2. Fai clic sulla scheda Prenotazioni future. La tabella elenca ogni richiesta di prenotazione futura e ogni colonna della tabella descrive una proprietà.
  3. (Facoltativo) Per perfezionare l'elenco delle richieste, nel campo Filtro seleziona le proprietà in base alle quali filtrare le richieste.

gcloud

Per visualizzare un elenco delle tue richieste di prenotazione futura, utilizza il comando gcloud compute future-reservations list: 

gcloud compute future-reservations list

L'output è simile al seguente:

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

Se vuoi perfezionare l'elenco delle richieste di prenotazione future, utilizza lo stesso comando con il flag --filter.

REST

Per visualizzare un elenco delle tue richieste di prenotazione futura, invia una richiesta GET a uno dei seguenti metodi:

Ad esempio, per visualizzare un elenco di richieste in tutte le zone, invia una richiesta GET come segue:

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

Sostituisci PROJECT_ID con l'ID del progetto in cui esistono le richieste.

L'output per un elenco di richieste di prenotazione futura in una singola zona è simile al seguente:

{
  "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"
}

Se vuoi perfezionare l'elenco delle richieste di prenotazione futura, invia la stessa richiesta e, nell'URL della richiesta, includi il parametro di query filter.

Visualizzare i dettagli di una richiesta di prenotazione futura

Puoi visualizzare i dettagli di una richiesta di prenotazione futura per esaminare le proprietà e il periodo di prenotazione delle risorse prenotate.

Per visualizzare i dettagli di una richiesta di prenotazione futura, seleziona una delle seguenti opzioni:

Console

  1. Nella console Google Cloud , vai alla pagina Prenotazioni.

    Vai a Prenotazioni

  2. Fai clic sulla scheda Prenotazioni future. La tabella elenca ogni richiesta di prenotazione futura e ogni colonna della tabella descrive una proprietà.
  3. Per visualizzare i dettagli di una richiesta, fai clic sul nome della richiesta nella colonna Nome. Viene visualizzata una pagina con i dettagli della richiesta di prenotazione futura.

gcloud

Per visualizzare i dettagli di una richiesta di prenotazione futura, utilizza il comando gcloud compute future-reservations describe:

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

Sostituisci quanto segue:

  • FUTURE_RESERVATION_NAME: il nome della richiesta di prenotazione futura
  • ZONE: la zona in cui esiste la richiesta di prenotazione futura.

L'output è simile al seguente:

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

Per visualizzare i dettagli di una richiesta di prenotazione futura, invia una richiesta GET al metodo futureReservations.get:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui esiste la richiesta di prenotazione futura
  • ZONE: la zona in cui esiste la richiesta di prenotazione futura.
  • FUTURE_RESERVATION_NAME: il nome della richiesta di prenotazione futura

L'output è simile al seguente:

{
  "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"
}

Visualizzare la capacità riservata

Visualizza la capacità prenotata quando vuoi eseguire una o più delle seguenti operazioni:

  • Identifica una prenotazione, un blocco e un sottoblocco che vuoi utilizzare per il deployment di un carico di lavoro.
  • Comprendi le proprietà, l'utilizzo e la topologia della capacità riservata.

Per visualizzare la capacità prenotata, utilizza uno o più dei seguenti metodi:

Visualizzare un elenco delle prenotazioni

Puoi visualizzare un elenco delle prenotazioni nel tuo progetto per vedere tutta la capacità riservata nel progetto e cercare una prenotazione da utilizzare per il deployment del tuo workload.

Per visualizzare un elenco delle prenotazioni, seleziona una delle seguenti opzioni:

Console

  1. Nella console Google Cloud , vai alla pagina Prenotazioni.

    Vai a Prenotazioni

    Nella scheda Prenotazioni on demand (predefinita), la tabella elenca ogni prenotazione e ogni colonna della tabella descrive una proprietà.

  2. (Facoltativo) Per perfezionare l'elenco delle prenotazioni, nel campo Filtro seleziona le proprietà in base alle quali filtrare le prenotazioni.

gcloud

Per visualizzare un elenco delle tue prenotazioni, utilizza il comando gcloud compute reservations list: 

gcloud compute reservations list

L'output è simile al seguente:

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

Se vuoi perfezionare l'elenco delle prenotazioni, utilizza lo stesso comando con il flag --filter.

REST

Per visualizzare un elenco delle tue prenotazioni, invia una richiesta GET a uno dei seguenti metodi:

Ad esempio, per visualizzare un elenco delle tue prenotazioni in tutte le zone, effettua una richiesta GET come segue:

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

Sostituisci PROJECT_ID con l'ID del progetto in cui esistono le prenotazioni.

L'output per un elenco di prenotazioni in una singola zona è simile al seguente:

{
  "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"
}

Se vuoi perfezionare l'elenco delle prenotazioni, invia la stessa richiesta e, nell'URL della richiesta, includi il parametro di query filter.

Visualizzare i dettagli di una prenotazione

Puoi visualizzare i dettagli di una prenotazione nel tuo progetto per comprendere dettagli come i seguenti:

  • Quali tipi di VM sono inclusi nella prenotazione.
  • Il numero di VM prenotate e disponibili nella prenotazione.

Se vuoi comprendere i blocchi e i sottoblocchi di una prenotazione, consulta Visualizzare la topologia di una prenotazione.

Per visualizzare i dettagli di una prenotazione, seleziona una delle seguenti opzioni:

Console

  1. Nella console Google Cloud , vai alla pagina Prenotazioni.

    Vai a Prenotazioni

  2. Nella tabella Prenotazioni on demand, nella colonna Nome, fai clic sul nome della prenotazione di cui vuoi visualizzare i dettagli. Viene visualizzata una pagina con i dettagli della prenotazione.

gcloud

Per visualizzare i dettagli di una prenotazione, utilizza il comando gcloud compute reservations describe:

gcloud compute reservations describe RESERVATION_NAME \
    --zone=ZONE

Sostituisci quanto segue:

  • RESERVATION_NAME: il nome della prenotazione.
  • ZONE: la zona in cui esiste la prenotazione.

L'output è simile al seguente:

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.googleapis.com/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.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a

L'output include i seguenti campi per la prenotazione:

  • name: il nome della prenotazione.
  • reservationBlockCount: il numero totale di blocchi nella prenotazione.
  • assuredCount: il numero totale di VM che possono essere implementate utilizzando la prenotazione. Se questo valore è inferiore a count, scopri come risolvere il problema Meno VM disponibili per l'utilizzo.
  • inUseCount: il numero di VM già implementate nella prenotazione.
  • instanceProperties: le proprietà delle VM che possono essere deployate nella prenotazione.

REST

Per visualizzare i dettagli di una prenotazione, invia una richiesta GET al metodo reservations.get:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui esiste la prenotazione.
  • ZONE: la zona in cui esiste la prenotazione.
  • RESERVATION_NAME: il nome della prenotazione.

L'output è simile al seguente:

{
  "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"
}

L'output include i seguenti campi per la prenotazione:

  • instanceProperties: le proprietà delle VM che possono essere deployate nella prenotazione.
  • inUseCount: il numero di VM già implementate nella prenotazione.
  • assuredCount: il numero totale di VM che possono essere implementate utilizzando la prenotazione. Se questo valore è inferiore a count, scopri come risolvere il problema Meno VM disponibili per l'utilizzo.
  • name: il nome della prenotazione.

Visualizzare la topologia di una prenotazione

Puoi visualizzare le informazioni dettagliate sulla topologia di una prenotazione per decidere dove creare le VM all'interno dei blocchi e dei sottoblocchi riservati. Per informazioni sul posizionamento delle VM riservate già deployate, vedi Visualizzare la topologia del cluster H4D.

Se vuoi visualizzare altri dettagli su una prenotazione, consulta Visualizzare i dettagli di una prenotazione.

Visualizzare i blocchi riservati

Per elencare e descrivere i blocchi disponibili in una prenotazione, utilizza uno dei seguenti metodi. Questa attività ti aiuta a determinare quanto segue:

  • Quali blocchi di capacità sono inclusi nella prenotazione.
  • Quanta capacità è disponibile in ogni blocco.
  • Il nome, il blocco e il blocco secondario di tutte le VM di cui è stato eseguito il deployment nel blocco. (Disponibile solo quando si visualizza un blocco specifico utilizzando gcloud CLI o REST.)

Console

  1. Nella console Google Cloud , vai alla pagina Prenotazioni.

    Vai a Prenotazioni

  2. Nella tabella Prenotazioni on demand, nella colonna Nome, fai clic sul nome della prenotazione di cui vuoi visualizzare i dettagli. Viene visualizzata la pagina dei dettagli della prenotazione.
  3. Nella sezione Topologia delle risorse, puoi visualizzare informazioni sui blocchi riservati. Queste informazioni includono quanto segue per ogni blocco:
    • ID blocco: il nome del blocco.
    • Conteggio: il numero totale di VM di cui può essere eseguito il deployment nel blocco.
    • In uso: il numero di VM già implementate nel blocco.

gcloud

Puoi visualizzare i blocchi in una prenotazione utilizzando i seguenti comandi:

  • Per visualizzare tutti i blocchi disponibili in una prenotazione, utilizza il gcloud compute reservations blocks list comando: 
    gcloud compute reservations blocks list RESERVATION_NAME \
    --zone=ZONE
  • Per visualizzare un blocco specifico in una prenotazione, utilizza il comando gcloud compute reservations blocks describe. Per visualizzare anche il nome e la topologia di tutte le VM di cui è stato eseguito il deployment nel blocco, aggiungi il flag --full-view=BLOCK_VIEW_FULL. 
    gcloud compute reservations blocks describe RESERVATION_NAME \
    --zone=ZONE \
    --block-name=BLOCK_NAME \
    --full-view=BLOCK_VIEW_FULL

Sostituisci quanto segue:

  • RESERVATION_NAME: il nome della prenotazione.
  • ZONE: la zona in cui esiste la prenotazione.
  • BLOCK_NAME: il nome del blocco.

L'output per ogni blocco è simile al seguente esempio:

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

L'output include i seguenti campi per ogni blocco:

  • count: il numero totale di VM che possono essere implementate nel blocco.
  • inUseCount: il numero di VM già di cui è stato eseguito il deployment nel blocco.
  • name: il nome del blocco.
  • physicalTopology: la posizione fisica del blocco, che viene visualizzata anche nella topologia delle VM, come segue:
    • block: l'ID specifico dell'organizzazione del blocco.
    • cluster: il nome globale del cluster.
    • instances: un elenco dei nomi e delle posizioni fisiche di tutte le VM nel blocco nel seguente modo. (Questo campo viene visualizzato solo quando includi il flag --full-view=BLOCK_VIEW_FULL.)
      • instanceId: l'ID di un'istanza.
      • subBlock: l'ID specifico dell'organizzazione del sotto-blocco in cui si trova questa istanza.
      • block: l'ID specifico dell'organizzazione del blocco in cui si trova questa istanza.
  • reservationSubBlockCount: il numero di sottoblocchi nel blocco.
  • reservationSubBlockInUseCount: il numero di sottoblocchi nel blocco con almeno una VM già di cui è stato eseguito il deployment.

REST

Puoi visualizzare i blocchi in una prenotazione utilizzando i seguenti metodi:

  • Per visualizzare tutti i blocchi disponibili in una prenotazione, invia una richiesta GET al metodo reservationBlocks.list: 
    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks
  • Per visualizzare un blocco specifico in una prenotazione, invia una richiesta GET al metodo reservationBlocks.get. Per visualizzare anche il nome e la topologia di tutte le VM di cui è stato eseguito il deployment nel blocco, aggiungi il parametro di query ?view=FULL. 
    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME?view=FULL

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui esiste la prenotazione.
  • ZONE: la zona in cui esiste la prenotazione.
  • RESERVATION_NAME: il nome della prenotazione.
  • BLOCK_NAME: il nome del blocco.

L'output per ogni blocco è simile al seguente:

{
  "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
  }
}

L'output include i seguenti campi per ogni blocco:

  • name: il nome del blocco.
  • count: il numero totale di VM che possono essere implementate nel blocco.
  • inUseCount: il numero di VM già implementate nel blocco.
  • physicalTopology: la posizione fisica del blocco, che viene visualizzata anche in Visualizza la topologia del cluster H4D, come segue:
    • cluster: il nome globale del cluster.
    • block: l'ID specifico dell'organizzazione del blocco.
    • instances: un elenco dei nomi e delle posizioni fisiche di tutte le VM nel blocco nel seguente modo. (Questo campo viene visualizzato solo quando includi il parametro di query ?view=FULL.)
      • instanceId: l'ID di un'istanza.
      • subBlock: l'ID specifico dell'organizzazione del sotto-blocco in cui si trova questa istanza.
      • block: l'ID specifico dell'organizzazione del blocco in cui si trova questa istanza.
  • reservationSubBlockCount: il numero di sottoblocchi nel blocco.
  • reservationSubBlockInUseCount: il numero di sottoblocchi nel blocco con almeno una VM già di cui è stato eseguito il deployment.

Visualizzare i sottoblocchi riservati

Per elencare e descrivere i sottoblocchi disponibili in un blocco di una prenotazione, utilizza Google Cloud CLI o l'API REST. Questa attività ti aiuta a determinare quanto segue:

  • Quali blocchi secondari di capacità si trovano nel blocco riservato.
  • Quanta capacità è disponibile in ogni sottoblocco.

gcloud

Puoi visualizzare i blocchi secondari in una prenotazione utilizzando i seguenti comandi:

Sostituisci quanto segue:

  • RESERVATION_NAME: il nome della prenotazione.
  • ZONE: la zona in cui esiste la prenotazione.
  • BLOCK_NAME: il nome del blocco.
  • SUB-BLOCK_NAME: il nome del sottoblocco.

L'output per ogni sottoblocco è simile al seguente:

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

L'output include i seguenti campi per ogni sottoblocco:

  • count: il numero totale di VM che possono essere implementate nel sottoblocco.
  • inUseCount: il numero di VM già di cui è stato eseguito il deployment nel sottoblocco.
  • name: il nome del sottoblocco.
  • physicalTopology: la posizione fisica del sottoblocco, che viene visualizzata anche nella topologia delle VM, come segue:
    • block: l'ID specifico dell'organizzazione del blocco.
    • cluster: il nome globale del cluster.
    • subblock: l'ID specifico dell'organizzazione del blocco secondario.

REST

Puoi visualizzare i blocchi secondari in una prenotazione utilizzando i seguenti metodi:

  • Per visualizzare tutti i sottoblocchi disponibili in un blocco di una prenotazione, invia una richiesta GET al metodo reservationSubBlocks.list: 
    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME/reservationSubBlocks
  • Per visualizzare un sottoblocco specifico in un blocco di una prenotazione, invia una richiesta GET al metodo reservationSubBlocks.get: 
    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME/reservationSubBlocks/SUB-BLOCK_NAME

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui esiste la prenotazione.
  • ZONE: la zona in cui esiste la prenotazione.
  • RESERVATION_NAME: il nome della prenotazione.
  • BLOCK_NAME: il nome del blocco.
  • SUB-BLOCK_NAME: il nome del sottoblocco.

L'output per ogni sottoblocco è simile al seguente:

{
  "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"
    }
  }
}

L'output include i seguenti campi per ogni sottoblocco:

  • name: il nome del sottoblocco.
  • count: il numero totale di VM che possono essere implementate nel sottoblocco.
  • inUseCount: il numero di VM già di cui è stato eseguito il deployment nel sottoblocco.
  • physicalTopology: la posizione fisica del sottoblocco, che viene visualizzata anche nella topologia delle VM, come segue:
    • cluster: il nome globale del cluster.
    • block: l'ID specifico dell'organizzazione del blocco.
    • subblock: l'ID specifico dell'organizzazione del blocco secondario.

Passaggi successivi