Questa pagina è stata tradotta dall'API Cloud Translation.

Crea richieste di prenotazione future condivise

Questo documento spiega come creare richieste di prenotazione future condivise.

Se Google Cloud approva la tua richiesta di prenotazione futura condivisa, all'ora di inizio specificata nella richiesta Compute Engine crea automaticamente le prenotazioni condivise tra più progetti. Queste prenotazioni condivise create automaticamente vengono utilizzate dalle VM corrispondenti e dalle prenotazioni esistenti nel progetto che ospita la prenotazione futura (progetto proprietario) e con i progetti con cui è condivisa la prenotazione futura (progetti consumer). Per saperne di più su come funzionano e possono essere utilizzate le prenotazioni condivise create automaticamente, consulta Creare prenotazioni condivise.

Prima di iniziare

Se non lo hai già fatto:
- Consulta le best practice per le prenotazioni on demand condivise.
- Esamina il funzionamento delle prenotazioni future.
- Per assicurarti di disporre di una quota sufficiente per le risorse che vuoi prenotare, controlla la quota.
Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale viene verificata l'identità per l'accesso ai servizi e alle API Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti in Compute Engine nel seguente modo.

Seleziona la scheda relativa a come prevedi di utilizzare gli esempi in questa pagina:
Console

Quando utilizzi la console Google Cloud per accedere ai servizi e alle API di Google Cloud, non devi configurare l'autenticazione.
gcloud
1. Installa Google Cloud CLI, quindi initialize eseguendo questo comando:
```
gcloud init
```
  Nota: se hai già installato gcloud CLI in precedenza, assicurati di disporre della versione più recente eseguendo gcloud components update.
2. Imposta una regione e una zona predefinite.
REST

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

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare richieste di prenotazione future condivise, chiedi all'amministratore di concederti il ruolo IAM Utente prenotazione futura Compute (roles/compute.futureReservationUser) per il progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Questo ruolo predefinito contiene le autorizzazioni necessarie per creare richieste di prenotazione future condivise. Per visualizzare le autorizzazioni esatte necessarie, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per creare richieste di prenotazione future condivise 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 nel progetto
Per specificare un modello di istanza: compute.instanceTemplates.useReadOnly sul modello di istanza

Potresti anche essere in grado di ottenere queste autorizzazioni con i ruoli personalizzati o altri ruoli predefiniti.

Limitazioni

Oltre alle limitazioni generali per le prenotazioni future, la creazione di richieste di prenotazione future condivise prevede le seguenti restrizioni:

Il progetto che utilizzi per creare richieste di prenotazione future condivise (il progetto del proprietario) deve essere aggiunto alla lista consentita per il vincolo dei criteri dell'organizzazione Progetti proprietario di prenotazioni condivise (compute.sharedReservationsOwnerProjects) da un amministratore dei criteri dell'organizzazione. Per ulteriori informazioni, consulta Consentire e limitare i progetti per la creazione e la modifica delle prenotazioni condivise nella documentazione delle prenotazioni di Compute Engine.
Se sposti in un'organizzazione diversa un progetto che ha creato una richiesta di prenotazione futura condivisa, la prenotazione futura condivisa viene eliminata. Il progetto non viene rimosso automaticamente dal vincolo del criterio dell'organizzazione Progetti proprietario di prenotazioni condivise (compute.sharedReservationsOwnerProjects), ma se vuoi puoi rimuovere il progetto da questo vincolo.
Ogni richiesta di prenotazione futura condivisa può essere condivisa con un massimo di 100 progetti consumer.
Per ogni organizzazione, puoi creare fino a 100 richieste di prenotazione future condivise per ogni combinazione univoca di proprietà VM.

Crea una richiesta di prenotazione futura condivisa

Questa sezione spiega come creare una richiesta di prenotazione futura condivisa.

Dopo aver creato una richiesta di prenotazione futura condivisa, può essere annullata, eliminata o modificata solo dal progetto del proprietario. Tuttavia, le prenotazioni create automaticamente possono essere utilizzate dal progetto proprietario e da qualsiasi progetto consumer con cui è condivisa la richiesta di prenotazione futura.

Avviso: dopo che una richiesta di prenotazione futura è stata inviata, approvata da Google Cloud e ha superato l'orario di blocco, puoi eliminare la prenotazione futura e le relative prenotazioni create automaticamente solo dopo l'ora di fine del periodo di prenotazione della prenotazione futura. Quindi, prima di creare una richiesta di prenotazione futura, assicurati di quanto segue:

Eventuali prenotazioni esistenti o future in un progetto limitano le impostazioni di condivisione delle richieste di prenotazione future che puoi creare. Per assicurarti di poter creare correttamente una richiesta di prenotazione futura e che la richiesta non causi problemi in altri progetti con cui condividi prenotazioni o prenotazioni future, consulta la pagina relativa alle restrizioni.
Devi impegnarti a pagare per le risorse prenotate di cui Compute Engine esegue il provisioning per l'intero periodo di prenotazione, indipendentemente dal fatto che vengano utilizzate o meno le prenotazioni create automaticamente. Per saperne di più, consulta Fatturazione.

Per utilizzare una prenotazione creata automaticamente per una prenotazione futura, una VM deve avere proprietà che corrispondono esattamente alla prenotazione. Per specificare le proprietà delle VM di cui vuoi richiedere la prenotazione creando una richiesta di prenotazione futura, seleziona uno dei seguenti metodi:

Opzione consigliata: specifica un modello di istanza

Questa sezione spiega come utilizzare un modello di istanza esistente per definire le proprietà di una richiesta di prenotazione futura condivisa. Con un modello di istanza, puoi definire le proprietà di una richiesta di prenotazione futura e le VM che possono utilizzare le prenotazioni create automaticamente nella stessa posizione. Tuttavia, poiché i modelli sono specifici per progetto, non puoi utilizzare lo stesso modello per creare VM che possono utilizzare le prenotazioni create automaticamente al di fuori del progetto che ha creato la richiesta di prenotazione futura. Per i progetti con cui è condivisa la prenotazione futura, devi creare modelli simili nei progetti stessi o creare VM specificando direttamente le proprietà.
Specificare direttamente le proprietà

Questa sezione spiega come definire direttamente le proprietà di una richiesta di prenotazione futura condivisa. Questo metodo richiede di assicurarti manualmente che le proprietà delle VM e le prenotazioni create automaticamente corrispondano esattamente, a qualsiasi proprietà non corrispondente previene il consumo.

Una prenotazione creata automaticamente per una prenotazione futura può essere utilizzata automaticamente da qualsiasi VM con proprietà corrispondenti. Se vuoi evitare che una VM utilizzi una di queste prenotazioni create automaticamente, scopri come creare VM senza utilizzare le prenotazioni.

Specifica un modello di istanza

Puoi creare una prenotazione futura condivisa specificando un modello di istanza esistente utilizzando la console Google Cloud, gcloud CLI e REST.

Attenzione: prima di utilizzare un modello di istanza per creare una richiesta di prenotazione futura, verifica quanto segue:

Un modello di istanza contiene impostazioni specifiche per il progetto, perciò puoi accedervi e utilizzarlo solo all'interno dello stesso progetto. Se crei una richiesta di prenotazione futura condivisa specificando un modello di istanza, devi creare modelli simili per creare VM oppure creare VM specificando direttamente le proprietà corrispondenti, in modo da utilizzare le prenotazioni create automaticamente in ogni progetto consumer.
Devi creare la tua richiesta di prenotazione futura nella stessa regione e nella stessa zona delle risorse all'interno del modello di istanza. Eventuali risorse a livello di regione o di zona specificate in un modello di istanza, ad esempio un tipo di macchina o un disco, limitano l'utilizzo del modello alle località in cui si trovano le risorse. Ad esempio, se il modello di istanza specifica un disco esistente nella zona us-central1-a, devi creare la richiesta di prenotazione futura nella stessa zona. In caso contrario, la creazione della richiesta di prenotazione futura non va a buon fine.

