Creare una richiesta di prenotazione futura in modalità calendario

Anteprima

Questo prodotto o funzionalità è soggetto ai "Termini delle offerte pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Questo documento spiega come creare una richiesta di prenotazione futura in modalità calendario. Utilizza queste richieste per prenotare risorse ad alta richiesta per la creazione di istanze di macchine virtuali (VM) con GPU o TPU collegate che vengono eseguite per un massimo di 90 giorni.

Puoi utilizzare le richieste di prenotazione futura in modalità calendario per prenotare risorse ad alta richiesta per eseguire i seguenti carichi di lavoro:

• Job di pre-addestramento dei modelli

• Job di ottimizzazione dei modelli

• Workload di simulazione di computing ad alte prestazioni (HPC)

• Aumenti a breve termine dei workload di inferenza

Dopo che Google Cloud approva una richiesta in modalità calendario, le risorse prenotate diventano disponibili per la creazione di VM GPU o TPU alla data e all'ora di consegna specificate. Per scoprire di più sui requisiti e sulle limitazioni che applichi quando crei una richiesta in modalità calendario, consulta la sezione Panoramica delle richieste di prenotazione futura in modalità calendario.

Importante: puoi prenotare fino a 80 VM GPU in un'unica richiesta in modalità calendario. Per prenotare più di 80 VM con GPU o per un periodo superiore a 90 giorni, consulta invece Prenotare capacità tramite il team dell'account nella documentazione di AI Hypercomputer.

Prima di iniziare

• Se non riesci a utilizzare le richieste di prenotazione futura in modalità calendario, potresti non avere l'idoneità all'accesso e all'utilizzo di questa funzionalità. In questo caso, contatta il tuo team dell'account o il team di vendita.
• Per condividere la capacità prenotata con altri progetti all'interno della tua organizzazione, assicurati che il progetto in cui vuoi creare richieste di prenotazione future in modalità calendario sia autorizzato a creare prenotazioni condivise. In caso contrario, si verificano degli errori.
• 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 seguente comando:

     gcloud init

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

     Nota:se hai installato gcloud CLI in precedenza, assicurati di avere l'ultima versione eseguendo gcloud components update.
  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 seguente comando:

  gcloud init

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

  Nota:se hai installato gcloud CLI in precedenza, assicurati di avere l'ultima versione eseguendo gcloud components update.

  Per saperne di più, consulta Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare una richiesta di prenotazione futura in modalità calendario, chiedi all'amministratore di concederti il ruolo IAM Compute Future Reservation User (roles/compute.futureReservationUser) sul 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 creare una richiesta di prenotazione futura in modalità calendario. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per creare una richiesta di prenotazione futura in modalità calendario, sono necessarie le seguenti autorizzazioni:

• Per creare una richiesta di prenotazione futura: compute.futureReservations.create sul progetto
• Per consentire a Compute Engine di creare automaticamente le prenotazioni: compute.reservations.create sul progetto
• Per specificare un modello di istanza: compute.instanceTemplates.useReadOnly sul template di istanza
• Per visualizzare la disponibilità futura delle risorse: compute.advice.calendarMode sul progetto

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

Panoramica

Per creare una richiesta di prenotazione futura in modalità calendario, completa i seguenti passaggi:

1. Visualizzare la disponibilità futura delle risorse. Visualizza la disponibilità futura delle VM GPU o delle TPU che vuoi prenotare. Poi, quando crei una richiesta, specifica il numero, il tipo e la durata della prenotazione delle risorse che hai confermato come disponibili. Google Cloud è più probabile che approvi la tua richiesta se fornisci queste informazioni.

   Nota: se crei una richiesta utilizzando la console Google Cloud , salta questo passaggio. Puoi visualizzare la disponibilità futura di VM GPU o TPU durante la creazione della richiesta.

2. Crea una richiesta di prenotazione per VM GPU o TPU. Crea e invia una richiesta di prenotazione futura in modalità calendario per VM GPU o TPU. Se riesci a creare una richiesta, Google Cloud la approva entro un minuto.

Visualizzare la disponibilità futura delle risorse

Puoi visualizzare la disponibilità futura per le VM GPU o le TPU in una regione nel seguente modo:

• Per le VM GPU, fino a 60 giorni di anticipo

• Per le TPU, fino a 120 giorni di anticipo

Per visualizzare la disponibilità futura di VM con GPU o TPU in una regione, seleziona una delle seguenti opzioni:

Console

Puoi visualizzare la disponibilità futura di VM con GPU o TPU in una regione quando crei una richiesta di prenotazione futura in modalità calendario. Per ulteriori informazioni, consulta Crea una richiesta di prenotazione per VM GPU o TPU in questo documento.

gcloud

Per visualizzare la disponibilità futura di VM con GPU o TPU in una regione, utilizza uno dei seguenti comandi gcloud beta compute advice calendar-mode. In base alle risorse che vuoi visualizzare, includi i seguenti flag:

• Per visualizzare la disponibilità delle VM GPU, includi i flag --vm-count e --machine-type:

  gcloud beta compute advice calendar-mode \
      --vm-count=NUMBER_OF_VMS \
      --machine-type=MACHINE_TYPE \
      --region=REGION \
      --start-time-range=from=FROM_START_TIME,to=TO_START_TIME \
      --end-time-range=from=FROM_END_TIME,to=TO_END_TIME
  

• Per visualizzare la disponibilità delle TPU, includi i flag --chip-count e --tpu-version:

  gcloud beta compute advice calendar-mode \
      --chip-count=NUMBER_OF_CHIPS \
      --tpu-version=TPU_VERSION \
      --region=REGION \
      --start-time-range=from=FROM_START_TIME,to=TO_START_TIME \
      --end-time-range=from=FROM_END_TIME,to=TO_END_TIME
  

Sostituisci quanto segue:

• NUMBER_OF_VMS: il numero di VM con GPU da prenotare. Il valore deve essere compreso tra 1 e 80.

• MACHINE_TYPE: il tipo di macchina GPU da prenotare. Specifica uno dei seguenti valori:

  • Per i tipi di macchina A4: a4-highgpu-8g

  • Per i tipi di macchine A3 Ultra: a3-ultragpu-8g

• NUMBER_OF_CHIPS: il numero di chip TPU da prenotare. Il valore deve essere 1, 4, 8, 16, 32, 64, 128, 256, 512, o 1024.

• TPU_VERSION: la versione TPU da prenotare. Specifica uno tra i seguenti valori:

  • Per TPU v6e: V6E

  • Per TPU v5p: V5P

  • Per TPU v5e: V5E

  Se specifichi una TPU v5e, devi includere il flag --workload-type. Imposta questo flag sul tipo di workload che vuoi eseguire sulle TPU:

  • Per i carichi di lavoro che gestiscono grandi quantità di dati in una o più operazioni, come i carichi di lavoro di addestramento del machine learning (ML), specifica BATCH.

  • Per i carichi di lavoro che gestiscono richieste simultanee e richiedono una latenza di rete minima, come i carichi di lavoro di inferenza ML, specifica SERVING.

    Nota: se specifichi SERVING, puoi prenotare solo 1, 4 o 8 chip TPU v5e.

• REGION: la regione in cui prenotare VM con GPU o TPU. Per verificare quali regioni e zone sono supportate, consulta Limitazioni.

• FROM_START_TIME e TO_START_TIME: le date più vicine e più lontane in cui vuoi prenotare la capacità. Formatta queste date come timestamp RFC 3339:

  YYYY-MM-DDTHH:MM:SSOFFSET
  

  Sostituisci quanto segue:

  • YYYY-MM-DD: una data formattata come anno a quattro cifre, mese a due cifre e giorno a due cifre, separati da trattini (-).

  • HH:MM:SS: un orario formattato con l'ora a due cifre utilizzando il sistema a 24 ore, i minuti a due cifre e i secondi a due cifre, separati da due punti (:).

  • OFFSET: il fuso orario formattato come offset rispetto al Tempo Universale Coordinato (UTC). Ad esempio, per utilizzare il fuso orario standard della costa del Pacifico (PST), specifica -08:00. Per non utilizzare alcun offset, specifica Z.

• FROM_END_TIME e TO_END_TIME: le date di inizio e fine della prenotazione di capacità. Formatta queste date come timestamp RFC 3339. Se vuoi specificare un intervallo di durate per il periodo di prenotazione anziché le date/ore di fine, sostituisci il flag --end-time-range con il flag --duration-range.

