Creare richieste di prenotazione futura condivise

Questo documento spiega come creare richieste di prenotazione futura condivise.

Se Google Cloud approva la tua richiesta di prenotazione futura condivisa, all'ora di inizio specificata nella richiesta, Compute Engine crea automaticamente 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 nei progetti con cui la prenotazione futura è condivisa (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 l'hai ancora fatto:
  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è la procedura mediante la quale la tua identità viene verificata per l'accesso alle API e ai servizi Google Cloud. 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. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

      Per utilizzare gli esempi dell'API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali fornite a gcloud CLI.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

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

Ruoli obbligatori

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

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

Autorizzazioni obbligatorie

Per creare richieste di prenotazione futura condivise sono necessarie le seguenti autorizzazioni:

  • Per creare una richiesta di prenotazione futura: compute.futureReservations.create nel 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 ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Limitazioni

Oltre alle limitazioni generali per le prenotazioni future, la creazione di richieste di prenotazione futura condivisa è soggetta alle seguenti limitazioni:

  • 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 del proprietario con prenotazioni condivise (compute.sharedReservationsOwnerProjects) da un amministratore dei criteri dell'organizzazione. Per maggiori informazioni, consulta Consentire e limitare la creazione e la modifica delle prenotazioni condivise da parte dei progetti nella documentazione delle prenotazioni di Compute Engine.

  • Se sposti un progetto che ha creato una richiesta di prenotazione futura condivisa in un'altra organizzazione, la prenotazione futura condivisa viene eliminata. Il progetto non viene rimosso automaticamente dal vincolo dei criteri organizzativi Progetti dei proprietari delle prenotazioni condivise (compute.sharedReservationsOwnerProjects), ma puoi rimuoverlo da questo vincolo, se vuoi.

  • Ogni richiesta di prenotazione futura condivisa può essere condivisa con fino a 100 progetti consumer.

  • Per ogni organizzazione, puoi creare fino a 100 richieste di prenotazione futura condivise per ogni combinazione univoca di proprietà VM.

Creare una richiesta di bozza

Quando crei una richiesta di prenotazione futura, puoi salvarla come bozza e inviarla in un secondo momento a Google Cloud per la revisione oppure inviarla direttamente per la revisione. Google consiglia di creare prima una bozza di richiesta, in quanto consente di determinare il numero di VM che Compute Engine eseguirà il provisioning per la richiesta anziché stimare manualmente questo numero e, facoltativamente, di modificare il numero di VM riservate nella richiesta prima di inviarla per la revisione.

Per utilizzare una prenotazione creata automaticamente per una prenotazione futura, una VM deve avere proprietà che corrispondono esattamente a quella prenotazione. Per specificare le proprietà delle VM che vuoi richiedere di prenotare creando una bozza di richiesta di prenotazione futura, utilizza uno dei seguenti metodi:

  • Consigliato: specifica un modello di istanza

    Puoi utilizzare un modello di istanza esistente per definire le proprietà di una bozza di richiesta di prenotazione futura. Utilizzando un modello di istanza, puoi definire le proprietà di una richiesta di prenotazione futura e le VM che possono utilizzare le prenotazioni create automaticamente nello stesso posto. Tuttavia, poiché i modelli sono specifici del 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 la prenotazione futura è condivisa, devi creare modelli simili in questi progetti o creare VM specificando direttamente le proprietà.

  • Specifica una VM esistente

    Puoi utilizzare una VM esistente per definire le proprietà di una richiesta di prenotazione futura. Utilizzando le proprietà di una VM esistente, puoi utilizzare le prenotazioni create automaticamente per la prenotazione futura creando VM con proprietà corrispondenti a quelle della VM di riferimento.

  • Specificare le proprietà direttamente

    Puoi definire direttamente le proprietà di una bozza di richiesta di prenotazione futura. Questo metodo richiede di verificare manualmente che le proprietà delle VM e le prenotazioni create automaticamente corrispondano esattamente. Eventuali proprietà non corrispondenti impediscono 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 prenotazioni.

Specifica un modello di istanza

Quando crei una richiesta di prenotazione futura condivisa specificando un modello di istanza, tieni presente quanto segue:

  • Un modello di istanza contiene impostazioni specifiche del progetto, pertanto puoi accedere e utilizzare un modello di istanza 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 per utilizzare le prenotazioni create automaticamente in ogni progetto consumer.

  • Devi creare la richiesta di prenotazione futura nella stessa regione e nella stessa zona delle risorse all'interno del modello di istanza. Qualsiasi risorsa regionale o di zona specificata in un modello di istanza, ad esempio un tipo di macchina o un Persistent Disk, limita l'utilizzo del modello alle località in cui si trovano queste risorse. Ad esempio, se il modello di istanza specifica un Persistent Disk 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 lo legano a una regione o a una zona specifica, visualizza i dettagli del modello e cerca i riferimenti alle risorse regionali o zonali al suo interno.

  • Se vuoi associare le prenotazioni create automaticamente per una prenotazione futura a un impegno, devi disattivare l'opzione di eliminazione automatica. Per ulteriori informazioni, consulta Limitazioni dopo la creazione.

