Modificare, annullare o eliminare richieste di prenotazione future

Questo documento spiega come gestire le richieste di prenotazione future. In particolare:

  • Modificare una bozza o una richiesta di prenotazione futura inviata per cambiare una o più delle sue proprietà.

  • Annulla una richiesta di prenotazione futura per interrompere la revisione da parte di Google Cloud o interrompere l'inserimento dell'orario di blocco per una prenotazione futura approvata.

  • Elimina una prenotazione futura prima che venga inserita l'ora di blocco richiesta o dopo la fine del periodo di prenotazione.

Se vuoi gestire le prenotazioni create automaticamente per una prenotazione futura completata dopo il termine del relativo periodo di prenotazione, consulta quanto segue:

Prima di iniziare

  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale viene verificata l'identità per l'accesso ai servizi e alle API Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti in Compute Engine nel seguente modo.

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Installa Google Cloud CLI, quindi initialize eseguendo questo comando: 

      gcloud init
    2. Set a default region and zone.

      3. REST

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

        Installa Google Cloud CLI, quindi initialize eseguendo questo comando: 

        gcloud init

      Per maggiori informazioni, consulta Autenticazione per REST nella documentazione sull'autenticazione di Google Cloud.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per modificare, annullare o eliminare le richieste di prenotazione future, chiedi all'amministratore di concederti il ruolo IAM Amministratore prenotazioni future Compute (roles/compute.futureReservationAdmin) sul progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Questo ruolo predefinito contiene le autorizzazioni necessarie per modificare, annullare o eliminare le richieste di prenotazione future. Per visualizzare le autorizzazioni esatte necessarie, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per modificare, annullare o eliminare le future richieste di prenotazione sono necessarie le seguenti autorizzazioni:

  • Per annullare una prenotazione futura: compute.futureReservations.cancel sul progetto
  • Per eliminare una prenotazione futura: compute.futureReservations.delete sul progetto
  • Per modificare una prenotazione futura: compute.futureReservations.update sul progetto

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

Limitazioni

Oltre alle limitazioni generali per le prenotazioni future, quando modifichi, annulli o elimini una richiesta di prenotazione futura, si applicano le seguenti limitazioni:

  • Puoi modificare, annullare o eliminare una richiesta di prenotazione futura solo all'interno del progetto in cui è stata creata la richiesta di prenotazione futura. In questo modo puoi condividere una richiesta di prenotazione futura con altri progetti, ma gli utenti con autorizzazioni solo per altri progetti non possono modificare quella richiesta di prenotazione futura.

  • Puoi modificare, annullare o eliminare una richiesta di prenotazione futura solo se il relativo stato di approvvigionamento lo consente. Per maggiori dettagli, consulta la tabella seguente:

    Stato approvvigionamento Annulla Elimina Modifica
    Bozza (DRAFTING)
    In attesa di approvazione (PENDING_APPROVAL)
    Approvate (APPROVED)
    Rifiutate (DECLINED)
    Annullati (CANCELED)
    Approvvigionamento (PROCURING)
    Provisioning in corso (PROVISIONING)
    Completato (FULFILLED) *
    Completata parzialmente (FAILED_PARTIALLY_FULFILLED) *
    Non riuscite (FAILED) *

    * Puoi eliminare una prenotazione futura completata, parzialmente evasa o non riuscita solo dopo la relativa ora di fine.

Modifica le richieste di prenotazione future

Puoi modificare una richiesta di prenotazione futura prima che raggiunga uno stato di approvvigionamento di Provisioning (PROVISIONING) a condizione che non sia stata annullata o in attesa di approvazione. Quando modifichi una richiesta di prenotazione futura, non puoi modificare le seguenti proprietà:

  • Per qualsiasi prenotazione futura:

    • Il nome della prenotazione futura.

    • Il progetto in cui è stata creata la richiesta di prenotazione futura.

    • La zona in cui si trova la prenotazione futura.

  • Per le richieste di prenotazione future create specificando un modello di istanza:

    • Non puoi eseguire l'override delle proprietà della VM specificate nel modello di istanza.

    • Non puoi sostituire il modello di istanza utilizzato per creare una richiesta di prenotazione futura con un altro modello.

Per modificare una di queste proprietà, devi creare una nuova richiesta di prenotazione futura con gli aggiornamenti desiderati.

Se vuoi modificare altre proprietà, seleziona uno dei seguenti metodi:

  • Modificare una bozza o una richiesta di prenotazione futura rifiutata.

    Questa sezione spiega come modificare una richiesta di prenotazione futura con lo stato approvvigionamento impostato su Bozza (DRAFTING) o Rifiutato (DECLINED).

  • Modificare una prenotazione futura approvata o approvvigionamento.

    Questa sezione spiega come modificare una prenotazione futura con uno stato di approvvigionamento impostato su Approvato (APPROVED) o Approvvigionamento (PROCURING). Se vuoi modificare l'opzione di eliminazione automatica, la descrizione o il prefisso del nome di una prenotazione futura, puoi modificarli senza revisione. In caso contrario, se vuoi modificare altre proprietà, devi avere l'approvazione di Google Cloud.

Modificare una bozza o una richiesta di prenotazione futura rifiutata

Se modifichi una bozza di richiesta di prenotazione futura, puoi salvare le modifiche o inviare la richiesta di prenotazione futura aggiornata a Google Cloud per la revisione. Se modifichi invece una richiesta di prenotazione futura rifiutata, devi inviarla per la revisione.

Per modificare le proprietà di una richiesta di prenotazione futura in modalità bozza o rifiutata, seleziona uno dei seguenti metodi:

Modifica una bozza o una prenotazione futura rifiutata specificando un modello di istanza

Per una richiesta di prenotazione futura creata specificando un modello di istanza con stato di approvvigionamento con stato Bozza (DRAFTING) o Rifiutato (DECLINED), puoi modificare le seguenti proprietà:

  • Eliminazione automatica

  • Descrizione

  • Prefisso nome

  • Impostazioni di condivisione

  • Ora di inizio e di fine del periodo di prenotazione

  • Conteggio totale (numero di VM)

Puoi modificare una bozza di richiesta di prenotazione futura creata specificando un modello di istanza tramite la console Google Cloud, gcloud CLI e REST.

Console

Per richiedere a Google Cloud di modificare una bozza o una richiesta di prenotazione futura rifiutata creata specificando un modello di istanza, segui questi passaggi:

  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 che vuoi modificare.

    Si apre la pagina dei dettagli della richiesta di prenotazione futura selezionata.

  4. Per modificare la richiesta di prenotazione futura, fai clic su Modifica o Modifica bozza.

    Si apre la pagina per modificare la richiesta di prenotazione futura selezionata.

  5. Esegui una o più delle seguenti operazioni:

    • Nel campo Prefisso, inserisci un nuovo prefisso per il nome.

    • Nel campo Descrizione, inserisci una nuova descrizione.

    • Modifica l'Ora di inizio o l'Ora di fine per la richiesta di prenotazione futura. Verifica quanto segue:

      • L'ora di inizio non può essere successiva a un anno dalla data e dall'ora in cui invii per la revisione una richiesta di prenotazione futura.

      • Specifica un valore consigliato per l'ora di inizio per assicurarti di avere tempo sufficiente prima che la prenotazione futura entri nell'orario di blocco.

      • Specifica un periodo minimo di prenotazione consigliato per aumentare la probabilità che Google Cloud approvi la tua richiesta dopo averla inviata per la revisione.

    • Nella sezione Tipo di condivisione, puoi selezionare Locale o Condivisa. Se selezioni Condivisa, puoi aggiungere o rimuovere progetti con cui condividere la richiesta di prenotazione futura.

      Puoi selezionare fino a 100 progetti. Questi progetti devono trovarsi nella stessa organizzazione del progetto in cui è stata creata la richiesta di prenotazione futura (progetto proprietario). Non specificare il progetto del proprietario. Per impostazione predefinita, è già consentito utilizzare le prenotazioni condivise create automaticamente per questa richiesta di prenotazione futura.

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

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

    • Nella sezione Eliminazione automatica delle prenotazioni generate automaticamente, puoi abilitare o disabilitare l'eliminazione automatica delle prenotazioni create automaticamente per la richiesta di prenotazione futura.

      Facoltativo. Se abiliti l'opzione di eliminazione automatica, puoi specificare la data e l'ora in cui Compute Engine elimina 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.

  6. A seconda dello stato di approvvigionamento della richiesta di prenotazione futura che stai modificando, esegui una delle seguenti operazioni:

    • Per una bozza di richiesta di prenotazione futura, seleziona una delle seguenti opzioni:

      • Per salvare le modifiche, fai clic su Salva bozza.

      • Per inviare la bozza della richiesta di prenotazione futura a Google Cloud per la revisione, fai clic su Invia.

    • Per una richiesta di prenotazione futura rifiutata, puoi inviarla per la revisione solo facendo clic su Invia.

      Se invii una richiesta, si apre la pagina Prenotazioni. In caso contrario, si apre la pagina dei dettagli della richiesta di prenotazione futura.

gcloud

Per richiedere a Google Cloud di modificare una bozza o una richiesta di prenotazione futura rifiutata creata specificando un modello di istanza, utilizza il comando gcloud beta compute future-reservations update.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --description="DESCRIPTION" \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --share-setting=SHARE_SETTING \
    --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 di una bozza esistente o di una richiesta di prenotazione futura rifiutata.
  • DESCRIPTION: facoltativo. Una nuova descrizione per la richiesta di prenotazione futura.
  • NAME_PREFIX: facoltativo. Un nuovo prefisso nome per la richiesta di prenotazione futura. Il nome di ogni prenotazione creata automaticamente per questa richiesta di prenotazione futura inizia con il prefisso del nome. Per aiutarti a identificare le prenotazioni create automaticamente per questa richiesta di prenotazione futura, ti consigliamo di specificare un prefisso nome univoco.

  • PLANNING_STATUS: lo stato di pianificazione della richiesta di prenotazione futura. Puoi specificare solo SUBMITTED, che invia la richiesta di prenotazione futura a Google Cloud per la revisione.

  • PROJECT_ID: facoltativo. L'ID del progetto in cui è stata creata la richiesta di prenotazione futura. Se modifichi una richiesta di prenotazione futura per un singolo progetto in una richiesta di prenotazione futura condivisa, questo progetto diventa il progetto proprietario della richiesta di prenotazione futura. Se ometti il flag --project, il valore viene impostato sull'ID del progetto attuale.

  • SHARE_SETTING: facoltativo. Per modificare il tipo di questa richiesta di prenotazione futura, specifica uno dei seguenti valori:

    • Per modificare una richiesta di prenotazione futura per un singolo progetto in una richiesta di prenotazione futura condivisa, specifica projects. Assicurati di specificare almeno un progetto consumer utilizzando il flag --share-with. In caso contrario, la modifica della prenotazione futura non andrà a buon fine.

    • In caso contrario, specifica local.

  • CONSUMER_PROJECT_IDS: facoltativo. Un elenco separato da virgole di ID progetto di progetti con cui è possibile condividere questa richiesta di prenotazione futura. Ad esempio, specifica project-1,project-2. Puoi specificare fino a 100 progetti. Questi progetti devono trovarsi nella stessa organizzazione del progetto in cui è stata creata questa richiesta di prenotazione futura (progetto proprietario). Non specificare il progetto del proprietario. Per impostazione predefinita, è già consentito utilizzare le prenotazioni condivise create automaticamente per questa richiesta di prenotazione futura.

  • START_TIME: facoltativo. La nuova ora di inizio del periodo di prenotazione formattata come timestamp RFC 3339, che deve essere il seguente:

    YYYY-MM-DDTHH:MM:SSOFFSET

    Sostituisci quanto segue:

    • YYYY-MM-DD: dati formattati come anno a quattro cifre, mese a due cifre e giorno del mese a due cifre, separati da trattini (-).

    • HH:MM:SS: un'ora formattata come ora a due cifre con formato a 24 ore, minuti a due cifre e secondi a due cifre, separati dai due punti (:).

    • OFFSET: il fuso orario formattato come offset del Tempo coordinato universale (UTC). Ad esempio, per utilizzare il fuso orario PST (Pacific Standard Time), specifica -08:00. In alternativa, per non usare alcun offset, specifica Z.

    L'ora di inizio non può essere successiva a un anno dalla data e dall'ora in cui invii una richiesta di prenotazione futura per la revisione. Per avere tempo sufficiente per annullare, eliminare o modificare una prenotazione futura dopo l'approvazione o prima dell'inserimento dell'ora di blocco, assicurati di specificare un'ora di inizio consigliata.

  • END_TIME: facoltativo. La nuova ora di fine del periodo di prenotazione formattata come timestamp RFC 3339. Il periodo di prenotazione deve durare almeno 24 ore. In alternativa, puoi sostituire il flag --end-time con il flag --duration=END_DURATION, dove END_DURATION è la durata del periodo di prenotazione in secondi. Ad esempio, specifica 1209600 per 1.209.600 secondi (14 giorni).

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

  • TOTAL_COUNT: facoltativo. Il nuovo numero totale di VM che vuoi prenotare per il periodo, la configurazione della VM e i progetti specificati in questa richiesta di prenotazione futura.

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

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

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

