Questa pagina è stata tradotta dall'API Cloud Translation.

Creare una richiesta di prenotazione futura in modalità calendario

Questo documento spiega come creare una richiesta di prenotazione futura in modalità calendario. Utilizza queste richieste per prenotare risorse ad alta domanda per la creazione di istanze di macchine virtuali (VM) che vengono eseguite per un massimo di 90 giorni. Ad esempio, puoi utilizzare le prenotazioni future in modalità calendario per prenotare risorse GPU o TPU per le tue VM.

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, H4D o TPU nella data e nell'ora di consegna specificate. Per scoprire di più sui requisiti e sulle limitazioni che applichi quando crei una richiesta in modalità calendario, consulta Panoramica delle richieste di prenotazione futura in modalità calendario.

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 comando seguente:
  gcloud init
  Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a 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.
Per saperne di più, consulta Autenticati per usare 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 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:

Visualizzare la disponibilità futura delle risorse. Visualizza la disponibilità futura delle VM GPU, delle VM H4D 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, VM H4D o TPU durante la creazione della richiesta.
Crea una richiesta di prenotazione per VM GPU, VM H4D o TPU. Crea e invia una richiesta di prenotazione futura in modalità calendario per VM GPU, VM H4D o TPU. Se riesci a creare una richiesta, Google Cloud la approva entro un minuto.

Visualizzare la disponibilità futura della risorsa

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

Per le VM GPU, fino a 60 giorni di anticipo
Per le VM H4D, fino a 120 giorni di anticipo
Per le TPU, fino a 120 giorni di anticipo

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

Console

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

gcloud

Per visualizzare la disponibilità futura di VM GPU, VM H4D 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à di VM GPU o VM H4D, 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 da prenotare. Il valore deve essere almeno 1 e non maggiore di 80 per le VM GPU o 256 per le VM H4D HPC.
MACHINE_TYPE: il tipo di macchina GPU o H4D 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
- Per i tipi di macchine A3 Mega: a3-megagpu-8g
- Per i tipi di macchine A3 High con 8 GPU: a3-highgpu-8g
- Per i tipi di macchine H4D HPC: vedi Tipi di macchine H4D
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 TPU7x: TPU7X
- 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, VM H4D 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-central1-a
      otherLocations:
        zones/us-central1-b:
          details: Recommendation in this zone is possible.
          status: RECOMMENDED
        zones/us-central1-c:
          details: Temporarily no free capacity in this zone in the
          requested time window.
          status: NO_CAPACITY
        zones/us-central1-f:
          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ù recente, l'ora di fine più recente e le zone in cui le risorse sono disponibili.

REST

Per visualizzare la disponibilità futura di VM GPU, VM H4D 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à di VM GPU o VM H4D, 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, VM H4D o TPU. Per controllare le regioni e le zone supportate, consulta Limitazioni.
NUMBER_OF_VMS: il numero di VM con GPU o H4D da prenotare. Per le VM con GPU, il valore deve essere compreso tra 1 e 80. Per le VM H4D, il valore deve essere compreso tra 1 e 256.
MACHINE_TYPE: il tipo di macchina GPU o H4D 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
- Per i tipi di macchine A3 Mega: a3-megagpu-8g
- Per i tipi di macchine A3 High con 8 GPU: a3-highgpu-8g
- Per i tipi di macchine H4D HPC: vedi Tipi di macchine H4D
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 TPU7x: VM_FAMILY_CLOUD_TPU_POD_SLICE_TPU7X
- 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 4 cifre, mese a 2 cifre e giorno a 2 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-central1-b": {
              "status": "RECOMMENDED",
              "details": "Recommendation in this zone is possible."
            },
            "zones/us-central1-c": {
              "status": "NO_CAPACITY",
              "details": "Temporarily no free capacity in this zone in the
                          requested time window."
            },
            "zones/us-central1-f": {
              "status": "NOT_SUPPORTED",
              "details": "This machine family is not supported in this zone."
            }
          },
          "location": "zones/us-central1-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, VM H4D 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 e H4D, 87 ore (3 giorni e 15 ore)
- Per le TPU, 6 ore
Data/ora di fine: puoi prenotare risorse per un massimo di 90 giorni.

Per creare una richiesta utilizzando una VM GPU o H4D esistente come riferimento, utilizza la consoleGoogle Cloud . In caso contrario, seleziona una delle seguenti opzioni:

Console

Nella console Google Cloud , vai alla pagina Prenotazioni.