L'output è simile al seguente:

- recommendationsPerSpec:
    spec:
      endTime: '2025-09-07T00:00:00Z'
      location: zones/us-east5-a
      otherLocations:
        zones/us-east5-b:
          details: this machine family is not supported in this zone
          status: NOT_SUPPORTED
        zones/us-east5-c:
          details: this machine family is not supported in this zone
          status: NOT_SUPPORTED
      recommendationId: 0d3f005d-f952-4fce-96f2-6af25e1591eb
      recommendationType: FUTURE_RESERVATION
      startTime: '2025-06-09T00:00:00Z'

Se le risorse richieste sono disponibili, l'output contiene i campi startTime, endTime e location. Questi campi specificano l'ora di inizio più presto, l'ora di fine più tardi e le zone in cui le risorse sono disponibili.

REST

Per visualizzare la disponibilità futura di VM GPU o TPU in una regione, invia una richiesta GET al metodo advice.calendarMode beta. In base alle risorse che vuoi visualizzare, includi i seguenti campi nel corpo della richiesta:

• Per visualizzare la disponibilità delle VM GPU, includi i campi instanceCount e machineType:

  POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/advice/calendarMode
  
  {
    "futureResourcesSpecs": {
      "spec": {
        "targetResources": {
          "specificSkuResources": {
            "instanceCount": "NUMBER_OF_VMS",
            "machineType": "MACHINE_TYPE"
          }
        },
        "timeRangeSpec": {
          "startTimeNotEarlierThan": "FROM_START_TIME",
          "startTimeNotLaterThan": "TO_START_TIME",
          "endTimeNotEarlierThan": "FROM_END_TIME",
          "endTimeNotLaterThan": "TO_END_TIME"
        }
      }
    }
  }
  

• Per visualizzare la disponibilità delle TPU, includi i campi acceleratorCount e vmFamily:

  POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/advice/calendarMode
  
  {
    "futureResourcesSpecs": {
      "spec": {
        "targetResources": {
          "aggregateResources": {
            "acceleratorCount": "NUMBER_OF_CHIPS",
            "vmFamily": "TPU_VERSION"
          }
        },
        "timeRangeSpec": {
          "startTimeNotEarlierThan": "FROM_START_TIME",
          "startTimeNotLaterThan": "TO_START_TIME",
          "endTimeNotEarlierThan": "FROM_END_TIME",
          "endTimeNotLaterThan": "TO_END_TIME"
        }
      }
    }
  }
  

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto in cui vuoi prenotare le risorse.

• REGION: la regione in cui vuoi prenotare VM con GPU o TPU. Per controllare le regioni e le zone supportate, consulta Limitazioni.

• NUMBER_OF_VMS: il numero di VM con GPU da prenotare. Il valore deve essere compreso tra 1 e 80.

• MACHINE_TYPE: il tipo di macchina GPU da prenotare. Specifica uno dei seguenti valori:

  • Per i tipi di macchina A4: a4-highgpu-8g

  • Per i tipi di macchine A3 Ultra: a3-ultragpu-8g

• NUMBER_OF_CHIPS: il numero di chip TPU da prenotare. Il valore deve essere 1, 4, 8, 16, 32, 64, 128, 256, 512, o 1024.

• TPU_VERSION: la versione TPU da prenotare. Specifica uno tra i seguenti valori:

  • Per TPU v6e: VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT6E

  • Per TPU v5p: VM_FAMILY_CLOUD_TPU_POD_SLICE_CT5P

  • Per TPU v5e: VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT5LP

  Se specifichi una TPU v5e, nel campo aggregateResources devi includere il campo workloadType. Imposta questo campo sul tipo di workload che vuoi eseguire sulle TPU:

  • Per i carichi di lavoro che gestiscono grandi quantità di dati in una o più operazioni, come i carichi di lavoro di addestramento del machine learning (ML), specifica BATCH.

  • Per i carichi di lavoro che gestiscono richieste simultanee e richiedono una latenza di rete minima, come i carichi di lavoro di inferenza ML, specifica SERVING.

    Nota: se specifichi SERVING, puoi prenotare solo 1, 4 o 8 chip TPU v5e.