Facoltativamente, puoi anche modificare se e quando Compute Engine elimina automaticamente le prenotazioni create automaticamente per una richiesta di prenotazione futura, in uno dei seguenti modi:

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

    • Per eliminare le prenotazioni entro due ore dall'ora di fine (impostazione predefinita), specifica il flag --auto-delete-auto-created-reservations.

      gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations

    • Per eliminare le prenotazioni create automaticamente in un orario specifico dopo l'ora di fine del periodo di prenotazione, specifica i flag --auto-delete-auto-created-reservations e --auto-created-reservations-delete-time.

      gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME

      Sostituisci AUTO_CREATED_RESERVATIONS_DELETE_TIME con una data e un'ora formattate come timestamp RFC 3339.

    • Per eliminare le prenotazioni create automaticamente dopo una durata specifica dopo l'ora di fine del periodo di prenotazione, specifica i flag --auto-delete-auto-created-reservations e --auto-created-reservations-duration.

      gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE

      Sostituisci DURATION_BEFORE_DELETE con una durata espressa in giorni, ore, minuti o secondi. Ad esempio, specifica 30m per 30 minuti o 1d2h3m4s per 1 giorno, 2 ore, 3 minuti e 4 secondi.

  • Per impedire a Compute Engine di eliminare automaticamente le prenotazioni create automaticamente, specifica il flag --no-auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations update example-future-reservation \
    --no-auto-delete-auto-created-reservations

Ad esempio, considera una bozza di richiesta di prenotazione futura condivisa denominata fr-03 e situata nella zona us-central1-a. Supponiamo di voler modificare questa richiesta di prenotazione futura condivisa apportando le seguenti modifiche:

  • Convertilo in una richiesta di prenotazione futura per un singolo progetto.

  • Disattiva l'opzione di eliminazione automatica.

  • Prenota 100 VM.

  • Invia la richiesta di prenotazione futura a Google Cloud per l'approvazione.

Per modificare fr-03, esegui questo comando:

gcloud beta compute future-reservations update fr-03 \
    --clear-share-settings \
    --no-auto-delete-auto-created-reservations \
    --planning-status=SUBMITTED \
    --project=example-project \
    --total-count=100 \
    --zone=us-central1-a

REST

Per richiedere a Google Cloud di modificare una bozza o una richiesta di prenotazione futura rifiutata creata specificando un modello di istanza, effettua una richiesta PATCH utilizzando il metodo beta.futureReservations.update. Nel parametro di query updateMask, specifica tutti i campi da aggiornare. Se devi eliminare un campo facoltativo dalla prenotazione, includilo nel parametro di query updateMask e omettilo dal corpo della richiesta.

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

{
  "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
  "description": "DESCRIPTION",
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "planningStatus": "PLANNING_STATUS",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SHARE_TYPE"
  },
  "specificSkuProperties": {
    "totalCount": "TOTAL_COUNT"
  },
  "timeWindow": {
    "endTime": "END_TIME",
    "startTime": "START_TIME"
  }
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui si trova la richiesta di prenotazione futura.

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

  • FUTURE_RESERVATION_NAME: il nome di una bozza esistente o di una richiesta di prenotazione futura rifiutata. Non puoi modificare il nome di una richiesta di prenotazione futura.

  • UPDATE_FIELDS: un elenco separato da virgole di campi da aggiornare in questa richiesta PATCH. Devi codificare ogni virgola come %2C. Ad esempio, se vuoi aggiornare i campi autoDeleteAutoCreatedReservations, totalCount e endTime nella richiesta di prenotazione futura, specifica quanto segue:

    autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime

  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: facoltativo. Se imposti questo campo su true, Compute Engine elimina automaticamente le prenotazioni create automaticamente per questa richiesta di prenotazione futura. Per impostazione predefinita, l'ora di eliminazione rientra entro 2 ore dall'ora di fine del periodo di prenotazione. Per modificare questa impostazione, esegui una delle seguenti operazioni:

    • Per eliminare le prenotazioni create automaticamente in un'ora specifica dopo l'ora di fine del periodo di prenotazione, imposta autoDeleteAutoCreatedReservations su true e specifica il campo autoCreatedReservationsDeleteTime.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDeleteTime": "DELETE_TIME"
}

      Sostituisci DELETE_TIME con una data e un'ora in cui Compute Engine elimina le prenotazioni. La data e l'ora devono essere formattate come timestamp RFC 3339, che deve essere il seguente:

      YYYY-MM-DDTHH:MM:SSOFFSET

      Sostituisci quanto segue:

      • YYYY-MM-DD: dati formattati come anno a quattro cifre, mese a due cifre e giorno del mese a due cifre, separati da trattini (-).

      • HH:MM:SS: un'ora formattata come ora a due cifre con formato di 24 ore, minuti a due cifre e secondi a due cifre, separati dai due punti (:).

      • OFFSET: il fuso orario formattato come offset del Tempo coordinato universale (UTC). Ad esempio, per utilizzare il fuso orario PST (Pacific Standard Time), specifica -08:00. In alternativa, per non usare alcun offset, specifica Z.

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

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  }
}

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

  • DESCRIPTION: facoltativo. Per aggiornare la descrizione di questa richiesta di prenotazione futura, esegui una delle seguenti operazioni:

    • Per aggiungere o aggiornare una descrizione, specificane una.

    • Per rimuovere la descrizione, elimina il campo description dal corpo della richiesta e specificalo in UPDATE_FIELDS.

  • NAME_PREFIX: facoltativo. Un nuovo prefisso nome per la richiesta di prenotazione futura. Il nome di ogni prenotazione creata automaticamente per questa richiesta di prenotazione futura inizia con il prefisso del nome. Per aiutarti a identificare le prenotazioni create automaticamente per questa prenotazione futura, è consigliabile specificare un prefisso nome univoco.

  • PLANNING_STATUS: lo stato di pianificazione della richiesta di prenotazione futura. Puoi specificare solo SUBMITTED, che invia la richiesta di prenotazione futura a Google Cloud per la revisione.

  • SHARE_TYPE: facoltativo. Per modificare il tipo di condivisione di questa richiesta di prenotazione futura, specifica uno dei seguenti valori:

    • Per modificare una richiesta di prenotazione futura per un singolo progetto in una richiesta di prenotazione futura condivisa, specifica SPECIFIC_PROJECTS. Inoltre, devi specificare almeno un progetto consumer nel campo projects. In caso contrario, la modifica della richiesta di prenotazione futura non andrà a buon fine.

    • In caso contrario, specifica LOCAL. Inoltre, devi eliminare il campo projects dal corpo della richiesta e specificarlo in UPDATE_FIELDS. In caso contrario, la modifica della richiesta di prenotazione futura non andrà a buon fine.

  • CONSUMER_PROJECT_ID_1 e CONSUMER_PROJECT_ID_2: facoltativi. Gli ID progetto dei progetti con cui è possibile condividere una richiesta di prenotazione futura condivisa. Puoi specificare fino a 100 progetti. Questi progetti devono trovarsi nella stessa organizzazione del progetto in cui è stata creata la richiesta di prenotazione futura (progetto proprietario). Non specificare il progetto del proprietario. Per impostazione predefinita, è già consentito utilizzare le prenotazioni condivise create automaticamente per questa richiesta di prenotazione futura.

  • TOTAL_COUNT: facoltativo. Il nuovo numero totale di VM che vuoi prenotare per il periodo, la configurazione della VM e i progetti specificati in questa richiesta di prenotazione futura.

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

  • START_TIME: facoltativo. La nuova ora di inizio del periodo di prenotazione formattata come timestamp RFC 3339. L'ora di inizio non può essere successiva a un anno dalla data e dall'ora in cui invii una richiesta di prenotazione futura per la revisione. Inoltre, assicurati di specificare un'ora di inizio consigliata per assicurarti di avere tempo sufficiente prima che una prenotazione futura venga inserita nel relativo orario di blocco.

  • END_TIME: facoltativo. La nuova ora di fine del periodo di prenotazione formattata come timestamp RFC 3339. Il periodo di prenotazione deve durare almeno 24 ore. In alternativa, puoi sostituire il campo endTime con il campo duration per specificare una durata specifica dall'ora di inizio del periodo di prenotazione:

    "duration": {
  "seconds": "END_DURATION"
}

    Sostituisci END_DURATION con una durata in secondi. Ad esempio, specifica 1209600 per 1.209.600 secondi (14 giorni).

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

Ad esempio, considera una bozza di richiesta di prenotazione futura condivisa denominata fr-03 e situata nella zona us-central1-a. Supponiamo di voler modificare questa richiesta di prenotazione futura condivisa apportando le seguenti modifiche:

  • Convertilo in una richiesta di prenotazione futura per un singolo progetto.

  • Disattiva l'opzione di eliminazione automatica.

  • Prenota 100 VM.

  • Invia la richiesta di prenotazione futura a Google Cloud per l'approvazione.

Per modificare fr-03, effettua la seguente richiesta di PATCH:

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-03?updateMask=autoDeleteAutoCreatedReservations%2CplanningStatus%2CshareSettings.shareType%2CspecificSkuProperties.totalCount

{
  "autoDeleteAutoCreatedReservations": "false",
  "name": "fr-03",
  "planningStatus": "SUBMITTED",
  "shareSettings": {
    "shareType": "LOCAL"
  },
  "specificSkuProperties": {
    "totalCount": "100"
  }
}

Dopo aver inviato una richiesta di prenotazione futura a Google Cloud per la revisione, visualizza i dettagli per monitorarne lo stato di approvvigionamento.

Modificare una bozza o una prenotazione futura rifiutata specificando direttamente le proprietà

Per una richiesta di prenotazione futura creata direttamente dalle proprietà con lo stato di approvvigionamento impostato su Bozza (DRAFTING) o Rifiutato (DECLINED), puoi modificare le seguenti proprietà:

  • Eliminazione automatica

  • Descrizione

  • Prefisso nome

  • GPU

  • SSD locali e tipo di interfaccia del disco

  • Serie di macchine e tipo di macchina

  • Piattaforma CPU minima

  • Impostazioni di condivisione

  • Ora di inizio e di fine del periodo di prenotazione

  • Conteggio totale (numero di VM)

Puoi modificare una richiesta di prenotazione futura in modalità bozza o rifiutata specificando le proprietà direttamente tramite la console Google Cloud, gcloud CLI e REST.

Console