Dopo aver creato una richiesta di prenotazione futura, non puoi modificarla per eseguire l'override delle proprietà VM del modello o specificare un altro modello. Se invece devi modificare le proprietà delle VM specificate nella richiesta, devi creare una nuova richiesta di prenotazione futura.

Per creare una prenotazione futura condivisa specificando un modello di istanza esistente, seleziona una delle seguenti opzioni:

Console

  1. Nella console Google Cloud, vai alla pagina Prenotazioni.

    Vai a Prenotazioni

  2. Fai clic sulla scheda Prenotazioni future.

  3. Fai clic su Crea prenotazione futura.

    Viene visualizzata la pagina Crea una prenotazione futura.

  4. In Nome, inserisci un nome per la richiesta di prenotazione futura.

  5. In Prefisso, inserisci un prefisso per il nome. Il nome di ogni prenotazione creata automaticamente da questa richiesta di prenotazione futura inizia con questo prefisso.

  6. Per Regione e Zona, seleziona la regione e la zona in cui prenotare le risorse.

  7. In 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. Per avere tempo sufficiente per eventualmente modificare, annullare o eliminare la prenotazione futura prima che entri nel suo orario di blocco, specifica un valore consigliato per l'ora di inizio.

  8. In 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 della 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.

  9. Nella sezione Tipo di condivisione:

    1. Per specificare una richiesta di prenotazione futura condivisa, seleziona Condivisa.

    2. Fai clic su Aggiungi progetti e poi seleziona i progetti dell'organizzazione del progetto corrente con cui vuoi condividere la richiesta di prenotazione futura. Puoi selezionare fino a 100 progetti.

  10. In Numero di istanze VM, inserisci il numero totale di VM che vuoi prenotare per il periodo, la configurazione delle VM e i progetti specificati in questa richiesta di prenotazione futura.

  11. Nella sezione Configurazione macchina:

    1. Seleziona Utilizza modello di istanza.

    2. In Modello di istanza, seleziona il modello di istanza che preferisci. Se selezioni un modello di istanza regionale, puoi prenotare solo risorse all'interno della stessa regione del modello.

  12. Nella sezione Data/ora di eliminazione automatica delle prenotazioni generate automaticamente, svolgi una delle seguenti operazioni:

    • Per consentire a Compute Engine di eliminare automaticamente le prenotazioni create automaticamente per la tua richiesta di prenotazione futura:

      1. Fai clic sul pulsante di attivazione/disattivazione Attiva eliminazione automatica in posizione On se non è già impostato su questa opzione.

      2. (Facoltativo) In Ora di eliminazione automatica, inserisci una data e un'ora per 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 due ore dall'ora di fine del periodo di prenotazione.

    • In caso contrario, fai clic sul pulsante di attivazione/disattivazione Attiva l'eliminazione automatica in posizione off.

  13. Per completare la creazione della bozza della richiesta di prenotazione futura, fai clic su Salva bozza.

Viene visualizzata 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 i flag --share-setting=projects e --share-with.

Per creare una bozza di richiesta di prenotazione futura specificando un modello di istanza senza includere flag facoltativi ed eliminare automaticamente la prenotazione creata automaticamente al termine del periodo di prenotazione, esegui il seguente comando:

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --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 futura richiesta di prenotazione.

  • MACHINE_TYPE: il tipo di macchina da utilizzare per ogni VM prenotata.

  • CONSUMER_PROJECT_IDS: un elenco separato da virgole di ID dei progetti a cui vuoi consentire di utilizzare le prenotazioni create automaticamente per questa richiesta di prenotazione futura, ad esempio project-1,project-2. Puoi specificare fino a 100 progetti. Questi progetti devono appartenere alla stessa organizzazione del progetto in cui viene creata la richiesta di prenotazione futura (il progetto proprietario). Non specificare il progetto del proprietario. Per impostazione predefinita, è già consentito utilizzare le prenotazioni create automaticamente per questa richiesta di prenotazione futura.

  • PROJECT_ID: l'ID del progetto in cui vuoi prenotare le risorse e in cui si trova il modello di istanza.

  • LOCATION: la posizione del modello di istanza. Specifica uno dei seguenti valori:

    • Per un modello di istanza regionale: regions/REGION. Sostituisci REGION con la regione in cui si trova il modello di istanza. Se specifichi un modello di istanza regionale, puoi creare la richiesta di prenotazione futura solo nella stessa regione del modello.

    • Per un modello di istanza globale: global.

  • INSTANCE_TEMPLATE_NAME: il nome di un modello di istanza esistente.

  • START_TIME: l'ora di inizio del periodo di prenotazione come timestamp RFC 3339, che deve essere formattato come segue:

    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 del mese a 2 cifre, separati da trattini (-).

    • HH:MM:SS: un'ora formattata come ora a due cifre utilizzando un'ora su 24 ore, minuti a due cifre e 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 PST (Pacific Standard Time), specifica -08:00. In alternativa, per non utilizzare alcun offset, specifica Z.

    L'ora di inizio non può essere successiva a un anno dalla data e dall'ora in cui invii una richiesta di prenotazione futura per la revisione. Per avere tempo sufficiente per annullare, eliminare o modificare facoltativamente una richiesta di prenotazione futura dopo la sua approvazione e prima dell'ora di blocco, specifica 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. Sostituisci END_DURATION con la durata del periodo di prenotazione in secondi. Ad esempio, specifica 1209600 per 1.209.600 secondi (14 giorni).

    Per aumentare la probabilità che Google Cloud approvi una richiesta di prenotazione futura dopo averla inviata per la revisione, specifica una durata minima consigliata.

  • TOTAL_COUNT: il numero totale di VM che vuoi prenotare.

  • ZONE: la zona in cui prenotare le risorse.