Per verificare se un modello esistente specifica risorse che associano il modello a una regione o zona specifica, visualizza i dettagli del modello e cerca i riferimenti alle risorse a livello di regione o zona al suo interno.
Dopo aver creato una richiesta di prenotazione futura, non puoi modificare la richiesta di prenotazione futura per sostituire le proprietà VM del modello o specificare un altro modello. Devi creare una nuova richiesta di prenotazione futura con gli aggiornamenti che preferisci.

Console

Per creare una richiesta di prenotazione futura condivisa specificando un modello di istanza, segui questi passaggi:

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.
Nel campo Nome, inserisci un nome per la richiesta di prenotazione futura.
Nel campo Prefisso, inserisci un prefisso per il nome. Il nome di ogni prenotazione creata automaticamente da questa richiesta di prenotazione futura inizia con questo prefisso.

Per aiutarti a identificare le prenotazioni create automaticamente per questa richiesta di prenotazione futura, è consigliabile specificare un prefisso nome univoco.
(Facoltativo) Nel campo Descrizione, inserisci una descrizione per la richiesta di prenotazione futura.
Nel campo Regione, seleziona la regione in cui prenotare le risorse.
Nel campo Zona, seleziona la zona in cui prenotare le risorse.
Nel campo Ora di inizio, inserisci un'ora di inizio per il periodo di prenotazione. L'ora di inizio non può essere successiva a un anno dalla data e dall'ora in cui invii la richiesta di prenotazione futura per la revisione.

Assicurati di specificare un valore consigliato per l'ora di inizio per assicurarti di avere tempo sufficiente prima che la prenotazione futura inserisca l'ora di blocco.
Nel campo Ora di fine, inserisci un'ora di fine per il periodo di prenotazione. Il periodo di prenotazione deve durare almeno 24 ore.

Nella sezione Riepilogo durata, puoi vedere la durata del periodo di prenotazione. Per aumentare le probabilità che Google Cloud approvi la tua richiesta di prenotazione futura dopo averla inviata per la revisione, assicurati di specificare un valore consigliato per il periodo di prenotazione.
Nella sezione Tipo di condivisione, procedi nel seguente modo:
1. Per specificare una richiesta di prenotazione futura condivisa, fai clic su Condivisa.
2. Fai clic su Aggiungi progetti, quindi seleziona i progetti dell'organizzazione del progetto attuale con cui vuoi condividere la richiesta di prenotazione futura.
  
  Puoi selezionare fino a 100 progetti. Non selezionare il progetto attuale. Per impostazione predefinita, è già consentito utilizzare le prenotazioni create automaticamente per questa richiesta di prenotazione futura.
Nel campo Numero di istanze VM, inserisci il numero totale di VM che vuoi prenotare per il periodo, la configurazione della VM e i progetti specificati in questa richiesta di prenotazione futura.

Nel calcolo del numero di nuove prenotazioni da creare per una richiesta di prenotazione futura approvata poco prima dell'ora di inizio, Compute Engine sottrae dal totale le prenotazioni esistenti che corrispondono alla richiesta. Per maggiori informazioni, vedi come Compute Engine conteggia ed esegue il provisioning delle risorse prenotate.

Attenzione: assicurati di disporre di una quota sufficiente per le risorse che richiedi di prenotare. In caso contrario, Google Cloud rifiuta la richiesta di prenotazione futura.
Nella sezione Configurazione macchina, segui questi passaggi:
1. Per specificare le proprietà delle VM utilizzando un modello di istanza esistente, seleziona Utilizza modello di istanza.
2. Nel campo Modello di istanza, seleziona il modello di istanza che preferisci. Se selezioni un modello di istanza a livello di regione, puoi prenotare le risorse solo all'interno della regione in cui si trova il modello di istanza.
Nella sezione Ora di eliminazione automatica delle prenotazioni generate automaticamente, esegui una delle seguenti operazioni:
- Per consentire a Compute Engine di eliminare automaticamente le prenotazioni create automaticamente per la tua richiesta di prenotazione futura:
  
  Attenzione: se l'opzione di eliminazione automatica è abilitata, tutte le prenotazioni create automaticamente vengono eliminate al momento dell'eliminazione specificato, indipendentemente dal fatto che siano state consumate completamente o meno.
  1. Fai clic sul pulsante di attivazione/disattivazione Abilita l'eliminazione automatica per attivare l'opzione (impostazione predefinita).
  2. (Facoltativo) Nel campo Ora di eliminazione automatica, inserisci una nuova data e ora in cui eliminare le prenotazioni create automaticamente. La data e l'ora devono essere successive all'ora di fine del periodo di prenotazione. Se lasci vuoto questo campo, le prenotazioni create automaticamente vengono eliminate entro 2 ore dall'ora di fine del periodo di prenotazione.
- In caso contrario, fai clic sul pulsante di attivazione/disattivazione Attiva l'eliminazione automatica per disattivare l'opzione.
Esegui una di queste operazioni:
- Per creare una richiesta di prenotazione futura e inviarla per la revisione a Google Cloud, fai clic su Invia.
  
  Attenzione: assicurati che una richiesta di prenotazione futura sia pronta per la revisione prima di inviarla. Una volta inviata la bozza, non puoi più tornare alla bozza.
- Per creare una bozza di richiesta di prenotazione futura, fai clic su Salva bozza.
- Per uscire senza salvare, fai clic su Annulla.

Si apre la pagina Prenotazioni. La creazione della richiesta di prenotazione futura può richiedere fino a un minuto.

gcloud

Per creare una richiesta di prenotazione futura condivisa specificando un modello di istanza, utilizza il comando gcloud beta compute future-reservations create con il flag --source-instance-template.

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --description="DESCRIPTION" \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Sostituisci quanto segue:

FUTURE_RESERVATION_NAME: il nome della richiesta di prenotazione futura da creare.

DESCRIPTION: facoltativo. Una descrizione per la richiesta di prenotazione futura.

NAME_PREFIX: il prefisso del nome della richiesta di prenotazione futura. Il nome di ogni prenotazione creata automaticamente per questa richiesta di prenotazione futura inizia con il prefisso del nome. Per aiutarti a identificare le prenotazioni create automaticamente per questa richiesta di prenotazione futura, è consigliabile specificare un prefisso nome univoco.
PLANNING_STATUS: facoltativo. Lo stato di pianificazione della richiesta di prenotazione futura, che deve essere uno dei seguenti:
- Per creare la bozza di una richiesta di prenotazione futura, specifica DRAFT.
- Per creare la richiesta di prenotazione futura e inviarla per l'approvazione a Google Cloud, specifica SUBMITTED.
  
  Attenzione: dopo aver inviato per la revisione una richiesta di prenotazione futura, non puoi ripristinare lo stato di pianificazione su DRAFT.
Se ometti il flag --planning-status, il valore viene impostato su DRAFT.
PROJECT_ID: l'ID del progetto in cui vuoi prenotare le risorse e dove si trova il modello di istanza.

CONSUMER_PROJECT_IDS: un elenco separato da virgole degli ID progetto dei progetti con cui può essere condivisa questa richiesta di prenotazione futura. Ad esempio, specifica project-1,project-2. Puoi specificare fino a 100 progetti. Questi progetti devono trovarsi nella stessa organizzazione del progetto in cui viene creata la richiesta di prenotazione futura (progetto proprietario). Non specificare il progetto proprietario. Per impostazione predefinita, è già consentito utilizzare le prenotazioni create automaticamente per questa richiesta di prenotazione futura.