Per richiedere a Google Cloud di modificare una bozza o una richiesta di prenotazione futura rifiutata creata specificando direttamente le proprietà, segui questi passaggi:

  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 che vuoi modificare.

    Si apre la pagina dei dettagli della richiesta di prenotazione futura selezionata.

  4. Per modificare la richiesta di prenotazione futura, fai clic su Modifica o Modifica bozza.

    Si apre la pagina per modificare la richiesta di prenotazione futura selezionata.

  5. Esegui una o più delle seguenti operazioni:

    • Nel campo Prefisso, inserisci un nuovo prefisso per il nome.

    • Nel campo Descrizione, inserisci una nuova descrizione.

    • Modifica l'Ora di inizio o l'Ora di fine per la richiesta di prenotazione futura. Verifica quanto segue:

      • L'ora di inizio non può essere successiva a un anno dalla data e dall'ora in cui invii per la revisione una richiesta di prenotazione futura.

      • Specifica un valore consigliato per l'ora di inizio per assicurarti di avere tempo sufficiente prima che la prenotazione futura entri nell'orario di blocco.

      • Specifica un periodo minimo di prenotazione consigliato per aumentare la probabilità che Google Cloud approvi la tua richiesta dopo averla inviata per la revisione.

    • Nella sezione Tipo di condivisione, puoi selezionare Locale o Condivisa. Se selezioni Condivisa, puoi aggiungere o rimuovere progetti con cui condividere la richiesta di prenotazione futura.

      Puoi selezionare fino a 100 progetti. Questi progetti devono trovarsi nella stessa organizzazione del progetto in cui è stata creata la richiesta di prenotazione futura (progetto proprietario). Non specificare il progetto del proprietario. Per impostazione predefinita, è già consentito utilizzare le prenotazioni condivise create automaticamente per questa richiesta di prenotazione futura.

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

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

    • Nella sezione Configurazione macchina, puoi modificare quanto segue:

      • La serie e il tipo di macchina utilizzati nelle VM prenotate.

      • Le GPU da collegare alle VM prenotate.

      • Gli SSD locali e il tipo di interfaccia del disco delle VM prenotate.

  6. A seconda dello stato di approvvigionamento della richiesta di prenotazione futura che stai modificando, esegui una delle seguenti operazioni:

    • Per una bozza di richiesta di prenotazione futura, seleziona una delle seguenti opzioni:

      • Per salvare le modifiche, fai clic su Salva bozza.

      • Per inviare la bozza della richiesta di prenotazione futura a Google Cloud per la revisione, fai clic su Invia.

    • Per una richiesta di prenotazione futura rifiutata, puoi inviarla per la revisione solo facendo clic su Invia.

      Se invii una richiesta, si apre la pagina Prenotazioni. In caso contrario, si apre la pagina dei dettagli della richiesta di prenotazione futura.

gcloud

Per richiedere a Google Cloud di modificare una bozza o una richiesta di prenotazione futura rifiutata creata specificando direttamente le proprietà, utilizza il comando gcloud beta compute future-reservations update.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
    --description="DESCRIPTION" \
    --local-ssd=size=375,interface=INTERFACE_1 \
    --local-ssd=size=375,interface=INTERFACE_2 \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform=MIN_CPU_PLATFORM \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --share-setting=SHARE_SETTING \
    --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 di una bozza esistente o di una richiesta di prenotazione futura rifiutata.

  • Facoltativo. Esegui una di queste operazioni:

    • Per aggiungere GPU (Graphics Processing Unit) a ogni VM prenotata, specifica quanto segue:

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

      • ACCELERATOR_TYPE: il tipo di GPU da aggiungere alle VM prenotate.

      Assicurati che il tipo di macchina specificato nella richiesta di prenotazione futura supporti i tipi di GPU specificati e che la GPU sia disponibile nella zona in cui vuoi prenotare le risorse. In caso contrario, si verificheranno errori.

    • Per rimuovere tutte le GPU da questa richiesta di prenotazione futura, sostituisci il flag --accelerator con il flag --clear-accelerator.

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

  • Facoltativo. Esegui una di queste operazioni:

    • Per aggiungere o modificare il tipo di interfaccia da utilizzare per gli SSD locali di ogni VM, sostituisci INTERFACE_1 e INTERFACE_2. Il valore deve essere uno dei seguenti:

      Ogni SSD locale ha una dimensione di 375 GB. Ripeti il flag --local-ssd per ogni SSD locale che vuoi aggiungere. Puoi specificare un massimo di 24 SSD locali.

    • Per rimuovere tutti gli SSD locali da questa prenotazione di richiesta futura, rimuovi tutti i flag --local-ssd e specifica il flag --clear-local-ssd.

  • MACHINE_TYPE: facoltativo. Un tipo di macchina predefinita o personalizzata da utilizzare per ogni VM. Prima di specificare un tipo di macchina personalizzata, esamina le limitazioni per le VM con tipi di macchine personalizzate.

  • MINIMUM_CPU_PLATFORM: facoltativo. La piattaforma CPU minima da utilizzare per ogni VM. Se ometti il flag --min-cpu-platform, il suo valore viene impostato sulla piattaforma CPU predefinita della zona.

  • NAME_PREFIX: facoltativo. Un nuovo prefisso nome per la richiesta di prenotazione futura. Il nome di ogni prenotazione creata automaticamente per questa richiesta di prenotazione futura inizia con il prefisso del nome. Per aiutarti a identificare le prenotazioni create automaticamente per questa richiesta di prenotazione futura, ti consigliamo di specificare un prefisso nome univoco.

  • PLANNING_STATUS: lo stato di pianificazione della richiesta di prenotazione futura. Puoi specificare solo SUBMITTED, che invia la richiesta di prenotazione futura a Google Cloud per la revisione.

  • PROJECT_ID: facoltativo. L'ID del progetto in cui è stata creata la richiesta di prenotazione futura. Se modifichi una richiesta di prenotazione futura per un singolo progetto in una richiesta di prenotazione futura condivisa, questo progetto diventa il progetto proprietario della richiesta di prenotazione futura. Se ometti il flag --project, il valore viene impostato sull'ID del progetto attuale.

  • SHARE_SETTING: facoltativo. Per modificare il tipo di questa richiesta di prenotazione futura, specifica uno dei seguenti valori:

    • Per modificare una richiesta di prenotazione futura per un singolo progetto in una richiesta di prenotazione futura condivisa, specifica projects. Assicurati di specificare almeno un progetto consumer utilizzando il flag --share-with. In caso contrario, la modifica della prenotazione futura non andrà a buon fine.

    • In caso contrario, specifica local.

  • CONSUMER_PROJECT_IDS: facoltativo. Un elenco separato da virgole di ID progetto di progetti con cui è possibile condividere questa richiesta di prenotazione futura. Ad esempio, specifica project-1,project-2. Puoi specificare fino a 100 progetti. Questi progetti devono trovarsi nella stessa organizzazione del progetto in cui è stata creata questa richiesta di prenotazione futura (progetto proprietario). Non specificare il progetto del proprietario. Per impostazione predefinita, è già consentito utilizzare le prenotazioni condivise create automaticamente per questa richiesta di prenotazione futura.

  • START_TIME: facoltativo. La nuova ora di inizio del periodo di prenotazione formattata come timestamp RFC 3339, che deve essere il seguente:

    YYYY-MM-DDTHH:MM:SSOFFSET

    Sostituisci quanto segue:

    • YYYY-MM-DD: dati formattati come anno a quattro cifre, mese a due cifre e giorno del mese a due cifre, separati da trattini (-).

    • HH:MM:SS: un'ora formattata come ora a due cifre con formato a 24 ore, minuti a due cifre e secondi a due cifre, separati dai due punti (:).

    • OFFSET: il fuso orario formattato come offset del Tempo coordinato universale (UTC). Ad esempio, per utilizzare il fuso orario PST (Pacific Standard Time), specifica -08:00. In alternativa, per non usare alcun offset, specifica Z.

    L'ora di inizio non può essere successiva a un anno dalla data e dall'ora in cui invii una richiesta di prenotazione futura per la revisione. Per avere tempo sufficiente per annullare, eliminare o modificare una prenotazione futura dopo l'approvazione o prima dell'inserimento dell'ora di blocco, assicurati di specificare un'ora di inizio consigliata.

  • END_TIME: facoltativo. La nuova ora di fine del periodo di prenotazione formattata come timestamp RFC 3339. Il periodo di prenotazione deve durare almeno 24 ore. In alternativa, puoi sostituire il flag --end-time con il flag --duration=END_DURATION, dove END_DURATION è la durata del periodo di prenotazione in secondi. Ad esempio, specifica 1209600 per 1.209.600 secondi (14 giorni).

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

  • TOTAL_COUNT: facoltativo. Il nuovo numero totale di VM che vuoi prenotare per il periodo, la configurazione della VM e i progetti specificati in questa richiesta di prenotazione futura.

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

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

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

Facoltativamente, puoi anche modificare se e quando Compute Engine elimina automaticamente le prenotazioni create automaticamente per una richiesta di prenotazione futura, in uno dei seguenti modi:

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

    • Per eliminare le prenotazioni entro due ore dall'ora di fine (impostazione predefinita), specifica il flag --auto-delete-auto-created-reservations.

      gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations

    • Per eliminare le prenotazioni create automaticamente in un orario specifico dopo l'ora di fine del periodo di prenotazione, specifica i flag --auto-delete-auto-created-reservations e --auto-created-reservations-delete-time.

      gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME

      Sostituisci AUTO_CREATED_RESERVATIONS_DELETE_TIME con una data e un'ora formattate come timestamp RFC 3339.

    • Per eliminare le prenotazioni create automaticamente dopo una durata specifica dopo l'ora di fine del periodo di prenotazione, specifica i flag --auto-delete-auto-created-reservations e --auto-created-reservations-duration.

      gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE

      Sostituisci DURATION_BEFORE_DELETE con una durata espressa in giorni, ore, minuti o secondi. Ad esempio, specifica 30m per 30 minuti o 1d2h3m4s per 1 giorno, 2 ore, 3 minuti e 4 secondi.

  • Per impedire a Compute Engine di eliminare automaticamente le prenotazioni create automaticamente, specifica il flag --no-auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations update example-future-reservation \
    --no-auto-delete-auto-created-reservations

Ad esempio, considera una bozza di richiesta di prenotazione futura condivisa denominata fr-03 e situata nella zona us-central1-a. Supponiamo di voler modificare questa richiesta di prenotazione futura condivisa apportando le seguenti modifiche:

  • Convertilo in una richiesta di prenotazione futura per un singolo progetto.

  • Disattiva l'opzione di eliminazione automatica.

  • Prenota 100 VM.

  • Invia la richiesta di prenotazione futura a Google Cloud per l'approvazione.

Per modificare fr-03, esegui questo comando:

gcloud beta compute future-reservations update fr-03 \
    --clear-share-settings \
    --no-auto-delete-auto-created-reservations \
    --planning-status=SUBMITTED \
    --project=example-project \
    --total-count=100 \
    --zone=us-central1-a

REST