• FROM_START_TIME e TO_START_TIME: le date più vicine e più lontane in cui vuoi prenotare la capacità. Formatta queste date come timestamp RFC 3339:

  YYYY-MM-DDTHH:MM:SSOFFSET
  

  Sostituisci quanto segue:

  • YYYY-MM-DD: una data formattata come anno a quattro cifre, mese a due cifre e giorno a due cifre, separati da trattini (-).

  • HH:MM:SS: un orario formattato con l'ora a due cifre utilizzando il sistema a 24 ore, i minuti a due cifre e i secondi a due cifre, separati da due punti (:).

  • OFFSET: il fuso orario formattato come offset rispetto al Tempo Universale Coordinato (UTC). Ad esempio, per utilizzare il fuso orario standard della costa del Pacifico (PST), specifica -08:00. Per non utilizzare alcun offset, specifica Z.

• FROM_END_TIME e TO_END_TIME: le date di inizio e fine della prenotazione di capacità. Formatta queste date come timestamp RFC 3339. Se vuoi specificare un intervallo di durate per il periodo di prenotazione anziché le date e ore di fine, sostituisci i campi endTimeNotEarlierThan e endTimeNotLaterThan con i campi minDuration e maxDuration.

L'output è simile al seguente:

{
  "recommendations": [
    {
      "recommendationsPerSpec": {
        "spec": {
          "recommendationId": "a21a2fa0-72c7-4105-8179-88de5409890b",
          "recommendationType": "FUTURE_RESERVATION",
          "startTime": "2025-06-09T00:00:00Z",
          "endTime": "2025-09-07T00:00:00Z",
          "otherLocations": {
            "zones/us-east5-b": {
              "status": "NOT_SUPPORTED",
              "details": "this machine family is not supported in this zone"
            },
            "zones/us-east5-c": {
              "status": "NOT_SUPPORTED",
              "details": "this machine family is not supported in this zone"
            }
          },
          "location": "zones/us-east5-a"
        }
      }
    }
  ]
}

Se le risorse richieste sono disponibili, l'output contiene i campi startTime, endTime e location. Questi campi specificano l'ora di inizio più presto, l'ora di fine più tardi e le zone in cui le risorse sono disponibili.

Crea una richiesta di prenotazione per VM GPU o TPU

Quando crei una richiesta di prenotazione futura in modalità calendario, puoi specificare un periodo di prenotazione solo come segue:

• Ora di inizio: in base alle risorse che vuoi prenotare, devi specificare un'ora di inizio che sia almeno uno dei seguenti valori dal momento in cui crei e invii una richiesta:

  • Per le VM GPU, 87 ore (tre giorni e 15 ore)

  • Per le TPU, sei ore

• Data/ora di fine: puoi prenotare risorse per un massimo di 90 giorni.

Attenzione: quando crei e invii una richiesta, confermi il tuo impegno a riservare la capacità richiesta. Dopo che Google Cloud ha approvato la tua richiesta, non puoi annullarla, eliminarla o modificarla. Ti impegni a pagare la capacità richiesta a partire dall'ora di inizio della richiesta, indipendentemente dal fatto che tu la utilizzi o meno.

Per creare una richiesta utilizzando una VM GPU esistente come riferimento, utilizza la consoleGoogle Cloud . In caso contrario, 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.

3. Fai clic su Crea prenotazione futura. Viene visualizzata la pagina Crea una prenotazione futura e viene selezionato il riquadro Configurazione hardware.

4. Nella sezione Configurazione, specifica le proprietà delle VM con GPU o delle TPU che vuoi prenotare eseguendo una delle seguenti operazioni:

   • Per specificare direttamente le proprietà della VM GPU o della TPU, completa i seguenti passaggi:

     1. Seleziona Specifica il tipo di macchina.

     2. Fai clic sulla scheda GPU o TPU, quindi seleziona il tipo di macchina GPU o la versione TPU da prenotare.

   • Per specificare le proprietà della VM GPU utilizzando un template di istanza esistente, seleziona Template di istanza, quindi seleziona il modello.

   • Per specificare le proprietà della VM GPU utilizzando una VM esistente come riferimento, seleziona Usa VM esistente e poi seleziona la VM.