LOCATION: la posizione del modello di istanza. Specifica uno dei seguenti valori:
- Per un modello di istanza globale: global.
- Per un modello di istanza a livello di regione: regions/REGION. Sostituisci REGION con la regione in cui si trova il modello di istanza. Se specifichi un modello di istanza a livello di regione, puoi prenotare le VM solo all'interno della regione in cui si trova il modello di istanza.
INSTANCE_TEMPLATE_NAME: il nome di un modello di istanza esistente. Se specifichi un modello di istanza, non puoi sostituire le sue proprietà durante la creazione della richiesta di prenotazione futura. In caso contrario, si verificano errori.

START_TIME: l'ora di inizio del periodo di prenotazione formattata come timestamp RFC 3339, che deve essere il seguente:
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
Sostituisci quanto segue:
- YYYY-MM-DD: dati formattati come anno a quattro cifre, mese a due cifre e giorno del mese a due cifre, separati da trattini (-).
- HH:MM:SS: un'ora formattata come ora a due cifre con formato a 24 ore, minuti a due cifre e secondi a due cifre, separati dai due punti (:).
- OFFSET: il fuso orario formattato come offset del Tempo coordinato universale (UTC). Ad esempio, per utilizzare il fuso orario PST (Pacific Standard Time), specifica -08:00. In alternativa, per non usare alcun offset, specifica Z.
L'ora di inizio non può essere successiva a un anno dalla data e dall'ora in cui invii la richiesta di prenotazione futura per la revisione. Per avere tempo sufficiente per annullare, eliminare o modificare facoltativamente una richiesta di prenotazione futura dopo l'approvazione o prima dell'inserimento dell'ora di blocco, assicurati di specificare un valore consigliato per l'ora di inizio.
END_TIME: l'ora di fine del periodo di prenotazione formattata come timestamp RFC 3339. Il periodo di prenotazione deve durare almeno 24 ore. In alternativa, puoi sostituire il flag --end-time con il flag --duration=END_DURATION, dove END_DURATION è la durata del periodo di prenotazione in secondi. Ad esempio, specifica 1209600 per 1.209.600 secondi (14 giorni).

Per aumentare le probabilità che Google Cloud approvi una richiesta di prenotazione futura dopo averla inviata per la revisione, assicurati di specificare uno dei valori consigliati per il periodo di prenotazione.

Importante: assicurati che il periodo di prenotazione non si sovrapponga al periodo di prenotazione di un'altra richiesta di prenotazione futura esistente con proprietà VM e zona corrispondenti e che sia stato creato nel progetto attuale o sia condiviso con quest'ultimo. In caso contrario, la creazione della richiesta di prenotazione futura non va a buon fine.
TOTAL_COUNT: numero totale di VM da prenotare per il periodo, la configurazione delle VM e i progetti specificati in questa richiesta di prenotazione futura.

Nel calcolare il numero di prenotazioni da creare per una prenotazione futura approvata, Compute Engine controlla prima le prenotazioni esistenti. Se esistono prenotazioni esistenti che corrispondono alla prenotazione futura approvata, il numero di prenotazioni esistenti viene sottratto dal numero totale richiesto di prenotazioni nella richiesta per determinare il numero di nuove prenotazioni create da Compute Engine. Per ulteriori informazioni, vedi come Compute Engine conteggia ed esegue il provisioning delle risorse prenotate.

Attenzione: assicurati di disporre di una quota sufficiente per le risorse che richiedi di prenotare. In caso contrario, Google Cloud rifiuta la richiesta di prenotazione futura.
ZONE: la zona in cui prenotare le risorse.

Quando specifichi il flag --auto-delete-auto-created-reservations, Compute Engine elimina automaticamente le prenotazioni create automaticamente per la richiesta di prenotazione futura. Per impostazione predefinita, l'ora di eliminazione è entro 2 ore dall'ora di fine del periodo di prenotazione. Se vuoi, puoi farlo in uno dei seguenti modi:

Per eliminare le prenotazioni create automaticamente dopo l'ora di fine del periodo di prenotazione, seleziona uno dei seguenti metodi:

Attenzione: se abiliti l'opzione di eliminazione automatica, tutte le prenotazioni create automaticamente vengono eliminate al momento dell'eliminazione specificato, indipendentemente dal fatto che siano state completamente utilizzate o meno.
- Per eliminare le prenotazioni create automaticamente in un orario specifico dopo l'ora di fine del periodo di prenotazione, specifica i flag --auto-delete-auto-created-reservations e --auto-created-reservations-delete-time.
```
gcloud beta compute future-reservations create example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
    ...
```
  Sostituisci AUTO_CREATED_RESERVATIONS_DELETE_TIME con una data e un'ora formattate come timestamp RFC 3339.
- Per eliminare le prenotazioni create automaticamente dopo una durata specifica dopo l'ora di fine del periodo di prenotazione, specifica i flag --auto-delete-auto-created-reservations e --auto-created-reservations-duration.
```
gcloud beta compute future-reservations create example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
    ...
```
  Sostituisci DURATION_BEFORE_DELETE con una durata espressa in giorni, ore, minuti o secondi. Ad esempio, specifica 30m per 30 minuti o 1d2h3m4s per 1 giorno, 2 ore, 3 minuti e 4 secondi.
Per impedire a Compute Engine di eliminare automaticamente le prenotazioni create automaticamente, specifica il flag --no-auto-delete-auto-created-reservations. Devi disabilitare l'opzione di eliminazione automatica se vuoi associare la prenotazione creata automaticamente a un impegno.
```
gcloud beta compute future-reservations create example-future-reservation \
    --no-auto-delete-auto-created-reservations \
    ...
```

Ad esempio, il seguente comando crea una bozza di richiesta di prenotazione futura utilizzando il modello di istanza globale example-template per 80 VM. La richiesta di prenotazione futura è condivisa con project-1 e project-2. Il periodo di prenotazione inizia a mezzanotte del 10 novembre 2023 UTC e termina a mezzanotte del 10 dicembre 2023 UTC. Le prenotazioni create automaticamente per la prenotazione futura vengono create nella zona us-central1-a, hanno un nome che inizia con fr-02-reservation e vengono eliminate automaticamente a mezzanotte del 13 dicembre 2023 UTC.

gcloud beta compute future-reservations create fr-02 \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-delete-time=2023-12-13T00:00:00Z \
    --name-prefix=fr-02-reservation \
    --planning-status=DRAFT \
    --project=example-project \
    --share-setting=projects \
    --share-with=project-1,project-2 \
    --source-instance-template=projects/example-project/global/instanceTemplates/example-template \
    --start-time=2023-11-10T00:00:00Z \
    --end-time=2023-12-10T00:00:00Z \
    --total-count=80 \
    --zone=us-central1-a

REST

Per creare una richiesta di prenotazione futura condivisa specificando un modello di istanza, effettua una richiesta POST al metodo beta.futureReservations.insert.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
  "description": "DESCRIPTION",
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "planningStatus": "PLANNING_STATUS",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
    "totalCount": "TOTAL_COUNT"
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

Sostituisci quanto segue:

PROJECT_ID: l'ID del progetto in cui vuoi prenotare le risorse e dove si trova il modello di istanza.
ZONE: la zona in cui vuoi prenotare le risorse.
AUTO_DELETE_AUTO_CREATED_RESERVATIONS: se imposti questo campo su true, Compute Engine elimina automaticamente le prenotazioni create automaticamente per questa richiesta di prenotazione futura, indipendentemente dal fatto che siano state completamente utilizzate o meno. Imposta questo campo su false se vuoi associare la prenotazione creata automaticamente a un impegno.