Per richiedere a Google Cloud di modificare una bozza o una richiesta di prenotazione futura rifiutata creata specificando direttamente le proprietà, effettua una richiesta PATCH utilizzando il metodo beta.futureReservations.update. Nel parametro di query updateMask, specifica tutti i campi da aggiornare. Se devi eliminare un campo facoltativo dalla prenotazione, includilo nel parametro di query updateMask e omettilo dal corpo della richiesta.

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

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui si trova la richiesta di prenotazione futura.

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

  • FUTURE_RESERVATION_NAME: il nome di una bozza esistente o di una richiesta di prenotazione futura rifiutata. Non puoi modificare il nome di una richiesta di prenotazione futura.

  • UPDATE_FIELDS: un elenco separato da virgole di campi da aggiornare in questa richiesta PATCH. Devi codificare ogni virgola come %2C. Ad esempio, se vuoi aggiornare i campi autoDeleteAutoCreatedReservations, totalCount e endTime nella richiesta di prenotazione futura, specifica quanto segue:

    autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime

  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: facoltativo. Se imposti questo campo su true, Compute Engine elimina automaticamente le prenotazioni create automaticamente per questa richiesta di prenotazione futura. Per impostazione predefinita, l'ora di eliminazione rientra entro 2 ore dall'ora di fine del periodo di prenotazione. Per modificare questa impostazione, esegui una delle seguenti operazioni:

    • Per eliminare le prenotazioni create automaticamente in un'ora specifica dopo l'ora di fine del periodo di prenotazione, imposta autoDeleteAutoCreatedReservations su true e specifica il campo autoCreatedReservationsDeleteTime.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDeleteTime": "DELETE_TIME"
}

      Sostituisci DELETE_TIME con una data e un'ora in cui Compute Engine elimina le prenotazioni. La data e l'ora devono essere formattate come timestamp RFC 3339, che deve essere il seguente:

      YYYY-MM-DDTHH:MM:SSOFFSET

      Sostituisci quanto segue:

      • YYYY-MM-DD: dati formattati come anno a quattro cifre, mese a due cifre e giorno del mese a due cifre, separati da trattini (-).

      • HH:MM:SS: un'ora formattata come ora a due cifre con formato di 24 ore, minuti a due cifre e secondi a due cifre, separati dai due punti (:).

      • OFFSET: il fuso orario formattato come offset del Tempo coordinato universale (UTC). Ad esempio, per utilizzare il fuso orario PST (Pacific Standard Time), specifica -08:00. In alternativa, per non usare alcun offset, specifica Z.

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

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  }
}

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

  • DESCRIPTION: facoltativo. Per aggiornare la descrizione di questa richiesta di prenotazione futura, esegui una delle seguenti operazioni:

    • Per aggiungere o aggiornare una descrizione, specificane una.

    • Per rimuovere la descrizione, elimina il campo description dal corpo della richiesta e specificalo in UPDATE_FIELDS.

  • NAME_PREFIX: facoltativo. Un nuovo prefisso nome per la richiesta di prenotazione futura. Il nome di ogni prenotazione creata automaticamente per questa richiesta di prenotazione futura inizia con il prefisso del nome. Per aiutarti a identificare le prenotazioni create automaticamente per questa prenotazione futura, è consigliabile specificare un prefisso nome univoco.

  • PLANNING_STATUS: lo stato di pianificazione della richiesta di prenotazione futura. Puoi specificare solo SUBMITTED, che invia la richiesta di prenotazione futura a Google Cloud per la revisione.

  • SHARE_TYPE: facoltativo. Per modificare il tipo di condivisione di questa richiesta di prenotazione futura, specifica uno dei seguenti valori:

    • Per modificare una richiesta di prenotazione futura per un singolo progetto in una richiesta di prenotazione futura condivisa, specifica SPECIFIC_PROJECTS. Inoltre, devi specificare almeno un progetto consumer nel campo projects. In caso contrario, la modifica della richiesta di prenotazione futura non andrà a buon fine.

    • In caso contrario, specifica LOCAL. Inoltre, devi eliminare il campo projects dal corpo della richiesta e specificarlo in UPDATE_FIELDS. In caso contrario, la modifica della richiesta di prenotazione futura non andrà a buon fine.

  • CONSUMER_PROJECT_ID_1 e CONSUMER_PROJECT_ID_2: facoltativi. Gli ID progetto dei progetti con cui è possibile condividere una richiesta di prenotazione futura condivisa. Puoi specificare fino a 100 progetti. Questi progetti devono trovarsi nella stessa organizzazione del progetto in cui è stata creata la richiesta di prenotazione futura (progetto proprietario). Non specificare il progetto del proprietario. Per impostazione predefinita, è già consentito utilizzare le prenotazioni condivise create automaticamente per questa richiesta di prenotazione futura.

  • Facoltativo. Per aggiornare le GPU (Graphics Processing Unit) collegate a ogni VM prenotata, esegui una delle seguenti operazioni:

    • Per aggiungere o modificare le GPU, specifica quanto segue:

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

      • ACCELERATOR_TYPE: il tipo di GPU da aggiungere alle VM prenotate.

      Assicurati che il tipo di macchina specificato nella richiesta di prenotazione futura supporti i tipi di GPU specificati e che la GPU sia disponibile nella zona in cui vuoi prenotare le risorse. In caso contrario, si verificheranno errori.

    • Per rimuovere tutte le GPU da questa richiesta di prenotazione futura, ometti il campo guestAccelerators nel corpo della richiesta e specificalo in UPDATE_FIELDS.

  • Facoltativo. Per aggiornare gli SSD locali collegati a ogni VM prenotata, esegui una delle seguenti operazioni:

    • Per aggiungere o modificare il tipo di interfaccia da utilizzare per gli SSD locali di ogni VM, sostituisci INTERFACE_1 e INTERFACE_2. Il valore deve essere uno dei seguenti:

      Ripeti i campi diskSizeGb e interface per ogni SSD locale che vuoi aggiungere o aggiornare. Puoi specificare un massimo di 24 SSD locali.

    • Per rimuovere tutti gli SSD locali da questa prenotazione futura, elimina il campo localSsds dal corpo della richiesta e specificalo in UPDATE_FIELDS.

  • MACHINE_TYPE: facoltativo. Un tipo di macchina predefinita o personalizzata da utilizzare per ogni VM. Prima di specificare un tipo di macchina personalizzata, esamina le limitazioni per le VM con tipi di macchine personalizzate.

  • MINIMUM_CPU_PLATFORM: facoltativo. Per aggiornare la piattaforma CPU minima da utilizzare per ogni VM, esegui una delle seguenti operazioni:

    • Per aggiungere o aggiornare la piattaforma CPU minima, specifica una piattaforma CPU minima.

    • Per ripristinare la piattaforma CPU predefinita della zona, elimina il campo minCpuPlatform dal corpo della richiesta e specificalo in UPDATE_FIELDS.

  • TOTAL_COUNT: facoltativo. Il nuovo numero totale di VM che vuoi prenotare per il periodo, la configurazione della VM e i progetti specificati in questa richiesta di prenotazione futura.

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

  • START_TIME: facoltativo. La nuova ora di inizio del periodo di prenotazione formattata come timestamp RFC 3339. L'ora di inizio non può essere successiva a un anno dalla data e dall'ora in cui invii una richiesta di prenotazione futura per la revisione. Inoltre, assicurati di specificare un'ora di inizio consigliata per assicurarti di avere tempo sufficiente prima che una prenotazione futura venga inserita nel relativo orario di blocco.

  • END_TIME: facoltativo. La nuova ora di fine del periodo di prenotazione formattata come timestamp RFC 3339. Il periodo di prenotazione deve durare almeno 24 ore. In alternativa, puoi sostituire il campo endTime con il campo duration per specificare una durata specifica dall'ora di inizio del periodo di prenotazione:

    "duration": {
  "seconds": "END_DURATION"
}

    Sostituisci END_DURATION con una durata in secondi. Ad esempio, specifica 1209600 per 1.209.600 secondi (14 giorni).

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

Ad esempio, considera una bozza di richiesta di prenotazione futura condivisa denominata fr-03 e situata nella zona us-central1-a. Supponiamo di voler modificare questa richiesta di prenotazione futura condivisa apportando le seguenti modifiche:

  • Convertilo in una richiesta di prenotazione futura per un singolo progetto.

  • Disattiva l'opzione di eliminazione automatica.

  • Prenota 100 VM.

  • Invia la richiesta di prenotazione futura a Google Cloud per l'approvazione.

Per modificare fr-03, effettua la seguente richiesta di PATCH:

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-03?updateMask=autoDeleteAutoCreatedReservations%2CplanningStatus%2CshareSettings.shareType%2CspecificSkuProperties.totalCount

{
  "autoDeleteAutoCreatedReservations": "false",
  "name": "fr-03",
  "planningStatus": "SUBMITTED",
  "shareSettings": {
    "shareType": "LOCAL"
  },
  "specificSkuProperties": {
    "totalCount": "100"
  }
}

Dopo aver inviato una richiesta di prenotazione futura a Google Cloud per la revisione, visualizza i dettagli per monitorarne lo stato di approvvigionamento.

Modificare una prenotazione futura approvata o approvvigionamento

Per modificare le proprietà di una prenotazione futura approvata o approvvigionamento, seleziona uno dei seguenti metodi:

  • Modificare una prenotazione futura approvata o approvvigionamento senza revisione.

    Questa sezione spiega come modificare l'opzione di eliminazione automatica, la descrizione e il prefisso del nome in una prenotazione futura approvata o acquisita senza revisione. La modifica di queste proprietà è immediata e non ci sono limiti al numero di volte in cui puoi cambiarle fino a quando Google Cloud non inizia a creare le prenotazioni.

  • Richiesta di modifica di una prenotazione futura approvata o di acquisizione.

    Questa sezione spiega come richiedere a Google Cloud di modificare una o più proprietà in una prenotazione futura approvata o approvvigionamento. Puoi inviare una richiesta solo per modificare una prenotazione futura con stato di approvvigionamento In fase di approvvigionamento (PROCURING).

Modificare una prenotazione approvata o acquisire una prenotazione futura senza revisione

Per una prenotazione futura con uno stato di approvvigionamento impostato su Approvato (APPROVED) o Approvvigionamento (PROCURING), puoi modificare i seguenti campi senza l'approvazione di Google Cloud:

  • Eliminazione automatica

  • Descrizione

  • Prefisso nome

La modifica di queste proprietà è immediata. Fino all'ora di inizio del periodo di prenotazione di una prenotazione futura, non sono previsti limiti al numero di volte in cui puoi modificare queste proprietà.

Puoi modificare una prenotazione futura approvata o approvvigionamento senza revisione utilizzando la console Google Cloud, gcloud CLI e REST.

Console

Per modificare una prenotazione approvata o approvvigionamento futura senza revisione, segui questi passaggi:

  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 prenotazione futura che vuoi modificare.

    Si apre la pagina dei dettagli della prenotazione futura selezionata.

  4. Se vuoi modificare l'opzione di eliminazione automatica e la descrizione di una prenotazione futura, esegui una o più delle seguenti operazioni:

    • Nella riga Ora di eliminazione automatica delle prenotazioni create automaticamente, fai clic su Modifica, poi segui questi passaggi:

      1. Esegui 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 l'eliminazione automatica per attivare l'opzione.

          2. (Facoltativo) Nel campo Ora eliminazione automatica, inserisci una nuova data e ora per quando eliminare le prenotazioni create automaticamente. La data e l'ora devono essere successive all'ora di fine del periodo di prenotazione. Se lasci vuoto questo campo, le prenotazioni create automaticamente vengono eliminate entro 2 ore dall'ora di fine del periodo di prenotazione.

        • In caso contrario, fai clic sul pulsante di attivazione/disattivazione Abilita eliminazione automatica per disattivare l'opzione.

      2. Fai clic su Invia.

    • Nella riga Prefisso, fai clic su Modifica, poi attieniti alla procedura seguente:

      1. Nel campo Prefisso, inserisci un nuovo prefisso per il nome.

      2. Fai clic su Invia.

    • Nella riga Descrizione, fai clic su Modifica, poi:

      1. Nel campo Descrizione, inserisci una nuova descrizione.

      2. Fai clic su Invia.

gcloud

Per modificare una prenotazione futura approvata o approvvigionamento senza revisione, utilizza il comando gcloud beta compute future-reservations update.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --description="DESCRIPTION" \
    --name-prefix=NAME_PREFIX \
    --project=PROJECT_ID \
    --zone=ZONE

Sostituisci quanto segue:

  • FUTURE_RESERVATION_NAME: il nome di una prenotazione esistente approvata o approvvigionamento futura.
  • DESCRIPTION: facoltativo. Una nuova descrizione per la prenotazione futura.
  • NAME_PREFIX: facoltativo. Un nuovo prefisso nome per la prenotazione futura. Il nome di ogni prenotazione creata automaticamente per questa prenotazione futura inizia con il prefisso del nome. Per aiutarti a identificare le prenotazioni create automaticamente per questa prenotazione futura, è consigliabile specificare un prefisso del nome univoco.
  • PROJECT_ID: facoltativo. L'ID del progetto in cui è stata creata la prenotazione futura.
  • ZONE: la zona in cui si trova la prenotazione futura.

Facoltativamente, puoi anche modificare se e quando Compute Engine elimina automaticamente le prenotazioni create automaticamente per una prenotazione futura, procedendo in uno dei seguenti modi:

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

    • Per eliminare le prenotazioni entro due ore dall'ora di fine (impostazione predefinita), specifica il flag --auto-delete-auto-created-reservations.

      gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations

    • Per eliminare le prenotazioni create automaticamente in un orario specifico dopo l'ora di fine del periodo di prenotazione, specifica i flag --auto-delete-auto-created-reservations e --auto-created-reservations-delete-time.

      gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME

      Sostituisci AUTO_CREATED_RESERVATIONS_DELETE_TIME con una data e un'ora formattate come timestamp RFC 3339.

    • Per eliminare le prenotazioni create automaticamente dopo una durata specifica dopo l'ora di fine del periodo di prenotazione, specifica i flag --auto-delete-auto-created-reservations e --auto-created-reservations-duration.

      gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE

      Sostituisci DURATION_BEFORE_DELETE con una durata espressa in giorni, ore, minuti o secondi. Ad esempio, specifica 30m per 30 minuti o 1d2h3m4s per 1 giorno, 2 ore, 3 minuti e 4 secondi.

  • Per impedire a Compute Engine di eliminare automaticamente le prenotazioni create automaticamente, specifica il flag --no-auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations update example-future-reservation \
    --no-auto-delete-auto-created-reservations