Ad esempio, supponiamo che tu voglia creare una bozza di richiesta di prenotazione futura chiamata fr-02 nella zona us-central1-a con le seguenti proprietà:

  • Un periodo di prenotazione che inizia a mezzanotte del 10 novembre 2024 UTC e termina a mezzanotte del 10 dicembre 2024 UTC.

  • Un conteggio totale di 80 VM.

  • Un modello di istanza regionale della regione us-central1.
  • L'opzione di eliminazione automatica è attivata. Le prenotazioni create automaticamente vengono eliminate alla fine del periodo di prenotazione.
  • La richiesta di prenotazione futura è condivisa con project-1 e project-2.

Per creare fr-02, esegui il comando seguente:

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

Se vuoi, puoi eseguire una o più delle seguenti operazioni:

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

    • Per eliminare le prenotazioni create automaticamente in una data e un'ora specifiche dopo l'ora di fine del periodo di prenotazione, includi il flag --auto-created-reservations-delete-time.

      gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
    --auto-delete-auto-created-reservations \
    --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 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 la data e l'ora di fine del periodo di prenotazione, includi il flag --auto-created-reservations-duration.

      gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
    --auto-delete-auto-created-reservations \
    --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 DURATION_BEFORE_DELETE con una durata in giorni, ore, minuti o secondi. Ad esempio, specifica 30m per 30 minuti o 1d2h3m4s per un giorno, due ore, tre minuti e quattro secondi.

  • Per disattivare l'opzione di eliminazione automatica per le prenotazioni create automaticamente, sostituisci il flag --auto-delete-auto-created-reservations con il flag --no-auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --no-auto-delete-auto-created-reservations \
    --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

  • Per specificare un prefisso del nome per le prenotazioni create automaticamente, includi il flag --name-prefix.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --name-prefix=NAME_PREFIX \
    --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 NAME_PREFIX con il prefisso del nome di ogni prenotazione creata automaticamente. Per aiutarti a identificare le prenotazioni create automaticamente per questa richiesta di prenotazione futura, Google Cloud consiglia di specificare un prefisso di nome univoco.

REST

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

Per creare una bozza di richiesta di prenotazione futura specificando un modello di istanza senza includere campi facoltativi, effettua una richiesta POST come segue:

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

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "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 in cui si trova il modello di istanza.

  • ZONE: la zona in cui prenotare le risorse.

  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: se imposti questo campo su true, Compute Engine elimina automaticamente le prenotazioni create automaticamente per questa prenotazione futura entro due ore dalla fine del periodo di prenotazione. Se vuoi associare le prenotazioni create automaticamente a un impegno, imposta questo campo su false.

  • CONSUMER_PROJECT_ID_1 e CONSUMER_PROJECT_ID_2: gli ID dei progetti con cui questa futura richiesta di prenotazione può essere condivisa. Puoi specificare fino a 100 progetti. Questi progetti devono appartenere alla stessa organizzazione del progetto in cui viene creata la richiesta di prenotazione futura (il progetto proprietario). Non specificare il progetto del 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 regionale: regions/REGION. Sostituisci REGION con la regione in cui si trova il modello di istanza. Se specifichi un modello di istanza regionale, puoi creare la richiesta di prenotazione futura solo nella stessa regione del modello.

    • Per un modello di istanza globale: global.

  • INSTANCE_TEMPLATE_NAME: il nome di un modello di istanza esistente.

  • TOTAL_COUNT: il numero totale di VM che vuoi prenotare.

  • START_TIME: l'ora di inizio del periodo di prenotazione come timestamp RFC 3339, che deve essere formattato come segue:

    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 del mese a 2 cifre, separati da trattini (-).

    • HH:MM:SS: un'ora formattata come ora a due cifre utilizzando un'ora su 24 ore, minuti a due cifre e 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 PST (Pacific Standard Time), specifica -08:00. In alternativa, per non utilizzare alcun offset, specifica Z.

    L'ora di inizio non può essere successiva a un anno dalla data e dall'ora in cui invii una richiesta di prenotazione futura per la revisione. Per avere tempo sufficiente per annullare, eliminare o modificare facoltativamente una richiesta di prenotazione futura dopo la sua approvazione e prima dell'ora di blocco, specifica 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 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 la probabilità che Google Cloud approvi una richiesta di prenotazione futura dopo che l'hai inviata per la revisione, specifica uno dei valori consigliati per il periodo di prenotazione.