Per impostazione predefinita, l'ora di eliminazione rientra entro 2 ore dall'ora di fine del periodo di prenotazione. Per cambiare questa impostazione, procedi in uno dei seguenti modi:
- Per eliminare le prenotazioni create automaticamente dopo un intervallo di tempo specifico dopo la fine del periodo di prenotazione, imposta autoDeleteAutoCreatedReservations su true e specifica il campo autoCreatedReservationsDeleteTime.
```
POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDeleteTime": "DELETE_TIME",
  ...
}
```
  Sostituisci DELETE_TIME con una data e un'ora quando Compute Engine elimina le prenotazioni create automaticamente. Data e ora devono essere formattate come timestamp RFC 3339, che deve essere il seguente:
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
  Sostituisci quanto segue:
  - YYYY-MM-DD: dati formattati come anno a quattro cifre, mese a due cifre e giorno del mese a due cifre, separati da trattini (-).
  - HH:MM:SS: un'ora formattata come ora a due cifre con formato di 24 ore, minuti a due cifre e secondi a due cifre, separati dai due punti (:).
  - OFFSET: il fuso orario formattato come offset rispetto al fuso orario UTC (Coordinated Universal Time). Ad esempio, per utilizzare il fuso orario PST (Pacific Standard Time), specifica -08:00. In alternativa, per non utilizzare alcun offset, specifica Z.
- Per eliminare le prenotazioni create automaticamente dopo una durata specifica dall'ora di inizio del periodo di prenotazione, imposta autoDeleteAutoCreatedReservations su true e specifica il campo autoCreatedReservationsDuration.
```
POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  },
  ...
}
```
  Sostituisci DURATION_BEFORE_DELETE con una durata in secondi. Ad esempio, specifica 604800 per 604.800 secondi (7 giorni).
DESCRIPTION: facoltativo. Una descrizione per la richiesta di prenotazione futura.
FUTURE_RESERVATION_NAME: il nome della richiesta di prenotazione futura da creare.
NAME_PREFIX: il prefisso del nome della richiesta di prenotazione futura. Il nome di ogni prenotazione creata automaticamente per questa richiesta di prenotazione futura inizia con il prefisso del nome. Per aiutarti a identificare le prenotazioni create automaticamente per questa richiesta di prenotazione futura, è consigliabile specificare un prefisso nome univoco.

CONSUMER_PROJECT_ID_1 e CONSUMER_PROJECT_ID_2: gli ID progetto dei progetti con cui può essere condivisa questa richiesta di prenotazione futura. Puoi specificare fino a 100 progetti. Questi progetti devono trovarsi nella stessa organizzazione del progetto in cui viene creata la richiesta di prenotazione futura (progetto proprietario). Non specificare il progetto del proprietario. Per impostazione predefinita, è già consentito utilizzare le prenotazioni create automaticamente per questa richiesta di prenotazione futura.

PLANNING_STATUS: facoltativo. Lo stato di pianificazione della richiesta di prenotazione futura, che deve essere uno dei seguenti:
- Per creare la bozza di una richiesta di prenotazione futura, specifica DRAFT.
- Per creare la richiesta di prenotazione futura e inviarla per l'approvazione a Google Cloud, specifica SUBMITTED.
  
  Attenzione: dopo aver inviato per la revisione una richiesta di prenotazione futura, non puoi ripristinare lo stato di pianificazione su DRAFT.
Se ometti il campo planningStatus, il valore viene impostato su DRAFT.

LOCATION: la posizione del modello di istanza. Specifica uno dei seguenti valori:
- Per un modello di istanza globale: global.
- Per un modello di istanza a livello di regione: regions/REGION. Sostituisci REGION con la regione in cui si trova il modello di istanza. Se specifichi un modello di istanza a livello di regione, puoi prenotare le VM solo all'interno della regione in cui si trova il modello di istanza.
INSTANCE_TEMPLATE_NAME: il nome di un modello di istanza esistente. Se specifichi un modello di istanza, non puoi sostituire le sue proprietà durante la creazione della richiesta di prenotazione futura. In caso contrario, si verificano errori.

TOTAL_COUNT: numero totale di VM da prenotare per il periodo, la configurazione delle VM e i progetti specificati in questa richiesta di prenotazione futura.

Nel calcolare il numero di prenotazioni da creare per una prenotazione futura approvata, Compute Engine controlla prima le prenotazioni esistenti. Se esistono prenotazioni esistenti che corrispondono alla prenotazione futura approvata, il numero di prenotazioni esistenti viene sottratto dal numero totale richiesto di prenotazioni nella richiesta per determinare il numero di nuove prenotazioni create da Compute Engine. Per ulteriori informazioni, vedi come Compute Engine conteggia ed esegue il provisioning delle risorse prenotate.

Attenzione: assicurati di disporre di una quota sufficiente per le risorse che richiedi di prenotare. In caso contrario, Google Cloud rifiuta la richiesta di prenotazione futura.
START_TIME: l'ora di inizio del periodo di prenotazione formattata come timestamp RFC 3339. L'ora di inizio non può essere successiva a un anno dalla data e dall'ora in cui invii per la revisione una richiesta di prenotazione futura. Inoltre, assicurati di specificare un valore consigliato per l'ora di inizio in modo da disporre di tempo sufficiente prima che una prenotazione futura inserisca il proprio orario di blocco.
END_TIME: l'ora di fine del periodo di prenotazione formattata come timestamp RFC 3339. Il periodo di prenotazione deve durare almeno 24 ore. In alternativa, puoi sostituire il campo endTime con il campo duration per specificare una durata specifica dall'ora di inizio del periodo di prenotazione:
```
"duration": {
  "seconds": "END_DURATION"
}
```
Sostituisci END_DURATION con una durata in secondi. Ad esempio, specifica 1209600 per 1.209.600 secondi (14 giorni).

Per aumentare le probabilità che Google Cloud approvi una richiesta di prenotazione futura dopo averla inviata per la revisione, assicurati di specificare uno dei valori consigliati per il periodo di prenotazione.

Importante: assicurati che il periodo di prenotazione non si sovrapponga al periodo di prenotazione di un'altra richiesta di prenotazione futura esistente con proprietà VM e zona corrispondenti e che sia stato creato nel progetto attuale o sia condiviso con quest'ultimo. In caso contrario, la creazione della richiesta di prenotazione futura non va a buon fine.

POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDeleteTime": "2023-12-13T00:00:00Z",
  "name": "fr-02",
  "namePrefix": "fr-02-reservation",
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/example-project/global/instanceTemplates/example-template",
    "totalCount": "80"
  },
  "planningStatus": "DRAFT",
  "shareSettings": {
    "projects": [
      "project-1",
      "project-2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "timeWindow": {
    "startTime": "2023-11-10T00:00:00Z",
    "endTime": "2023-12-10T00:00:00Z"
  }
}

Specifica direttamente le proprietà della VM

Puoi creare una richiesta di prenotazione futura condivisa specificando le proprietà direttamente tramite la console Google Cloud, gcloud CLI e REST.

Console

Per creare una richiesta di prenotazione futura condivisa specificando direttamente le proprietà, segui questi passaggi:

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.
Nel campo Nome, inserisci un nome per la richiesta di prenotazione futura.
Nel campo Prefisso, inserisci un prefisso per il nome. Il nome di ogni prenotazione creata automaticamente da questa richiesta di prenotazione futura inizia con questo prefisso.