5. Se hai specificato una TPU v5e (CT5LP) nel passaggio precedente, seleziona una delle seguenti opzioni nell'elenco Tipo di workload TPU v5:

   • Per eseguire carichi di lavoro sulle TPU che gestiscono grandi quantità di dati in una o più operazioni, ad esempio carichi di lavoro di addestramento ML, seleziona Batch.

   • Per eseguire carichi di lavoro sulle TPU che gestiscono richieste simultanee e richiedono una latenza di rete minima, ad esempio carichi di lavoro di inferenza ML, seleziona Serving.

     Nota: se selezioni Serving, puoi prenotare solo 1, 4 o 8 chip TPU v5e.

6. Nella sezione Cerca capacità, completa i seguenti passaggi:

   1. Negli elenchi Regione e Zona, specifica la regione e la zona in cui vuoi prenotare le risorse. Per esaminare le regioni e le zone supportate, consulta Limitazioni.

   2. Nel campo Capacità totale necessaria (quando prenoti VM GPU) o nell'elenco Numero di chip (quando prenoti TPU), specifica il numero di VM GPU o chip TPU da prenotare. Puoi specificare i seguenti valori:

      • Per le VM GPU, un valore compreso tra 1 e 80

      • Per i chip TPU, un valore di 1, 4, 8, 16, 32, 64, 128, 256, 512 o 1024

   3. Nell'elenco Ora di inizio, seleziona l'ora di inizio della richiesta.

   4. (Facoltativo) Nell'elenco Scegli la flessibilità della data di inizio, seleziona il livello di precisione della data di inizio.

   5. Nel campo Durata della prenotazione, specifica per quanto tempo vuoi prenotare le risorse.

   6. Fai clic su Cerca capacità. Quindi, nella tabella Capacità disponibile, seleziona una delle opzioni disponibili che contengono il tipo, il numero e il periodo di prenotazione delle VM con GPU o delle TPU da prenotare.

7. Fai clic su Avanti.

8. Nella sezione Tipo di condivisione, seleziona i progetti con cui condividere la capacità richiesta:

   • Per utilizzare la capacità riservata solo all'interno del tuo progetto, seleziona Locale.

   • Per condividere la capacità prenotata con altri progetti, seleziona Condivisa, fai clic su Aggiungi progetti e segui le istruzioni per selezionare i progetti.

9. Fai clic su Avanti.

10. Nel campo Nome prenotazione futura, inserisci un nome per la richiesta.

11. Nel campo Nome prenotazione, inserisci il nome della prenotazione che Compute Engine crea automaticamente per eseguire il provisioning della capacità richiesta.

12. Fai clic su Crea.

gcloud

Per creare una richiesta di prenotazione futura in modalità calendario e inviarla per la revisione, utilizza uno dei seguenti comandi gcloud beta compute future-reservations create. In base alle risorse che vuoi prenotare, includi i seguenti flag:

• Per prenotare le VM GPU, includi i flag --total-count, --machine-type e --deployment-type=DENSE:

  gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
      --auto-delete-auto-created-reservations \
      --total-count=NUMBER_OF_VMS \
      --machine-type=MACHINE_TYPE \
      --deployment-type=DENSE \
      --planning-status=SUBMITTED \
      --require-specific-reservation \
      --reservation-mode=CALENDAR \
      --reservation-name=RESERVATION_NAME \
      --share-setting=SHARE_TYPE \
      --start-time=START_TIME \
      --end-time=END_TIME \
      --zone=ZONE
  

• Per prenotare TPU, includi i flag --chip-count e --tpu-version:

  gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
      --auto-delete-auto-created-reservations \
      --chip-count=NUMBER_OF_CHIPS \
      --tpu-version=TPU_VERSION \
      --planning-status=SUBMITTED \
      --require-specific-reservation \
      --reservation-mode=CALENDAR \
      --reservation-name=RESERVATION_NAME \
      --share-setting=SHARE_TYPE \
      --start-time=START_TIME \
      --end-time=END_TIME \
      --zone=ZONE
  

Sostituisci quanto segue:

• FUTURE_RESERVATION_NAME: il nome della richiesta.