Ad esempio, supponiamo che tu voglia creare una bozza di richiesta di prenotazione futura chiamata fr-02 nella zona us-central1-a con le seguenti proprietà:

  • Un periodo di prenotazione che inizia a mezzanotte del 10 novembre 2024 UTC e termina a mezzanotte del 10 dicembre 2024 UTC.

  • Un conteggio totale di 80 VM.

  • Un modello di istanza regionale della regione us-central1.
  • L'opzione di eliminazione automatica è attivata. Le prenotazioni create automaticamente vengono eliminate alla fine del periodo di prenotazione.
  • La richiesta di prenotazione futura è condivisa con project-1 e project-2.

Per creare fr-02, invia una richiesta POST come segue:

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

{
  "autoDeleteAutoCreatedReservations": true,
  "name": "fr-02",
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/example-project/regions/us-central1/instanceTemplates/example-template",
    "totalCount": 80
  },
  "shareSettings": {
    "projects": [
      "project-1",
      "project-2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "timeWindow": {
    "startTime": "2024-11-10T00:00:00Z",
    "endTime": "2024-12-10T00:00:00Z"
  }
}

Se vuoi, puoi eseguire una o più delle seguenti operazioni:

  • Per specificare un prefisso del nome per le prenotazioni create automaticamente, includi il campo namePrefix.

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

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "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 NAME_PREFIX con il prefisso del nome di ogni prenotazione creata automaticamente. Per aiutarti a identificare le prenotazioni create automaticamente per questa richiesta di prenotazione futura, Google Cloud consiglia di specificare un prefisso di nome univoco.

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

    • Per eliminare le prenotazioni create automaticamente dopo un'ora specifica successiva al termine del periodo di prenotazione, imposta autoDeleteAutoCreatedReservations su true e includi il campo autoCreatedReservationsDeleteTime.

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

