Visualizzare la capacità riservata

Questo documento spiega come visualizzare le richieste di capacità riservata e la capacità riservata per AI Hypercomputer. 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 AI Hypercomputer, consulta Panoramica della 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. Successivamente, all'ora di inizio richiesta, si verifica quanto segue:

  • Compute Engine aggiunge le istanze di macchine virtuali (VM) riservate alla prenotazione. Puoi quindi iniziare a utilizzare la prenotazione creando VM che corrispondono alla prenotazione.
  • Puoi modificare la prenotazione per consentire ai job di addestramento o previsione di Vertex AI di utilizzarla. Per istruzioni, vedi Modifica la policy di condivisione di una prenotazione.

Limitazioni

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

Prima di iniziare

  1. Riserva capacità:se non l'hai già fatto, riserva capacità per AI Hypercomputer utilizzando una delle seguenti opzioni:

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

    Console

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

    gcloud

    In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

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

    REST

    Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi 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.

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

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

    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 workload.
    • 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 tue prenotazioni nel 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-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"
}

    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.
    • Lo stato della prenotazione, incluso il numero di blocchi integri. (Disponibile solo utilizzando gcloud CLI o REST).

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

    L'output include i seguenti campi per la prenotazione:

    • name: il nome della prenotazione.
    • healthInfo: le informazioni sanitarie per la prenotazione come segue:
      • degradedBlockCount: il numero di blocchi danneggiati nella prenotazione.
      • healthStatus: lo stato di integrità generale della prenotazione.
      • healthyBlockCount: il numero di blocchi integri nella prenotazione.
    • reservationBlockCount: il numero totale di blocchi nella prenotazione.
    • assuredCount: il numero totale di VM che possono essere sottoposte a deployment 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 implementate 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": "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"
}

    L'output include i seguenti campi per la prenotazione:

    • instanceProperties: le proprietà delle VM che possono essere implementate nella prenotazione.
    • inUseCount: il numero di VM già implementate nella prenotazione.
    • assuredCount: il numero totale di VM che possono essere sottoposte a deployment 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.
    • healthInfo: le informazioni sanitarie per la prenotazione come segue:
      • healthStatus: lo stato di integrità generale della prenotazione.
      • healthyBlockCount: il numero di blocchi integri nella prenotazione.
      • degradedBlockCount: il numero di blocchi danneggiati nella 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, consulta Visualizza la topologia di un'istanza di calcolo.

    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.
    • Lo stato di integrità di ogni blocco, incluso il numero di blocchi secondari integri. (Disponibile solo utilizzando gcloud CLI o REST).
    • Il nome, il blocco e il blocco secondario di tutte le VM di cui è stato eseguito il deployment nel blocco. (Disponibile solo quando visualizzi 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 è possibile eseguire 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 comando gcloud compute reservations blocks list: 
      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'
  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

    L'output include i seguenti campi per ogni blocco:

    • count: il numero totale di VM che possono essere implementate nel blocco.
    • healthInfo: le informazioni sullo stato del blocco come segue:
      • degradedSubBlockCount: il numero di sottoblocchi degradati nel blocco.
      • healthStatus: lo stato di integrità complessivo del blocco.
      • healthySubBlockCount: il numero di sottoblocchi integri nel blocco.
    • inUseCount: il numero di VM già implementate 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,
    "healthInfo": {
      "healthStatus": "DEGRADED",
      "healthySubBlockCount": 0,
      "degradedSubBlockCount": 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 Topologia VM, 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.
    • healthInfo: le informazioni sullo stato del blocco come segue:
      • healthStatus: lo stato di integrità complessivo del blocco.
      • healthySubBlockCount: il numero di sottoblocchi integri nel blocco.
      • degradedSubBlockCount: il numero di sottoblocchi degradati nel blocco.

    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.
    • Lo stato di ogni sottoblocco, incluso il numero di macchine host in stato integro e il numero di interconnessioni dell'acceleratore in stato integro.

    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'
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

    L'output include i seguenti campi per ogni sottoblocco:

    • count: il numero totale di VM che possono essere implementate nel sottoblocco.
    • healthInfo: le informazioni sullo stato di integrità del sottoblocco come segue:
      • degradedHostCount: il numero di macchine host degradate nel sottoblocco.
      • degradedInfraCount: il numero di interconnessioni dell'acceleratore degradate nel sottoblocco.
      • healthStatus: lo stato di integrità complessivo del sottoblocco.
      • healthyHostCount: il numero di macchine host integre nel sottoblocco.
      • healthyInfraCount: il numero di interconnessioni di acceleratori integre 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"
    },
    "healthInfo": {
      "healthStatus": "DEGRADED",
      "healthyHostCount": 16,
      "degradedHostCount": 2,
      "healthyInfraCount": 1,
      "degradedInfraCount": 0
    }
  }
}

    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.
    • healthInfo: le informazioni sullo stato di integrità del sottoblocco come segue:
      • healthStatus: lo stato di integrità complessivo del sottoblocco.
      • healthyHostCount: il numero di macchine host integre nel sottoblocco.
      • degradedHostCount: il numero di macchine host degradate nel sottoblocco.
      • healthyInfraCount: il numero di interconnessioni di acceleratori integre nel sottoblocco.
      • degradedInfraCount: il numero di interconnessioni dell'acceleratore degradate nel sottoblocco.

    Passaggi successivi