• NUMBER_OF_VMS: il numero di VM con GPU da prenotare. Il valore deve essere compreso tra 1 e 80.

• MACHINE_TYPE: il tipo di macchina GPU da prenotare. Specifica uno dei seguenti valori:

  • Per i tipi di macchina A4: a4-highgpu-8g

  • Per i tipi di macchine A3 Ultra: a3-ultragpu-8g

• NUMBER_OF_CHIPS: il numero di chip TPU da prenotare. Il valore deve essere 1, 4, 8, 16, 32, 64, 128, 256, 512, o 1024.

• TPU_VERSION: la versione TPU da prenotare. Specifica uno tra i seguenti valori:

  • Per TPU v6e: V6E

  • Per TPU v5p: V5P

  • Per TPU v5e: V5E

  Se specifichi una TPU v5e, devi includere il flag --workload-type. Imposta il flag sul tipo di carichi di lavoro che vuoi eseguire sulle TPU:

  • Per i carichi di lavoro che gestiscono grandi quantità di dati in una o più operazioni, come i carichi di lavoro di addestramento del machine learning (ML), specifica BATCH.

  • Per i carichi di lavoro che gestiscono richieste simultanee e richiedono una latenza di rete minima, come i carichi di lavoro di inferenza ML, specifica SERVING.

    Nota: se specifichi SERVING, puoi prenotare solo 1, 4 o 8 chip TPU v5e.

• RESERVATION_NAME: il nome della prenotazione che Compute Engine crea automaticamente per eseguire il provisioning della capacità richiesta.

• SHARE_TYPE: indica se altri progetti della tua organizzazione possono utilizzare la capacità riservata. Specifica uno dei seguenti valori:

  • Per utilizzare la capacità solo all'interno del tuo progetto: local

  • Per condividere la capacità con altri progetti: projects

  Se specifichi projects, devi includere il flag --share-with impostato su un elenco separato da virgole di ID progetto, ad esempio project-1,project-2. Puoi specificare fino a 100 progetti all'interno della tua organizzazione. Non includere l'ID progetto in questo elenco. Puoi utilizzare la capacità riservata per impostazione predefinita.

• START_TIME: l'ora di inizio della richiesta, formattata come timestamp RFC 3339.

• END_TIME: la data/ora di fine del periodo di prenotazione, formattata come timestamp RFC 3339. Se vuoi specificare una durata, in secondi, per il periodo di prenotazione anziché una data/ora di fine, sostituisci il flag --end-time con il flag --duration.

• ZONE: la zona in cui vuoi prenotare le risorse.

REST

Per creare una richiesta di prenotazione futura in modalità calendario e inviarla per la revisione, invia la seguente richiesta POST al metodo futureReservations.insert beta. A seconda delle risorse che vuoi prenotare, includi i seguenti campi nel corpo della richiesta:

• Per prenotare VM GPU, includi i campi totalCount e machineType, nonché il campo deploymentType impostato su DENSE:

  POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations
  
  {
    "name": "FUTURE_RESERVATION_NAME",
    "autoDeleteAutoCreatedReservations": true,
    "deploymentType": "DENSE",
    "planningStatus": "SUBMITTED",
    "reservationMode": "CALENDAR",
    "reservationName": "RESERVATION_NAME",
    "shareSettings": {
      "shareType": "SHARE_TYPE"
    },
    "specificReservationRequired": true,
    "specificSkuProperties": {
      "totalCount": NUMBER_OF_VMS,
      "instanceProperties": {
        "machineType": "MACHINE_TYPE"
      }
    },
    "timeWindow": {
      "startTime": "START_TIME",
      "endTime": "END_TIME"
    }
  }
  

• Per prenotare TPU, includi i campi acceleratorCount e vmFamily:

  POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations
  
  {
    "name": "FUTURE_RESERVATION_NAME",
    "autoDeleteAutoCreatedReservations": true,
    "planningStatus": "SUBMITTED",
    "reservationMode": "CALENDAR",
    "reservationName": "RESERVATION_NAME",
    "shareSettings": {
      "shareType": "SHARE_TYPE"
    },
    "specificReservationRequired": true,
    "aggregateReservation": {
      "reservedResources": [
        {
          "accelerator": {
            "acceleratorCount": NUMBER_OF_CHIPS
          }
        }
      ],
      "vmFamily": "TPU_VERSION"
    },
    "timeWindow": {
      "startTime": "START_TIME",
      "endTime": "END_TIME"
    }
  }
  

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto in cui vuoi creare la richiesta.