{
  "autoCreatedReservationsDeleteTime": "DELETE_TIME",
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "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 DELETE_TIME con una data e un'ora in cui Compute Engine elimina le prenotazioni create automaticamente. La data e l'ora devono essere formattate come timestamp RFC 3339.

    • Per eliminare le prenotazioni create automaticamente dopo una durata specifica dall'ora di inizio del periodo di prenotazione, imposta autoDeleteAutoCreatedReservations su true e includi il campo autoCreatedReservationsDuration.

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

{
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  },
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "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 DURATION_BEFORE_DELETE con una durata in secondi. Ad esempio, specifica 604800 per 604.800 secondi (7 giorni).

Dopo aver creato una bozza di richiesta di prenotazione futura, puoi determinare il numero di VM che Compute Engine eseguirà il provisioning per la richiesta.

Specifica una VM esistente

Puoi creare una bozza di richiesta di prenotazione futura solo in base a una VM esistente nello stesso progetto e nella stessa zona della VM.

Dopo che la richiesta di prenotazione futura è stata approvata da Google Cloud ed è entrata nel periodo di prenotazione, puoi utilizzare le prenotazioni create automaticamente creando VM con proprietà corrispondenti alla VM di riferimento. A tal fine, puoi eseguire una delle seguenti operazioni:

  • Crea e utilizza un modello di istanza come segue:

    1. Crea un modello di istanza basato sulla VM di riferimento senza sostituire le proprietà della VM di riferimento.

    2. Crea le VM utilizzando il modello appena creato effettuando una o entrambe le operazioni riportate di seguito:

  • Crea una VM con proprietà che corrispondono esattamente alla VM di riferimento come segue:

    • Nel progetto del proprietario, crea una VM basata sulla VM di riferimento senza modificare le proprietà della VM che stai creando.

    • Nei progetti consumer, crea una VM assicurandoti manualmente che le sue proprietà corrispondano a quelle della VM di riferimento.

Per creare una richiesta di prenotazione futura condivisa che utilizzi le proprietà di una VM esistente:

  1. Nella console Google Cloud, vai alla pagina Prenotazioni.

    Vai a Prenotazioni

  2. Fai clic sulla scheda Prenotazioni future.

  3. Fai clic su Crea prenotazione futura.

    Viene visualizzata la pagina Crea una prenotazione futura.

  4. In Nome, inserisci un nome per la richiesta di prenotazione futura.

  5. In Prefisso, inserisci un prefisso per il nome. Il nome di ogni prenotazione creata automaticamente da questa richiesta di prenotazione futura inizia con questo prefisso.

  6. Per Regione e Zona, seleziona la regione e la zona in cui prenotare le risorse.

  7. In 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. Per avere tempo sufficiente per eventualmente modificare, annullare o eliminare la prenotazione futura prima che entri nel suo orario di blocco, specifica un valore consigliato per l'ora di inizio.

  8. In 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 della 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.

  9. Nella sezione Tipo di condivisione:

    1. Per specificare una richiesta di prenotazione futura condivisa, seleziona Condivisa.

    2. Fai clic su Aggiungi progetti e poi seleziona i progetti dell'organizzazione del progetto corrente con cui vuoi condividere la richiesta di prenotazione futura. Puoi selezionare fino a 100 progetti.

  10. In Numero di istanze VM, inserisci il numero totale di VM che vuoi prenotare per il periodo, la configurazione delle VM e i progetti specificati in questa richiesta di prenotazione futura.

  11. Nella sezione Configurazione macchina:

    1. Seleziona Usa VM esistente.

    2. Per VM esistente, seleziona la VM le cui proprietà vuoi utilizzare per creare la prenotazione.

  12. Nella sezione Data/ora di eliminazione automatica delle prenotazioni generate automaticamente, svolgi una delle seguenti operazioni:

    • Per consentire a Compute Engine di eliminare automaticamente le prenotazioni create automaticamente per la tua richiesta di prenotazione futura:

      1. Fai clic sul pulsante di attivazione/disattivazione Attiva eliminazione automatica in posizione On se non è già impostato su questa opzione.

      2. (Facoltativo) In Ora di eliminazione automatica, inserisci una data e un'ora per 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 due ore dall'ora di fine del periodo di prenotazione.

    • In caso contrario, fai clic sul pulsante di attivazione/disattivazione Attiva l'eliminazione automatica in posizione off.

  13. Per completare la creazione della bozza della richiesta di prenotazione futura, fai clic su Salva bozza.

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

Dopo aver creato una bozza di richiesta di prenotazione futura, puoi determinare il numero di VM che Compute Engine eseguirà il provisioning per la richiesta.

Specificare le proprietà direttamente

Se vuoi associare le prenotazioni create automaticamente per una prenotazione futura a un impegno, devi disattivare l'opzione di eliminazione automatica. Per maggiori informazioni, consulta Limitazioni dopo la creazione.

Per creare una richiesta di prenotazione futura condivisa specificando direttamente le proprietà, seleziona una delle seguenti opzioni:

Console

  1. Nella console Google Cloud, vai alla pagina Prenotazioni.

    Vai a Prenotazioni

  2. Fai clic sulla scheda Prenotazioni future.

  3. Fai clic su Crea prenotazione futura.

    Viene visualizzata la pagina Crea una prenotazione futura.

  4. In Nome, inserisci un nome per la richiesta di prenotazione futura.

  5. In Prefisso, inserisci un prefisso per il nome. Il nome di ogni prenotazione creata automaticamente da questa richiesta di prenotazione futura inizia con questo prefisso.

  6. Per Regione e Zona, seleziona la regione e la zona in cui prenotare le risorse.

  7. In 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. Per avere tempo sufficiente per eventualmente modificare, annullare o eliminare la prenotazione futura prima che entri nel suo orario di blocco, specifica un valore consigliato per l'ora di inizio.

  8. In 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 della 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.

  9. Nella sezione Tipo di condivisione:

    1. Per specificare una richiesta di prenotazione futura condivisa, seleziona Condivisa.

    2. Fai clic su Aggiungi progetti e poi seleziona i progetti dell'organizzazione del progetto corrente con cui vuoi condividere la richiesta di prenotazione futura. Puoi selezionare fino a 100 progetti.

  10. In Numero di istanze VM, inserisci il numero totale di VM che vuoi prenotare per il periodo, la configurazione delle VM e i progetti specificati in questa richiesta di prenotazione futura.

  11. Nella sezione Configurazione macchina:

    1. Seleziona Specifica il tipo di macchina, se non è già selezionato.

    2. Specifica il tipo di macchina da utilizzare per le VM riservate.

  12. Nella sezione Data/ora di eliminazione automatica delle prenotazioni generate automaticamente, svolgi una delle seguenti operazioni:

    • Per consentire a Compute Engine di eliminare automaticamente le prenotazioni create automaticamente per la tua richiesta di prenotazione futura:

      1. Fai clic sul pulsante di attivazione/disattivazione Attiva eliminazione automatica in posizione On se non è già impostato su questa opzione.

      2. (Facoltativo) In Ora di eliminazione automatica, inserisci una data e un'ora per 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 due ore dall'ora di fine del periodo di prenotazione.

    • In caso contrario, fai clic sul pulsante di attivazione/disattivazione Attiva l'eliminazione automatica in posizione off.

  13. Per completare la creazione della bozza della richiesta di prenotazione futura, fai clic su Salva bozza.

Viene visualizzata 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 con i flag --share-setting=projects e --share-with.

Per creare una bozza di richiesta di prenotazione futura specificando direttamente le proprietà senza includere flag facoltativi ed eliminare automaticamente la prenotazione creata automaticamente al termine del periodo di prenotazione, esegui il seguente comando:

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --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 futura richiesta di prenotazione.

  • MACHINE_TYPE: il tipo di macchina da utilizzare per ogni VM prenotata.

  • CONSUMER_PROJECT_IDS: un elenco separato da virgole di ID dei progetti a cui vuoi consentire di utilizzare le prenotazioni create automaticamente per questa richiesta di prenotazione futura, ad esempio project-1,project-2. Puoi specificare fino a 100 progetti. Questi progetti devono appartenere alla stessa organizzazione del progetto in cui viene creata la richiesta di prenotazione futura (il progetto proprietario). Non specificare il progetto del 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 come timestamp RFC 3339, che deve essere formattato come segue:

    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 del mese a 2 cifre, separati da trattini (-).

    • HH:MM:SS: un'ora formattata come ora a due cifre utilizzando un'ora su 24 ore, minuti a due cifre e 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 PST (Pacific Standard Time), specifica -08:00. In alternativa, per non utilizzare alcun offset, specifica Z.

    L'ora di inizio non può essere successiva a un anno dalla data e dall'ora in cui invii una richiesta di prenotazione futura per la revisione. Per avere tempo sufficiente per annullare, eliminare o modificare facoltativamente una richiesta di prenotazione futura dopo la sua approvazione e prima dell'ora di blocco, specifica 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. Sostituisci END_DURATION con la durata del periodo di prenotazione in secondi. Ad esempio, specifica 1209600 per 1.209.600 secondi (14 giorni).

    Per aumentare la probabilità che Google Cloud approvi una richiesta di prenotazione futura dopo averla inviata per la revisione, specifica una durata minima consigliata.

  • TOTAL_COUNT: il numero totale di VM che vuoi prenotare.

  • ZONE: la zona in cui prenotare le risorse.

Ad esempio, supponiamo che tu voglia creare una bozza di richiesta di prenotazione futura chiamata fr-02 nella zona us-central1-a con le seguenti proprietà:

  • Un periodo di prenotazione che inizia a mezzanotte del 10 novembre 2024 UTC e termina a mezzanotte del 10 dicembre 2024 UTC.

  • Un conteggio totale di 80 VM.

  • Un tipo di macchina N2 predefinito con 4 vCPU.
  • L'opzione di eliminazione automatica è attivata. Le prenotazioni create automaticamente vengono eliminate alla fine del periodo di prenotazione.
  • La richiesta di prenotazione futura è condivisa con project-1 e project-2.

Per creare fr-02, esegui il comando seguente:

gcloud beta compute future-reservations create fr-02 \
    --auto-delete-auto-created-reservations \
    --machine-type=n2-standard-4 \
    --share-setting=projects \
    --share-with=project-1,project-2 \
    --start-time=2024-11-10T00:00:00Z \
    --end-time=2024-12-10T00:00:00Z \
    --total-count=80 \
    --zone=us-central1-a

Se vuoi, puoi eseguire una o più delle seguenti operazioni:

  • Per collegare le GPU alle VM N1 riservate, includi il flag --accelerator.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --accelerator=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --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:

    • NUMBER_OF_ACCELERATORS: il numero di GPU da aggiungere per VM prenotata.

    • ACCELERATOR_TYPE: un modello di GPU supportato per le VM N1. Per evitare errori, assicurati che il modello di GPU scelto sia disponibile nella zona in cui stai creando la richiesta di prenotazione futura.

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

    • Per eliminare le prenotazioni create automaticamente in una data e un'ora specifiche dopo l'ora di fine del periodo di prenotazione, includi il flag --auto-created-reservations-delete-time.

      gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

      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 la data e l'ora di fine del periodo di prenotazione, includi il flag --auto-created-reservations-duration.

      gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

      Sostituisci DURATION_BEFORE_DELETE con una durata in giorni, ore, minuti o secondi. Ad esempio, specifica 30m per 30 minuti o 1d2h3m4s per un giorno, due ore, tre minuti e quattro secondi.

  • Per disattivare l'opzione di eliminazione automatica per le prenotazioni create automaticamente, sostituisci il flag --auto-delete-auto-created-reservations con il flag --no-auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --no-auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

  • Per aggiungere uno o più dischi SSD locali a ogni VM prenotata, includi uno o più flag --local-ssd. Puoi specificare fino a 24 dischi SSD locali. Ogni disco SSD locale ha una dimensione di 375 GB.

    Ad esempio, per specificare due dischi SSD locali quando crei una bozza di richiesta di prenotazione futura, includi due flag --local-ssd come segue:

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --local-ssd=size=375,interface=INTERFACE_1 \
    --local-ssd=size=375,interface=INTERFACE_2 \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

    Sostituisci INTERFACE_1 e INTERFACE_2 con il tipo di interfaccia che vuoi che venga utilizzato dal disco SSD locale come segue:

    Assicurati che il tipo di macchina specificato per le VM riservate supporti le interfacce dei dischi scelte. In caso contrario, la creazione della richiesta di prenotazione futura non andrà a buon fine. Per ulteriori informazioni, scopri come scegliere un'interfaccia del disco.

  • Per fare in modo che le VM riservate utilizzino una piattaforma CPU minima specifica anziché la piattaforma CPU predefinita della zona, includi il flag --min-cpu-platform.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform="MIN_CPU_PLATFORM" \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

    Sostituisci MIN_CPU_PLATFORM con una piattaforma CPU minima. Per verificare che una piattaforma CPU sia disponibile nella zona in cui stai prenotando le risorse, visualizza le piattaforme CPU disponibili per zona.

  • Per specificare un prefisso del nome per le prenotazioni create automaticamente, includi il flag --name-prefix.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --name-prefix=NAME_PREFIX \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

    Sostituisci NAME_PREFIX con il prefisso del nome di ogni prenotazione creata automaticamente. Per aiutarti a identificare le prenotazioni create automaticamente per questa richiesta di prenotazione futura, Google Cloud consiglia di specificare un prefisso di nome univoco.

REST

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

Per creare una bozza di richiesta di prenotazione futura specificando direttamente le proprietà senza includere campi facoltativi, effettua una richiesta POST come segue:

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

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "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 prenotare le risorse.

  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: se imposti questo campo su true, Compute Engine elimina automaticamente le prenotazioni create automaticamente per questa prenotazione futura entro due ore dalla fine del periodo di prenotazione. Se vuoi associare le prenotazioni create automaticamente a un impegno, imposta questo campo su false.

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

  • TOTAL_COUNT: il numero totale di VM che vuoi prenotare.

  • START_TIME: l'ora di inizio del periodo di prenotazione come timestamp RFC 3339, che deve essere formattato come segue:

    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 del mese a 2 cifre, separati da trattini (-).

    • HH:MM:SS: un'ora formattata come ora a due cifre utilizzando un'ora su 24 ore, minuti a due cifre e 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 PST (Pacific Standard Time), specifica -08:00. In alternativa, per non utilizzare alcun offset, specifica Z.

    L'ora di inizio non può essere successiva a un anno dalla data e dall'ora in cui invii una richiesta di prenotazione futura per la revisione. Per avere tempo sufficiente per annullare, eliminare o modificare facoltativamente una richiesta di prenotazione futura dopo la sua approvazione e prima dell'ora di blocco, specifica 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 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 la probabilità che Google Cloud approvi una richiesta di prenotazione futura dopo che l'hai inviata per la revisione, specifica uno dei valori consigliati per il periodo di prenotazione.

Ad esempio, supponiamo che tu voglia creare una bozza di richiesta di prenotazione futura chiamata fr-02 nella zona us-central1-a con le seguenti proprietà:

  • Un periodo di prenotazione che inizia a mezzanotte del 10 novembre 2024 UTC e termina a mezzanotte del 10 dicembre 2024 UTC.

  • Un conteggio totale di 80 VM.

  • Un tipo di macchina N2 predefinito con 4 vCPU.
  • L'opzione di eliminazione automatica è attivata. Le prenotazioni create automaticamente vengono eliminate alla fine del periodo di prenotazione.
  • La richiesta di prenotazione futura è condivisa con project-1 e project-2.

Per creare fr-02, invia una richiesta POST come segue:

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

{
  "autoDeleteAutoCreatedReservations": true,
  "name": "fr-02",
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "n2-standard-4"
    },
    "totalCount": 80
  },
  "shareSettings": {
    "projects": [
      "project-1",
      "project-2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "timeWindow": {
    "startTime": "2024-11-10T00:00:00Z",
    "endTime": "2024-12-10T00:00:00Z"
  }
}

