Creare richieste di prenotazione futura 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 prenotazioni condivise tra più progetti. Queste prenotazioni condivise create automaticamente vengono utilizzate abbinando le VM e le prenotazioni esistenti nel progetto che ospita la prenotazione futura (progetto proprietario) e nei progetti con cui la prenotazione futura è condivisa (progetti consumer). Per ulteriori informazioni su come funzionano le prenotazioni condivise automaticamente e come possono essere consumate, consulta Creare prenotazioni condivise.

Prima di iniziare

  • Se non l'hai ancora fatto:
  • Se non l'hai ancora fatto, configura l'autenticazione. Autenticazione è Il processo di verifica dell'identità per l'accesso ai servizi e alle API di Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine come segue.

    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 ulteriori informazioni, vedi Esegui 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 future condivise, chiedi all'amministratore di concederti Ruolo IAM Compute Future Reservation User (roles/compute.futureReservationUser) per il 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 future 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 condivise è soggetta alle seguenti limitazioni:

  • Il progetto che utilizzi per creare richieste di prenotazione futura 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 ulteriori informazioni, vedi Consentire e limitare i progetti per creare e modificare prenotazioni condivise 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 un massimo di 100 consumer in modo programmatico a gestire i progetti.

  • 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 creare una bozza e inviarla in seguito a Google Cloud per la revisione oppure inviarla direttamente la richiesta di 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 la 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 esistente modello di istanza per definire 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 progetti con cui è condivisa la prenotazione futura, devi creare i modelli 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 alla VM di riferimento.

  • Specificare le proprietà direttamente

    Puoi definire direttamente le proprietà di una bozza di prenotazione futura richiesta. Questo metodo richiede di verificare manualmente che le proprietà tra le tue VM e le prenotazioni create automaticamente corrispondono esattamente a qualsiasi se le proprietà non corrispondenti ne impediscono il consumo.

Una prenotazione creata automaticamente per una prenotazione futura può essere consumato 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 zona come 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 disco permanente, limita l'utilizzo del modello alle località in cui si trovano queste risorse. Ad esempio, se il modello di istanza specifica un disco permanente 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 collegare le prenotazioni create automaticamente di cui è stato eseguito il provisioning per un futuro a un impegno, devi disabilitare l'opzione di eliminazione automatica. Per ulteriori informazioni, consulta Limitazioni dopo la creazione.

Dopo aver creato una richiesta di prenotazione futura, non puoi modificare quella futura richiesta di prenotazione per eseguire l'override delle proprietà della VM del modello o specificarne 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 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 Google Cloud.

  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 modificare, annullare o eliminare facoltativamente 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 durata, puoi vedere la durata del periodo di prenotazione. Per aumentare la probabilità che Google Cloud approva la tua richiesta di prenotazione futura dopo averla inviata per la revisione, assicurati di specificare valore consigliato per il periodo di prenotazione.

  9. Nella sezione Tipo di condivisione, procedi nel seguente modo:

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

    2. Fai clic su Aggiungi progetti e poi selezionare i progetti dell'organizzazione del progetto attuale a cui vuoi condividere la richiesta di prenotazione futura. Puoi selezionare al massimo 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 risorse solo all'interno della stessa regione del modello.

  12. Nella sezione Data/ora di eliminazione automatica delle prenotazioni generate automaticamente, segui una di queste 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. Data e ora devono essere dopo l'ora di fine del periodo di prenotazione. Se esci vuoto, le prenotazioni create automaticamente vengono eliminate due ore dopo l'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.

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

