Modifica prenotazioni

Questo documento spiega come modificare una prenotazione esistente.

Se vuoi modificare una prenotazione condivisa, devi utilizzare il progetto del proprietario.

Se vuoi modificare una prenotazione collegata a un impegno, consulta Sostituire le prenotazioni collegate agli impegni .

Prima di iniziare

  • Leggi lo requisiti e limitazioni per le prenotazioni.
  • Se non l'hai già fatto, configura l'autenticazione. Autenticazione è Il processo di verifica dell'identità per l'accesso ai servizi e alle API di Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi eseguire l'autenticazione Compute Engine come segue.

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

    Console

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

    gcloud

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

      gcloud init
    2. Set a default region and zone.

      3. REST

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

        Installa Google Cloud CLI, quindi initialize eseguendo questo comando: 

        gcloud init

      Per ulteriori informazioni, vedi Esegui l'autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per modificare le prenotazioni, chiedi all'amministratore di concederti Ruolo IAM Amministratore computing (roles/compute.admin) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Questo ruolo predefinito contiene le autorizzazioni necessarie per modificare le prenotazioni. Per vedere le autorizzazioni esatte obbligatorie, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per modificare le prenotazioni sono necessarie le seguenti autorizzazioni:

  • Per modificare l'opzione di eliminazione automatica in una prenotazione o nei progetti consumer in una prenotazione condivisa: compute.reservations.update del progetto
  • Per modificare il numero di VM in una prenotazione: compute.reservations.resize del progetto

Potresti anche riuscire a ottenere queste autorizzazioni con ruoli personalizzati e altri ruoli predefiniti.

Modifica prenotazioni

Per modificare direttamente una prenotazione esistente, puoi eseguire una o più delle seguenti operazioni seguenti:

Se vuoi modificare le proprietà non menzionate in questo elenco, consulta Modificare altre proprietà in una prenotazione in questo documento.

Modificare l'eliminazione automatica di una prenotazione

Puoi modificare il momento in cui Compute Engine elimina automaticamente un modello esistente effettuando una delle seguenti operazioni:

  • Attiva l'opzione di eliminazione automatica o modifica il momento in cui la prenotazione viene eliminati automaticamente.

  • Disattiva l'opzione di eliminazione automatica.

Per modificare l'eliminazione automatica di una prenotazione, seleziona una delle seguenti opzioni opzioni:

Console

Per modificare l'eliminazione automatica di una prenotazione:

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

    Vai a Prenotazioni

  2. Nella colonna Nome, fai clic sul nome della prenotazione che ti interessa. da modificare.

    Si apre la pagina dei dettagli della prenotazione selezionata.

  3. Nella riga Ora di eliminazione automatica, fai clic su Modifica ora di eliminazione automatica.

  4. Nel riquadro Aggiorna prenotazione, esegui una delle seguenti operazioni:

    • Per eliminare la prenotazione in una data e un'ora specifiche, procedi come segue seguenti:

      1. Se l'opzione di eliminazione automatica non è già attivata, fai clic sull'icona Attiva l'opzione Attiva l'eliminazione automatica.

      2. Nel campo Ora di eliminazione automatica, inserisci una data e un'ora quando Compute Engine elimina automaticamente la prenotazione.

    • In caso contrario, disattiva l'opzione Attiva l'eliminazione automatica. posizione.

  5. Fai clic su Invia.

    La modifica della prenotazione potrebbe richiedere alcuni secondi.

gcloud

Quando abiliti l'opzione di eliminazione automatica in una prenotazione, puoi specificare Data e ora in cui la prenotazione deve essere eliminata o specifica una durata dopodiché deve essere eliminata la prenotazione.