Vai a Prenotazioni
Fai clic sulla scheda Prenotazioni future.
Fai clic su Crea prenotazione futura. Viene visualizzata la pagina Crea una prenotazione futura e viene selezionato il riquadro Configurazione hardware.
Nella sezione Configurazioni, specifica le proprietà delle VM GPU, delle VM H4D o delle TPU che vuoi prenotare eseguendo una delle seguenti operazioni:
- Per specificare direttamente le proprietà della VM GPU, della VM H4D o della TPU, completa i seguenti passaggi:
  1. Seleziona Specifica il tipo di macchina.
  2. Fai clic sulla scheda GPU, TPU o Ottimizzata per il calcolo e poi seleziona un tipo di macchina GPU, un tipo di macchina H4D o una versione TPU supportati.
- Per specificare le proprietà della GPU o della VM H4D utilizzando una VM esistente come riferimento, seleziona Usa VM esistente e poi seleziona la VM.
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.
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.
2. Nel campo Capacità totale necessaria (quando prenoti VM GPU o H4D) o nell'elenco Numero di chip (quando prenoti TPU), specifica il numero di VM GPU, VM H4D o chip TPU da prenotare. Puoi specificare i seguenti valori:
  - Per le VM GPU, un valore compreso tra 1 e 80
  - Per le VM H4D, un valore compreso tra 1 e 256
  - 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 GPU, delle VM H4D o delle TPU da prenotare.
Fai clic su Avanti.
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.
Fai clic su Avanti.
Nel campo Nome prenotazione futura, inserisci un nome per la richiesta.
Nel campo Nome prenotazione, inserisci il nome della prenotazione che Compute Engine crea automaticamente per eseguire il provisioning della capacità richiesta.
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 VM GPU o H4D, 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 o H4D da prenotare. Per le VM con GPU, il valore deve essere compreso tra 1 e 80. Per le VM H4D, il valore deve essere compreso tra 1 e 256. Specifica un numero di VM uguale o inferiore al numero di VM che hai confermato come disponibili.
MACHINE_TYPE: il tipo di macchina GPU o H4D da prenotare.
NUMBER_OF_CHIPS: il numero di chip TPU da prenotare. Specifica un valore uguale o inferiore al numero di chip che hai confermato come disponibili. Il valore deve essere uno tra i seguenti: 1, 4, 8, 16, 32, 64, 128, 256, 512 o 1024.
TPU_VERSION: la versione TPU da prenotare. Se specifichi una TPU v5e (V5E), devi includere il flag --workload-type per specificare il tipo di workload da eseguire sulle TPU.
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: la data/ora di inizio della richiesta, che devi formattare come timestamp RFC 3339.
END_TIME: la data/ora di fine del periodo di prenotazione, che devi formattare 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 o H4D, 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 o H4D da prenotare. Per le VM con GPU, il valore deve essere compreso tra 1 e 80. Per le VM H4D, il valore deve essere compreso tra 1 e 256. Specifica un numero di VM uguale o inferiore al numero di VM che hai confermato come disponibili.
MACHINE_TYPE: il tipo di macchina GPU o H4D da prenotare.
NUMBER_OF_CHIPS: il numero di chip TPU da prenotare. Specifica un valore uguale o inferiore al numero di chip che hai confermato come disponibili. Il valore deve essere uno tra i seguenti: 1, 4, 8, 16, 32, 64, 128, 256, 512 o 1024.
TPU_VERSION: la versione TPU da prenotare. Se specifichi una TPU v5e (VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT5LP), nel campo aggregateResources devi includere il campo workloadType per specificare il tipo di workload da eseguire sulle TPU.
START_TIME: la data/ora di inizio della richiesta, che devi formattare come timestamp RFC 3339.
END_TIME: la data/ora di fine del periodo di prenotazione, che devi formattare 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

Per le VM GPU o H4D, utilizza una prenotazione creata automaticamente in Compute Engine:
Utilizza una prenotazione creata automaticamente per VM GPU o TPU in Vertex AI:
- Utilizzare le prenotazioni con i job di inferenza online
- Utilizzare le prenotazioni con i job di addestramento
Utilizzare una prenotazione creata automaticamente per le TPU in Cloud TPU
Visualizzare le prenotazioni o le richieste di prenotazione futura

Creare una richiesta di prenotazione futura in modalità calendario Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Prima di iniziare

Console

gcloud

REST

Ruoli obbligatori

Autorizzazioni obbligatorie

Panoramica

Visualizzare la disponibilità futura della risorsa

Console

gcloud

REST

Crea una richiesta di prenotazione per VM GPU, VM H4D o TPU

Console

gcloud

REST

Passaggi successivi

Creare una richiesta di prenotazione futura in modalità calendario