Per creare una bozza di richiesta di prenotazione futura specificando un modello di istanza senza includere eventuali flag facoltativi ed elimina automaticamente la prenotazione creata automaticamente periodo di prenotazione, esegui questo 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 del futuro richiesta di prenotazione.

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

  • CONSUMER_PROJECT_IDS: un elenco di ID separati da virgole di progetti per i quali vuoi consentire il consumo delle prenotazioni create automaticamente questa richiesta di prenotazione futura, ad esempio project-1,project-2. Puoi specificare fino a 100 progetti. Questi progetti devono trovarsi nello stesso organizzazione come progetto in cui viene creata la richiesta di prenotazione futura (il progetto proprietario). Non specificare il progetto proprietario. Per impostazione predefinita, ha già l'autorizzazione a utilizzare le prenotazioni create automaticamente per questo futuro richiesta di prenotazione.

  • PROJECT_ID: l'ID del progetto in cui vuoi e prenotare risorse e dove 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'istanza esistente modello.

  • 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 formattato 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 le 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 abilitata. Le prenotazioni create automaticamente vengono eliminate in data 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 un determinato periodo di tempo dopo l'ora di fine del periodo di prenotazione, includi --auto-created-reservations-duration flag.

      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 una prenotazione creata automaticamente. Per aiutarti a identificare le prenotazioni create automaticamente. per questa richiesta di prenotazione futura, Google Cloud consiglia specificare un prefisso 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 e la posizione del 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 allegare i file creati automaticamente a un impegno, quindi 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). Azioni sconsigliate e 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 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'istanza esistente modello.

  • TOTAL_COUNT: il conteggio totale delle 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 Formato di 24 ore, minuti a due cifre e secondi a due cifre, separati da due punti (:).

    • OFFSET: il fuso orario formattato come offset di Tempo coordinato universale (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 di annullare, eliminare o modificare una richiesta di prenotazione futura dopo viene approvata e, prima che entri nell'orario di blocco, specifica 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 duration per specificare una durata specifica dall'ora di inizio dell'evento 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. denominato fr-02 pollici 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 abilitata. Le prenotazioni create automaticamente vengono eliminate in data 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"
  }
}

Facoltativamente, 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 una 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 intervallo di tempo specifico dopo il alla fine del periodo di prenotazione, imposta autoDeleteAutoCreatedReservations a true e includi il 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 quando Compute Engine elimina le prenotazioni create automaticamente. Data e ora devono essere formattati 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 tra secondi. Ad esempio, specifica 604800 per 604.800 secondi (7 giorni).

Dopo aver creato una bozza di richiesta di prenotazione futura, puoi determinare numero di VM di cui 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 eseguire l'override delle 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 che 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 e le proprietà della VM di riferimento corrispondono.

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 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 Google Cloud.

  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 facoltativamente modificare, annullare o eliminare la prenotazione futura prima che entri l'orario di blocco, specifica valore consigliato per l'ora di inizio.

  8. In Ora di fine, inserisci un'ora di fine per il periodo di prenotazione. La 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.

  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, segui questi passaggi:

    1. Seleziona Usa VM esistente.

    2. In VM esistente, seleziona la VM che vuoi utilizzare per le proprietà. per creare la prenotazione.

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

    • 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. Data e ora devono essere dopo l'ora di fine del periodo di prenotazione. Se esci vuoto, le prenotazioni create automaticamente vengono eliminate due ore dopo l'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ò 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.

Specifica direttamente le proprietà della VM

