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

   Viene visualizzata 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, esegui 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 svolgi le seguenti operazioni:

     1. Specifica se vuoi attivare, disattivare o modificare l'opzione di eliminazione automatica procedendo in uno dei seguenti modi:

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

          1. Fai clic sul pulsante di attivazione/disattivazione Attiva eliminazione automatica per attivare l'opzione.

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

        • Altrimenti, fai clic sul pulsante di attivazione/disattivazione Attiva eliminazione automatica in modo che sia impostato su Off.

     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 edit Modifica bozza.

   Si apre 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, esegui una o più delle seguenti operazioni:

   • In Prefisso, inserisci un nuovo prefisso del nome per le prenotazioni create automaticamente di cui è stato eseguito il provisioning per questa richiesta di prenotazione futura.

   • In Descrizione, inserisci una nuova descrizione.

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

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

     • Specifica un valore consigliato per la data/ora di inizio per assicurarti di avere tempo sufficiente prima che la prenotazione futura entri nel periodo di blocco.

     • Specifica un periodo di prenotazione minimo consigliato per aumentare le probabilità che Google Cloud approvi la tua richiesta dopo l'invio per la revisione.

   • Nella sezione Tipo di condivisione, puoi selezionare Locale o Condiviso. 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 istanza, nella sezione Configurazione macchina puoi modificare quanto segue:

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

     • Le GPU da collegare alle VM prenotate.

     • I dischi SSD locali e il tipo di interfaccia del disco 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, esegui 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 apre 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 richiesta di prenotazione futura.

• 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 flag corrispondenti:

• 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 (impostazione predefinita), 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 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 ora formattata come timestamp RFC 3339.

  • Per eliminare le prenotazioni create automaticamente dopo un periodo di tempo specifico 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 alle VM N1 prenotate o aggiornare il tipo di GPU, esegui 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 prenotate. Verifica 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 prenotate, sostituisci il flag --accelerator con il flag --clear-accelerator.

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

• Per aggiungere o rimuovere dischi SSD locali dalle VM riservate o modificare il tipo di interfaccia del disco SSD locale, esegui 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 dispone di driver NVMe ottimizzati: nvme.

    • Altrimenti: 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 prenotate, 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 modifichi il tipo di macchina, specifica anche un periodo di prenotazione minimo consigliato per la nuova serie di macchine. In caso contrario, Google Cloud probabilmente rifiuterà 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 di cui è stato eseguito il provisioning per la tua futura richiesta di prenotazione.

• SHARE_SETTING: Un nuovo tipo di condivisione per la tua futura richiesta 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 specificare almeno un progetto consumer nel flag --share-with.

• CONSUMER_PROJECT_IDS: un elenco separato da virgole di ID dei 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. L'ora di inizio non può essere successiva a un anno dalla data e dall'ora in cui invii la richiesta di modifica per la revisione. Per avere tempo sufficiente di eventualmente annullare, eliminare o modificare una prenotazione futura dopo che è stata approvata e prima che entri nel periodo di blocco, specifica un orario di inizio consigliato.

• END_TIME: La nuova ora di fine del periodo di prenotazione formattata come timestamp RFC 3339. Per aumentare le probabilità che Google Cloud approvi la tua richiesta dopo l'invio, specifica un periodo di prenotazione minimo consigliato. Per specificare una durata anziché una data e ora di fine, sostituisci il flag --end-time con il flag --duration=END_DURATION. Sostituisci END_DURATION con la durata del periodo di prenotazione in secondi. Ad esempio, specifica 1209600 per 1.209.600 secondi (14 giorni).

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

Ad esempio, considera 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 questo 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 richiesta di prenotazione futura.

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

• FUTURE_RESERVATION_NAME: il nome della richiesta di prenotazione futura.

• UPDATE_FIELDS: un elenco separato da virgole dei campi da aggiornare 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, questo elimina il campo.

  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 di cui è stato eseguito il provisioning per la tua futura richiesta di prenotazione. Per impostazione predefinita, l'eliminazione avviene entro due ore dall'ora di fine del periodo di prenotazione. Per modificare questa impostazione, procedi in uno dei seguenti modi:

  • Per eliminare le prenotazioni create automaticamente a 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/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 un periodo di tempo specifico 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 di cui è stato eseguito il provisioning per la tua futura richiesta di prenotazione.

• 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 la tua futura richiesta di prenotazione. Esegui una di queste operazioni:

  • Per specificare una richiesta di prenotazione futura per un singolo progetto, segui questi passaggi:

    • Specifica LOCAL.

    • Rimuovi il campo shareSettings.projects.

  • Per specificare una richiesta di prenotazione futura condivisa:

    • Specifica SPECIFIC_PROJECTS.

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

• Per modificare il numero e il tipo di GPU da collegare alle VM N1 prenotate, 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 prenotate. Verifica 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 disco per i dischi SSD locali collegati a ogni VM riservata. Specifica uno dei seguenti valori:

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

  • Altrimenti: 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, specifica 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 VM e i progetti specificati in questa richiesta di prenotazione futura. Se vuoi aumentare il conteggio totale, verifica di disporre di una quota sufficiente per le risorse che stai prenotando. In caso contrario, Google Cloud rifiuta la tua richiesta di modifica.

• START_TIME: 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 la richiesta di modifica per la revisione. Per avere tempo sufficiente di eventualmente annullare, eliminare o modificare una prenotazione futura dopo che è stata approvata e prima che entri nel periodo di blocco, specifica un orario di inizio consigliato.

• END_TIME: La nuova ora di fine del periodo di prenotazione formattata come timestamp RFC 3339. Per aumentare le probabilità che Google Cloud approvi la tua richiesta dopo l'invio, specifica un periodo di prenotazione minimo. Per specificare una durata anziché una data e ora di fine, sostituisci il campo endTime con il campo duration:

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

Ad esempio, considera 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, invia una richiesta PATCH nel seguente modo:

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