Per abilitare l'opzione di eliminazione automatica o modificare il momento in cui deve essere effettuata la prenotazione eliminati, esegui una delle seguenti operazioni:

  • Per eliminare la prenotazione in una data e un'ora specifiche, utilizza il Comando gcloud beta compute reservations update con il flag --delete-at-time.

    gcloud beta compute reservations update RESERVATION_NAME \
    --delete-at-time=DELETE_AT_TIME \
    --project=PROJECT_ID \
    --zone=ZONE

    Sostituisci quanto segue:

    • RESERVATION_NAME: il nome di un elemento esistente prenotazione.

    • DELETE_AT_TIME: una data e un'ora formattate come Timestamp RFC 3339, che indica deve essere:

      YYYY-MM-DDTHH:MM:SSOFFSET

      Sostituisci quanto segue:

      • YYYY-MM-DD: una data formattata come quattro cifre anno, mese a due cifre e giorno del mese a due cifre, separati per trattini (-).

      • HH:MM:SS: un'ora nel formato a due cifre utilizzando un orario di 24 ore, minuti a 2 cifre e secondi a 2 cifre, separate dai due punti (:).

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

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

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

  • Per eliminare la prenotazione dopo un determinato periodo di tempo, utilizza il metodo Comando gcloud beta compute reservations update con il flag --delete-after-duration.

    gcloud beta compute reservations update RESERVATION_NAME \
    --delete-after-duration=DELETE_AFTER_DURATION \
    --project=PROJECT_ID \
    --zone=ZONE

    Sostituisci quanto segue:

    • RESERVATION_NAME: il nome di un elemento esistente prenotazione.

    • DELETE_AFTER_DURATION: una durata in giorni, ore minuti o secondi prima che la prenotazione venga eliminata automaticamente. Ad esempio, specifica 30m per 30 minuti o 1d2h3m4s per 1 giorno, 2 ore, 3 minuti e 4 secondi.

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

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

Per disattivare l'opzione di eliminazione automatica, utilizza il Comando gcloud beta compute reservations update con il flag --disable-auto-delete.

gcloud beta compute reservations update RESERVATION_NAME \
    --disable-auto-delete \
    --project=PROJECT_ID \
    --zone=ZONE

Sostituisci quanto segue:

  • RESERVATION_NAME: il nome di un elemento esistente prenotazione.

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

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

REST

Quando abiliti l'opzione di eliminazione automatica in una prenotazione, puoi specificare Data e ora in cui la prenotazione deve essere eliminata o specifica una durata dopodiché deve essere eliminata la prenotazione.

Per abilitare l'opzione di eliminazione automatica o modificare il momento in cui la prenotazione deve essere eliminati, esegui una delle seguenti operazioni:

  • Per eliminare la prenotazione in una data e un'ora specifiche, crea un PATCH richiesta alla Metodo beta.reservations.update con il parametro di query paths impostato su deleteAtTime.

    PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAtTime

{
  "name": "RESERVATION_NAME",
  "deleteAtTime": "DELETE_AT_TIME"
}

    Sostituisci quanto segue:

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

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

    • RESERVATION_NAME: il nome di un elemento esistente prenotazione.

    • DELETE_AT_TIME: una data e un'ora formattate come Timestamp RFC 3339, che indica deve essere:

      YYYY-MM-DDTHH:MM:SSOFFSET

      Sostituisci quanto segue:

      • YYYY-MM-DD: una data formattata come quattro cifre anno, mese a due cifre e giorno del mese a due cifre, separati per trattini (-).

      • HH:MM:SS: un'ora nel formato a due cifre utilizzando un orario di 24 ore, minuti a 2 cifre e secondi a 2 cifre, separate dai due punti (:).

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

  • Per eliminare la prenotazione dopo un determinato periodo di tempo, crea una PATCH richiesta alla Metodo beta.reservations.update con il parametro di query paths impostato su deleteAfterDuration.

    PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAfterDuration

{
  "name": "RESERVATION_NAME",
  "deleteAfterDuration": {
    "seconds": "DELETE_AFTER_DURATION"
  }
}

    Sostituisci quanto segue:

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

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

    • RESERVATION_NAME: il nome di un elemento esistente prenotazione.

    • DELETE_AFTER_DURATION: durata in secondi prima dell'eliminazione automatica della prenotazione. Ad esempio: specifica 86400 per 86.400 secondi (1 giorno).