Se vuoi collegare le prenotazioni create automaticamente di cui è stato eseguito il provisioning per un futuro a un impegno, devi disabilitare l'opzione di eliminazione automatica. Per ulteriori informazioni, vedi Restrizioni 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 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 Google Cloud.

  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 modificare, annullare o eliminare facoltativamente 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 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 selezionare i progetti dell'organizzazione del progetto attuale a cui vuoi condividere la richiesta di prenotazione futura. Puoi selezionare al massimo 100 progetti.

  10. In Numero di istanze VM, inserisci il conteggio totale di VM che vuoi prenotare per il periodo, la configurazione delle VM e i progetti specificato 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, segui una di queste 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. Data e ora devono essere dopo l'ora di fine del periodo di prenotazione. Se esci vuoto, le prenotazioni create automaticamente vengono eliminate due ore dopo l'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.

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 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 del futuro richiesta di prenotazione.

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

  • CONSUMER_PROJECT_IDS: un elenco di ID separati da virgole di progetti per i quali vuoi consentire il consumo delle prenotazioni create automaticamente questa richiesta di prenotazione futura, ad esempio project-1,project-2. Puoi specificare fino a 100 progetti. Questi progetti devono trovarsi nello stesso organizzazione come 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 Formato di 24 ore, minuti a due cifre e secondi a due cifre, separati da due punti (:).

    • OFFSET: il fuso orario formattato come offset di Tempo coordinato universale (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 alle ore 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 pochi 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, specifica una durata minima consigliata.

  • TOTAL_COUNT: il conteggio totale delle 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 predefinita N2 con 4 vCPU.
  • L'opzione di eliminazione automatica abilitata. 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

Facoltativamente, puoi eseguire una o più delle seguenti operazioni:

  • Per collegare le GPU alle VM N1 prenotate, 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 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 un determinato periodo di tempo dopo l'ora di fine del periodo di prenotazione, includi --auto-created-reservations-duration flag.

      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 ciascuno 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 durante la creazione di una bozza futura una richiesta di prenotazione, 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 il disco SSD locale deve utilizzare, come segue:

    Assicurati che il tipo di macchina specificato per le VM prenotate supporti le interfacce del disco scelte. In caso contrario, verrà creata la prenotazione futura non va a buon fine. Per ulteriori informazioni, scopri come scegli 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 una prenotazione creata automaticamente. Per aiutarti a identificare le prenotazioni create automaticamente. per questa richiesta di prenotazione futura, Google Cloud consiglia specificare un prefisso univoco.

REST

Per creare un condiviso richiesta di prenotazione futura specificando direttamente le proprietà, invia una richiesta POST a Metodo beta.futureReservations.insert.

Per creare una bozza di richiesta di prenotazione futura specificando direttamente le proprietà senza includere eventuali campi facoltativi, effettua una richiesta POST in questo modo:

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 allegare i file creati automaticamente a un impegno, quindi 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 trovarsi nella stessa organizzazione del progetto in cui viene creata la richiesta di prenotazione futura (il progetto del proprietario). Azioni sconsigliate e specificare il progetto proprietario. Per impostazione predefinita, è già autorizzato a utilizzare prenotazioni create automaticamente per questa richiesta di prenotazione futura.

  • TOTAL_COUNT: il conteggio totale delle 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 Formato di 24 ore, minuti a due cifre e secondi a due cifre, separati da due punti (:).

    • OFFSET: il fuso orario formattato come offset di Tempo coordinato universale (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 duration per specificare una durata specifica dall'ora di inizio dell'evento 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. denominato fr-02 pollici 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 predefinita N2 con 4 vCPU.
  • L'opzione di eliminazione automatica abilitata. 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"
  }
}

Facoltativamente, 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 i dischi SSD. Ogni disco SSD locale ha una dimensione di 375 GB.

    Ad esempio, per specificare due dischi SSD locali durante la creazione di una bozza futura richiesta di prenotazione, effettua una richiesta POST nel seguente modo:

    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 prenotate supporti interfacce del disco scelte. In caso contrario, la creazione della richiesta di prenotazione futura non va a buon fine. Per ulteriori informazioni, consulta la sezione su 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. A assicurati che sia disponibile una piattaforma CPU nella zona in cui stai prenotando di cloud computing, 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 intervallo di tempo specifico dopo il alla fine del periodo di prenotazione, imposta autoDeleteAutoCreatedReservations a true e includi il 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 quando Compute Engine elimina le prenotazioni create automaticamente. Data e ora devono essere formattati 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 tra secondi. Ad esempio, specifica 604800 per 604.800 secondi (7 giorni).

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

Invia una bozza di richiesta

Dopo l'invio di una richiesta di prenotazione futura, approvata da Google Cloud, oltre l'orario di blocco, puoi eliminare la prenotazione futura e i relativi le prenotazioni create automaticamente solo al termine del periodo periodo di prenotazione. Eliminare 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:

  • Le prenotazioni esistenti o future in un progetto limitano il le impostazioni di condivisione che potrai creare per le richieste di prenotazione future. 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 per le risorse prenotate Compute Engine esegue il provisioning per l'intero periodo di prenotazione, a prescindere dal fatto che le prenotazioni create automaticamente vengano utilizzate o meno. Per maggiori informazioni le informazioni, vedi 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 di 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 un elemento esistente bozza di richiesta di prenotazione futura.

  • ZONE: la zona in cui verrà inviata la richiesta di prenotazione futura in cui viene localizzato.

REST

Per inviare una bozza di richiesta di prenotazione futura per la revisione, crea una PATCH richiesta alla 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 verrà richiesta di prenotazione individuata.

  • ZONE: la zona in cui verrà inviata la richiesta di prenotazione futura in cui viene localizzato.

  • 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 eseguire seguenti:

Risoluzione dei problemi

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

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

Passaggi successivi