Se vuoi, puoi eseguire una o più delle seguenti operazioni:

  • Per specificare un prefisso del nome per le prenotazioni create automaticamente, includi il campo namePrefix.

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

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

    Sostituisci NAME_PREFIX con il prefisso del nome di ogni prenotazione creata automaticamente. Per aiutarti a identificare le prenotazioni create automaticamente per questa richiesta di prenotazione futura, Google Cloud consiglia di specificare un prefisso di nome univoco.

  • Per collegare le GPU alle VM N1 riservate, includi il campo guestAccelerators.

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

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "guestAccelerators": [
        {
          "acceleratorCount": NUMBER_OF_ACCELERATORS,
          "acceleratorType": "ACCELERATOR_TYPE"
        }
      ],
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

    Sostituisci quanto segue:

    • NUMBER_OF_ACCELERATORS: il numero di GPU da aggiungere per VM prenotata.

    • ACCELERATOR_TYPE: un modello di GPU supportato per le VM N1. Per evitare errori, assicurati che il modello di GPU scelto sia disponibile nella zona in cui stai creando la richiesta di prenotazione futura.

  • Per aggiungere uno o più dischi SSD locali a ogni VM prenotata, includi il campo localSsds. Puoi specificare fino a 24 dischi SSD locali. Ogni disco SSD locale ha una dimensione di 375 GB.

    Ad esempio, per specificare due dischi SSD locali quando crei una bozza di richiesta di prenotazione futura, effettua una richiesta POST come segue:

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

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_1"
        },
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_2"
        }
      ],
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

    Sostituisci INTERFACE_1 e INTERFACE_2 con il tipo di interfaccia che vuoi che venga utilizzato per i dischi SSD locali:

    Assicurati che il tipo di macchina specificato per le VM riservate supporti le interfacce di disco scelte. In caso contrario, la creazione della richiesta di prenotazione futura non va a buon fine. Per ulteriori informazioni, scopri come scegliere un'interfaccia del disco.

  • Per fare in modo che le VM riservate utilizzino una piattaforma CPU minima specifica anziché la piattaforma CPU predefinita della zona, includi minCpuPlatform.

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

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "machineType": "MACHINE_TYPE",
      "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

    Sostituisci MIN_CPU_PLATFORM con una piattaforma CPU minima. Per verificare che una piattaforma CPU sia disponibile nella zona in cui stai prenotando le risorse, visualizza le piattaforme CPU disponibili per zona.

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

    • Per eliminare le prenotazioni create automaticamente dopo un'ora specifica successiva al termine del periodo di prenotazione, imposta autoDeleteAutoCreatedReservations su true e includi il campo autoCreatedReservationsDeleteTime.

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