• ZONE: la zona in cui vuoi prenotare le risorse.

• FUTURE_RESERVATION_NAME: il nome della richiesta.

• RESERVATION_NAME: il nome della prenotazione che Compute Engine crea automaticamente per eseguire il provisioning della capacità richiesta.

• SHARE_TYPE: indica se altri progetti della tua organizzazione possono utilizzare la capacità riservata. Specifica uno dei seguenti valori:

  • Per utilizzare la capacità solo all'interno del tuo progetto: LOCAL

  • Per condividere la capacità con altri progetti: SPECIFIC_PROJECTS

  Se specifichi SPECIFIC_PROJECTS, nel campo shareSettings devi includere il campo projectMap per specificare i progetti con cui condividere la capacità. Puoi specificare fino a 100 progetti all'interno della tua organizzazione. Non specificare l'ID progetto. Per impostazione predefinita, puoi utilizzare la capacità riservata.

  Ad esempio, per condividere la capacità richiesta con altri due progetti, includi quanto segue:

  "shareSettings": {
    "shareType": "SPECIFIC_PROJECTS",
    "projectMap": {
      "CONSUMER_PROJECT_ID_1": {
        "projectId": "CONSUMER_PROJECT_ID_1"
      },
      "CONSUMER_PROJECT_ID_2": {
        "projectId": "CONSUMER_PROJECT_ID_2"
      }
    }
  }
  

  Sostituisci CONSUMER_PROJECT_ID_1 e CONSUMER_PROJECT_ID_2 con gli ID di due progetti a cui vuoi consentire di utilizzare la capacità richiesta.

• NUMBER_OF_VMS: il numero di VM con GPU da prenotare. Il valore deve essere compreso tra 1 e 80.

• MACHINE_TYPE: il tipo di macchina GPU da prenotare. Specifica uno dei seguenti valori:

  • Per i tipi di macchina A4: a4-highgpu-8g

  • Per i tipi di macchine A3 Ultra: a3-ultragpu-8g

• NUMBER_OF_CHIPS: il numero di chip TPU da prenotare. Il valore deve essere 1, 4, 8, 16, 32, 64, 128, 256, 512, o 1024.

• TPU_VERSION: la versione TPU da prenotare. Specifica uno tra i seguenti valori:

  • Per TPU v6e: VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT6E

  • Per TPU v5p: VM_FAMILY_CLOUD_TPU_POD_SLICE_CT5P

  • Per TPU v5e: VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT5LP

  Se specifichi una TPU v5e, nel campo aggregateResources devi includere il campo workloadType. Imposta il campo sul tipo di carichi di lavoro che vuoi eseguire sulle TPU:

  • Per i carichi di lavoro che gestiscono grandi quantità di dati in una o più operazioni, come i carichi di lavoro di addestramento ML, specifica BATCH.

  • Per i carichi di lavoro che gestiscono richieste simultanee e richiedono una latenza di rete minima, come i carichi di lavoro di inferenza ML, specifica SERVING.

    Nota: se specifichi SERVING, puoi prenotare solo 1, 4 o 8 chip TPU v5e.

• START_TIME: l'ora di inizio della richiesta, formattata come timestamp RFC 3339.

• END_TIME: la data/ora di fine del periodo di prenotazione, formattata come timestamp RFC 3339. Se vuoi specificare una durata, in secondi, per il periodo di prenotazione anziché una data e ora di fine, sostituisci il campo endTime con il campo duration.

Passaggi successivi

• Utilizzare una prenotazione creata automaticamente per le VM con GPU in Compute Engine

• Utilizzare una prenotazione creata automaticamente per le TPU in Cloud TPU

• Utilizzare una prenotazione creata automaticamente utilizzando i job di previsione Vertex AI

• Utilizzare una prenotazione creata automaticamente utilizzando i job di addestramento di Vertex AI

• Visualizzare le prenotazioni o le richieste di prenotazione futura