Per aiutarti a identificare le prenotazioni create automaticamente per questa richiesta di prenotazione futura, è consigliabile specificare un prefisso nome univoco.
(Facoltativo) Nel campo Descrizione, inserisci una descrizione per la richiesta di prenotazione futura.
Nel campo Regione, seleziona la regione in cui prenotare le risorse.
Nel campo Zona, seleziona la zona in cui prenotare le risorse.
Nel campo Ora di inizio, inserisci un'ora di inizio per il periodo di prenotazione. L'ora di inizio non può essere successiva a un anno dalla data e dall'ora in cui invii la richiesta di prenotazione futura per la revisione.

Assicurati di specificare un valore consigliato per l'ora di inizio per assicurarti di avere tempo sufficiente prima che la prenotazione futura inserisca l'ora di blocco.
Nel campo Ora di fine, inserisci un'ora di fine per il periodo di prenotazione. Il periodo di prenotazione deve durare almeno 24 ore.

Nella sezione Riepilogo durata, puoi vedere la durata del periodo di prenotazione. Per aumentare le probabilità che Google Cloud approvi la tua richiesta di prenotazione futura dopo averla inviata per la revisione, assicurati di specificare un valore consigliato per il periodo di prenotazione.
Nella sezione Tipo di condivisione, procedi nel seguente modo:
1. Per specificare una richiesta di prenotazione futura condivisa, fai clic su Condivisa.
2. Fai clic su Aggiungi progetti, quindi seleziona i progetti dell'organizzazione del progetto attuale con cui vuoi condividere la richiesta di prenotazione futura.
  
  Puoi selezionare fino a 100 progetti. Non selezionare il progetto attuale. Per impostazione predefinita, è già consentito utilizzare le prenotazioni create automaticamente per questa richiesta di prenotazione futura.
Nel campo Numero di istanze VM, inserisci il numero totale di VM che vuoi prenotare per il periodo, la configurazione della VM e i progetti specificati in questa richiesta di prenotazione futura.

Nel calcolo del numero di nuove prenotazioni da creare per una richiesta di prenotazione futura approvata poco prima dell'ora di inizio, Compute Engine sottrae dal totale le prenotazioni esistenti che corrispondono alla richiesta. Per maggiori informazioni, vedi come Compute Engine conteggia ed esegue il provisioning delle risorse prenotate.

Attenzione: assicurati di disporre di una quota sufficiente per le risorse che richiedi di prenotare. In caso contrario, Google Cloud rifiuta la richiesta di prenotazione futura.
Nella sezione Configurazione macchina, segui questi passaggi:
1. Seleziona Specifica il tipo di macchina (impostazione predefinita).
2. Seleziona una delle seguenti opzioni:
  - Per i carichi di lavoro comuni, fai clic sulla scheda Uso generico (impostazione predefinita).
  - Per i carichi di lavoro che richiedono prestazioni elevate, fai clic sulla scheda Ottimizzato per il calcolo.
  - Per carichi di lavoro con un rapporto memoria-vCPU elevato, fai clic sulla scheda Ottimizzata per la memoria.
  - Per i carichi di lavoro che utilizzano GPU (Graphics Processing Unit), fai clic sulla scheda GPU.
3. Esegui una di queste operazioni:
  - Se nel passaggio precedente hai specificato Uso generico, Ottimizzata per il calcolo o Ottimizzata per la memoria:
    1. Nell'elenco Serie, seleziona una serie di macchine.
    2. Nell'elenco Tipo di macchina, seleziona un tipo di macchina.
    3. (Facoltativo) Per personalizzare ulteriormente la macchina per le VM che vuoi prenotare, espandi Configurazioni avanzate e segui le istruzioni.
  - Se hai specificato GPU nel passaggio precedente:
    1. Nel menu Tipo di GPU, seleziona un tipo di GPU.
    2. Nel menu Numero di GPU, seleziona il numero di GPU.
    3. (Facoltativo) Se il tipo di GPU lo consente e vuoi utilizzare le risorse prenotate per eseguire carichi di lavoro ad alta intensità di grafica, seleziona la casella di controllo Abilita workstation virtuale (NVIDIA GRID).
    4. Nell'elenco Tipo di macchina, seleziona un tipo di macchina.
    5. Nell'elenco Piattaforma CPU, seleziona una piattaforma CPU per le VM che vuoi prenotare.
4. (Facoltativo) Se il tipo di macchina lo consente e vuoi aggiungere SSD locali, segui questi passaggi:
  1. Nel campo Numero di dischi, seleziona il numero di dischi per le unità SSD locali.
  2. Nella sezione Tipo di interfaccia, seleziona una delle seguenti interfacce:
    - SCSI (predefinita)
    - NVMe
Nella sezione Ora di eliminazione automatica delle prenotazioni generate automaticamente, esegui una delle seguenti operazioni:
- Per consentire a Compute Engine di eliminare automaticamente le prenotazioni create automaticamente per la tua richiesta di prenotazione futura:
  
  Attenzione: se l'opzione di eliminazione automatica è abilitata, tutte le prenotazioni create automaticamente vengono eliminate al momento dell'eliminazione specificato, indipendentemente dal fatto che siano state consumate completamente o meno.
  1. Fai clic sul pulsante di attivazione/disattivazione Abilita l'eliminazione automatica per attivare l'opzione (impostazione predefinita).
  2. (Facoltativo) Nel campo Ora di eliminazione automatica, inserisci una nuova data e ora in cui eliminare le prenotazioni create automaticamente. La data e l'ora devono essere successive all'ora di fine del periodo di prenotazione. Se lasci vuoto questo campo, le prenotazioni create automaticamente vengono eliminate entro 2 ore dall'ora di fine del periodo di prenotazione.
- In caso contrario, fai clic sul pulsante di attivazione/disattivazione Attiva l'eliminazione automatica per disattivare l'opzione.
Esegui una di queste operazioni:
- Per creare una richiesta di prenotazione futura e inviarla per la revisione a Google Cloud, fai clic su Invia.
  
  Attenzione: assicurati che una richiesta di prenotazione futura sia pronta per la revisione prima di inviarla. Una volta inviata la bozza, non puoi più tornare alla bozza.
- Per creare una bozza di richiesta di prenotazione futura, fai clic su Salva bozza.
- Per uscire senza salvare, fai clic su Annulla.

Si apre la pagina Prenotazioni. La creazione della richiesta di prenotazione futura può richiedere fino a un minuto.

gcloud

Per creare una richiesta di prenotazione futura condivisa specificando direttamente le proprietà, utilizza il comando gcloud beta compute future-reservations create.

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
    --auto-delete-auto-created-reservations \
    --description="DESCRIPTION" \
    --local-ssd=size=375,interface=INTERFACE_1 \
    --local-ssd=size=375,interface=INTERFACE_2 \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform=MIN_CPU_PLATFORM \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Sostituisci quanto segue:

FUTURE_RESERVATION_NAME: il nome della richiesta di prenotazione futura da creare.

(Facoltativo) Per aggiungere GPU (Graphics Processing Unit) a ogni VM prenotata, specifica quanto segue:
- NUMBER_OF_ACCELERATORS: il numero di GPU da aggiungere per VM prenotata.
- ACCELERATOR_TYPE: il tipo di GPU da aggiungere alle VM prenotate.
Assicurati che il tipo di macchina specificato nella richiesta di prenotazione futura supporti i tipi di GPU specificati e che la GPU sia disponibile nella zona in cui vuoi prenotare le risorse. In caso contrario, si verificheranno errori.

DESCRIPTION: facoltativo. Una descrizione per la richiesta di prenotazione futura.