{
  "autoCreatedReservationsDeleteTime": "DELETE_TIME",
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

      Sostituisci DELETE_TIME con una data e un'ora in cui Compute Engine elimina le prenotazioni create automaticamente. La data e l'ora devono essere formattate come timestamp RFC 3339.

    • Per eliminare le prenotazioni create automaticamente dopo una durata specifica dall'ora di inizio del periodo di prenotazione, imposta autoDeleteAutoCreatedReservations su true e includi il campo autoCreatedReservationsDuration.

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

{
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  },
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

      Sostituisci DURATION_BEFORE_DELETE con una durata in secondi. Ad esempio, specifica 604800 per 604.800 secondi (7 giorni).

Dopo aver creato una bozza di richiesta di prenotazione futura, puoi determinare il numero di VM che Compute Engine eseguirà il provisioning per la richiesta.

Inviare una richiesta di bozza

Dopo che una richiesta di prenotazione futura è stata inviata, approvata da Google Cloud e superata la relativa ora di blocco, puoi eliminare la prenotazione futura e le prenotazioni create automaticamente solo dopo la fine del periodo di prenotazione della prenotazione futura. L'eliminazione di una prenotazione futura esistente è utile se devi creare un'altra prenotazione futura con le stesse proprietà. Pertanto, 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 futura che puoi creare. Per assicurarti di poter creare correttamente una richiesta di prenotazione futura e che la tua richiesta non causi problemi in altri progetti con cui condividi richieste di prenotazione o prenotazioni future, consulta le limitazioni.

  • Devi impegnarti a pagare le risorse riservate che Compute Engine fornisce per l'intero periodo di prenotazione, indipendentemente dal fatto che le prenotazioni create automaticamente vengano utilizzate o meno. Per ulteriori informazioni, consulta la sezione Fatturazione.

Se vuoi modificare una o più proprietà quando invii la bozza della richiesta di prenotazione futura per la revisione, consulta Modificare le richieste di prenotazione futura.

Per inviare una bozza di richiesta di prenotazione futura a Google Cloud per la revisione, seleziona una delle seguenti opzioni:

Console

  1. Nella console Google Cloud, vai alla pagina Prenotazioni.

    Vai a Prenotazioni

  2. Fai clic sulla scheda Prenotazioni future.

  3. Nella colonna Nome, fai clic sul nome della richiesta di prenotazione futura con stato di approvvigionamento Bozza.

    Viene visualizzata la pagina Prenotazioni future con i dettagli della richiesta di prenotazione futura.

  4. Fai clic su Modifica bozza.

    Si apre la pagina per aggiornare la bozza della richiesta di prenotazione futura.

  5. Per inviare la bozza della richiesta di prenotazione futura per la revisione, 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 una bozza di richiesta di prenotazione futura per la revisione, 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 \
    --zone=ZONE

Sostituisci quanto segue:

  • FUTURE_RESERVATION_NAME: il nome di una bozza esistente di una richiesta di prenotazione futura.

  • ZONE: la zona in cui si trova la richiesta di prenotazione futura.

REST

Per inviare una bozza di richiesta di prenotazione futura per la revisione, invia una richiesta PATCH al metodo beta.futureReservations.update. Nel corpo della richiesta, includi il campo planningStatus e impostalo 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 futura richiesta di prenotazione.

  • ZONE: la zona in cui si trova la richiesta di prenotazione futura.

  • FUTURE_RESERVATION_NAME: il nome di una bozza esistente di una richiesta di prenotazione futura.

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

Risoluzione dei problemi

Se si verificano errori durante la creazione di una richiesta di prenotazione futura, scopri come risolvere i problemi relativi alle richieste di prenotazione futura.

Se i problemi persistono dopo la risoluzione dei problemi, contatta il tuo Technical Account Manager o il team di vendita.

Passaggi successivi