Per disattivare l'opzione di eliminazione automatica, invia una richiesta PATCH a Metodo beta.reservations.update. Nella richiesta, specifica paths=deleteAtTime&paths=deleteAfterDuration e ometti il parametro di query corpo della richiesta.

PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAtTime&paths=deleteAfterDuration

Sostituisci quanto segue:

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

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

  • RESERVATION_NAME: il nome di un elemento esistente prenotazione.

Modificare i progetti consumer in una prenotazione condivisa

Puoi consentire ai progetti di utilizzare una prenotazione condivisa solo se questi progetti si trovano nella stessa organizzazione del progetto del proprietario. Per scoprire come eseguire la migrazione di un progetto nell'organizzazione del progetto proprietario, consulta Migrazione dei progetti tra risorse dell'organizzazione nella documentazione di Resource Manager.

Dopo aver modificato i progetti consumer che possono essere utilizzati in una prenotazione condivisa, del consumo della prenotazione potrebbe cambiare. Ad esempio, qualsiasi consumatore rimosso smette di utilizzare le risorse della prenotazione. Inoltre, se configurata per essere consumata automaticamente da qualsiasi VM corrispondente proprietà della prenotazione (comportamento predefinito), quindi qualsiasi consumer aggiunto potrebbe iniziare a consumare risorse della prenotazione. Se vuoi monitorare il consumo di una prenotazione, scopri come verificare il consumo delle prenotazioni.

Per modificare i progetti consumer che possono utilizzare una prenotazione condivisa, seleziona una delle seguenti opzioni:

Console

Per modificare i progetti consumer per una prenotazione condivisa, segui questi passaggi: passaggi:

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

    Vai a Prenotazioni

  2. Nella colonna Nome, fai clic sul nome della prenotazione da a descrivere.

    Si apre la pagina dei dettagli della prenotazione.

  3. Fai clic su Modifica.

  4. Nella sezione Progetti selezionati, esegui una delle seguenti operazioni:

    • Per interrompere la condivisione della prenotazione con un progetto consumer specifico, fai clic su Elimina.

    • Per iniziare a condividere la prenotazione con uno o più progetti specifici, procedi nel seguente modo:

      1. Fai clic su Aggiungi progetti.

      2. Seleziona la casella di controllo per ogni progetto dall'account del organizzazione con cui vuoi condividere la prenotazione.

      3. Fai clic su Seleziona.

  5. Per confermare le modifiche, fai clic su Salva.

    La modifica della prenotazione potrebbe richiedere alcuni secondi.

gcloud

Quando modifichi i progetti consumer per una prenotazione condivisa, devi specificare un elenco separato da virgole di ID dei progetti da consentire; oppure non consentire più l'accesso, per utilizzare la prenotazione condivisa. Questi progetti devono trovarsi della stessa organizzazione del progetto proprietario. Non specificare il progetto proprietario nell'elenco. Per impostazione predefinita, è già autorizzato a utilizzare prenotazione.

