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. In un secondo momento, all'ora di inizio richiesta, si verifica quanto segue:

  • Compute Engine aggiunge le istanze Compute Engine riservate alla prenotazione. Puoi quindi iniziare a utilizzare la prenotazione creando istanze di calcolo corrispondenti alla prenotazione.
  • Puoi modificare la prenotazione per consentire ai job di addestramento o di 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 Google l'ha creata.

Prima di iniziare

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

  2. Seleziona la scheda relativa a come intendi utilizzare i campioni in questa pagina:

    Console

    Quando utilizzi la console Google Cloud per accedere ai servizi Google Cloud e alle API, non devi configurare l'autenticazione.

    gcloud

    Nella console Google Cloud , attiva Cloud Shell.

    Attiva Cloud Shell

    Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell e viene visualizzato un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installata e con valori già impostati per il progetto corrente. L'inizializzazione della sessione può richiedere alcuni secondi.

    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.

      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 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 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, invia 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 istanze di calcolo sono inclusi nella prenotazione.
  • Quante istanze di computing sono riservate e disponibili nella prenotazione.
  • Lo stato della prenotazione, incluso il numero di blocchi integri. (Disponibile solo tramite 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 degradati 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 implementate utilizzando la prenotazione. Se questo valore è inferiore a count, scopri come risolvere il problema Meno VM disponibili per il consumo.
  • inUseCount: il numero di VM già di cui è stato eseguito il deployment nella prenotazione.
  • instanceProperties: le proprietà delle VM che possono essere sottoposte a deployment 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 istanze di computing che possono essere sottoposte a deployment nella prenotazione.
  • inUseCount: il numero di istanze di computing già di cui è stato eseguito il deployment nella prenotazione.
  • assuredCount: il numero totale di istanze di computing che possono essere sottoposte a deployment utilizzando la prenotazione. Se questo valore è inferiore a count, scopri come risolvere il problema Meno VM disponibili per il consumo.
  • 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 degradati nella prenotazione.

Visualizzare la topologia di una prenotazione

Puoi visualizzare le informazioni dettagliate sulla topologia di una prenotazione per decidere dove creare istanze di computing all'interno dei blocchi e dei sottoblocchi riservati. Per informazioni sul posizionamento delle istanze di computing riservate già implementate, consulta Visualizzare la topologia di un'istanza di computing.

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 tramite gcloud CLI o REST).
  • Il nome, il blocco e il sottoblocco di tutte le istanze di Compute Engine 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 istanze di calcolo che possono essere implementate nel blocco.
    • In uso: il numero di istanze di computing 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 istanze di Compute Engine 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 istanze di computing che possono essere implementate nel blocco.
  • healthInfo: le informazioni sullo stato di salute 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 istanze di computing già implementate nel blocco.
  • name: il nome del blocco.
  • physicalTopology: la posizione fisica del blocco, che viene visualizzata anche nella topologia dell'istanza di calcolo, 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 istanze di computing nel blocco come segue. (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 blocchi secondari nel blocco con almeno un'istanza di computing già implementata.

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 istanze di Compute Engine 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 istanze di computing che possono essere sottoposte a deployment nel blocco.
  • inUseCount: il numero di istanze di computing già di cui è stato eseguito il deployment nel blocco.
  • physicalTopology: la posizione fisica del blocco, che viene visualizzata anche in topologia dell'istanza di computing, 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 istanze di computing nel blocco come segue. 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 sottoblocco in cui si trova questa istanza di computing.
      • block: l'ID specifico dell'organizzazione del blocco in cui si trova questa istanza di computing.
  • reservationSubBlockCount: il numero di sottoblocchi nel blocco.
  • reservationSubBlockInUseCount: il numero di blocchi secondari nel blocco con almeno un'istanza di computing già implementata.
  • healthInfo: le informazioni sullo stato di salute 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 istanze di computing che possono essere sottoposte a deployment 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 dell'acceleratore integre nel sottoblocco.
  • inUseCount: il numero di istanze di computing già implementate nel sottoblocco.
  • name: il nome del sottoblocco.
  • physicalTopology: la posizione fisica del sottoblocco, che viene visualizzata anche nella topologia dell'istanza di computing, 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 istanze di computing che possono essere sottoposte a deployment nel sottoblocco.
  • inUseCount: il numero di istanze di computing già implementate nel sottoblocco.
  • physicalTopology: la posizione fisica del sottoblocco, che viene visualizzata anche nella topologia dell'istanza di computing, 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