INTERFACE_1 e INTERFACE_2: facoltativi. Il tipo di interfaccia che vuoi che vengano utilizzati dagli SSD locali per ogni VM. Il valore deve essere uno dei seguenti:
- Se l'immagine disco di avvio ha driver NVMe ottimizzati, specifica nvme.
- In caso contrario, specifica scsi.
Ogni SSD locale ha una dimensione di 375 GB. Ripeti il flag --local-ssd per ogni SSD locale che vuoi aggiungere. Puoi specificare un massimo di 24 SSD locali.
MACHINE_TYPE: un tipo di macchina da utilizzare per ogni VM. Specifica uno dei seguenti valori:
- Per un tipo di macchina predefinita: MACHINE_FAMILY-standard-CPUS.
- Per un tipo di macchina personalizzata: MACHINE_FAMILY-custom-CPUS-MEMORY. Prima di specificare un tipo di macchina personalizzata, esamina le limitazioni per le VM con tipi di macchine personalizzate.
Sostituisci quanto segue:
- MACHINE_FAMILY: la famiglia di macchine.
- CPUS: il numero di vCPU.
- MEMORY: la memoria totale per una VM riservata. La memoria deve essere un multiplo di 256 MB e deve essere fornita in MB.
Ad esempio, per specificare un tipo di macchina personalizzata N2 con 4 vCPU e 5 GB di memoria, pari a 5120 MB, specifica n2-custom-4-5120.
MINIMUM_CPU_PLATFORM: facoltativo. La piattaforma CPU minima da utilizzare per ogni VM. Se ometti il flag --min-cpu-platform, il suo valore viene impostato sulla piattaforma CPU predefinita della zona.

NAME_PREFIX: il prefisso del nome della richiesta di prenotazione futura. Il nome di ogni prenotazione creata automaticamente per questa richiesta di prenotazione futura inizia con il prefisso del nome. Per aiutarti a identificare le prenotazioni create automaticamente per questa richiesta di prenotazione futura, è consigliabile specificare un prefisso nome univoco.
PLANNING_STATUS: facoltativo. Lo stato di pianificazione della richiesta di prenotazione futura, che deve essere uno dei seguenti:
- Per creare la bozza di una richiesta di prenotazione futura, specifica DRAFT.
- Per creare la richiesta di prenotazione futura e inviarla per l'approvazione a Google Cloud, specifica SUBMITTED.
  
  Attenzione: dopo aver inviato per la revisione una richiesta di prenotazione futura, non puoi ripristinare lo stato di pianificazione su DRAFT.
Se ometti il flag --planning-status, il valore viene impostato su DRAFT.
PROJECT_ID: l'ID del progetto in cui vuoi prenotare le risorse.

CONSUMER_PROJECT_IDS: un elenco separato da virgole degli ID progetto dei progetti con cui può essere condivisa questa richiesta di prenotazione futura. Ad esempio, specifica project-1,project-2. Puoi specificare fino a 100 progetti. Questi progetti devono trovarsi nella stessa organizzazione del progetto in cui viene creata la richiesta di prenotazione futura (progetto proprietario). Non specificare il progetto proprietario. Per impostazione predefinita, è già consentito utilizzare le prenotazioni create automaticamente per questa richiesta di prenotazione futura.

START_TIME: l'ora di inizio del periodo di prenotazione formattata come timestamp RFC 3339, che deve essere il seguente:
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
Sostituisci quanto segue:
- YYYY-MM-DD: dati formattati come anno a quattro cifre, mese a due cifre e giorno del mese a due cifre, separati da trattini (-).
- HH:MM:SS: un'ora formattata come ora a due cifre con formato a 24 ore, minuti a due cifre e secondi a due cifre, separati dai due punti (:).
- OFFSET: il fuso orario formattato come offset del Tempo coordinato universale (UTC). Ad esempio, per utilizzare il fuso orario PST (Pacific Standard Time), specifica -08:00. In alternativa, per non usare alcun offset, specifica Z.
L'ora di inizio non può essere successiva a un anno dalla data e dall'ora in cui invii la richiesta di prenotazione futura per la revisione. Per avere tempo sufficiente per annullare, eliminare o modificare facoltativamente una richiesta di prenotazione futura dopo l'approvazione o prima dell'inserimento dell'ora di blocco, assicurati di specificare un valore consigliato per l'ora di inizio.
END_TIME: l'ora di fine del periodo di prenotazione formattata come timestamp RFC 3339. Il periodo di prenotazione deve durare almeno 24 ore. In alternativa, puoi sostituire il flag --end-time con il flag --duration=END_DURATION, dove END_DURATION è la durata del periodo di prenotazione in secondi. Ad esempio, specifica 1209600 per 1.209.600 secondi (14 giorni).

Per aumentare le probabilità che Google Cloud approvi una richiesta di prenotazione futura dopo averla inviata per la revisione, assicurati di specificare uno dei valori consigliati per il periodo di prenotazione.

Importante: assicurati che il periodo di prenotazione non si sovrapponga al periodo di prenotazione di un'altra richiesta di prenotazione futura esistente con proprietà VM e zona corrispondenti e che sia stato creato nel progetto attuale o sia condiviso con quest'ultimo. In caso contrario, la creazione della richiesta di prenotazione futura non va a buon fine.
TOTAL_COUNT: numero totale di VM da prenotare per il periodo, la configurazione delle VM e i progetti specificati in questa richiesta di prenotazione futura.

Nel calcolare il numero di prenotazioni da creare per una prenotazione futura approvata, Compute Engine controlla prima le prenotazioni esistenti. Se esistono prenotazioni esistenti che corrispondono alla prenotazione futura approvata, il numero di prenotazioni esistenti viene sottratto dal numero totale richiesto di prenotazioni nella richiesta per determinare il numero di nuove prenotazioni create da Compute Engine. Per ulteriori informazioni, vedi come Compute Engine conteggia ed esegue il provisioning delle risorse prenotate.

Attenzione: assicurati di disporre di una quota sufficiente per le risorse che richiedi di prenotare. In caso contrario, Google Cloud rifiuta la richiesta di prenotazione futura.
ZONE: la zona in cui prenotare le risorse.

Per eliminare le prenotazioni create automaticamente dopo l'ora di fine del periodo di prenotazione, seleziona uno dei seguenti metodi:

Attenzione: se abiliti l'opzione di eliminazione automatica, tutte le prenotazioni create automaticamente vengono eliminate al momento dell'eliminazione specificato, indipendentemente dal fatto che siano state completamente utilizzate o meno.
- Per eliminare le prenotazioni create automaticamente in un orario specifico dopo l'ora di fine del periodo di prenotazione, specifica i flag --auto-delete-auto-created-reservations e --auto-created-reservations-delete-time.
```
gcloud beta compute future-reservations create example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
    ...
```
  Sostituisci AUTO_CREATED_RESERVATIONS_DELETE_TIME con una data e un'ora formattate come timestamp RFC 3339.
- Per eliminare le prenotazioni create automaticamente dopo una durata specifica dopo l'ora di fine del periodo di prenotazione, specifica i flag --auto-delete-auto-created-reservations e --auto-created-reservations-duration.
```
gcloud beta compute future-reservations create example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
    ...
```
  Sostituisci DURATION_BEFORE_DELETE con una durata espressa in giorni, ore, minuti o secondi. Ad esempio, specifica 30m per 30 minuti o 1d2h3m4s per 1 giorno, 2 ore, 3 minuti e 4 secondi.
Per impedire a Compute Engine di eliminare automaticamente le prenotazioni create automaticamente, specifica il flag --no-auto-delete-auto-created-reservations. Devi disabilitare l'opzione di eliminazione automatica se vuoi associare la prenotazione creata automaticamente a un impegno.
```
gcloud beta compute future-reservations create example-future-reservation \
    --no-auto-delete-auto-created-reservations \
    ...
```

