Modificare le richieste di prenotazione futura

Console

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

   Vai a Prenotazioni

2. Fai clic sulla scheda Prenotazioni future.

3. Nella colonna Nome, fai clic sul nome della richiesta di prenotazione futura da modificare.

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

4. Se vuoi modificare l'opzione di eliminazione automatica, la descrizione o il prefisso del nome di una prenotazione futura approvata, svolgi una o più delle seguenti operazioni:

   • Per modificare l'opzione di eliminazione automatica, nella riga Ora di eliminazione automatica delle prenotazioni create automaticamente, fai clic su edit Modifica e poi segui questi passaggi:

     1. Specifica se vuoi attivare, disattivare o modificare l'opzione di eliminazione automatica effettuando una delle seguenti operazioni:

        • Per attivare l'opzione di eliminazione automatica o modificare l'ora in cui Compute Engine elimina automaticamente le prenotazioni create automaticamente:

          1. Fai clic sul pulsante di attivazione/disattivazione Attiva l'eliminazione automatica in posizione attivo.

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

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

     2. Fai clic su Invia.

   • Per modificare il prefisso del nome, nella riga Prefisso, fai clic su edit Modifica e poi procedi nel seguente modo:

     1. In Prefisso, inserisci un nuovo prefisso per il nome.

     2. Fai clic su Invia.

   • Per modificare la descrizione, nella riga Descrizione, fai clic su edit Modifica e poi procedi nel seguente modo:

     1. In Descrizione, inserisci una nuova descrizione.

     2. Fai clic su Invia.

5. Fai clic su edit Modifica o su edit Modifica bozza.

   Viene visualizzata la pagina per modificare la richiesta di prenotazione futura selezionata.

6. Per modificare una richiesta di prenotazione futura e inviarla a Google Cloud per la revisione o salvare la bozza della richiesta, svolgi una o più delle seguenti operazioni:

   • In Prefisso, inserisci un nuovo prefisso per i nomi delle prenotazioni create automaticamente per questa richiesta di prenotazione futura.

   • In Descrizione, inserisci una nuova descrizione.

   • Modifica l'ora di inizio o l'ora di fine per la tua futura richiesta di prenotazione. Assicurati di quanto segue:

     • 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.

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

     • Specifica un periodo di prenotazione minimo consigliato per aumentare le 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 Condiviso, puoi aggiungere o rimuovere progetti con cui condividere la richiesta di prenotazione futura. Puoi includere fino a 100 progetti.

   • In Numero di istanze VM, inserisci il numero totale di VM che vuoi prenotare.

   • Se stai modificando una prenotazione futura che non è stata creata tramite un modello di istanze, nella sezione Configurazione macchina puoi modificare quanto segue:

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

     • Le GPU da collegare alle VM riservate.

     • I dischi SSD locali e il tipo di interfaccia dei dischi delle VM riservate.

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

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

   • Se stai modificando una bozza di richiesta di prenotazione futura, svolgi una delle seguenti operazioni:

     • 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.

   • In caso contrario, fai clic su Invia.

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

gcloud

Per modificare una richiesta di prenotazione futura, 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 \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform=MIN_CPU_PLATFORM \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --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 della futura richiesta di prenotazione.

• PLANNING_STATUS: lo stato di pianificazione della richiesta di prenotazione futura. Specifica uno dei seguenti valori:

  • Per modificare una bozza di richiesta di prenotazione futura senza inviarla per la revisione: DRAFT.

  • Per inviare la richiesta di prenotazione futura per la revisione: SUBMITTED.

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

Sostituisci uno o più dei seguenti segnaposto o rimuovili insieme ai relativi flag:

• Per consentire a Compute Engine di eliminare automaticamente le prenotazioni create automaticamente dopo l'ora di fine del periodo di prenotazione, svolgi una delle seguenti operazioni:

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

    gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
        --auto-delete-auto-created-reservations \
        --planning-status=PLANNING_STATUS \
        --zone=ZONE
    

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

    gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
        --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
        --auto-delete-auto-created-reservations \
        --planning-status=PLANNING_STATUS \
        --zone=ZONE
    

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

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

    gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
        --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
        --auto-delete-auto-created-reservations \
        --planning-status=PLANNING_STATUS \
        --zone=ZONE
    

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

• Per impedire a Compute Engine di eliminare automaticamente le prenotazioni create automaticamente di cui è stato eseguito il provisioning per questa richiesta di prenotazione futura, includi il flag --no-auto-delete-auto-created-reservations.

  gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
      --no-auto-delete-auto-created-reservations \
      --planning-status=PLANNING_STATUS \
      --zone=ZONE
  

• Per aggiungere o rimuovere GPU collegate a VM N1 riservate o aggiornare il tipo di GPU, svolgi una delle seguenti operazioni:

  • Per modificare il numero e il tipo di GPU, sostituisci quanto segue:

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

    • ACCELERATOR_TYPE: il tipo di GPU da aggiungere alle VM riservate. Assicurati che la GPU sia disponibile nella zona in cui si trova la richiesta di prenotazione futura. In caso contrario, la modifica della richiesta non andrà a buon fine.

  • Per rimuovere tutte le GPU collegate alle VM N1 riservate, sostituisci il --accelerator flag con il --clear-accelerator flag.