Ad esempio, considera una prenotazione futura approvata denominata fr-04 e situata nella zona us-central1-a. Supponi di voler modificare questa prenotazione futura apportando le seguenti modifiche:

  • Attiva l'opzione di eliminazione automatica.

  • Elimina automaticamente le prenotazioni create automaticamente dopo 864.000 secondi (10 giorni).

  • Specifica un nuovo prefisso nome.

Per modificare fr-04, esegui questo comando:

gcloud beta compute future-reservations update fr-04 \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-duration=864000 \
    --name-prefix=new-prefix \
    --project=example-project \
    --zone=us-central1-a

REST

Per modificare una prenotazione futura approvata o approvvigionamento senza revisione, effettua una richiesta PATCH al metodo beta.futureReservations.update. Nel parametro di query updateMask, specifica tutti i campi da aggiornare. Se devi eliminare un campo facoltativo dalla prenotazione, includilo nel parametro di query updateMask e omettilo dal corpo della richiesta.

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

{
  "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
  "description": "DESCRIPTION",
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX"
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui si trova la prenotazione futura.

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

  • FUTURE_RESERVATION_NAME: il nome di una prenotazione esistente approvata o approvvigionamento futura. Non puoi modificare il nome di una prenotazione futura.

  • UPDATE_FIELDS: un elenco separato da virgole di campi da aggiornare in questa richiesta PATCH. Devi codificare ogni virgola come %2C. Ad esempio, se vuoi aggiornare i campi description e namePrefix nella prenotazione futura, specifica quanto segue:

    description%2CnamePrefix

  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: facoltativo. Se imposti questo campo su true, Compute Engine elimina automaticamente le prenotazioni create automaticamente per questa prenotazione futura. Per impostazione predefinita, l'ora di eliminazione rientra entro 2 ore dall'ora di fine del periodo di prenotazione. Per modificare questa impostazione, esegui una delle seguenti operazioni:

    • Per eliminare le prenotazioni create automaticamente in un'ora specifica dopo l'ora di fine del periodo di prenotazione, imposta autoDeleteAutoCreatedReservations su true e specifica il campo autoCreatedReservationsDeleteTime.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDeleteTime": "DELETE_TIME"
}

      Sostituisci DELETE_TIME con una data e un'ora in cui Compute Engine elimina le prenotazioni. La data e l'ora devono essere formattate come timestamp RFC 3339, che deve essere il seguente:

      YYYY-MM-DDTHH:MM:SSOFFSET

      Sostituisci quanto segue:

      • YYYY-MM-DD: dati formattati come anno a quattro cifre, mese a due cifre e giorno del mese a due cifre, separati da trattini (-).

      • HH:MM:SS: un'ora formattata come ora a due cifre con formato di 24 ore, minuti a due cifre e secondi a due cifre, separati dai due punti (:).

      • OFFSET: il fuso orario formattato come offset del Tempo coordinato universale (UTC). Ad esempio, per utilizzare il fuso orario PST (Pacific Standard Time), specifica -08:00. In alternativa, per non usare alcun offset, specifica Z.

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

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  }
}

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

  • DESCRIPTION: facoltativo. Per aggiornare la descrizione di questa prenotazione futura, esegui una delle seguenti operazioni:

    • Per aggiungere o aggiornare una descrizione, specificane una.

    • Per rimuovere la descrizione, elimina il campo description dal corpo della richiesta e specificalo in UPDATE_FIELDS.

  • NAME_PREFIX: facoltativo. Un nuovo prefisso nome per la prenotazione futura. Il nome di ogni prenotazione creata automaticamente per questa prenotazione futura inizia con il prefisso del nome. Per aiutarti a identificare le prenotazioni create automaticamente per questa prenotazione futura, è consigliabile specificare un prefisso nome univoco.

Ad esempio, considera una prenotazione futura approvata denominata fr-04 e situata nella zona us-central1-a. Supponi di voler modificare questa prenotazione futura apportando le seguenti modifiche:

  • Attiva l'opzione di eliminazione automatica.

  • Elimina automaticamente le prenotazioni create automaticamente dopo 864.000 secondi (10 giorni).

  • Specifica un nuovo prefisso nome.

Per modificare fr-04, effettua la seguente richiesta di PATCH:

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-04?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration%2CnamePrefix

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDuration": {
    "seconds": "864000"
  },
  "name": "fr-04",
  "namePrefix": "new-prefix"
}

Richiedi di modificare una prenotazione futura approvata o approvvigionamento

Puoi richiedere a Google Cloud di modificare una prenotazione futura con uno stato di approvvigionamento impostato su Approvato (APPROVED) o Approvvigionamento (PROCURING) come segue:

  • Se richiedi di modificare una prenotazione futura approvata, Google Cloud procede in uno dei seguenti modi:

    • Approva la richiesta e imposta lo stato di approvvigionamento su Approvato (APPROVED). Se l'ora di inizio del periodo di prenotazione rientra in 56 giorni (8 settimane), Compute Engine imposta lo stato di approvvigionamento su Approvvigionamento (PROCURING) entro pochi minuti.

    • Rifiuta la richiesta e imposta lo stato dell'approvvigionamento su Rifiutato (DECLINED). Se vuoi modificare di nuovo la prenotazione futura, consulta Modificare una bozza o una prenotazione futura rifiutata in questo documento.

  • Se richiedi di modificare una prenotazione futura di acquisizione, Compute Engine crea lo stato di aggiornamento nella prenotazione futura e lo imposta su Aggiornamento in attesa di approvazione (AMENDMENT_PENDING_APPROVAL). Quindi, Google Cloud esamina la richiesta ed esegue una delle seguenti operazioni:

    • Approva la richiesta e imposta lo stato di aggiornamento su Aggiornamento approvato (AMENDMENT_APPROVED).

    • Rifiuta la richiesta, imposta lo stato di aggiornamento su Aggiornamento rifiutato (AMENDMENT_DECLINED) e continua a utilizzare le proprietà approvate in precedenza per le prenotazioni create automaticamente.

    Durante il periodo in cui Google Cloud esamina la tua richiesta di modifica di una prenotazione futura, non puoi modificare nessuna proprietà, comprese le proprietà che normalmente puoi modificare senza approvazione, finché Google Cloud non approva o rifiuta la richiesta.

Per richiedere a Google Cloud di modificare le proprietà di una prenotazione futura approvata o approvvigionamento, seleziona uno dei seguenti metodi:

Richiedi di modificare una prenotazione futura creata specificando un modello di istanza

Per una prenotazione futura creata specificando un modello di istanza il cui stato di approvvigionamento è Approvato (APPROVED) o Approvvigionamento (PROCURING), puoi richiedere di modificare le seguenti proprietà:

  • Eliminazione automatica

  • Descrizione

  • Prefisso nome

  • Impostazioni di condivisione

  • Ora di inizio e di fine del periodo di prenotazione

  • Conteggio totale (numero di VM)†

† Se richiedi un aumento o una riduzione significativi del conteggio totale entro 14 giorni dall'ora di inizio della prenotazione futura, è probabile che Google Cloud rifiuterà la richiesta.

Puoi richiedere a Google Cloud di modificare una prenotazione futura creata specificando un modello di istanza tramite gcloud CLI e REST.

Console

Per richiedere a Google Cloud di modificare una prenotazione futura approvata o approvvigionamento creata specificando un modello di istanza, segui questi passaggi:

  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 prenotazione futura che vuoi modificare.

    Si apre la pagina dei dettagli della prenotazione futura selezionata.

  4. Se vuoi modificare l'opzione di eliminazione automatica e la descrizione di una prenotazione futura, esegui una o più delle seguenti operazioni:

    • Nella riga Ora di eliminazione automatica delle prenotazioni create automaticamente, fai clic su Modifica, poi segui questi passaggi:

      1. Esegui 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 l'eliminazione automatica per attivare l'opzione.

          2. (Facoltativo) Nel campo Ora eliminazione automatica, inserisci una nuova data e ora per quando eliminare le prenotazioni create automaticamente. La data e l'ora devono essere successive all'ora di fine del periodo di prenotazione. Se lasci vuoto questo campo, le prenotazioni create automaticamente vengono eliminate entro 2 ore dall'ora di fine del periodo di prenotazione.

        • In caso contrario, fai clic sul pulsante di attivazione/disattivazione Abilita eliminazione automatica per disattivare l'opzione.

      2. Fai clic su Invia.

    • Nella riga Prefisso, fai clic su Modifica, poi attieniti alla procedura seguente:

      1. Nel campo Prefisso, inserisci un nuovo prefisso per il nome.

      2. Fai clic su Invia.

    • Nella riga Descrizione, fai clic su Modifica, poi:

      1. Nel campo Descrizione, inserisci una nuova descrizione.

      2. Fai clic su Invia.

  5. Fai clic su Modifica.

    Si apre la pagina per modificare la prenotazione futura selezionata.

  6. Se vuoi modificare altre proprietà, esegui una o più delle seguenti operazioni:

    • Modifica l'ora di inizio o l'ora di fine della prenotazione futura. Verifica quanto segue:

      • L'ora di inizio non può essere successiva a un anno dalla data e dall'ora in cui invii una prenotazione futura per la revisione.

      • Specifica un valore consigliato per l'ora di inizio per assicurarti di avere tempo sufficiente prima che la prenotazione futura entri nell'orario di blocco.

      • Specifica un periodo minimo di prenotazione consigliato per aumentare la probabilità che Google Cloud approvi la tua richiesta dopo averla inviata per la revisione.

    • Nella sezione Tipo di condivisione, puoi selezionare Locale o Condivisa. Se selezioni Condivisa, puoi aggiungere o rimuovere progetti con cui condividere la prenotazione futura.

      Puoi selezionare fino a 100 progetti. Questi progetti devono trovarsi nella stessa organizzazione del progetto in cui è stata creata la prenotazione futura (progetto proprietario). Non specificare il progetto del proprietario. Per impostazione predefinita, l'account è già autorizzato a utilizzare le prenotazioni condivise create automaticamente per questa prenotazione futura.

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

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

  7. Per inviare una richiesta di modifica a Google Cloud per la revisione, fai clic su Invia.

    Se invii una richiesta, si apre la pagina Prenotazioni. In caso contrario, si apre la pagina dei dettagli della prenotazione futura.

gcloud

