Modificare le richieste di prenotazione futura

Console

1. Nella console Trusted 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 Data/ora 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 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, segui questi passaggi:

          1. Fai clic sul pulsante di attivazione/disattivazione Abilita eliminazione automatica in modo che sia impostato su On.

          2. (Facoltativo) In Data/ora eliminazione automatica, inserisci una nuova data e un nuovo orario in cui eliminare le prenotazioni create automaticamente. La data e l'ora devono essere successive alla data/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 Abilita 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, quindi esegui le seguenti operazioni:

     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, quindi esegui le seguenti operazioni:

     1. In Descrizione, inserisci una nuova descrizione.

     2. Fai clic su Invia.

5. Fai clic su edit Modifica o 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 Trusted 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:

     • La data/ora di inizio non può essere successiva a un anno dalla data e dall'ora di invio della 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 tua prenotazione futura entri nel periodo di blocco.

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

   • Nella sezione Tipo di condivisione, puoi selezionare Locale o Condiviso. Se selezioni Condivisa, 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 template di istanza, 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.

     • 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 dell'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 Trusted Cloud per la revisione, fai clic su Invia.

   • In caso contrario, fai clic su Invia.

Se invii una richiesta di modifica, viene visualizzata la pagina Prenotazioni. In caso contrario, viene visualizzata 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 la data/ora di fine del periodo di prenotazione, svolgi una delle seguenti operazioni:

  • Per eliminare le prenotazioni entro due ore dalla data/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 la data/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 dalla data/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 va 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 richiesta di prenotazione futura.

• 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 contiene 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 prenotata. Se modifichi il tipo di macchina, specifica anche un periodo di prenotazione minimo consigliato per la nuova serie di macchine. In caso contrario, Trusted 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 richiesta di prenotazione futura.

• SHARE_SETTING: un nuovo tipo di condivisione per la tua richiesta di prenotazione futura. 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 richiesta di prenotazione futura, ad esempio project-1,project-2. Puoi specificare fino a 100 progetti consumer.

• START_TIME: la nuova data/ora di inizio del periodo di prenotazione formattata come timestamp RFC 3339. La data/ora di inizio non può essere successiva a un anno dalla data e dall'ora di invio della richiesta di modifica per la revisione. Per avere tempo sufficiente per annullare, eliminare o modificare facoltativamente una prenotazione futura dopo che è stata approvata e prima del periodo di blocco, specifica un orario di inizio consigliato.

• END_TIME: la nuova data/ora di fine del periodo di prenotazione formattata come timestamp RFC 3339. Per aumentare le probabilità che Trusted Cloud approvi la tua richiesta dopo l'invio, specifica un periodo di prenotazione minimo consigliato. Per specificare una durata anziché una data/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 delle VM e i progetti specificati nella 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, Trusted Cloud rifiuta la tua richiesta di modifica.

Ad esempio, considera una bozza di richiesta di prenotazione futura condivisa denominata fr-03 e che si trova 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 Trusted 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 di 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 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 in uno dei seguenti modi:

  • Per eliminare le prenotazioni create automaticamente a un'ora specifica successiva al termine 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/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 richiesta di prenotazione futura.

• NAME_PREFIX: un nuovo prefisso del nome per le prenotazioni create automaticamente di cui è stato eseguito il provisioning per la 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 la tua richiesta di prenotazione futura. Esegui una di queste operazioni:

  • Per specificare una richiesta di prenotazione futura per un singolo progetto, procedi nel seguente modo:

    • 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 va a buon fine.

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

  • Se l'immagine del disco di avvio contiene 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 prenotata. Se modifichi il tipo di macchina, specifica anche un periodo di prenotazione minimo consigliato per la nuova serie di macchine. In caso contrario, Trusted 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 delle 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, Trusted Cloud rifiuta la tua richiesta di modifica.

• START_TIME: la nuova data/ora di inizio del periodo di prenotazione formattata come timestamp RFC 3339. La data/ora di inizio non può essere successiva a un anno dalla data e dall'ora di invio della richiesta di modifica per la revisione. Per avere tempo sufficiente per annullare, eliminare o modificare facoltativamente una prenotazione futura dopo che è stata approvata e prima del periodo di blocco, specifica un orario di inizio consigliato.

• END_TIME: la nuova data/ora di fine del periodo di prenotazione formattata come timestamp RFC 3339. Per aumentare le probabilità che Trusted 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 che si trova 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 Trusted Cloud per la revisione.

Per modificare fr-03, invia 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"
  }
}