Ad esempio, il comando seguente crea una bozza di richiesta di prenotazione futura per 80 VM. La richiesta di prenotazione futura è condivisa con project-1 e project-2. Il periodo di prenotazione inizia a mezzanotte del 10 novembre 2023 UTC e termina a mezzanotte del 10 dicembre 2023 UTC. Le VM prenotate specificano un tipo di macchina n2-standard-4, una piattaforma CPU minima skylake e 1 SSD locale con interfaccia scsi e 375 GB ciascuna. Le prenotazioni create automaticamente per la prenotazione futura vengono create nella zona us-central1-a, hanno un nome che inizia con fr-02-reservation e vengono eliminate automaticamente a mezzanotte del 13 dicembre 2023 UTC.

gcloud beta compute future-reservations create fr-02 \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-delete-time=2023-12-13T00:00:00Z \
    --local-ssd=size=375,interface=scsi \
    --machine-type=n2-standard-4 \
    --min-cpu-platform=skylake \
    --name-prefix=fr-02-reservation \
    --planning-status=DRAFT \
    --project=example-project \
    --share-setting=projects \
    --share-with=project-1,project-2 \
    --start-time=2023-11-10T00:00:00Z \
    --end-time=2023-12-10T00:00:00Z \
    --total-count=80 \
    --zone=us-central1-a

REST

Per creare una richiesta di prenotazione futura condivisa specificando direttamente le proprietà, effettua una richiesta POST al metodo beta.futureReservations.insert.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
  "description": "DESCRIPTION",
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "planningStatus": "PLANNING_STATUS",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "instanceProperties": {
      "guestAccelerators": [
        {
          "acceleratorCount": NUMBER_OF_ACCELERATORS,
          "acceleratorType": "ACCELERATOR_TYPE"
        }
      ],
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_1"
        },
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_2"
        }
      ],
      "machineType": "MACHINE_TYPE",
      "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
    },
    "totalCount": "TOTAL_COUNT"
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

Sostituisci quanto segue:

PROJECT_ID: l'ID del progetto in cui vuoi prenotare le risorse.
ZONE: la zona in cui vuoi prenotare le risorse.
AUTO_DELETE_AUTO_CREATED_RESERVATIONS: se imposti questo campo su true, Compute Engine elimina automaticamente le prenotazioni create automaticamente per questa richiesta di prenotazione futura, indipendentemente dal fatto che siano state completamente utilizzate o meno. Imposta questo campo su false se vuoi associare la prenotazione creata automaticamente a un impegno.

Per impostazione predefinita, l'ora di eliminazione rientra entro 2 ore dall'ora di fine del periodo di prenotazione. Per cambiare questa impostazione, procedi in uno dei seguenti modi:
- Per eliminare le prenotazioni create automaticamente dopo un intervallo di tempo specifico dopo la fine del periodo di prenotazione, imposta autoDeleteAutoCreatedReservations su true e specifica il campo autoCreatedReservationsDeleteTime.
```
POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDeleteTime": "DELETE_TIME",
  ...
}
```
  Sostituisci DELETE_TIME con una data e un'ora quando Compute Engine elimina le prenotazioni create automaticamente. Data e ora devono essere formattate come timestamp RFC 3339, che deve essere il seguente:
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
  Sostituisci quanto segue:
  - YYYY-MM-DD: dati formattati come anno a quattro cifre, mese a due cifre e giorno del mese a due cifre, separati da trattini (-).
  - HH:MM:SS: un'ora formattata come ora a due cifre con formato di 24 ore, minuti a due cifre e secondi a due cifre, separati dai due punti (:).
  - OFFSET: il fuso orario formattato come offset rispetto al fuso orario UTC (Coordinated Universal Time). Ad esempio, per utilizzare il fuso orario PST (Pacific Standard Time), specifica -08:00. In alternativa, per non utilizzare alcun offset, specifica Z.
- Per eliminare le prenotazioni create automaticamente dopo una durata specifica dall'ora di inizio del periodo di prenotazione, imposta autoDeleteAutoCreatedReservations su true e specifica il campo autoCreatedReservationsDuration.
```
POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  },
  ...
}
```
  Sostituisci DURATION_BEFORE_DELETE con una durata in secondi. Ad esempio, specifica 604800 per 604.800 secondi (7 giorni).
DESCRIPTION: facoltativo. Una descrizione per la richiesta di prenotazione futura.
FUTURE_RESERVATION_NAME: il nome della richiesta di prenotazione futura da creare.
NAME_PREFIX: il prefisso del nome della richiesta di prenotazione futura. Il nome di ogni prenotazione creata automaticamente per questa richiesta di prenotazione futura inizia con il prefisso del nome. Per aiutarti a identificare le prenotazioni create automaticamente per questa richiesta di prenotazione futura, è consigliabile specificare un prefisso nome univoco.

CONSUMER_PROJECT_ID_1 e CONSUMER_PROJECT_ID_2: gli ID progetto dei progetti con cui può essere condivisa questa richiesta di prenotazione futura. Puoi specificare fino a 100 progetti. Questi progetti devono trovarsi nella stessa organizzazione del progetto in cui viene creata la richiesta di prenotazione futura (progetto proprietario). Non specificare il progetto del proprietario. Per impostazione predefinita, è già consentito utilizzare le prenotazioni create automaticamente per questa richiesta di prenotazione futura.

PLANNING_STATUS: facoltativo. Lo stato di pianificazione della richiesta di prenotazione futura, che deve essere uno dei seguenti:
- Per creare la bozza di una richiesta di prenotazione futura, specifica DRAFT.
- Per creare la richiesta di prenotazione futura e inviarla per l'approvazione a Google Cloud, specifica SUBMITTED.
  
  Attenzione: dopo aver inviato per la revisione una richiesta di prenotazione futura, non puoi ripristinare lo stato di pianificazione su DRAFT.
Se ometti il campo planningStatus, il valore viene impostato su DRAFT.

(Facoltativo) Per aggiungere GPU (Graphics Processing Unit) a ogni VM prenotata, specifica quanto segue:
- NUMBER_OF_ACCELERATORS: il numero di GPU da aggiungere per VM prenotata.
- ACCELERATOR_TYPE: il tipo di GPU da aggiungere alle VM prenotate.
Assicurati che il tipo di macchina specificato nella richiesta di prenotazione futura supporti i tipi di GPU specificati e che la GPU sia disponibile nella zona in cui vuoi prenotare le risorse. In caso contrario, si verificheranno errori.
INTERFACE_1 e INTERFACE_2: facoltativi. Il tipo di interfaccia che vuoi che vengano utilizzati dagli SSD locali per ogni VM. Il valore deve essere uno dei seguenti:
- Se l'immagine disco di avvio ha driver NVMe ottimizzati, specifica NVME.
- In caso contrario, specifica SCSI.
Ogni SSD locale ha una dimensione di 375 GB. Ripeti il flag --local-ssd per ogni SSD locale che vuoi aggiungere. Puoi specificare un massimo di 24 SSD locali.
MACHINE_TYPE: un tipo di macchina da utilizzare per ogni VM. Specifica uno dei seguenti valori:
- Per un tipo di macchina predefinita: MACHINE_FAMILY-standard-CPUS.
- Per un tipo di macchina personalizzata: MACHINE_FAMILY-custom-CPUS-MEMORY. Prima di specificare un tipo di macchina personalizzata, esamina le limitazioni per le VM con tipi di macchine personalizzate.
Sostituisci quanto segue:
- MACHINE_FAMILY: la famiglia di macchine.
- CPUS: il numero di vCPU.
- MEMORY: la memoria totale per una VM riservata. La memoria deve essere un multiplo di 256 MB e deve essere fornita in MB.
Ad esempio, per specificare un tipo di macchina personalizzata N2 con 4 vCPU e 5 GB di memoria, pari a 5120 MB, specifica n2-custom-4-5120.
MINIMUM_CPU_PLATFORM: facoltativo. La piattaforma CPU minima da utilizzare per ogni VM. Se ometti il flag --min-cpu-platform, il suo valore viene impostato sulla piattaforma CPU predefinita della zona.