Per richiedere a Google Cloud di modificare una prenotazione futura approvata o approvvigionamento creata specificando un modello di istanza, utilizza il comando gcloud beta compute future-reservations update.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --description="DESCRIPTION" \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --share-setting=SHARE_SETTING \
    --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 di una prenotazione esistente approvata o approvvigionamento futura.
  • DESCRIPTION: facoltativo. Una nuova descrizione per la prenotazione futura.
  • NAME_PREFIX: facoltativo. Un nuovo prefisso nome per la prenotazione futura. Il nome di ogni prenotazione creata automaticamente per questa prenotazione futura inizia con il prefisso del nome. Per aiutarti a identificare le prenotazioni create automaticamente per questa prenotazione futura, è consigliabile specificare un prefisso del nome univoco.

  • PLANNING_STATUS: lo stato di pianificazione della prenotazione futura. Puoi specificare solo SUBMITTED, che invierà la prenotazione futura a Google Cloud per la revisione.

  • PROJECT_ID: facoltativo. L'ID del progetto in cui è stata creata la prenotazione futura. Se modifichi una prenotazione futura per un singolo progetto in una prenotazione futura condivisa, questo progetto diventa il progetto proprietario della prenotazione futura. Se ometti il flag --project, il valore viene impostato sull'ID del progetto attuale.

  • SHARE_SETTING: facoltativo. Per modificare il tipo di questa prenotazione futura, specifica uno dei seguenti valori:

    • Per modificare una prenotazione futura di un singolo progetto in una prenotazione futura condivisa, specifica projects. Assicurati di specificare almeno un progetto consumer utilizzando il flag --share-with. In caso contrario, la modifica della richiesta di prenotazione futura non andrà a buon fine.

    • In caso contrario, specifica local.

  • CONSUMER_PROJECT_IDS: facoltativo. Un elenco separato da virgole di ID progetto di progetti con cui è possibile condividere questa prenotazione futura. Ad esempio, specifica project-1,project-2. Puoi specificare fino a 100 progetti. Questi progetti devono trovarsi nella stessa organizzazione del progetto in cui è stata creata la prenotazione futura (progetto proprietario). Non specificare il progetto del proprietario. Per impostazione predefinita, l'account è già autorizzato a utilizzare le prenotazioni condivise create automaticamente per questa prenotazione futura.

  • START_TIME: facoltativo. La nuova ora di inizio del periodo di prenotazione formattata come timestamp RFC 3339, che deve essere il seguente:

    YYYY-MM-DDTHH:MM:SSOFFSET

    Sostituisci quanto segue:

    • YYYY-MM-DD: dati formattati come anno a quattro cifre, mese a due cifre e giorno del mese a due cifre, separati da trattini (-).

    • HH:MM:SS: un'ora formattata come ora a due cifre con formato a 24 ore, minuti a due cifre e secondi a due cifre, separati dai due punti (:).

    • OFFSET: il fuso orario formattato come offset del Tempo coordinato universale (UTC). Ad esempio, per utilizzare il fuso orario PST (Pacific Standard Time), specifica -08:00. In alternativa, per non usare alcun offset, specifica Z.

    L'ora di inizio non può essere successiva a un anno dalla data e dall'ora in cui invii una prenotazione futura per la revisione. Per avere tempo sufficiente per annullare, eliminare o modificare una prenotazione futura dopo l'approvazione o prima dell'inserimento dell'ora di blocco, assicurati di specificare un'ora di inizio consigliata.

  • END_TIME: facoltativo. La nuova ora di fine del periodo di prenotazione formattata come timestamp RFC 3339. Il periodo di prenotazione deve durare almeno 24 ore. In alternativa, puoi sostituire il flag --end-time con il flag --duration=END_DURATION, dove END_DURATION è la durata del periodo di prenotazione in secondi. Ad esempio, specifica 1209600 per 1.209.600 secondi (14 giorni).

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

  • TOTAL_COUNT: facoltativo. Il nuovo numero totale di VM che vuoi prenotare per il periodo, la configurazione della VM e i progetti specificati in questa richiesta di prenotazione futura.

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

    Attenzione: se vuoi aumentare il numero di VM da prenotare, assicurati di disporre di una quota sufficiente per le risorse aggiuntive che richiedi di prenotare. In caso contrario, Google Cloud rifiuta la richiesta di modifica.

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

Facoltativamente, puoi anche modificare se e quando Compute Engine elimina automaticamente le prenotazioni create automaticamente per una prenotazione futura, procedendo in uno dei seguenti modi:

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

    • Per eliminare le prenotazioni entro due ore dall'ora di fine (impostazione predefinita), specifica il flag --auto-delete-auto-created-reservations.

      gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations

    • Per eliminare le prenotazioni create automaticamente in un orario specifico dopo l'ora di fine del periodo di prenotazione, specifica i flag --auto-delete-auto-created-reservations e --auto-created-reservations-delete-time.

      gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME

      Sostituisci AUTO_CREATED_RESERVATIONS_DELETE_TIME con una data e un'ora formattate come timestamp RFC 3339.

    • Per eliminare le prenotazioni create automaticamente dopo una durata specifica dopo l'ora di fine del periodo di prenotazione, specifica i flag --auto-delete-auto-created-reservations e --auto-created-reservations-duration.

      gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE

      Sostituisci DURATION_BEFORE_DELETE con una durata espressa in giorni, ore, minuti o secondi. Ad esempio, specifica 30m per 30 minuti o 1d2h3m4s per 1 giorno, 2 ore, 3 minuti e 4 secondi.

  • Per impedire a Compute Engine di eliminare automaticamente le prenotazioni create automaticamente, specifica il flag --no-auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations update example-future-reservation \
    --no-auto-delete-auto-created-reservations

Ad esempio, considera una prenotazione futura approvata denominata fr-05 e situata nella zona us-central1-a. Supponi di voler richiedere a Google Cloud di modificare questa prenotazione futura apportando le seguenti modifiche:

  • Modifica l'ora di fine del periodo di prenotazione a mezzanotte del 31 dicembre 2023 UTC.

  • Prenota 10 VM.

  • Specifica un nuovo prefisso nome.

Per richiedere a Google Cloud di modificare fr-05, esegui questo comando:

gcloud beta compute future-reservations update fr-05 \
    --end-time=2024-12-31T00:00:00Z \
    --name-prefix=new-prefix \
    --planning-status=SUBMITTED \
    --project=example-project \
    --total-count=10 \
    --zone=us-central1-a

REST

Per richiedere a Google Cloud di modificare una prenotazione futura approvata o approvvigionamento creata specificando un modello di istanza, effettua una richiesta PATCH al metodo beta.futureReservations.update. Nel parametro di query updateMask, specifica tutti i campi da aggiornare. Se devi eliminare un campo facoltativo dalla prenotazione, includilo nel parametro di query updateMask e omettilo dal corpo della richiesta.

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

{
  "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
  "description": "DESCRIPTION",
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "planningStatus": "PLANNING_STATUS",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SHARE_TYPE"
  },
  "specificSkuProperties": {
    "totalCount": "TOTAL_COUNT"
  },
  "timeWindow": {
    "endTime": "END_TIME",
    "startTime": "START_TIME"
  }
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui si trova la prenotazione futura.

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

  • FUTURE_RESERVATION_NAME: il nome di una prenotazione esistente approvata o approvvigionamento futura. Non puoi modificare il nome di una prenotazione futura.

  • UPDATE_FIELDS: un elenco separato da virgole di campi da aggiornare in questa richiesta PATCH. Devi codificare ogni virgola come %2C. Ad esempio, se vuoi aggiornare i campi autoDeleteAutoCreatedReservations, totalCount e endTime nella prenotazione futura, specifica quanto segue:

    autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime

  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: facoltativo. Se imposti questo campo su true, Compute Engine elimina automaticamente le prenotazioni create automaticamente per questa prenotazione futura. Per impostazione predefinita, l'ora di eliminazione rientra entro 2 ore dall'ora di fine del periodo di prenotazione. Per modificare questa impostazione, esegui una delle seguenti operazioni:

    • Per eliminare le prenotazioni create automaticamente in un'ora specifica dopo l'ora di fine del periodo di prenotazione, imposta autoDeleteAutoCreatedReservations su true e specifica il campo autoCreatedReservationsDeleteTime.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDeleteTime": "DELETE_TIME"
}

      Sostituisci DELETE_TIME con una data e un'ora in cui Compute Engine elimina le prenotazioni. La data e l'ora devono essere formattate come timestamp RFC 3339, che deve essere il seguente:

      YYYY-MM-DDTHH:MM:SSOFFSET

      Sostituisci quanto segue:

      • YYYY-MM-DD: dati formattati come anno a quattro cifre, mese a due cifre e giorno del mese a due cifre, separati da trattini (-).

      • HH:MM:SS: un'ora formattata come ora a due cifre con formato di 24 ore, minuti a due cifre e secondi a due cifre, separati dai due punti (:).

      • OFFSET: il fuso orario formattato come offset del Tempo coordinato universale (UTC). Ad esempio, per utilizzare il fuso orario PST (Pacific Standard Time), specifica -08:00. In alternativa, per non usare alcun offset, specifica Z.

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

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  }
}

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

  • DESCRIPTION: facoltativo. Per aggiornare la descrizione di questa prenotazione futura, esegui una delle seguenti operazioni:

    • Per aggiungere o aggiornare una descrizione, specificane una.

    • Per rimuovere la descrizione, elimina il campo description dal corpo della richiesta e specificalo in UPDATE_FIELDS.

  • NAME_PREFIX: facoltativo. Un nuovo prefisso nome per la prenotazione futura. Il nome di ogni prenotazione creata automaticamente per questa prenotazione futura inizia con il prefisso del nome. Per aiutarti a identificare le prenotazioni create automaticamente per questa prenotazione futura, è consigliabile specificare un prefisso nome univoco.

  • PLANNING_STATUS: lo stato di pianificazione della prenotazione futura. Puoi specificare solo SUBMITTED, che invierà la prenotazione futura a Google Cloud per la revisione.

  • SHARE_TYPE: facoltativo. Per modificare il tipo di condivisione di questa prenotazione futura, specifica uno dei seguenti valori:

    • Per modificare una prenotazione futura di un singolo progetto in una prenotazione futura condivisa, specifica SPECIFIC_PROJECTS. Inoltre, devi specificare almeno un progetto consumer nel campo projects. In caso contrario, la modifica della prenotazione futura non andrà a buon fine.

    • In caso contrario, specifica LOCAL. Inoltre, devi eliminare il campo projects dal corpo della richiesta e specificarlo in UPDATE_FIELDS. In caso contrario, la modifica della prenotazione futura non andrà a buon fine.

  • CONSUMER_PROJECT_ID_1 e CONSUMER_PROJECT_ID_2: facoltativi. Gli ID progetto dei progetti con cui è possibile condividere una prenotazione futura condivisa. Puoi specificare fino a 100 progetti. Questi progetti devono trovarsi nella stessa organizzazione del progetto in cui è stata creata la prenotazione futura (il progetto del proprietario). Non specificare il progetto del proprietario. Per impostazione predefinita, l'account è già autorizzato a utilizzare le prenotazioni condivise create automaticamente per questa prenotazione futura.

  • TOTAL_COUNT: facoltativo. Il nuovo numero totale di VM che vuoi prenotare per il periodo, la configurazione della VM e i progetti specificati in questa richiesta di prenotazione futura.

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

  • START_TIME: facoltativo. La nuova ora di inizio del periodo di prenotazione formattata come timestamp RFC 3339. L'ora di inizio non può essere successiva a un anno dalla data e dall'ora in cui invii una prenotazione futura per la revisione. Inoltre, assicurati di specificare un'ora di inizio consigliata per assicurarti di avere tempo sufficiente prima che una prenotazione futura venga inserita nel relativo orario di blocco.

  • END_TIME: facoltativo. La nuova ora di fine del periodo di prenotazione formattata come timestamp RFC 3339. Il periodo di prenotazione deve durare almeno 24 ore. In alternativa, puoi sostituire il campo endTime con il campo duration per specificare una durata specifica dall'ora di inizio del periodo di prenotazione:

    "duration": {
  "seconds": "END_DURATION"
}

    Sostituisci END_DURATION con una durata in secondi. Ad esempio, specifica 1209600 per 1.209.600 secondi (14 giorni).

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

Ad esempio, considera una prenotazione futura approvata denominata fr-05 e situata nella zona us-central1-a. Supponi di voler richiedere a Google Cloud di modificare questa prenotazione futura apportando le seguenti modifiche:

  • Modifica l'ora di fine del periodo di prenotazione a mezzanotte del 31 dicembre 2023 UTC.

  • Prenota 10 VM.

  • Specifica un nuovo prefisso nome.

Per richiedere a Google Cloud di modificare fr-05, effettua la seguente richiesta PATCH:

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-05?updateMask=namePrefix%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime

{
  "name": "fr-05",
  "namePrefix": "new-prefix",
  "planningStatus": "SUBMITTED",
  "specificSkuProperties": {
    "totalCount": "10"
  },
  "timeWindow": {
    "endTime": "2023-12-31T00:00:00Z"
  }
}

Dopo aver inviato una richiesta di modifica di una prenotazione futura a Google Cloud, puoi monitorare lo stato della richiesta visualizzando i dettagli della prenotazione futura.

Richiedi di modificare una prenotazione futura creata specificando direttamente le proprietà

Per una prenotazione futura creata specificando direttamente le proprietà con lo stato di approvvigionamento impostato su Approvato (APPROVED) o Approvvigionamento (Procuring), puoi richiedere di modificare le seguenti proprietà:

  • Eliminazione automatica

  • Descrizione

  • Prefisso nome

  • GPU‡

  • SSD locali e tipo di interfaccia del disco‡

  • Serie di macchine e tipo di macchina‡

  • Piattaforma CPU minima‡

  • Impostazioni di condivisione

  • Ora di inizio e di fine del periodo di prenotazione

  • Conteggio totale (numero di VM)‡