Per modificare i progetti consumer per una prenotazione condivisa, seleziona una delle seguenti metodi:

  • Per consentire a uno o più progetti di utilizzare una prenotazione condivisa, utilizza il Comando gcloud compute reservations update con il flag --add-share-with.

    gcloud compute reservations update RESERVATION_NAME \
    --project=PROJECT_ID \
    --add-share-with=CONSUMER_PROJECT_IDS \
    --zone=ZONE

    Sostituisci quanto segue:

    • RESERVATION_NAME: il nome di un elemento condiviso esistente prenotazione.

    • PROJECT_ID: l'ID del progetto proprietario, che è al progetto utilizzato per creare la prenotazione condivisa.

    • CONSUMER_PROJECT_IDS: un elenco separato da virgole di ID dei progetti con cui condividere la prenotazione. Ad esempio, specifica project-1,project-2.

    • ZONE: la zona in cui si trova la prenotazione condivisa individuarlo.

  • Per interrompere l'utilizzo di una prenotazione condivisa da parte di uno o più progetti, utilizza la Comando gcloud compute reservations update con il flag --remove-share-with.

    gcloud compute reservations update RESERVATION_NAME \
    --project=PROJECT_ID \
    --remove-share-with=CONSUMER_PROJECT_IDS \
    --zone=ZONE

    Sostituisci quanto segue:

    • RESERVATION_NAME: il nome di un elemento condiviso esistente prenotazione.

    • PROJECT_ID: l'ID del progetto proprietario, che è al progetto utilizzato per creare la prenotazione condivisa.

    • CONSUMER_PROJECT_IDS: un elenco separato da virgole di ID dei progetti con cui vuoi interrompere la condivisione della prenotazione. Ad esempio, specifica project-1,project-2.

    • ZONE: la zona in cui si trova la prenotazione condivisa individuarlo.

  • Per sostituire l'elenco di progetti che possono utilizzare una prenotazione condivisa, utilizza la Comando gcloud beta compute reservations update con il flag --share-with.

    gcloud beta compute reservations update RESERVATION_NAME \
    --project=PROJECT_ID \
    --share-with=CONSUMER_PROJECT_IDS \
    --zone=ZONE

    Sostituisci quanto segue:

    • RESERVATION_NAME: il nome di un elemento condiviso esistente prenotazione.

    • PROJECT_ID: l'ID del progetto proprietario, che è al progetto utilizzato per creare la prenotazione condivisa.

    • ZONE: la zona in cui si trova la prenotazione condivisa individuarlo.

    • CONSUMER_PROJECT_IDS: un elenco separato da virgole di ID dei progetti con cui condividere la prenotazione. Ad esempio, specifica project-1,project-2.

REST

Quando modifichi i progetti consumer per una prenotazione condivisa, devi specificare gli ID dei progetti che vuoi autorizzare o meno la prenotazione condivisa. Questi progetti devono trovarsi nello stesso dell'organizzazione come progetto proprietario. Non specificare il progetto proprietario. Di per impostazione predefinita, è già autorizzato a utilizzare la prenotazione condivisa.

Per modificare i progetti consumer per una prenotazione condivisa, seleziona una delle seguenti metodi:

  • Per consentire a uno o più progetti di utilizzare una prenotazione condivisa, crea una Richiesta di PATCH inviata a Metodo reservations.update. Nell'URL della richiesta, includi il parametro paths=shareSettings.projectMap.PROJECT_ID query per ogni progetto con cui vuoi condividere la prenotazione.

    Ad esempio, per consentire a due progetti di utilizzare una prenotazione condivisa, la seguente richiesta di PATCH:

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.projectMap.CONSUMER_PROJECT_ID_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_ID_2

{
  "name": "RESERVATION_NAME",
  "shareSetting": {
    "projectMap": {
      "CONSUMER_PROJECT_ID_1": {
        "projectId": "CONSUMER_PROJECT_ID_1"
      },
      "CONSUMER_PROJECT_ID_2": {
        "projectId": "CONSUMER_PROJECT_ID_2"
      }
    }
  }
}

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del progetto proprietario, che è al progetto utilizzato per creare la prenotazione condivisa.

    • ZONE: la zona in cui si trova la prenotazione condivisa individuarlo.

    • RESERVATION_NAME: il nome di un elemento condiviso esistente prenotazione.

    • CONSUMER_PROJECT_ID_1 e CONSUMER_PROJECT_ID_2: gli ID di due progetti con cui vuoi condividere la prenotazione.

  • Per interrompere l'utilizzo di una prenotazione condivisa da parte di uno o più progetti, invia una richiesta PATCH a Metodo reservations.update. Nell'URL della richiesta, includi il parametro paths=shareSettings.projectMap.PROJECT_ID query per ogni progetto per cui vuoi interrompere la condivisione della prenotazione con. Inoltre, devi omettere il campo shareSetting dalla corpo della richiesta.

    Ad esempio, per interrompere l'utilizzo di un'istanza condivisa tra due progetti effettua la seguente richiesta PATCH:

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.projectMap.CONSUMER_PROJECT_ID_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_ID_2