TOTAL_COUNT: numero totale di VM da prenotare per il periodo, la configurazione delle VM e i progetti specificati in questa richiesta di prenotazione futura.

Nel calcolare il numero di prenotazioni da creare per una prenotazione futura approvata, Compute Engine controlla prima le prenotazioni esistenti. Se esistono prenotazioni esistenti che corrispondono alla prenotazione futura approvata, il numero di prenotazioni esistenti viene sottratto dal numero totale richiesto di prenotazioni nella richiesta per determinare il numero di nuove prenotazioni create da Compute Engine. Per ulteriori informazioni, vedi come Compute Engine conteggia ed esegue il provisioning delle risorse prenotate.

Attenzione: assicurati di disporre di una quota sufficiente per le risorse che richiedi di prenotare. In caso contrario, Google Cloud rifiuta la richiesta di prenotazione futura.
START_TIME: l'ora di inizio del periodo di prenotazione formattata come timestamp RFC 3339. L'ora di inizio non può essere successiva a un anno dalla data e dall'ora in cui invii per la revisione una richiesta di prenotazione futura. Inoltre, assicurati di specificare un valore consigliato per l'ora di inizio in modo da disporre di tempo sufficiente prima che una prenotazione futura inserisca il proprio orario di blocco.
END_TIME: l'ora di fine del periodo di prenotazione formattata come timestamp RFC 3339. Il periodo di prenotazione deve durare almeno 24 ore. In alternativa, puoi sostituire il campo endTime con il campo duration per specificare una durata specifica dall'ora di inizio del periodo di prenotazione:
```
"duration": {
  "seconds": "END_DURATION"
}
```
Sostituisci END_DURATION con una durata in secondi. Ad esempio, specifica 1209600 per 1.209.600 secondi (14 giorni).

Per aumentare le probabilità che Google Cloud approvi una richiesta di prenotazione futura dopo averla inviata per la revisione, assicurati di specificare uno dei valori consigliati per il periodo di prenotazione.

Importante: assicurati che il periodo di prenotazione non si sovrapponga al periodo di prenotazione di un'altra richiesta di prenotazione futura esistente con proprietà VM e zona corrispondenti e che sia stato creato nel progetto attuale o sia condiviso con quest'ultimo. In caso contrario, la creazione della richiesta di prenotazione futura non va a buon fine.

Ad esempio, il comando seguente crea una bozza di richiesta di prenotazione futura per 80 VM. La richiesta di prenotazione futura è condivisa con project-1 e project-2. Il periodo di prenotazione inizia a mezzanotte del 10 novembre 2023 UTC e termina a mezzanotte del 10 dicembre 2023 UTC. Le VM prenotate specificano un tipo di macchina n2-standard-4, una piattaforma CPU minima skylake e 1 SSD locale con interfaccia SCSI e 375 GB ciascuna. Le prenotazioni create automaticamente per la prenotazione futura vengono create nella zona us-central1-a, hanno un nome che inizia con fr-02-reservation e vengono eliminate automaticamente a mezzanotte del 13 dicembre 2023 UTC.

POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDeleteTime": "2023-12-13T00:00:00Z",
  "name": "fr-02",
  "namePrefix": "fr-02-reservation",
  "specificSkuProperties": { 
    "instanceProperties": {
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "SCSI"
        }
      ],
      "machineType": "n2-standard-4",
      "minCpuPlatform": "Skylake"
    },
    "totalCount": "80"
  },
  "planningStatus": "DRAFT",
  "shareSettings": {
    "projects": [
      "project-1",
      "project-2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "timeWindow": {
    "startTime": "2023-11-10T00:00:00Z",
    "endTime": "2023-12-10T00:00:00Z"
  }
}

Inviare una bozza di richiesta di prenotazione futura per la revisione

Puoi inviare a Google Cloud una bozza di richiesta di prenotazione futura per la revisione utilizzando la console Google Cloud, gcloud CLI e il REST. Se vuoi anche modificare una o più proprietà quando invii per la revisione la bozza di richiesta di prenotazione futura, consulta Modificare una bozza o una richiesta di prenotazione futura rifiutata.

Console

Per inviare per la revisione una bozza di richiesta di prenotazione futura:

Nella console Google Cloud, vai alla pagina Prenotazioni.

Vai a Prenotazioni
Fai clic sulla scheda Prenotazioni future.
Nella colonna Nome, fai clic sul nome di una richiesta di prenotazione futura con lo stato di approvvigionamento Bozza.

Si apre la pagina Prenotazioni future con i dettagli della richiesta di prenotazione futura.
Fai clic su Modifica bozza.

Si apre la pagina dei dettagli della bozza di richiesta di prenotazione futura.
Per inviare a Google Cloud la bozza di richiesta di prenotazione futura, fai clic su Invia.

Si apre la pagina Prenotazione. Nella colonna Stato della richiesta di prenotazione futura che hai appena inviato, lo stato dell'approvvigionamento è impostato su In attesa di approvazione.

gcloud

Per inviare per la revisione una bozza di richiesta di prenotazione futura, utilizza il comando gcloud beta compute future-reservations update con il flag --planning-status impostato su SUBMITTED.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME  \
    --planning-status=SUBMITTED \
    --project=PROJECT_ID \
    --zone=ZONE

Sostituisci quanto segue:

FUTURE_RESERVATION_NAME: il nome di una bozza di richiesta di prenotazione futura esistente.
PROJECT_ID: l'ID del progetto in cui si trova la richiesta di prenotazione futura.
ZONE: la zona in cui si trova la richiesta di prenotazione futura.

REST

Per inviare per la revisione una bozza di richiesta di prenotazione futura, invia una richiesta PATCH al metodo beta.futureReservations.update con il campo planningStatus impostato su SUBMITTED.

PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=planningStatus

{
  "name": "FUTURE_RESERVATION_NAME",
  "planningStatus": "SUBMITTED"
}

Sostituisci quanto segue:

PROJECT_ID: l'ID del progetto in cui si trova la richiesta di prenotazione futura.
ZONE: la zona in cui si trova la richiesta di prenotazione futura.
FUTURE_RESERVATION_NAME: il nome di una bozza di richiesta di prenotazione futura esistente.

Dopo aver inviato una bozza di richiesta di prenotazione futura per la revisione, puoi:

Per monitorare lo stato di approvvigionamento della richiesta e controllare se Google Cloud ha approvato o rifiutato la richiesta, visualizza i dettagli della richiesta di prenotazione futura.
Per impedire a Google Cloud di esaminare la tua richiesta e impedire a Compute Engine di eseguire il provisioning della capacità richiesta, annulla o elimina la richiesta di prenotazione futura.

Risolvere i problemi

Se riscontri errori durante la creazione di una richiesta di prenotazione futura, scopri come risolvere i problemi delle richieste di prenotazione future.

Se i problemi persistono anche dopo la risoluzione dei problemi, contatta il tuo gestore dell'account tecnico o il team di vendita.

Passaggi successivi

Scopri come visualizzare le richieste di prenotazione future.
Scopri come modificare, annullare o eliminare le richieste di prenotazione future.
Una volta raggiunta l'ora di inizio del periodo di prenotazione, scopri come utilizzare le prenotazioni create automaticamente.