‡ Se richiedi di modificare qualsiasi proprietà VM o di aumentare o diminuire in gran parte il numero totale entro 14 giorni dall'ora di inizio della prenotazione futura, è probabile che Google Cloud rifiuti la tua richiesta.

Puoi richiedere a Google Cloud di modificare una prenotazione futura creata specificando direttamente le proprietà tramite la console Google Cloud, gcloud CLI e REST.

Console

Per richiedere a Google Cloud di modificare una prenotazione futura approvata o approvvigionamento creata specificando direttamente le proprietà, segui questi passaggi:

  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 prenotazione futura che vuoi modificare.

    Si apre la pagina dei dettagli della prenotazione futura selezionata.

  4. Se vuoi modificare l'opzione di eliminazione automatica e la descrizione di una prenotazione futura, esegui una o più delle seguenti operazioni:

    • Nella riga Ora di eliminazione automatica delle prenotazioni create automaticamente, fai clic su Modifica, poi segui questi passaggi:

      1. Esegui 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 l'eliminazione automatica per attivare l'opzione.

          2. (Facoltativo) Nel campo Ora eliminazione automatica, inserisci una nuova data e ora per quando eliminare le prenotazioni create automaticamente. La data e l'ora devono essere successive all'ora di fine del periodo di prenotazione. Se lasci vuoto questo campo, le prenotazioni create automaticamente vengono eliminate entro 2 ore dall'ora di fine del periodo di prenotazione.

        • In caso contrario, fai clic sul pulsante di attivazione/disattivazione Abilita eliminazione automatica per disattivare l'opzione.

      2. Fai clic su Invia.

    • Nella riga Prefisso, fai clic su Modifica, poi attieniti alla procedura seguente:

      1. Nel campo Prefisso, inserisci un nuovo prefisso per il nome.

      2. Fai clic su Invia.

    • Nella riga Descrizione, fai clic su Modifica, poi:

      1. Nel campo Descrizione, inserisci una nuova descrizione.

      2. Fai clic su Invia.

  5. Fai clic su Modifica.

    Si apre la pagina per modificare la prenotazione futura selezionata.

  6. Se vuoi modificare altre proprietà, esegui una o più delle seguenti operazioni:

    • Modifica l'ora di inizio o l'ora di fine della prenotazione futura. Verifica quanto segue:

      • L'ora di inizio non può essere successiva a un anno dalla data e dall'ora in cui invii una prenotazione futura per la revisione.

      • Specifica un valore consigliato per l'ora di inizio per assicurarti di avere tempo sufficiente prima che la prenotazione futura entri nell'orario di blocco.

      • Specifica un periodo minimo di prenotazione consigliato per aumentare la probabilità che Google Cloud approvi la tua richiesta dopo averla inviata per la revisione.

    • Nella sezione Tipo di condivisione, puoi selezionare Locale o Condivisa. Se selezioni Condivisa, puoi aggiungere o rimuovere progetti con cui condividere la prenotazione futura.

      Puoi selezionare fino a 100 progetti. Questi progetti devono trovarsi nella stessa organizzazione del progetto in cui è stata creata la prenotazione futura (progetto proprietario). Non specificare il progetto del proprietario. Per impostazione predefinita, l'account è già autorizzato a utilizzare le prenotazioni condivise create automaticamente per questa prenotazione futura.

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

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

    • Nella sezione Configurazione macchina, puoi modificare quanto segue:

      • La serie e il tipo di macchina utilizzati nelle VM prenotate.

      • Le GPU da collegare alle VM prenotate.

      • Gli SSD locali e il tipo di interfaccia del disco delle VM prenotate.

  7. Per inviare una richiesta di modifica a Google Cloud per la revisione, fai clic su Invia.

    Se invii una richiesta, si apre la pagina Prenotazioni. In caso contrario, si apre la pagina dei dettagli della prenotazione futura.

gcloud

Per richiedere a Google Cloud di modificare una prenotazione futura approvata o approvvigionamento creata specificando direttamente le proprietà, utilizza il comando gcloud beta compute future-reservations update.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
    --description="DESCRIPTION" \
    --local-ssd=size=375,interface=INTERFACE_1 \
    --local-ssd=size=375,interface=INTERFACE_2 \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform=MIN_CPU_PLATFORM \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --share-setting=SHARE_SETTING \
    --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 di una prenotazione esistente approvata o approvvigionamento futura.

  • Facoltativo. Esegui una di queste operazioni:

    • Per aggiungere GPU (Graphics Processing Unit) a ogni VM prenotata, specifica quanto segue:

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

      • ACCELERATOR_TYPE: il tipo di GPU da aggiungere alle VM prenotate.

      Assicurati che il tipo di macchina specificato nella prenotazione futura supporti i tipi di GPU specificati e che la GPU sia disponibile nella zona in cui vuoi prenotare le risorse. In caso contrario, si verificheranno errori.

    • Per rimuovere tutte le GPU da questa richiesta futura, sostituisci il flag --accelerator con il flag --clear-accelerator.

  • DESCRIPTION: facoltativo. Una nuova descrizione per la prenotazione futura.

  • Facoltativo. Esegui una di queste operazioni:

    • Per aggiungere o modificare il tipo di interfaccia da utilizzare per gli SSD locali di ogni VM, sostituisci INTERFACE_1 e INTERFACE_2. Il valore deve essere uno dei seguenti:

      Ogni SSD locale ha una dimensione di 375 GB. Ripeti il flag --local-ssd per ogni SSD locale che vuoi aggiungere. Puoi specificare un massimo di 24 SSD locali.

    • Per rimuovere tutti gli SSD locali da questa prenotazione futura, rimuovi tutti i flag --local-ssd e specifica il flag --clear-local-ssd.

  • MACHINE_TYPE: facoltativo. Un tipo di macchina predefinita o personalizzata da utilizzare per ogni VM. Prima di specificare un tipo di macchina personalizzata, esamina le limitazioni per le VM con tipi di macchine personalizzate.

  • MINIMUM_CPU_PLATFORM: facoltativo. La piattaforma CPU minima da utilizzare per ogni VM. Se ometti il flag --min-cpu-platform, il suo valore viene impostato sulla piattaforma CPU predefinita della zona.

  • NAME_PREFIX: facoltativo. Un nuovo prefisso nome per la prenotazione futura. Il nome di ogni prenotazione creata automaticamente per questa prenotazione futura inizia con il prefisso del nome. Per aiutarti a identificare le prenotazioni create automaticamente per questa prenotazione futura, è consigliabile specificare un prefisso del nome univoco.

  • PLANNING_STATUS: lo stato di pianificazione della prenotazione futura. Puoi specificare solo SUBMITTED, che invierà la prenotazione futura a Google Cloud per la revisione.

  • PROJECT_ID: facoltativo. L'ID del progetto in cui è stata creata la prenotazione futura. Se modifichi una prenotazione futura per un singolo progetto in una prenotazione futura condivisa, questo progetto diventa il progetto proprietario della prenotazione futura. Se ometti il flag --project, il valore viene impostato sull'ID del progetto attuale.

  • SHARE_SETTING: facoltativo. Per modificare il tipo di questa prenotazione futura, specifica uno dei seguenti valori:

    • Per modificare una prenotazione futura di un singolo progetto in una prenotazione futura condivisa, specifica projects. Assicurati di specificare almeno un progetto consumer utilizzando il flag --share-with. In caso contrario, la modifica della richiesta di prenotazione futura non andrà a buon fine.

    • In caso contrario, specifica local.

  • CONSUMER_PROJECT_IDS: facoltativo. Un elenco separato da virgole di ID progetto di progetti con cui è possibile condividere questa prenotazione futura. Ad esempio, specifica project-1,project-2. Puoi specificare fino a 100 progetti. Questi progetti devono trovarsi nella stessa organizzazione del progetto in cui è stata creata la prenotazione futura (progetto proprietario). Non specificare il progetto del proprietario. Per impostazione predefinita, l'account è già autorizzato a utilizzare le prenotazioni condivise create automaticamente per questa prenotazione futura.

  • START_TIME: facoltativo. La nuova ora di inizio del periodo di prenotazione formattata come timestamp RFC 3339, che deve essere il seguente:

    YYYY-MM-DDTHH:MM:SSOFFSET

    Sostituisci quanto segue:

    • YYYY-MM-DD: dati formattati come anno a quattro cifre, mese a due cifre e giorno del mese a due cifre, separati da trattini (-).

    • HH:MM:SS: un'ora formattata come ora a due cifre con formato a 24 ore, minuti a due cifre e secondi a due cifre, separati dai due punti (:).

    • OFFSET: il fuso orario formattato come offset del Tempo coordinato universale (UTC). Ad esempio, per utilizzare il fuso orario PST (Pacific Standard Time), specifica -08:00. In alternativa, per non usare alcun offset, specifica Z.

    L'ora di inizio non può essere successiva a un anno dalla data e dall'ora in cui invii una prenotazione futura per la revisione. Per avere tempo sufficiente per annullare, eliminare o modificare una prenotazione futura dopo l'approvazione o prima dell'inserimento dell'ora di blocco, assicurati di specificare un'ora di inizio consigliata.

  • END_TIME: facoltativo. La nuova ora di fine del periodo di prenotazione formattata come timestamp RFC 3339. Il periodo di prenotazione deve durare almeno 24 ore. In alternativa, puoi sostituire il flag --end-time con il flag --duration=END_DURATION, dove END_DURATION è la durata del periodo di prenotazione in secondi. Ad esempio, specifica 1209600 per 1.209.600 secondi (14 giorni).

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

  • TOTAL_COUNT: facoltativo. Il nuovo numero totale di VM che vuoi prenotare per il periodo, la configurazione della VM e i progetti specificati in questa richiesta di prenotazione futura.

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

    Attenzione: se vuoi aumentare il numero di VM da prenotare, assicurati di disporre di una quota sufficiente per le risorse aggiuntive che richiedi di prenotare. In caso contrario, Google Cloud rifiuta la richiesta di modifica.

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

Facoltativamente, puoi anche modificare se e quando Compute Engine elimina automaticamente le prenotazioni create automaticamente per una prenotazione futura, procedendo in uno dei seguenti modi:

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

    • Per eliminare le prenotazioni entro due ore dall'ora di fine (impostazione predefinita), specifica il flag --auto-delete-auto-created-reservations.

      gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations

    • Per eliminare le prenotazioni create automaticamente in un orario specifico dopo l'ora di fine del periodo di prenotazione, specifica i flag --auto-delete-auto-created-reservations e --auto-created-reservations-delete-time.

      gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME

      Sostituisci AUTO_CREATED_RESERVATIONS_DELETE_TIME con una data e un'ora formattate come timestamp RFC 3339.

    • Per eliminare le prenotazioni create automaticamente dopo una durata specifica dopo l'ora di fine del periodo di prenotazione, specifica i flag --auto-delete-auto-created-reservations e --auto-created-reservations-duration.

      gcloud beta compute future-reservations update example-future-reservation \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE

      Sostituisci DURATION_BEFORE_DELETE con una durata espressa in giorni, ore, minuti o secondi. Ad esempio, specifica 30m per 30 minuti o 1d2h3m4s per 1 giorno, 2 ore, 3 minuti e 4 secondi.

  • Per impedire a Compute Engine di eliminare automaticamente le prenotazioni create automaticamente, specifica il flag --no-auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations update example-future-reservation \
    --no-auto-delete-auto-created-reservations

Ad esempio, considera una prenotazione futura approvata denominata fr-05 e situata nella zona us-central1-a. Supponi di voler richiedere a Google Cloud di modificare questa prenotazione futura apportando le seguenti modifiche:

  • Modifica l'ora di fine del periodo di prenotazione a mezzanotte del 31 dicembre 2023 UTC.

  • Prenota 10 VM.

  • Specifica un nuovo prefisso nome.

Per richiedere a Google Cloud di modificare fr-05, esegui questo comando:

gcloud beta compute future-reservations update fr-05 \
    --end-time=2024-12-31T00:00:00Z \
    --name-prefix=new-prefix \
    --planning-status=SUBMITTED \
    --project=example-project \
    --total-count=10 \
    --zone=us-central1-a