{
  "name": "RESERVATION_NAME"
}

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del progetto proprietario, che è al progetto utilizzato per creare la prenotazione condivisa.

    • ZONE: la zona in cui si trova la prenotazione condivisa individuarlo.

    • RESERVATION_NAME: il nome di un elemento condiviso esistente prenotazione.

    • CONSUMER_PROJECT_ID_1 e CONSUMER_PROJECT_ID_2: gli ID di due progetti con cui vuoi interrompere la condivisione della prenotazione.

Modificare il numero di VM prenotate in una prenotazione

Puoi modificare una prenotazione esistente per aumentare o diminuire il numero di le VM prenotate.

Prima di modificare il numero di VM prenotate in una prenotazione, assicurati che seguenti:

  • Se vuoi aumentare il numero di VM prenotate in una prenotazione, si applicano le seguenti limitazioni:

    • Devono essere presenti risorse sufficienti nella zona in cui viene effettuata la prenotazione individuarlo.

    • Devi disporre di una quota sufficiente per le risorse aggiuntive che utilizzi prenotazione.

  • Se la tua prenotazione tipo di consumo sono specifici e vuoi ridurre il numero di VM prenotate degli annunci, assicurati che il numero di VM che utilizzano la prenotazione non superi le dimensioni della prenotazione che vuoi. Tu possono farlo con i seguenti metodi:

    Altrimenti, riscontrerai errori.

Per modificare il numero di VM prenotate in una prenotazione, seleziona una delle le seguenti opzioni:

Console

Per modificare il numero di VM prenotate in una prenotazione:

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

    Vai a Prenotazioni

  2. Nella colonna Nome, fai clic sul nome della prenotazione che ti interessa. da modificare.

    Si apre la pagina dei dettagli della prenotazione.

  3. Fai clic su Modifica.

  4. Nel campo Numero di istanze VM, inserisci il numero aggiornato di VM. per prenotare.

  5. Per confermare, fai clic su Salva.

    La modifica della prenotazione potrebbe richiedere alcuni secondi.

gcloud

Per modificare il numero di VM prenotate in una prenotazione, utilizza Comando gcloud compute reservations update.

gcloud compute reservations update RESERVATION_NAME \
    --project=PROJECT_ID \
    --vm-count=NUMBER_OF_VMS \
    --zone=ZONE

Sostituisci quanto segue:

  • RESERVATION_NAME: il nome di una prenotazione esistente.

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

  • NUMBER_OF_VMS: il nuovo numero di VM da prenotare.

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

REST

Per modificare il numero di VM prenotate in una prenotazione, effettua una richiesta POST alla Metodo reservations.resize.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/resize

{
  "specificSkuCount": "NUMBER_OF_VMS"
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui è stata effettuata la prenotazione in cui viene localizzato.

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

  • RESERVATION_NAME: il nome di una prenotazione esistente.

  • NUMBER_OF_VMS: il nuovo numero di VM da prenotare.

Modificare altre proprietà in una prenotazione

Se vuoi modificare una proprietà non menzionata nel Modificare le prenotazioni devi creare una prenotazione sostitutiva.

Per sostituire una prenotazione senza correre il rischio di una riduzione involontaria delle capacità riservata, segui questi passaggi:

  1. Crea un nuovo elemento progetto singolo o prenotazione condivisa con le proprietà aggiornate.

  2. Se la prenotazione originale non ti serve più: eliminare la prenotazione.

Passaggi successivi