• DESCRIPTION: una nuova descrizione per le tue future richieste di prenotazione.

• Per aggiungere o rimuovere dischi SSD locali dalle VM riservate o modificare il tipo di interfaccia del disco SSD locale, svolgi una delle seguenti operazioni:

  • Per aggiungere dischi SSD locali o modificare il tipo di interfaccia del disco, sostituisci INTERFACE con uno dei seguenti valori:

    • Se l'immagine del disco di avvio include driver NVMe ottimizzati: nvme.

    • In caso contrario: scsi.

    Includi il flag --local-ssd per tutti i dischi SSD locali che vuoi aggiungere. Puoi specificare un massimo di 24 dischi SSD locali.

  • Per rimuovere tutti i dischi SSD locali collegati alle VM riservate, rimuovi tutti i flag --local-ssd e includi il flag --clear-local-ssd.

• MACHINE_TYPE: il nuovo tipo di macchina da utilizzare per ogni VM riservata. Se cambi il tipo di macchina, assicurati di specificare anche un periodo di prenotazione minimo consigliato per la nuova serie di macchine. In caso contrario, Google Cloud potrebbe rifiutare la tua richiesta di modifica.

• MINIMUM_CPU_PLATFORM: una nuova piattaforma CPU minima da utilizzare per ogni VM prenotata.

• NAME_PREFIX: un nuovo prefisso del nome per le prenotazioni create automaticamente per la tua richiesta di prenotazione futura.

• SHARE_SETTING: un nuovo tipo di condivisione per le tue future richieste di prenotazione. Specifica uno dei seguenti valori:

  • Per una richiesta di prenotazione futura per un singolo progetto: local. Per evitare errori, devi anche sostituire il flag --share-with con il flag --clear-share-settings.

  • Per una richiesta di prenotazione futura condivisa: projects. Per evitare errori, devi anche specificare almeno un progetto consumer nel flag --share-with.

• CONSUMER_PROJECT_IDS: un elenco separato da virgole di ID di progetti con cui vuoi condividere la tua futura richiesta di prenotazione, ad esempio project-1,project-2. Puoi specificare fino a 100 progetti consumer.

• START_TIME: la nuova ora di inizio del periodo di prenotazione formattata come timestamp RFC 3339. La data e l'ora di inizio non possono essere successive a un anno dalla data e dall'ora in cui invii la richiesta di modifica per la revisione. Per avere tempo sufficiente per cancellare, eliminare o modificare facoltativamente una prenotazione futura dopo che è stata approvata e prima che entri nel relativo orario di blocco, specifica un'ora di inizio consigliata.

• END_TIME: 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. Sostituisci END_DURATION con la durata del periodo di prenotazione in secondi. Per aumentare la probabilità che Google Cloud approvi una richiesta di prenotazione futura dopo che l'hai inviata per la revisione, specifica un periodo di prenotazione consigliato.

• TOTAL_COUNT: il nuovo numero totale di VM che vuoi prenotare per il periodo, la configurazione della VM e i progetti specificati nella richiesta di prenotazione futura. Se vuoi aumentare il conto totale, assicurati di disporre di una quota sufficiente per le risorse che stai riservando. In caso contrario, Google Cloud rifiuta la richiesta di modifica.

Ad esempio, prendi in considerazione una bozza di richiesta di prenotazione futura condivisa denominata fr-03 e situata nella zona us-central1-a. Supponiamo che tu voglia modificare questa richiesta di prenotazione futura condivisa apportando le seguenti modifiche:

• Converti la richiesta 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 la revisione.

Per modificare fr-03, esegui il seguente comando:

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

REST

Per modificare una richiesta di prenotazione futura, invia una richiesta PATCH al metodo beta.futureReservations.update.

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

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

• FUTURE_RESERVATION_NAME: il nome della futura richiesta di prenotazione.

• UPDATE_FIELDS: un elenco separato da virgole di campi da actualizare nel corpo della richiesta. Devi codificare ogni virgola come %2C. Se specifichi un campo nel parametro di query updateMask e nel corpo della richiesta, il valore del campo viene aggiornato. In caso contrario, se specifichi il campo solo nel parametro di query updateMask, il campo viene eliminato.

  Ad esempio, per aggiornare i campi autoDeleteAutoCreatedReservations, totalCount e endTime nella richiesta di prenotazione futura, specifica quanto segue:

  autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
  

• PLANNING_STATUS: lo stato di pianificazione della richiesta di prenotazione futura. Specifica uno dei seguenti valori:

  • Per modificare una bozza di richiesta di prenotazione futura senza inviarla per la revisione: DRAFT.

  • Per inviare la richiesta di modifica per la revisione: SUBMITTED.

Sostituisci uno o più dei seguenti segnaposto o rimuovili insieme ai campi corrispondenti:

• AUTO_DELETE_AUTO_CREATED_RESERVATIONS: se imposti questo campo su true, Compute Engine elimina automaticamente le prenotazioni create automaticamente per la tua richiesta di prenotazione futura. Per impostazione predefinita, l'eliminazione avviene entro due ore dall'ora di fine del periodo di prenotazione. Per modificare questa impostazione, procedi nel seguente modo:

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

    PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime%2CplanningStatus
    
    {
      "autoDeleteAutoCreatedReservations": "true",
      "autoCreatedReservationsDeleteTime": "DELETE_TIME",
      "name": "FUTURE_RESERVATION_NAME",
      "planningStatus": "PLANNING_STATUS"
    }
    

    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.

  • Per eliminare le prenotazioni create automaticamente dopo una durata specifica dalla data e 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/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration%2CplanningStatus
    
    {
      "autoDeleteAutoCreatedReservations": "true",
      "autoCreatedReservationsDuration": {
        "seconds": "DURATION_BEFORE_DELETE"
      },
      "name": "FUTURE_RESERVATION_NAME",
      "planningStatus": "PLANNING_STATUS"
    }
    

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

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

• NAME_PREFIX: un nuovo prefisso del nome per le prenotazioni create automaticamente per la tua richiesta di prenotazione futura.

• CONSUMER_PROJECT_ID_1 e CONSUMER_PROJECT_ID_2: gli ID dei progetti con cui vuoi condividere la richiesta di prenotazione futura. I progetti devono appartenere alla stessa organizzazione del progetto proprietario. Puoi specificare fino a 100 progetti consumer.

• SHARE_TYPE: un nuovo tipo di condivisione per le tue future richieste di prenotazione. Esegui una di queste operazioni:

  • Per specificare una richiesta di prenotazione futura per un singolo progetto, procedi come segue:

    • Specifica LOCAL.

    • Rimuovi il campo shareSettings.projects.

  • Per specificare una richiesta di prenotazione futura condivisa, svolgi i seguenti passaggi:

    • Specifica SPECIFIC_PROJECTS.

    • Specifica almeno un progetto consumer nel shareSettings.projects campo. I progetti consumer devono appartenere alla stessa organizzazione del progetto proprietario. Puoi specificare fino a 100 progetti per consumatori.

• Per modificare il numero e il tipo di GPU da collegare alle VM N1 riservate, sostituire quanto segue:

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

  • ACCELERATOR_TYPE: il tipo di GPU da aggiungere alle VM riservate. Assicurati che la GPU sia disponibile nella zona in cui si trova la richiesta di prenotazione futura. In caso contrario, la modifica della richiesta non andrà a buon fine.

• INTERFACE_1 e INTERFACE_2: il tipo di interfaccia dei dischi SSD locali collegati a ogni VM riservata. Specifica uno dei seguenti valori:

  • Se l'immagine del disco di avvio include driver NVMe ottimizzati: NVME.

  • In caso contrario: SCSI.

    Puoi specificare un massimo di 24 dischi SSD locali.

• MACHINE_TYPE: il nuovo tipo di macchina da utilizzare per ogni VM riservata. Se modifichi il tipo di macchina, assicurati di specificare anche un periodo di prenotazione minimo consigliato per la nuova serie di macchine. In caso contrario, Google Cloud ha meno probabilità di approvare la tua richiesta di modifica.

• MINIMUM_CPU_PLATFORM: una nuova piattaforma CPU minima da utilizzare per ogni VM prenotata.

• TOTAL_COUNT: 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. Se vuoi aumentare il conto totale, assicurati di disporre di una quota sufficiente per le risorse che stai riservando. In caso contrario, Google Cloud rifiuta la richiesta di modifica.

• START_TIME: la nuova ora di inizio del periodo di prenotazione formattata come timestamp RFC 3339. La data e l'ora di inizio non possono essere successive a un anno dalla data e dall'ora in cui invii la richiesta di modifica per la revisione. Per avere tempo sufficiente per cancellare, eliminare o modificare facoltativamente una prenotazione futura dopo che è stata approvata e prima che entri nel relativo orario di blocco, specifica un'ora di inizio consigliata.

• END_TIME: 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 dalla data di inizio del periodo di prenotazione:

  PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=timeWindow.duration%2CplanningStatus
  
  {
    "name": "FUTURE_RESERVATION_NAME",
    "planningStatus": "PLANNING_STATUS",
    "timeWindow": {
      "duration": {
        "seconds": "END_DURATION"
      }
    }
  }
  

  Sostituisci END_DURATION con una durata in secondi. Ad esempio, specifica 1209600 per 1.209.600 secondi (14 giorni). Per aumentare la probabilità che Google Cloud approvi una richiesta di prenotazione futura dopo che l'hai inviata per la revisione, specifica un periodo di prenotazione consigliato.

Ad esempio, prendi in considerazione una bozza di richiesta di prenotazione futura condivisa denominata fr-03 e situata nella zona us-central1-a. Supponiamo che tu voglia modificare questa richiesta di prenotazione futura condivisa apportando le seguenti modifiche:

• Converti la richiesta 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 la revisione.

Per modificare fr-03, effettua una richiesta PATCH come segue:

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"
  }
}