REST

Per richiedere a Google Cloud di modificare una prenotazione futura approvata o approvvigionamento creata specificando direttamente le proprietà, effettua una richiesta PATCH al metodo beta.futureReservations.update. Nel parametro di query updateMask, specifica tutti i campi da aggiornare. Se devi eliminare un campo facoltativo dalla prenotazione, includilo nel parametro di query updateMask e omettilo dal corpo della richiesta.

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

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui si trova la prenotazione futura.

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

  • FUTURE_RESERVATION_NAME: il nome di una prenotazione esistente approvata o approvvigionamento futura. Non puoi modificare il nome di una prenotazione futura.

  • UPDATE_FIELDS: un elenco separato da virgole di campi da aggiornare in questa richiesta PATCH. Devi codificare ogni virgola come %2C. Ad esempio, se vuoi aggiornare i campi autoDeleteAutoCreatedReservations, totalCount e endTime nella prenotazione futura, specifica quanto segue:

    autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime

  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: facoltativo. Se imposti questo campo su true, Compute Engine elimina automaticamente le prenotazioni create automaticamente per questa prenotazione futura. Per impostazione predefinita, l'ora di eliminazione rientra entro 2 ore dall'ora di fine del periodo di prenotazione. Per modificare questa impostazione, esegui una delle seguenti operazioni:

    • Per eliminare le prenotazioni create automaticamente in un'ora specifica dopo l'ora di fine del periodo di prenotazione, imposta autoDeleteAutoCreatedReservations su true e specifica il campo autoCreatedReservationsDeleteTime.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDeleteTime": "DELETE_TIME"
}

      Sostituisci DELETE_TIME con una data e un'ora in cui Compute Engine elimina le prenotazioni. La data e l'ora devono essere formattate come timestamp RFC 3339, che deve essere il seguente:

      YYYY-MM-DDTHH:MM:SSOFFSET

      Sostituisci quanto segue:

      • YYYY-MM-DD: dati formattati come anno a quattro cifre, mese a due cifre e giorno del mese a due cifre, separati da trattini (-).

      • HH:MM:SS: un'ora formattata come ora a due cifre con formato di 24 ore, minuti a due cifre e secondi a due cifre, separati dai due punti (:).

      • OFFSET: il fuso orario formattato come offset del Tempo coordinato universale (UTC). Ad esempio, per utilizzare il fuso orario PST (Pacific Standard Time), specifica -08:00. In alternativa, per non usare alcun offset, specifica Z.

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

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  }
}

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

  • DESCRIPTION: facoltativo. Per aggiornare la descrizione di questa prenotazione futura, esegui una delle seguenti operazioni:

    • Per aggiungere o aggiornare una descrizione, specificane una.

    • Per rimuovere la descrizione, elimina il campo description dal corpo della richiesta e specificalo in UPDATE_FIELDS.

  • NAME_PREFIX: facoltativo. Un nuovo prefisso nome per la prenotazione futura. Il nome di ogni prenotazione creata automaticamente per questa prenotazione futura inizia con il prefisso del nome. Per aiutarti a identificare le prenotazioni create automaticamente per questa prenotazione futura, è consigliabile specificare un prefisso nome univoco.

  • PLANNING_STATUS: lo stato di pianificazione della prenotazione futura. Puoi specificare solo SUBMITTED, che invierà la prenotazione futura a Google Cloud per la revisione.

  • SHARE_TYPE: facoltativo. Per modificare il tipo di condivisione di questa prenotazione futura, specifica uno dei seguenti valori:

    • Per modificare una prenotazione futura di un singolo progetto in una prenotazione futura condivisa, specifica SPECIFIC_PROJECTS. Inoltre, devi specificare almeno un progetto consumer nel campo projects. In caso contrario, la modifica della prenotazione futura non andrà a buon fine.

    • In caso contrario, specifica LOCAL. Inoltre, devi eliminare il campo projects dal corpo della richiesta e specificarlo in UPDATE_FIELDS. In caso contrario, la modifica della prenotazione futura non andrà a buon fine.

  • CONSUMER_PROJECT_ID_1 e CONSUMER_PROJECT_ID_2: facoltativi. Gli ID progetto dei progetti con cui è possibile condividere una prenotazione futura condivisa. Puoi specificare fino a 100 progetti. Questi progetti devono trovarsi nella stessa organizzazione del progetto in cui è stata creata la prenotazione futura (il progetto del proprietario). Non specificare il progetto del proprietario. Per impostazione predefinita, l'account è già autorizzato a utilizzare le prenotazioni condivise create automaticamente per questa prenotazione futura.

  • Facoltativo. Per aggiornare le GPU (Graphics Processing Unit) collegate a ogni VM prenotata, esegui una delle seguenti operazioni:

    • Per aggiungere o modificare le GPU, specifica quanto segue:

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

      • ACCELERATOR_TYPE: il tipo di GPU da aggiungere alle VM prenotate.

      Assicurati che il tipo di macchina specificato nella prenotazione futura supporti i tipi di GPU specificati e che la GPU sia disponibile nella zona in cui vuoi prenotare le risorse. In caso contrario, si verificheranno errori.

    • Per rimuovere tutte le GPU da questa richiesta futura, ometti il campo guestAccelerators nel corpo della richiesta e specificalo in UPDATE_FIELDS.

  • Facoltativo. Per aggiornare gli SSD locali collegati a ogni VM prenotata, esegui una delle seguenti operazioni:

    • Per aggiungere o modificare il tipo di interfaccia da utilizzare per gli SSD locali di ogni VM, sostituisci INTERFACE_1 e INTERFACE_2. Il valore deve essere uno dei seguenti:

      Ripeti i campi diskSizeGb e interface per ogni SSD locale che vuoi aggiungere o aggiornare. Puoi specificare un massimo di 24 SSD locali.

    • Per rimuovere tutti gli SSD locali da questa prenotazione futura, elimina il campo localSsds dal corpo della richiesta e specificalo in UPDATE_FIELDS.

  • MACHINE_TYPE: facoltativo. Un tipo di macchina predefinita o personalizzata da utilizzare per ogni VM. Prima di specificare un tipo di macchina personalizzata, esamina le limitazioni per le VM con tipi di macchine personalizzate.

  • MINIMUM_CPU_PLATFORM: facoltativo. Per aggiornare la piattaforma CPU minima da utilizzare per ogni VM, esegui una delle seguenti operazioni:

    • Per aggiungere o aggiornare la piattaforma CPU minima, specifica una piattaforma CPU minima.

    • Per ripristinare la piattaforma CPU predefinita della zona, elimina il campo minCpuPlatform dal corpo della richiesta e specificalo in UPDATE_FIELDS.

  • TOTAL_COUNT: facoltativo. Il nuovo numero totale di VM che vuoi prenotare per il periodo, la configurazione della VM e i progetti specificati in questa richiesta di prenotazione futura.

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

  • START_TIME: facoltativo. La nuova ora di inizio del periodo di prenotazione formattata come timestamp RFC 3339. L'ora di inizio non può essere successiva a un anno dalla data e dall'ora in cui invii una prenotazione futura per la revisione. Inoltre, assicurati di specificare un'ora di inizio consigliata per assicurarti di avere tempo sufficiente prima che una prenotazione futura venga inserita nel relativo orario di blocco.

  • END_TIME: facoltativo. La nuova ora di fine del periodo di prenotazione formattata come timestamp RFC 3339. Il periodo di prenotazione deve durare almeno 24 ore. In alternativa, puoi sostituire il campo endTime con il campo duration per specificare una durata specifica dall'ora di inizio del periodo di prenotazione:

    "duration": {
  "seconds": "END_DURATION"
}

    Sostituisci END_DURATION con una durata in secondi. Ad esempio, specifica 1209600 per 1.209.600 secondi (14 giorni).

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

Ad esempio, considera una prenotazione futura approvata denominata fr-05 e situata nella zona us-central1-a. Supponi di voler richiedere a Google Cloud di modificare questa prenotazione futura apportando le seguenti modifiche:

  • Modifica l'ora di fine del periodo di prenotazione a mezzanotte del 31 dicembre 2023 UTC.

  • Prenota 10 VM.

  • Specifica un nuovo prefisso nome.

Per richiedere a Google Cloud di modificare fr-05, effettua la seguente richiesta PATCH:

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-05?updateMask=namePrefix%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime

{
  "name": "fr-05",
  "namePrefix": "new-prefix",
  "planningStatus": "SUBMITTED",
  "specificSkuProperties": {
    "totalCount": "10"
  },
  "timeWindow": {
    "endTime": "2023-12-31T00:00:00Z"
  }
}

Dopo aver inviato una richiesta di modifica di una prenotazione futura a Google Cloud, puoi monitorare lo stato della richiesta visualizzando i dettagli della prenotazione futura.

Modificare altre proprietà in una richiesta di prenotazione futura

Se vuoi modificare altre proprietà in una richiesta di prenotazione futura prima che raggiunga lo stato di approvvigionamento (PROCURING), segui questi passaggi:

  1. Esegui una o più delle seguenti operazioni:

  2. Crea un nuovo single-project o una richiesta di prenotazione futura condivisa con gli aggiornamenti che preferisci.

Risolvere i problemi

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

Se i problemi persistono anche dopo la risoluzione dei problemi, contatta il rappresentante del tuo account o l'assistenza Google Cloud.

Annullare le richieste di prenotazione future

Puoi annullare una richiesta di prenotazione futura approvata, rifiutata o in attesa di approvazione per interrompere il provisioning della capacità richiesta da parte di Google Cloud. Dopo aver annullato una richiesta di prenotazione futura, potrai solo visualizzarne i dettagli o eliminarla.

Puoi annullare una richiesta di prenotazione futura utilizzando gcloud CLI e REST.

gcloud

Per annullare una richiesta di prenotazione futura, utilizza il comando gcloud beta compute future-reservations cancel.

gcloud beta compute future-reservations cancel FUTURE_RESERVATION_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

Sostituisci quanto segue:

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

  • PROJECT_ID: facoltativo. L'ID del progetto in cui si trova la richiesta di prenotazione futura. Se ometti il flag --project, viene utilizzato l'ID del progetto corrente.

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

REST

Per annullare una richiesta di prenotazione futura, effettua una richiesta POST utilizzando il metodo beta.futureReservations.cancel.

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui si trova la richiesta di prenotazione futura.

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

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

Elimina richieste di prenotazione future

Puoi eliminare una richiesta di prenotazione futura solo in uno dei seguenti casi:

  • La richiesta di prenotazione futura è stata annullata.

  • Prima che la prenotazione futura abbia raggiunto l'ora di inizio del periodo di prenotazione.

  • Dopo che la prenotazione futura ha raggiunto l'ora di fine del periodo di prenotazione.

L'eliminazione di una prenotazione futura non comporta l'eliminazione delle prenotazioni create automaticamente per la prenotazione futura. Se vuoi eliminare una prenotazione creata automaticamente dopo il termine del periodo di prenotazione, consulta Eliminare le prenotazioni.

Puoi eliminare una richiesta di prenotazione futura utilizzando la console Google Cloud, gcloud CLI e REST.

Console

Per eliminare una richiesta di prenotazione futura:

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

    Vai a Prenotazioni

  2. Fai clic sulla scheda Prenotazioni future.

  3. Seleziona la casella di controllo accanto a ogni richiesta di prenotazione futura da eliminare.

  4. Fai clic su Elimina prenotazione.

  5. Per confermare, fai clic su Elimina.

    L'eliminazione di una richiesta di prenotazione futura può richiedere fino a un minuto.

gcloud

Per eliminare una richiesta di prenotazione futura, utilizza il comando gcloud beta compute future-reservations delete.

gcloud beta compute future-reservations delete FUTURE_RESERVATION_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

Sostituisci quanto segue:

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

  • PROJECT_ID: facoltativo. L'ID del progetto in cui si trova la richiesta di prenotazione futura. Se ometti il flag --project, viene utilizzato l'ID del progetto corrente.

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

REST

Per eliminare una richiesta di prenotazione futura, effettua una richiesta DELETE utilizzando il metodo beta.futureReservations.delete.

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui si trova la richiesta di prenotazione futura.

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

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

Passaggi successivi