Questa pagina è stata tradotta dall'API Cloud Translation.

Modificare le richieste di prenotazione futura

Questo documento spiega come modificare le richieste di prenotazione future.

Puoi modificare una richiesta di prenotazione futura in qualsiasi momento prima dell'orario di inizio, a condizione che non sia stata annullata o non sia in attesa di approvazione. La modifica di una richiesta di prenotazione futura è utile quando le tue esigenze di capacità cambiano, ad esempio quando vuoi aumentare il numero di istanze di macchine virtuali (VM) prenotate o modificare il periodo di prenotazione. Se vuoi modificare una richiesta di prenotazione futura condivisa, devi modificare la richiesta utilizzando il progetto del proprietario.

Per modificare una prenotazione creata automaticamente al termine del relativo periodo di prenotazione, consulta Modificare le prenotazioni.

Prima di iniziare

Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è la procedura mediante la quale la tua identità viene verificata per l'accesso alle API e ai servizi Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:

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

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
1. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

Ruoli obbligatori

Per ottenere l'autorizzazione necessaria per modificare le richieste di prenotazione futura, chiedi all'amministratore di concederti il ruolo IAM Amministratore delle prenotazioni future di Compute (roles/compute.futureReservationAdmin) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l'autorizzazione compute.futureReservations.update necessaria per modificare le richieste di prenotazione future.

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Proprietà modificabili

Una richiesta di prenotazione futura ha diverse proprietà che definiscono la prenotazione, ne determinano il comportamento e specificano le risorse da prenotare. Puoi modificare queste proprietà come descritto nelle sezioni seguenti.

Dopo la creazione

Dopo aver creato una richiesta di prenotazione futura, non puoi modificare le seguenti proprietà:

Il nome della richiesta di prenotazione futura.
Il progetto in cui è stata creata la richiesta di prenotazione futura.
La zona in cui si trova la richiesta di prenotazione futura.
Il modello di istanza da utilizzare e le proprietà della VM specificate nel modello di istanza.

Per modificare una di queste proprietà prima che una richiesta di prenotazione futura raggiunga il suo tempo di blocco, crea una nuova richiesta.

Prima dell'invio

Prima di inviare una richiesta di prenotazione futura a Google Cloud per la revisione o dopo aver inviato una richiesta di prenotazione futura per la revisione e la richiesta è stata rifiuta, puoi modificare le seguenti proprietà:

Opzione di eliminazione automatica
Descrizione
GPU e tipo di GPU
Dischi SSD locali e tipo di interfaccia dei dischi
Serie e tipo di macchina
Piattaforma CPU minima
Prefisso nome
Impostazioni di condivisione
Ora di inizio e di fine del periodo di prenotazione
Conteggio totale (numero di VM)

La modifica dello stato di una bozza di richiesta di prenotazione futura è immediata e non esistono limiti al numero di volte in cui puoi modificarla. Se stai modificando una richiesta di prenotazione futura rifiutata (DECLINED), puoi modificarla solo se la invii di nuovo per la revisione.

Dopo l'approvazione

Dopo che Google Cloud ha approvato una prenotazione futura, puoi modificarla prima che la prenotazione futura raggiunga lo stato di approvvigionamento del provisioning (PROVISIONING). Nello specifico, puoi modificare le seguenti proprietà:

Modificando la prenotazione futura in qualsiasi momento:
- Opzione di eliminazione automatica
- Descrizione
- Prefisso nome
Inviando una richiesta di modifica non prima di 72 ore prima dell'ora di inizio:
- GPU e tipo di GPU^*
- Dischi SSD locali e tipo di interfaccia dei dischi^*
- Serie 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 le proprietà delle VM o di aumentare o diminuire notevolmente il conteggio totale entro 14 giorni dall'ora di inizio della prenotazione futura, Google Cloud potrebbe rifiutare la tua richiesta di modifica.

Modificare le richieste di prenotazione futura

Prima di modificare una richiesta di prenotazione futura, controlla le proprietà che puoi modificare, se non l'hai già fatto.

Se vuoi modificare una richiesta di prenotazione futura di un singolo progetto creata tramite un modello di istanza in una richiesta di prenotazione futura condivisa, non puoi utilizzare lo stesso modello per creare VM che possono utilizzare le prenotazioni create automaticamente al di fuori del progetto che ha creato la richiesta di prenotazione futura condivisa. Per i progetti con cui è condivisa la prenotazione futura, devi creare modelli di istanze simili in questi progetti o creare VM specificando direttamente le proprietà.

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

Console

Nella console Google Cloud, vai alla pagina Prenotazioni.

Vai a Prenotazioni
Fai clic sulla scheda Prenotazioni future.
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.
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 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 modo che sia 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 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 Modifica e poi procedi nel seguente modo:
  1. In Descrizione, inserisci una nuova descrizione.
  2. Fai clic su Invia.
Fai clic su Modifica o su Modifica bozza.

Viene visualizzata la pagina per modificare la richiesta di prenotazione futura selezionata.
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. Verifica 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.
  
  Attenzione: se vuoi aumentare il numero di VM da prenotare, assicurati di disporre di una quota sufficiente per le risorse aggiuntive che stai chiedendo di prenotare. In caso contrario, Google Cloud declinerà la tua richiesta di modifica.
- 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.
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 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 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.

Importante: assicurati che il periodo di prenotazione non si sovrapponga al periodo di prenotazione di un'altra richiesta di prenotazione futura esistente con proprietà e zone VM corrispondenti e che sia stata creata nel tuo progetto attuale o sia condivisa con il tuo progetto attuale. In caso contrario, la modifica della richiesta di prenotazione futura non andrà a buon fine.
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 numero 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 dei 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 numero 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.

Importante: assicurati che il periodo di prenotazione non si sovrapponga al periodo di prenotazione di un'altra richiesta di prenotazione futura esistente con proprietà e zone VM corrispondenti e che sia stata creata nel tuo progetto attuale o sia condivisa con il tuo progetto attuale. In caso contrario, la modifica della richiesta di prenotazione futura non andrà a buon fine.

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

Dopo aver modificato una richiesta di prenotazione futura, puoi monitorarne lo stato di approvvigionamento o aggiornamento visualizzando i dettagli della richiesta.

Modificare altre proprietà in una richiesta di prenotazione futura

Per modificare le proprietà che non puoi modificare dopo aver creato una richiesta di prenotazione futura, e prima che la richiesta venga approvata e venga inserito il relativo orario di blocco, procedi nel seguente modo:

Per impedire alla richiesta di prenotazione futura di limitare il tipo di richieste di prenotazione futura che puoi creare nel tuo progetto o nei progetti con cui è condivisa, elimina la richiesta di prenotazione futura.
Crea una nuova richiesta di prenotazione futura per un singolo progetto o condivisa con gli aggiornamenti che preferisci.

Risoluzione dei problemi

Se si verificano errori durante la modifica di una richiesta di prenotazione futura, scopri come risolvere i problemi relativi alle richieste di prenotazione futura.

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

Passaggi successivi

Scopri come visualizzare le richieste di prenotazione future.
Scopri come annullare o eliminare le richieste di prenotazione future.
Dopo l'ora di inizio di un periodo di prenotazione, scopri come utilizzare le prenotazioni create automaticamente.
Dopo la data e l'ora di fine di un periodo di prenotazione, scopri come modificare le prenotazioni create automaticamente.