Combinare le prenotazioni con sconti per impegno di utilizzo

Gli sconti per impegno di utilizzo (CUD) offrono prezzi molto scontati per le risorse Compute Engine in cambio di contratti per impegno di utilizzo di 1 o 3 anni (noti anche come impegni). Ti impegni per un utilizzo minimo delle risorse o una spesa minima e ricevi in cambio sconti per impegno di utilizzo (CUD) sui costi di utilizzo delle risorse. Tuttavia, gli impegni non riservano capacità a livello di zona per le risorse impegnate. Per ottenere risorse di zona a prezzi scontati e assicurarti che la capacità sia riservata per loro, devi acquistare impegni e creare prenotazioni per le risorse di zona.

Questo documento spiega come ricevere sconti per impegno di utilizzo (CUD) per le risorse prenotate e come collegare le prenotazioni agli impegni basati sulle risorse.

Prima di iniziare

• Esamina le nozioni di base sulle prenotazioni, i relativi requisiti e limitazioni. Per ulteriori informazioni, consulta Prenotazioni delle risorse di zona di Compute Engine.
• Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale viene verificata l'identità per l'accesso ai servizi e alle API Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti in Compute Engine nel seguente modo.
  

  Seleziona la scheda relativa a come prevedi di utilizzare gli esempi in questa pagina:

  Console

  Quando utilizzi la console Google Cloud per accedere ai servizi e alle API di Google Cloud, non devi configurare l'autenticazione.

  gcloud

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

     gcloud init

     Nota: se hai già installato gcloud CLI in precedenza, assicurati di disporre della versione più recente eseguendo gcloud components update.
  2. Imposta una regione e una zona predefinite.

  REST

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

  Installa Google Cloud CLI, quindi initialize eseguendo questo comando:

  gcloud init

Sconti per impegno di utilizzo (CUD) per le risorse prenotate

Ricevi sconti per impegno di utilizzo (CUD) dagli impegni attivi per qualsiasi utilizzo idoneo delle risorse nei tuoi progetti. Se hai anche prenotazioni per conservare la capacità per le risorse in quel progetto, gli sconti per impegno di utilizzo (CUD) degli impegni attivi possono essere applicati anche alle risorse prenotate. Affinché le risorse prenotate siano idonee a ricevere gli sconti per impegno di utilizzo (CUD), si applicano i seguenti requisiti:

• Non riceverai altre forme di sconto per il tuo utilizzo delle risorse.
• Le VM devono utilizzare le prenotazioni mentre gli impegni sono attivi.

• Come minimo, le seguenti proprietà devono corrispondere tra gli impegni attivi e le prenotazioni utilizzate dalle VM:

  • Progetto e regione a cui si applicano
  • Serie di famiglie di macchine

A seconda del tipo di risorsa, puoi ricevere sconti per impegno di utilizzo (CUD) per le risorse prenotate in uno dei seguenti modi:

• vCPU e memoria: per ricevere sconti per impegno di utilizzo (CUD) per uno o entrambi questi tipi di risorse, puoi acquistare impegni basati sulle risorse o sulla spesa che includono i tipi di risorse richiesti. Quando le VM nel tuo progetto utilizzano prenotazioni le cui proprietà corrispondono a questi impegni attivi, ricevi automaticamente gli sconti per impegno di utilizzo (CUD) applicabili per questi tipi di risorse prenotate. Se hai prenotato più risorse di quelle che hai impegnato, non riceverai sconti per impegno di utilizzo (CUD) per queste risorse aggiuntive.

• GPU e dischi SSD locali: per ricevere sconti per impegno di utilizzo (CUD) per uno o entrambi i tipi di risorse, devi:

  • Acquista impegni basati sulle risorse che includono i tipi di risorse richiesti.
  • Crea prenotazioni per tutte le risorse impegnate con proprietà che corrispondono al tuo impegno e collega queste prenotazioni all'impegno.

  Quando le VM nel tuo progetto consumano queste prenotazioni collegate, inizi a ricevere gli sconti per impegno di utilizzo (CUD) applicabili per questi tipi di risorse prenotate.

Collega le prenotazioni agli impegni basati sulle risorse

Puoi collegare le prenotazioni a qualsiasi impegno basato sulle risorse e assicurarti che la capacità sia mantenuta in zone specifiche per le risorse impegnate che prevedi di utilizzare. Puoi collegare più prenotazioni a un singolo impegno. Tuttavia, una prenotazione può essere associata a un solo impegno. Quando acquisti un impegno, puoi collegare le prenotazioni a questo impegno in uno dei seguenti modi:

• Utilizzo delle prenotazioni esistenti le cui proprietà corrispondono all'impegno
• Creazione di nuove prenotazioni corrispondenti durante l'acquisto dell'impegno

Dopo aver acquistato un impegno con prenotazioni collegate, le prenotazioni rimangono attive finché l'impegno è attivo. Alla scadenza dell'impegno, Compute Engine elimina automaticamente tutte le prenotazioni collegate. L'eliminazione di queste prenotazioni non ha alcun effetto sulle VM in esecuzione che utilizzavano quelle prenotazioni. Le VM in esecuzione continuano a essere eseguite e ti vengono comunque addebitati i costi per queste VM.

Importante: per la durata dell'impegno, non puoi eliminare o ridimensionare le prenotazioni collegate che specificano GPU, dischi SSD locali o entrambi. Tuttavia, puoi sostituire le prenotazioni collegate esistenti all'impegno con nuove. Per saperne di più su cosa può e non può essere modificato per le prenotazioni allegate, consulta la sezione Modifiche consentite in questo documento.

Risorse impegnate che non richiedono prenotazioni collegate

Le vCPU e la memoria impegnate non richiedono di collegare prenotazioni corrispondenti ai tuoi impegni. Tuttavia, quando acquisti un impegno che include vCPU, memoria o entrambe, puoi comunque scegliere di collegare prenotazioni che specificano quelle risorse. Per informazioni su come acquistare impegni esclusivamente per vCPU, memoria o entrambe, senza collegare le prenotazioni, consulta Acquisto di impegni senza prenotazioni collegate.

Risorse impegnate che richiedono prenotazioni collegate

Le GPU impegnate e i dischi SSD locali richiedono il collegamento delle prenotazioni corrispondenti ai tuoi impegni. Quando acquisti un impegno che include GPU, dischi SSD locali o entrambi, devi anche prenotare queste risorse e collegare le prenotazioni all'impegno. Puoi farlo utilizzando una singola prenotazione o una combinazione di prenotazioni. Quando acquisti questo impegno, puoi includere anche vCPU, memoria o entrambe. Tuttavia, non è necessario prenotare le vCPU o la memoria. Per informazioni su come acquistare gli impegni che includono una o entrambe le GPU e i dischi SSD locali, consulta Impegni con prenotazioni allegate in questo documento.

Per visualizzare l'elenco completo delle serie di macchine che supportano gli sconti per impegno di utilizzo (CUD) per GPU e dischi SSD locali, consulta la sezione Tipi di impegno nella documentazione sugli sconti per impegno di utilizzo (CUD) basati sulle risorse.

Quantità di risorse consentite nelle prenotazioni collegate

Per vCPU e memoria, puoi avere prenotazioni collegate che specificano più o meno quantità di risorse di quelle che ti impegni a utilizzare. Se ti impegni a utilizzare più vCPU o memoria di quella prenotata, Compute Engine prenota capacità solo per queste risorse prenotate. Tuttavia, puoi comunque utilizzare le tue risorse impegnate aggiuntive a seconda della loro disponibilità nella tua regione. Se prenota più vCPU o memoria di quella impegnata, non ricevi sconti per impegno di utilizzo (CUD) per le risorse aggiuntive che prenoti.

Ad esempio, se acquisti un impegno per 4 vCPU e 30 GB di memoria, puoi scegliere di eseguire una delle seguenti operazioni:

• Non allegare alcuna prenotazione.

• Associa le prenotazioni che specificano qualsiasi combinazione di questi tipi di risorse, ad esempio quanto segue:

  • 4 vCPU e 30 GB di memoria
  • 2 vCPU e 50 GB di memoria
  • 10 vCPU e 10 GB di memoria

Tuttavia, se l'impegno contiene GPU, dischi SSD locali o entrambi, devi prenotare e collegare tutte queste risorse. Le prenotazioni collegate devono specificare i numeri e i tipi esatti di GPU e dischi SSD locali per cui ti impegni. Di conseguenza, nelle prenotazioni collegate non è possibile aggiungere altri tipi di GPU o dischi SSD locali. Ad esempio, supponi di acquistare un impegno per 30 GB di memoria e 4 GPU NVIDIA P100. La prenotazione collegata (o una combinazione di prenotazioni allegate) può specificare qualsiasi quantità di vCPU o memoria, ma deve avere esattamente 4 GPU di tipo NVIDIA P100. In questo esempio, non puoi associare prenotazioni che specifichino nessuna delle seguenti combinazioni di risorse:

• 6 GPU NVIDIA P100
• 2 GPU NVIDIA P100
• 4 GPU NVIDIA P100 e 2 GPU NVIDIA V100
• 4 GPU NVIDIA P100 e 4 dischi SSD locali

Impegni di acquisto con prenotazioni allegate

Quando acquisti un nuovo impegno, puoi collegare le prenotazioni al tuo impegno in uno dei seguenti modi:

• Utilizzo delle prenotazioni esistenti le cui proprietà corrispondono all'impegno
• Creazione di nuove prenotazioni corrispondenti durante l'acquisto dell'impegno

Dopo aver acquistato un impegno, questo diventa attivo il giorno successivo alle 00:00 (fuso orario del Pacifico - USA e Canada) (UTC-8 o UTC-7 durante l'ora legale). Tra il momento dell'acquisto e la data di attivazione, lo stato dell'impegno rimane NOT_YET_ACTIVE (o PENDING nella console Google Cloud). Dopo l'attivazione, lo stato dell'impegno diventa ACTIVE. Ad esempio, supponi di aver acquistato l'impegno il 20 gennaio alle 22:00 fuso orario del Pacifico - USA (UTC-8 o UTC-7). Compute Engine crea il tuo impegno immediatamente con il suo stato NOT_YET_ACTIVE. Tuttavia, il tuo impegno diventerà ACTIVE solo il 21 gennaio alle ore 00:00 (fuso orario del Pacifico - USA) (UTC-8 o UTC-7).

Requisiti

Prima di acquistare un impegno con prenotazioni collegate, esamina questi requisiti e assicurati che l'impegno e le prenotazioni soddisfino i seguenti criteri:

• Devi acquistare l'impegno e creare le prenotazioni collegate nello stesso progetto e nella stessa regione.
• Devi acquistare l'impegno e creare le prenotazioni collegate per le risorse della stessa serie di macchine della famiglia.
• Devi disabilitare l'opzione di eliminazione automatica nelle prenotazioni allegate.
• Se l'impegno include GPU, il tipo di GPU specificato nella prenotazione e l'impegno devono corrispondere.
• Per GPU e dischi SSD locali, il numero di risorse prenotate di ogni tipo di risorsa deve corrispondere esattamente al numero di risorse impegnate per quel tipo di risorsa. Ad esempio, se vuoi acquistare un impegno per 4 GPU V100, le prenotazioni collegate dell'impegno devono specificare un totale di 4 GPU V100. Tuttavia, la quantità di vCPU e memoria prenotata può essere superiore o inferiore all'impegno previsto.
• Per le GPU, acquista impegni per i tipi di GPU specifici che intendi utilizzare. Ad esempio, puoi acquistare impegni per NVIDIA P100 o NVIDIA V100, ma non puoi utilizzare un impegno acquistato per GPU NVIDIA P100 al fine di coprire le GPU NVIDIA V100.

• Se la prenotazione collegata è una prenotazione condivisa e vuoi ricevere gli sconti per impegno di utilizzo (CUD) applicabili quando utilizzi questa prenotazione al di fuori del progetto dell'impegno, devi eseguire entrambe le seguenti operazioni:

  • Condividi le tue prenotazioni solo tra progetti che appartengono allo stesso account di fatturazione Cloud dell'impegno.
  • Abilita la condivisione dello sconto per impegno di utilizzo (CUD) per l'account di fatturazione Cloud in questione.

Collega prenotazioni esistenti

Puoi collegare le prenotazioni esistenti durante l'acquisto dell'impegno utilizzando la console Google Cloud, Google Cloud CLI o REST.

Autorizzazioni richieste per questa attività

Per eseguire questa attività, devi disporre delle seguenti autorizzazioni:

• Per creare un impegno: compute.commitments.create sul progetto
• Per creare le prenotazioni: compute.reservations.create nel progetto

Console

Prima di acquistare un impegno utilizzando la console Google Cloud, seleziona il progetto che vuoi utilizzare per acquistarlo. Se la condivisione dello sconto per impegno di utilizzo (CUD) è abilitata per un account di fatturazione Cloud, puoi acquistare l'impegno utilizzando qualsiasi progetto da quell'account di fatturazione Cloud. Dopo aver selezionato il progetto, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Sconti per impegno di utilizzo.

   Vai a Sconti per impegno di utilizzo

2. Per acquistare un impegno, fai clic su Acquista impegno. La pagina Acquista uno sconto per impegno di utilizzo si apre e mostra la scheda Hardware.

3. Nel campo Nome, inserisci un nome per l'impegno.

4. Nel campo Regione, seleziona la regione in cui vuoi eseguire il commit delle risorse Compute Engine.

5. Nel campo Tipo di impegno, seleziona la serie di famiglie di macchine per le risorse impegnate.

6. Nel campo Durata, seleziona la durata dell'impegno.

7. Nel campo Core, inserisci il numero di vCPU di cui vuoi eseguire il commit.

8. Nel campo Memoria, inserisci la quantità, in GB, di memoria che vuoi utilizzare.

9. Per eseguire il commit delle GPU, nella sezione GPU, fai clic su Aggiungi GPU, quindi procedi nel seguente modo:

   1. Nel campo Tipo di GPU, seleziona il tipo di GPU.
   2. Nel campo Numero di GPU, inserisci il numero di GPU.
   3. (Facoltativo) Se il tuo modello GPU supporta le workstation virtuali NVIDIA RTX (vWS) per carichi di lavoro di grafica e prevedi di eseguire carichi di lavoro ad alta intensità di grafica, seleziona la casella di controllo Abilita workstation virtuale (NVIDIA GRID).

10. Per eseguire il commit dei dischi SSD locali, nella sezione SSD locali, fai clic su Aggiungi SSD e specifica il numero di dischi nel campo Numero di unità SSD.

11. Per collegare una o più prenotazioni esistenti all'impegno, seleziona Allega prenotazioni esistenti nel campo Prenotazioni.

    Nella console Google Cloud viene visualizzato un elenco di tutte le prenotazioni nel progetto la cui regione, tipo di macchina e tipo di GPU corrispondono all'impegno. Poi segui questi passaggi:

    1. Facoltativo. Per visualizzare le prenotazioni con proprietà specifiche, aggiungi o rimuovi i filtri per le proprietà che ti interessano nel menu Filtro.
    2. Seleziona tutte le prenotazioni che vuoi associare all'impegno.
    Importante: i tipi e il numero totale di GPU e dischi SSD locali specificati in tutte le prenotazioni collegate devono corrispondere a quanto specificato nell'impegno. In caso contrario, non potrai acquistare l'impegno.

12. Per completare l'acquisto dell'impegno con le prenotazioni allegate, segui questi passaggi:

    1. Fai clic su Acquista.
    2. Nella finestra di dialogo Acquista uno sconto per impegno di utilizzo, se accetti i termini specifici dei servizi, fai di nuovo clic su Acquista.

gcloud

Per acquistare un impegno collegando le prenotazioni esistenti, esegui il comando gcloud compute commitments create. Nel comando, includi il flag --existing-reservation per specificare una prenotazione esistente che vuoi collegare all'impegno. Includi una nuova istanza di questo flag per ogni prenotazione esistente che vuoi collegare. Puoi collegare il numero di prenotazioni esistenti al tuo impegno.

Ad esempio, per acquistare un impegno collegando due prenotazioni, esegui questo comando:

gcloud compute commitments create COMMITMENT_NAME \
    --region=REGION \
    --project=PROJECT_ID \
    --resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \
    --resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \
    --plan=DURATION \
    --type=COMMITMENT_TYPE \
    --existing-reservation=name='RESERVATION_NAME_1',zone='RESERVATION_ZONE_1' \
    --existing-reservation=name='RESERVATION_NAME_2',zone='RESERVATION_ZONE_2'

Sostituisci quanto segue:

• COMMITMENT_NAME: il nome dell'impegno.
• REGION: la regione in cui si trova l'impegno.
• PROJECT_ID: l'ID del progetto in cui vuoi acquistare l'impegno con le prenotazioni allegate.
• DURATION: la durata dell'impegno, 12-month o 36-month.

• COMMITMENT_TYPE: il tipo di impegno. I seguenti tipi di impegno forniscono opzioni per GPU, dischi SSD locali o entrambi:

  • accelerator-optimized per le risorse del tipo di macchina
  • compute-optimized per le risorse di tipo di macchina C2
  • compute-optimized-c2d per le risorse di tipo di macchina C2D
  • compute-optimized-c3 per le risorse di tipo di macchina C3
  • compute-optimized-c3d per le risorse del tipo di macchina C3D
  • general-purpose per risorse di tipo di macchina N1
  • general-purpose-e2 per le risorse di tipo di macchina E2
  • general-purpose-n2 per risorse di tipo di macchina N2
  • general-purpose-n2d per risorse macchina N2D
  • general-purpose-t2d per risorse di tipo di macchina Tau T2D
  • graphics-optimized per le risorse del tipo di macchina G2
  • memory-optimized per risorse del tipo di macchina M1 o M2
  • memory-optimized-m3 per il tipo di macchina M3 ottimizzato per la memoria

• COMMITTED_VCPUS: il numero di vCPU che vuoi includere nel tuo impegno. Il numero deve essere un numero intero positivo.

• COMMITTED_MEMORY: la quantità, in MB o GB, di memoria che vuoi includere nell'impegno. Ad esempio, 10240MB o 10GB. Se non specifichi un'unità, Compute Engine utilizza GB come unità. Puoi acquistare memoria in incrementi di 0,25 GB.

• COMMITTED_LOCAL_SSD: la quantità, in GB, di spazio SSD locale che vuoi includere nel tuo impegno. Ogni disco SSD locale ha una dimensione di 375 GB.

• COMMITTED_ACCELERATOR_COUNT: il numero di GPU che vuoi includere nel tuo impegno.

• COMMITTED_ACCELERATOR_TYPE: il tipo di GPU che vuoi includere nell'impegno.

• RESERVATION_NAME_1 e RESERVATION_NAME_2: i nomi delle prenotazioni esistenti che vuoi collegare all'impegno.

• RESERVATION_ZONE_1 e RESERVATION_ZONE_2: le zone delle prenotazioni esistenti che vuoi collegare all'impegno.

Esempio: acquista un impegno collegando le prenotazioni esistenti

Supponi di avere due prenotazioni res-01 e res-02 nelle zone us-central1-a e us-central1-b del progetto myproject. Supponiamo che queste prenotazioni contengano una capacità combinata per 4 GPU NVIDIA P100 e 4 dischi SSD locali. Per acquistare un nuovo impegno nella regione us-central1 di questo progetto per queste GPU e dischi SSD locali e utilizzare le prenotazioni esistenti come prenotazioni collegate, esegui il comando seguente. Tieni presente che l'impegno di esempio contiene anche vCPU e memoria.

gcloud compute commitments create commitment-01 \
    --region=us-central1 \
    --project=myproject \
    --resources=vcpu=96,memory=624GB \
    --resources-accelerator=type=nvidia-tesla-v100,count=4 \
    --plan 12-month \
    --existing-reservation=name=res-01,zone=us-central1-a \
    --existing-reservation=name=res-02,zone=us-central1-b
    

REST

Per acquistare un impegno collegando le prenotazioni esistenti, effettua una richiesta POST con il metodo regionCommitments.insert. Nella richiesta, includi il campo existingReservations per specificare un elenco separato da virgole di tutte le prenotazioni esistenti che vuoi associare all'impegno. Puoi collegare il numero di prenotazioni esistenti al tuo impegno.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments

{
  "name": "COMMITMENT_NAME",
  "plan": "DURATION",
  "type": COMMITMENT_TYPE,
  "resources":
  [
    {
      "amount": "COMMITTED_VCPUS",
      "type": "VCPU"
    },
    {
      "amount": "COMMITTED_MEMORY",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "COMMITTED_ACCELERATOR_TYPE",
      "amount": "COMMITTED_ACCELERATOR_COUNT",
      "type": "ACCELERATOR"
    }
    {
      "amount": "COMMITTED_LOCAL_SSD",
      "type": "LOCAL_SSD"
    }
  ],
  "existingReservations": "RESERVATION_URLs"
}

Sostituisci quanto segue:

• COMMITMENT_NAME: il nome dell'impegno.
• REGION: la regione in cui si trova l'impegno.
• PROJECT_ID: l'ID del progetto in cui vuoi acquistare l'impegno con le prenotazioni allegate.
• DURATION: la durata dell'impegno, TWELVE_MONTH o THIRTY_SIX_MONTH.

• COMMITMENT_TYPE: il tipo di impegno. I seguenti tipi di impegno forniscono opzioni per GPU, dischi SSD locali o entrambi:

  • GENERAL_PURPOSE_E2 per le risorse di tipo di macchina E2
  • GENERAL_PURPOSE_N2 per risorse di tipo di macchina N2
  • GENERAL_PURPOSE_N2D per risorse macchina N2D
  • COMPUTE_OPTIMIZED_C3 per le risorse di tipo di macchina C3
  • GENERAL_PURPOSE_C3D per le risorse del tipo di macchina C3D
  • GENERAL_PURPOSE_T2D per risorse di tipo di macchina Tau T2D
  • GENERAL_PURPOSE per risorse di tipo di macchina N1
  • COMPUTE_OPTIMIZED per le risorse di tipo di macchina C2
  • COMPUTE_OPTIMIZED_C2D per le risorse di tipo di macchina C2D
  • MEMORY_OPTIMIZED per risorse del tipo di macchina M1 o M2
  • MEMORY_OPTIMIZED_M3 per il tipo di macchina M3 ottimizzato per la memoria
  • ACCELERATOR_OPTIMIZED per le risorse del tipo di macchina
  • GRAPHICS_OPTIMIZED per le risorse del tipo di macchina G2

• COMMITTED_VCPUS: il numero di vCPU che vuoi includere nel tuo impegno. Il numero deve essere un numero intero positivo.

• COMMITTED_MEMORY: la quantità di memoria, in MB, che vuoi includere nel tuo impegno. Ad esempio, 10240MB. Puoi acquistare memoria in incrementi di 256 MB.

• COMMITTED_LOCAL_SSD: la quantità, in GB, di spazio di archiviazione SSD locale che vuoi includere nel tuo impegno. Ogni disco SSD locale ha una dimensione di 375 GB.

• COMMITTED_ACCELERATOR_COUNT: il numero di GPU che vuoi includere nel tuo impegno.

• COMMITTED_ACCELERATOR_TYPE: il tipo di GPU che vuoi includere nell'impegno.

• RESERVATION_URLs: un elenco separato da virgole di URL delle prenotazioni esistenti che vuoi collegare all'impegno. Ad esempio, per collegare due prenotazioni, res-1 e res-2, specifica quanto segue:

  "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/example-res-1",
  "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-c/reservations/example-res-2"
  

Esempio: acquista un impegno collegando le prenotazioni esistenti

Supponi di avere due prenotazioni res-01 e res-02 nelle zone us-central1-a e us-central1-b del progetto myproject. Supponiamo che queste prenotazioni contengano una capacità combinata per 4 GPU NVIDIA P100 e 4 dischi SSD locali. Per acquistare un nuovo impegno nella regione us-central1 di questo progetto per queste GPU e dischi SSD locali e per utilizzare le prenotazioni esistenti come prenotazioni collegate, effettua la seguente richiesta POST. Tieni presente che l'impegno di esempio contiene anche vCPU e memoria.

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments

{
  "name": "commitment-01",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE"
  "resources":
  [
    {
      "amount": "96",
      "type": "VCPU"
    },
    {
      "amount": "638976",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-v100",
      "amount": "4",
      "type": "ACCELERATOR"
    },
    {
      "amount": "1536000",
      "type": "LOCAL_SSD"
    }
  ],
  "existingReservations":
  [
    "https://www.googleapis.com/compute/v1/projects/my-project/zone/us-central1-a/reservations/res-01",
    "https://www.googleapis.com/compute/v1/projects/my-project/zone/us-central1-b/reservations/res-02"
  ]
}

Crea nuove prenotazioni da collegare

Puoi creare le prenotazioni collegate durante l'acquisto dell'impegno utilizzando la console Google Cloud, Google Cloud CLI o REST.

Autorizzazioni richieste per questa attività

Per eseguire questa attività, devi disporre delle seguenti autorizzazioni:

• Per creare un impegno: compute.commitments.create sul progetto
• Per creare le prenotazioni: compute.reservations.create nel progetto

Console

Prima di acquistare un impegno utilizzando la console Google Cloud, seleziona il progetto che vuoi utilizzare per acquistarlo. Se la condivisione dello sconto per impegno di utilizzo (CUD) è abilitata per un account di fatturazione Cloud, puoi acquistare l'impegno utilizzando qualsiasi progetto da quell'account di fatturazione Cloud. Dopo aver selezionato il progetto, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Sconti per impegno di utilizzo.

   Vai a Sconti per impegno di utilizzo

2. Per acquistare un impegno, fai clic su Acquista impegno. La pagina Acquista uno sconto per impegno di utilizzo si apre e mostra la scheda Hardware.

3. Nel campo Nome, inserisci un nome per l'impegno.

4. Nel campo Regione, seleziona la regione in cui vuoi eseguire il commit delle risorse Compute Engine.

5. Nel campo Tipo di impegno, seleziona la serie di famiglie di macchine per le risorse impegnate.

6. Nel campo Durata, seleziona la durata dell'impegno.

7. Nel campo Core, inserisci il numero di vCPU di cui vuoi eseguire il commit.

8. Nel campo Memoria, inserisci la quantità, in GB, di memoria che vuoi utilizzare.

9. Per eseguire il commit delle GPU, nella sezione GPU, fai clic su Aggiungi GPU, quindi procedi nel seguente modo:

   1. Nel campo Tipo di GPU, seleziona il tipo di GPU.
   2. Nel campo Numero di GPU, inserisci il numero di GPU.
   3. (Facoltativo) Se il tuo modello GPU supporta le workstation virtuali NVIDIA RTX (vWS) per carichi di lavoro di grafica e prevedi di eseguire carichi di lavoro ad alta intensità di grafica, seleziona la casella di controllo Abilita workstation virtuale (NVIDIA GRID).

10. Per eseguire il commit dei dischi SSD locali, nella sezione SSD locali, fai clic su Aggiungi SSD e specifica il numero di dischi nel campo Numero di unità SSD.

11. Per creare una nuova prenotazione e collegarla all'impegno, seleziona Crea prenotazioni nel campo Prenotazioni e procedi nel seguente modo. Ripeti questo passaggio per ogni nuova prenotazione che vuoi creare e collegare.

    1. Fai clic su Aggiungi una prenotazione. Viene visualizzata la sezione Nuova prenotazione.
    2. Nel campo Nome, inserisci un nome per la prenotazione allegata.
    3. Nel campo Regione, seleziona la stessa regione dell'impegno.
    4. Nel campo Zona, seleziona la zona in cui vuoi prenotare le risorse.

    5. Nella sezione Tipo di condivisione, specifica come condividere questa prenotazione in uno dei seguenti modi:

       • Per creare una prenotazione per un singolo progetto, seleziona Locale.
       • Per creare una prenotazione condivisa con più progetti, seleziona Condivisa. Quindi, per specificare i progetti con cui condividere questa prenotazione, fai clic su Aggiungi progetti, poi seleziona i progetti prescelti dall'organizzazione del progetto attuale.

    6. Nel campo Utilizza con un'istanza VM, seleziona in che modo le VM utilizzano la prenotazione in uno dei seguenti modi:

       • Per consentire alle VM con proprietà corrispondenti di utilizzare automaticamente questa prenotazione, fai clic su Usa prenotazione automaticamente (impostazione predefinita).
       • Per utilizzare le risorse di questa prenotazione solo quando crei VM con proprietà corrispondenti che hanno come target specificamente questa prenotazione per nome, fai clic su Seleziona prenotazione specifica.

    7. Nella sezione Dettagli risorsa, procedi nel seguente modo:

       1. Nel campo Numero di istanze VM, inserisci il numero di istanze VM che vuoi prenotare.

       2. Nella sezione Configurazione macchina, specifica le proprietà delle VM prenotate in uno dei seguenti modi:

          1. Per specificare le proprietà delle VM utilizzando un modello di istanza esistente, seleziona Utilizza modello di istanza.

             Nel campo Modello di istanza, seleziona un modello di istanza che specifichi la stessa serie di famiglie di macchine dell'impegno. Se selezioni un modello di istanza a livello di regione, anche la regione del modello di istanza deve corrispondere alla regione specificata nell'impegno.

          2. Per specificare manualmente le proprietà delle VM, scegli Seleziona tipo di macchina, quindi segui questi passaggi:

             1. Seleziona la famiglia di macchine che si applica alla serie di macchine specificata per l'impegno:

                • Uso generico per serie di macchine per uso generico
                • Ottimizzato per il calcolo per le serie di macchine ottimizzate per il calcolo
                • Memoria ottimizzata per le serie di macchine ottimizzate per la memoria
                • GPU per serie di macchine ottimizzate per l'acceleratore

             2. Nella tabella contenente la colonna Serie, seleziona la stessa serie di macchine che hai specificato per l'impegno.

             3. Nel campo Tipo di macchina, specifica un tipo di macchina predefinita o personalizzata in uno dei seguenti modi:

                1. Per scegliere un tipo di macchina predefinita, seleziona Preimpostazione, poi seleziona il tipo di macchina che preferisci.
                2. Per scegliere un tipo di macchina personalizzata, seleziona Personalizzata, quindi specifica i Core e la Memoria che preferisci.

             4. Per specificare il numero minimo di piattaforma CPU, GPU o entrambe, espandi il menu Piattaforma CPU e GPU ed esegui queste operazioni:

                1. (Facoltativo) Per specificare una piattaforma CPU minima, seleziona un'opzione nell'elenco Piattaforma CPU.

                2. (Facoltativo) Per prenotare le GPU, fai clic su Aggiungi GPU. Quindi, nei campi Tipo di GPU e Numero di GPU, seleziona il tipo e il numero di GPU per ogni VM.

                   Importante: i tipi e il numero totale di GPU specificati in tutte le prenotazioni collegate devono corrispondere a quanto specificato nell'impegno. In caso contrario, non potrai acquistare l'impegno.

             5. Per prenotare dischi SSD locali:

                1. Nel campo Numero di dischi, seleziona il numero di dischi SSD locali che vuoi per ogni VM.
                2. Nel campo Tipo di interfaccia, seleziona l'interfaccia per i dischi SSD locali.
                Importante: il numero totale di dischi SSD locali specificato in tutte le prenotazioni collegate deve corrispondere a quanto specificato nell'impegno. In caso contrario, non potrai acquistare l'impegno.

    8. Per completare la specifica delle proprietà per questa prenotazione, fai clic su Fine.

12. Per completare l'acquisto dell'impegno con le prenotazioni allegate, segui questi passaggi:

    1. Fai clic su Acquista.
    2. Nella finestra di dialogo Acquista uno sconto per impegno di utilizzo, se accetti i termini specifici dei servizi, fai di nuovo clic su Acquista.

gcloud

Per creare le prenotazioni collegate durante l'acquisto dell'impegno, esegui il comando gcloud compute commitments create.

Nota: non puoi utilizzare Google Cloud CLI per creare prenotazioni collegate utilizzando i modelli di istanza. Devi invece specificare manualmente le proprietà delle VM per le tue prenotazioni.

A seconda che tu voglia collegare una singola prenotazione o più prenotazioni, esegui il comando in uno dei seguenti modi:

• Per creare e collegare una singola prenotazione all'impegno, definisci le proprietà della prenotazione collegata eseguendo questo comando:

  gcloud compute commitments create COMMITMENT_NAME \
      --region=REGION \
      --project=PROJECT_ID \
      --plan DURATION \
      --type COMMITMENT_TYPE
      --resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \
      --resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \
      --reservation=RESERVATION_NAME \
      --reservation-zone=RESERVATION_ZONE \
      --machine-type=RESERVED_MACHINE_TYPE \
      --require-specific-reservation=REQUIRE_SPECIFIC_RESERVATION_VALUE \
      --vm-count=NUMBER_OF_RESERVED_VMs \
      --accelerator=type=RESERVED_ACCELERATOR_TYPE,count=RESERVED_ACCELERATOR_COUNT \
      --local-ssd=interface=INTERFACE_1,size=375 \
      --local-ssd=interface=INTERFACE_2,size=375 \
      --minimum-cpu-platform=MINIMUM_CPU_PLATFORM \
      --share-setting=SHARE_SETTING \
      --share-with=CONSUMER_PROJECT_ID_1,CONSUMER_PROJECT_ID_2
  

• Per creare e allegare più prenotazioni al tuo impegno, definisci le proprietà della prenotazione utilizzando un file YAML e specifica quel file YAML nel comando che utilizzi per acquistare l'impegno. Facoltativamente, puoi utilizzare questo approccio basato su file YAML anche per creare e allegare una singola prenotazione al tuo impegno. Per creare le prenotazioni collegate utilizzando questo approccio:

  1. Crea il file YAML nella directory attuale e specifica la configurazione che vuoi per ogni prenotazione collegata. Ad esempio, per specificare la configurazione di una prenotazione condivisa con due progetti che specifica GPU, due dischi SSD locali e una piattaforma CPU minima, includi il seguente testo nel file YAML:

     - reservation: RESERVATION_NAME
       reservation_zone: RESERVATION_ZONE
       require_specific_reservation: REQUIRE_SPECIFIC_RESERVATION_VALUE
       vm_count: NUMBER_OF_RESERVED_VMs
       machine_type: RESERVED_MACHINE_TYPE
       accelerator:
       - count: RESERVED_ACCELERATOR_COUNT
         type: RESERVED_ACCELERATOR_TYPE
       localssd:
       - interface: INTERFACE_1
         size: 375
       - interface: INTERFACE_2
         size: 375
       project: OWNER_PROJECT_ID
       minimum-cpu-platform: MINIMUM_CPU_PLATFORM
       share-setting: SHARE_SETTING
       share-with:
       - CONSUMER_PROJECT_ID_1
       - CONSUMER_PROJECT_ID_2
     
     

     Per specificare la configurazione per più prenotazioni, ripeti queste proprietà per ogni prenotazione che vuoi creare. Puoi associare il numero di prenotazioni esistenti che vuoi al tuo impegno.

  2. Esegui il comando gcloud compute commitments create e includi il flag --reservation-from-file.

     gcloud compute commitments create COMMITMENT_NAME \
         --region REGION \
         --project PROJECT_ID \
         --plan DURATION \
         --type COMMITMENT_TYPE \
         --resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \
         --resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \
         --reservations-from-file=YAML_FILE
     

Sostituisci quanto segue con le proprietà corrispondenti dell'impegno e delle prenotazioni collegate:

Impegno

• COMMITMENT_NAME: il nome dell'impegno.
• REGION: la regione in cui si trova l'impegno.
• PROJECT_ID: l'ID del progetto in cui vuoi acquistare l'impegno con le prenotazioni allegate.
• DURATION: la durata dell'impegno, 12-month o 36-month.

• COMMITMENT_TYPE: il tipo di impegno. I seguenti tipi di impegno forniscono opzioni per GPU, dischi SSD locali o entrambi:

  • general-purpose-e2 per le risorse di tipo di macchina E2
  • general-purpose-n2 per risorse di tipo di macchina N2
  • general-purpose-n2d per risorse macchina N2D
  • compute-optimized-c3 per le risorse di tipo di macchina C3
  • general-purpose-c3d per le risorse del tipo di macchina C3D
  • general-purpose-t2d per risorse di tipo di macchina Tau T2D
  • general-purpose per risorse di tipo di macchina N1
  • compute-optimized per le risorse di tipo di macchina C2
  • compute-optimized-c2d per le risorse di tipo di macchina C2D
  • memory-optimized per risorse del tipo di macchina M1 o M2
  • memory-optimized-m3 per il tipo di macchina M3 ottimizzato per la memoria
  • accelerator-optimized per le risorse del tipo di macchina
  • graphics-optimized per le risorse del tipo di macchina G2

• COMMITTED_VCPUS: il numero di vCPU che vuoi includere nel tuo impegno. Il numero deve essere un numero intero positivo.

• COMMITTED_MEMORY: la quantità, in MB o GB, di memoria che vuoi includere nell'impegno. Ad esempio, 10GB o 10240MB. Se non specifichi un'unità, Compute Engine utilizza GB come unità. Puoi acquistare memoria in incrementi di 0,25 GB.

• COMMITTED_LOCAL_SSD: la quantità, in GB, di spazio di archiviazione SSD locale che vuoi includere nel tuo impegno. Ogni disco SSD locale ha una dimensione di 375 GB.

• COMMITTED_ACCELERATOR_COUNT: il numero di GPU che vuoi includere nel tuo impegno.

• COMMITTED_ACCELERATOR_TYPE: il tipo di GPU che vuoi includere nell'impegno.

• YAML_FILE: il percorso del file YAML che contiene la configurazione delle prenotazioni allegate.

Prenotazioni collegate

• RESERVATION_NAME: il nome della prenotazione allegata.
• RESERVATION_ZONE: la zona della prenotazione collegata.
• REQUIRE_SPECIFIC_RESERVATION_VALUE: indica se la prenotazione associata è una prenotazione a target specifico; true o false. Per ulteriori informazioni sulle prenotazioni con targeting specifico, consulta Come funzionano le prenotazioni.
• NUMBER_OF_RESERVED_VMS: il numero di VM che vuoi prenotare nella prenotazione collegata.

• RESERVED_MACHINE_TYPE: il tipo di macchina che vuoi per le VM nella prenotazione collegata.

  • Per i tipi di macchine predefinite, utilizza il formato MACHINE_FAMILY-standard-CPUS, ad esempio n2-standard-4.

  • Per i tipi di macchine personalizzate, utilizza il formato MACHINE_FAMILY-custom-CPUS-MEMORY, ad esempio n2-custom-4-5120. Per un elenco completo delle limitazioni, leggi le specifiche per i tipi di macchine personalizzate.

    Sostituisci quanto segue:

    • MACHINE_FAMILY: la famiglia di tipi di macchine; ad esempio, specifica n2 per le VM N2.
    • CPUS: il numero di vCPUs.
    • MEMORY: la memoria totale per una VM prenotata. La memoria deve essere un multiplo di 256 MB e deve essere fornita in MB; ad esempio, per creare una VM N2 con 4 vCPU e 5 GB di memoria, ovvero 5120 MB, utilizza n2-custom-4-5120.

• RESERVED_ACCELERATOR_COUNT: il numero di GPU che vuoi aggiungere, per VM, nella prenotazione collegata.

• RESERVED_ACCELERATOR_TYPE: il tipo di acceleratore che vuoi aggiungere nella prenotazione allegata.

• INTERFACE_1 e INTERFACE_2: il tipo di interfaccia che vuoi utilizzare i dischi SSD locali per ogni VM prenotata. Le opzioni valide sono: scsi e nvme. Ogni disco SSD locale ha una dimensione di 375 GB. Ripeti il parametro local_ssd per ogni disco SSD locale che vuoi aggiungere. Puoi specificare fino a 24 dischi SSD locali.

• OWNER_PROJECT_ID: l'ID del progetto in cui vuoi acquistare l'impegno con la prenotazione collegata. Specifica questo campo se vuoi condividere la prenotazione collegata tra più progetti consumer.

• MINIMUM_CPU_PLATFORM: la piattaforma CPU minima che vuoi specificare per la prenotazione collegata.

• SHARE_SETTING: il tipo di condivisione per la prenotazione associata. Specifica questo campo con il valore projects se vuoi condividere la prenotazione collegata tra più progetti consumer. Escludi questo campo se vuoi creare una prenotazione per un singolo progetto.

• CONSUMER_PROJECT_ID_1 e CONSUMER_PROJECT_ID_2: gli ID progetto dei progetti che possono condividere questa prenotazione, ad esempio project-1 e project-2. Puoi includere fino a 100 progetti consumer. Questi progetti devono trovarsi nella stessa organizzazione del progetto proprietario. Non includere l'ID del progetto in cui crei questa prenotazione, poiché il progetto può consumare questa prenotazione per impostazione predefinita. Escludi questi campi se vuoi creare una prenotazione per un solo progetto.

Compute Engine crea l'impegno e le prenotazioni collegate solo se sono presenti risorse sufficienti del tipo di macchina specificato nella zona di destinazione e una quota sufficiente al momento della richiesta. Se l'acquisto è andato a buon fine, viene visualizzato un messaggio di successo simile al seguente:

Created[https://www.googleapis.com/compute/v1/projects/your-project/regions/your-region/commitments/your-commitment-name]

Esempi di impegni di acquisto mediante la creazione di nuove prenotazioni da collegare

Gli scenari e i comandi di esempio seguenti mostrano come acquistare un impegno per GPU, dischi SSD locali o entrambi creando nuove prenotazioni da collegare all'impegno.

Esempio 1: acquista un impegno per GPU collegando una singola nuova prenotazione

Supponiamo che tu voglia acquistare un impegno commitment-01 nella regione us-central1 che include 4 GPU NVIDIA V100. Vuoi creare una nuova prenotazione reservation-01 come prenotazione collegata per queste GPU. Supponi inoltre di voler specificare in Compute Engine l'utilizzo delle GPU riservate in 2 VM n1-standard-32 nella zona us-central1-a. Per acquistare questo impegno di esempio con la relativa prenotazione collegata, esegui questo comando:

gcloud compute commitments create commitment-01 \
    --region=us-central1 \
    --project=myproject \
    --resources=vcpu=96,memory=624GB \
    --resources-accelerator=type=nvidia-tesla-v100,count=4 \
    --plan 12-month \
    --reservation=reservation-01 \
    --reservation-zone=us-central1-a \
    --machine-type=n1-standard-32 \
    --accelerator=type=nvidia-tesla-v100,count=2 \
    --vm-count=2

Esempio 2: acquista un impegno per GPU senza impegnarsi per vCPU o memoria

Per eseguire il commit di GPU e dischi SSD locali senza eseguire il commit di GPU e dischi SSD locali, specifica 0 come valore per le quantità di vCPU e memoria. Ad esempio, supponi di voler acquistare un impegno commitment-02 per una singola GPU NVIDIA P4 nella regione us-west2. Vuoi anche creare una nuova prenotazione come prenotazione collegata e specificare Compute Engine per utilizzare la GPU prenotata su una VM n1-standard-2 nella zona us-west2-b. Per acquistare questo impegno di esempio con la relativa prenotazione collegata, esegui questo comando:

gcloud compute commitments create commitment-02 \
    --region=us-west2 \
    --project=myproject \
    --resources=vcpu=0,memory=0 \
    --resources-accelerator=type=nvidia-tesla-p4,count=1 \
    --plan 12-month \
    --reservation=reservation-01 \
    --reservation-zone=us-west2-b \
    --machine-type=n1-standard-2 \
    --accelerator=type=nvidia-tesla-p4,count=1 \
    --vm-count=1

Esempio 3: acquista un impegno per GPU e dischi SSD locali collegando più nuove prenotazioni

Supponiamo che tu voglia acquistare un impegno commitment-03 per 1 GPU NVIDIA V 100 e 2 dischi SSD locali nella regione us-central1. Vuoi anche creare e collegare due prenotazioni nella zona us-central1-a. Nella prima prenotazione, res-01, vuoi prenotare 1 VM n1-standard-2 con 1 GPU. Vuoi rendere res-01 una prenotazione scelta come target, il che significa che devi scegliere come target in modo specifico quella prenotazione per nome per utilizzare le relative VM prenotate. Nella seconda prenotazione, res-02, vuoi prenotare 1 VM n1-standard-8 con 2 tipi di dischi SSD locali collegati.

Per acquistare questo impegno di esempio con le prenotazioni allegate, crea prima il file YAML con le proprietà di entrambe le prenotazioni.

- reservation: res-01
  reservation_zone: us-central1-a
  require_specific_reservation: true
  vm_count: 1
  machine_type: n1-standard-2
  accelerator:
  - count: 1
    type: nvidia-tesla-v100
- reservation: res-02
  reservation_zone: us-central1-a
  vm_count: 1
  machine_type: n1-standard-8
  local_ssd:
  - interface: scsi
    size: 375
  - interface: nvme
    size: 375

Dopo aver creato il file YAML, per completare l'acquisto dell'impegno con le prenotazioni associate, esegui questo comando. Tieni presente che l'impegno di esempio contiene anche risorse vCPU e di memoria.

gcloud compute commitments create commitment-03 \
    --region=us-central1 \
    --project=myproject \
    --resources=vcpu=96,memory=624,local-ssd=750 \
    --resources-accelerator=type=nvidia-tesla-v100,count=1 \
    --plan 12-month \
    --reservations-from-file=YAML_FILE

REST

Per creare le prenotazioni allegate durante l'acquisto dell'impegno, effettua una richiesta POST con il metodo regionCommitments.insert. Nella richiesta, includi il campo reservations per definire un elenco di tutte le nuove prenotazioni che vuoi creare e collegare. Puoi collegare il numero di prenotazioni esistenti che vuoi al tuo impegno.

• Per creare la nuova prenotazione specificando manualmente tutte le proprietà della VM, includi il campo instanceProperties ed escludi il campo sourceInstanceTemplate.

  Ad esempio, per specificare manualmente la configurazione di una prenotazione condivisa con due progetti che specifica GPU, due dischi SSD locali e una piattaforma CPU minima, effettua la seguente richiesta:

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments
  
  {
  "name": "COMMITMENT_NAME",
  "plan": "DURATION",
  "type": COMMITMENT_TYPE,
  "resources":
  [
    {
      "amount": "COMMITTED_VCPUS",
      "type": "VCPU"
    },
    {
      "amount": "COMMITTED_MEMORY",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "COMMITTED_ACCELERATOR_TYPE",
      "amount": "COMMITTED_ACCELERATOR_COUNT",
      "type": "ACCELERATOR"
    }
    {
      "amount": "COMMITTED_LOCAL_SSD",
      "type": "LOCAL_SSD"
    }
  ],
  "reservations":
  [
    {
      "name": "RESERVATION_NAME",
      "specificReservation":
      {
        "count": "NUMBER_OF_RESERVED_VMS",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": "RESERVED_ACCELERATOR_COUNT",
              "acceleratorType": "RESERVED_ACCELERATOR_TYPE"
            }
          ],
          "localSsds":
          [
            {
              "diskSizeGb": "375",
              "interface": "RESERVED_INTERFACE_1"
            },
            {
              "diskSizeGb": "375",
              "interface": "RESERVED_INTERFACE_2"
            }
          ],
          "machineType": "RESERVED_MACHINE_TYPE",
          "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
        }
      },
      "specificReservationRequired": REQUIRE_SPECIFIC_RESERVATION_VALUE",
      "zone": "RESERVED_ZONE",
      "shareSettings":
      {
        "shareType": "SPECIFIC_PROJECTS",
        "projectMap":
        {
          "CONSUMER_PROJECT_ID_1":
          {
            "projectId": "CONSUMER_PROJECT_ID_1"
          },
          "CONSUMER_PROJECT_ID_2":
          {
            "projectId": "CONSUMER_PROJECT_ID_2"
          }
        }
      }
    }
  ]
  }
  
  

• Per creare la nuova prenotazione specificando un modello di istanza, includi il campo sourceInstanceTemplate ed escludi il campo instanceProperties.

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments
  
  {
  "name": "COMMITMENT_NAME",
  "plan": "DURATION",
  "type": COMMITMENT_TYPE,
  "resources":
  [
    {
      "amount": "COMMITTED_VCPUS",
      "type": "VCPU"
    },
    {
      "amount": "COMMITTED_MEMORY",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "COMMITTED_ACCELERATOR_TYPE",
      "amount": "COMMITTED_ACCELERATOR_COUNT",
      "type": "ACCELERATOR"
    }
    {
      "amount": "COMMITTED_LOCAL_SSD",
      "type": "LOCAL_SSD"
    }
  ],
  "reservations":
  [
    {
      "name": "RESERVATION_NAME",
      "specificReservation":
      {
        "count": "NUMBER_OF_RESERVED_VMS",
        "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME"
      },
      "specificReservationRequired": REQUIRE_SPECIFIC_RESERVATION_VALUE",
      "zone": "RESERVED_ZONE",
      "shareSettings":
      {
        "shareType": "SPECIFIC_PROJECTS",
        "projectMap":
        {
          "CONSUMER_PROJECT_ID_1":
          {
            "projectId": "CONSUMER_PROJECT_ID_1"
          },
          "CONSUMER_PROJECT_ID_2":
          {
            "projectId": "CONSUMER_PROJECT_ID_2"
          }
        }
      }
    }
  ]
  }
  
  

Sostituisci quanto segue con le proprietà corrispondenti dell'impegno e delle prenotazioni collegate:

Impegno

• COMMITMENT_NAME: il nome dell'impegno.
• REGION: la regione in cui si trova l'impegno.
• PROJECT_ID: l'ID del progetto in cui vuoi acquistare l'impegno con le prenotazioni allegate.
• DURATION: la durata dell'impegno, TWELVE_MONTH o THIRTY_SIX_MONTH.

• COMMITMENT_TYPE: il tipo di impegno. I seguenti tipi di impegno forniscono opzioni per GPU, dischi SSD locali o entrambi:

  • ACCELERATOR_OPTIMIZED per le risorse del tipo di macchina
  • COMPUTE_OPTIMIZED per le risorse di tipo di macchina C2
  • COMPUTE_OPTIMIZED_C2D per le risorse di tipo di macchina C2D
  • COMPUTE_OPTIMIZED_C3 per le risorse di tipo di macchina C3
  • COMPUTE_OPTIMIZED_C3D per le risorse del tipo di macchina C3D
  • GENERAL_PURPOSE per risorse di tipo di macchina N1
  • GENERAL_PURPOSE_E2 per le risorse di tipo di macchina E2
  • GENERAL_PURPOSE_N2 per risorse di tipo di macchina N2
  • GENERAL_PURPOSE_N2D per risorse macchina N2D
  • GENERAL_PURPOSE_T2D per risorse di tipo di macchina Tau T2D
  • GRAPHICS_OPTIMIZED per le risorse del tipo di macchina G2
  • MEMORY_OPTIMIZED per risorse del tipo di macchina M1 o M2
  • MEMORY_OPTIMIZED_M3 per il tipo di macchina M3 ottimizzato per la memoria

• COMMITTED_VCPUS: il numero di vCPU che vuoi includere nel tuo impegno. Il numero deve essere un numero intero positivo.

• COMMITTED_MEMORY: la quantità di memoria, in MB, che vuoi includere nel tuo impegno. Ad esempio, 10240MB. Puoi acquistare memoria in incrementi di 256 MB.

• COMMITTED_LOCAL_SSD: la quantità, in GB, di spazio di archiviazione SSD locale che vuoi includere nel tuo impegno. Ogni disco SSD locale ha una dimensione di 375 GB.

• COMMITTED_ACCELERATOR_COUNT: il numero di GPU che vuoi includere nel tuo impegno.

• COMMITTED_ACCELERATOR_TYPE: il tipo di GPU che vuoi includere nell'impegno.

Prenotazioni collegate

• RESERVATION_NAME: il nome della prenotazione allegata.
• RESERVATION_ZONE: la zona della prenotazione collegata.
• REQUIRE_SPECIFIC_RESERVATION_VALUE: indica se la prenotazione associata è una prenotazione a target specifico; true o false. Per ulteriori informazioni sulle prenotazioni con targeting specifico, consulta Come funzionano le prenotazioni.
• NUMBER_OF_RESERVED_VMS: il numero di VM che vuoi prenotare nella prenotazione collegata.

• RESERVED_MACHINE_TYPE: il tipo di macchina che vuoi per le VM nella prenotazione collegata.

  • Per i tipi di macchine predefinite, utilizza il formato MACHINE_FAMILY-standard-CPUS, ad esempio n2-standard-4.

  • Per i tipi di macchine personalizzate, utilizza il formato MACHINE_FAMILY-custom-CPUS-MEMORY, ad esempio n2-custom-4-5120. Per un elenco completo delle limitazioni, leggi le specifiche per i tipi di macchine personalizzate.

    Sostituisci quanto segue:

    • MACHINE_FAMILY: la famiglia di tipi di macchine; ad esempio, specifica n2 per le VM N2.
    • CPUS: il numero di vCPUs.
    • MEMORY: la memoria totale per una VM prenotata. La memoria deve essere un multiplo di 256 MB e deve essere fornita in MB; ad esempio, per creare una VM N2 con 4 vCPU e 5 GB di memoria, ovvero 5120 MB, utilizza n2-custom-4-5120.

• RESERVED_ACCELERATOR_COUNT: il numero di GPU che vuoi aggiungere, per VM, nella prenotazione collegata.

• RESERVED_ACCELERATOR_TYPE: il tipo di acceleratore che vuoi aggiungere nella prenotazione allegata.

• INTERFACE_1 e INTERFACE_2: il tipo di interfaccia che vuoi che utilizzino i dischi SSD locali per ogni VM prenotata. Le opzioni valide sono: scsi e nvme. Ogni disco SSD locale ha una dimensione di 375 GB. Ripeti il parametro localSsds per ogni disco SSD locale che vuoi aggiungere. Puoi specificare fino a 24 dischi SSD locali.

• MINIMUM_CPU_PLATFORM: la piattaforma CPU minima che vuoi specificare per la prenotazione collegata.

• INSTANCE_TEMPLATE_NAME: il nome del modello di istanza che vuoi utilizzare per creare la prenotazione allegata.

• SHARE_SETTING: il tipo di condivisione per la prenotazione associata. Specifica questo campo con il valore SPECIFIC_PROJECTS se vuoi condividere la prenotazione collegata tra più progetti consumer. Escludi questo campo se vuoi creare una prenotazione per un singolo progetto.

• CONSUMER_PROJECT_ID_1 e CONSUMER_PROJECT_ID_2: gli ID progetto dei progetti che possono condividere questa prenotazione, ad esempio project-1 e project-2. Puoi includere fino a 100 progetti consumer. Questi progetti devono trovarsi nella stessa organizzazione del progetto proprietario. Non includere l'ID del progetto in cui crei questa prenotazione, poiché il progetto può consumare questa prenotazione per impostazione predefinita. Escludi questi campi se vuoi creare una prenotazione per un singolo progetto.

Compute Engine crea l'impegno e le prenotazioni collegate solo se sono disponibili risorse sufficienti del tipo di macchina specificato nella zona di destinazione e una quota sufficiente al momento della richiesta. Se l'acquisto è andato a buon fine, Compute Engine restituisce lo stato 200 per la richiesta API REST.

Esempi di impegni di acquisto mediante la creazione di nuove prenotazioni da collegare

Gli scenari e i comandi di esempio seguenti mostrano come acquistare un impegno per GPU, dischi SSD locali o entrambi creando nuove prenotazioni da collegare all'impegno.

Esempio 1: acquista un impegno per GPU collegando una singola nuova prenotazione

Supponiamo che tu voglia acquistare un impegno commitment-01 nella regione us-central1 che include 4 GPU NVIDIA V100. Vuoi creare una nuova prenotazione reservation-01 come prenotazione collegata per queste GPU. Supponiamo anche di voler specificare in Compute Engine l'utilizzo delle GPU prenotate in 2 VM n1-standard-8 nella zona us-central1-a. Per acquistare questo impegno di esempio con la relativa prenotazione allegata, effettua la seguente richiesta POST:

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments

{
  "name": "commitment-01",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE"
  "resources":
  [
    {
      "amount": "96",
      "type": "VCPU"
    },
    {
      "amount": "638976",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-v100",
      "amount": "4",
      "type": "ACCELERATOR"
    }
  ],
  "reservations":
  [
    {
      "name": "reservation-01",
      "specificReservation":
      {
        "count": "2",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": 2,
              "acceleratorType": "nvidia-tesla-v100"
            }
          ],
          "machineType": "n1-standard-8"
        }
      },
      "specificReservationRequired": false,
      "zone": "us-central1-a"
    }
  ]
}

Esempio 2: acquista un impegno per GPU senza impegnarsi per vCPU o memoria

Per eseguire il commit di GPU e dischi SSD locali senza eseguire il commit di GPU e dischi SSD locali, specifica 0 come valore per le quantità di vCPU e memoria. Ad esempio, supponi di acquistare un impegno commitment-02 per una singola GPU NVIDIA P4 nella regione us-west2. Vuoi anche creare una nuova prenotazione come prenotazione collegata e specificare Compute Engine per l'utilizzo della GPU prenotata su una VM n1-standard-2 nella zona us-west2-b. Per acquistare questo impegno di esempio con la relativa prenotazione collegata, effettua la seguente richiesta POST:

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-west2/commitments

{
  "name": "commitment-02",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE",
  "resources":
  [
    {
      "amount": "0",
      "type": "VCPU"
    },
    {
      "amount": "0",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-p4",
      "amount": "4",
      "type": "ACCELERATOR"
    }
  ],
  "reservations":
  [
    {
      "name": "reservation-01",
      "specificReservation":
      {
        "count": "1",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": 4,
              "acceleratorType": "nvidia-tesla-p4"
            }
          ],
          "machineType": "n1-standard-2"
        }
      },
      "specificReservationRequired": false,
      "zone": "us-west2-b"
    }
  ]
}

Esempio 3: acquista un impegno per GPU e dischi SSD locali collegando più nuove prenotazioni

Supponiamo che tu voglia acquistare un impegno commitment-03 per 1 GPU NVIDIA V 100 e 2 dischi SSD locali nella regione us-central1. Vuoi anche creare e collegare due prenotazioni nella zona us-central1-a. Nella prima prenotazione, res-01, vuoi prenotare 1 VM n1-standard-2 con 1 GPU. Vuoi rendere res-01 una prenotazione scelta come target, il che significa che devi scegliere come target in modo specifico quella prenotazione per nome per utilizzare le relative VM prenotate. Nella seconda prenotazione, res-02, vuoi prenotare 1 VM n1-standard-8 con 2 tipi di dischi SSD locali collegati. Per acquistare questo impegno di esempio con le prenotazioni allegate, effettua la seguente richiesta POST. Tieni presente che l'impegno di esempio contiene anche risorse vCPU e di memoria.

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments

{
  "name": "commitment-03",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE",
  "resources":
  [
    {
      "amount": "96",
      "type": "VCPU"
    },
    {
      "amount": "638976",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-v100",
      "amount": "1",
      "type": "ACCELERATOR"
    },
    {
      "amount": "768000",
      "type": "LOCAL_SSD"
    }
  ],
  "reservations":
  [
    {
      "name": "res-01",
      "specificReservation":
      {
        "count": "1",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": 1,
              "acceleratorType": "nvidia-tesla-v100"
            }
          ],
          "machineType": "n1-standard-2"
        }
      },
      "specificReservationRequired": true,
      "zone": "us-central1-a"
    },
    {
      "name": "res-02",
      "specificReservation":
      {
        "count": "1",
        "instanceProperties":
        {
          "localSsds":
          [
            {
              "diskSizeGb": "375",
              "interface": "SCSI"
            },
            {
              "diskSizeGb": "375",
              "interface": "NVME"
            }
          ]
          "machineType": "n1-standard-8"
        }
      },
      "specificReservationRequired": false,
      "zone": "us-central1-a"
    }
  ]
}

Sostituisci le prenotazioni collegate a impegni

Sostituisci le prenotazioni collegate esistenti del tuo impegno con nuove se vuoi modificare i tipi e il numero di VM che utilizzano le risorse impegnate.

Modifiche consentite

Quando sostituisci la prenotazione collegata esistente a un impegno con una nuova prenotazione, puoi richiedere una delle seguenti modifiche:

• Puoi prenotare VM di un tipo di macchina diverso. Tuttavia, devi comunque prenotare le VM della stessa serie di macchine per continuare a ricevere sconti per impegno di utilizzo (CUD) per le risorse prenotate.
• Puoi modificare il numero di VM da prenotare.
• Puoi modificare la quantità di GPU e dischi SSD locali collegati per ogni VM, purché la quantità totale di GPU prenotate e dischi SSD locali rimanga la stessa.

• Puoi specificare le prenotazioni sostituite come prenotazioni locali o condivise.

  Importante: se una prenotazione collegata a un impegno viene utilizzata da un progetto non incluso nell'impegno, non hai diritto al prezzo scontato. Se le prenotazioni allegate sono prenotazioni condivise, condividile solo con i progetti inclusi nell'impegno per assicurarti di ricevere gli sconti per impegno di utilizzo.

Requisiti

Quando sostituisci la prenotazione collegata al tuo impegno con una nuova, la richiesta deve soddisfare tutti i seguenti requisiti:

• Puoi sostituire una sola prenotazione collegata alla volta con esattamente una nuova prenotazione collegata. Per sostituire una prenotazione collegata, rimuovi contemporaneamente una prenotazione collegata esistente impostando il numero di VM su 0 e definisci una nuova prenotazione collegata che vuoi sostituirla.
• La nuova prenotazione deve esistere nello stesso progetto dell'impegno.
• La nuova prenotazione deve trovarsi nella stessa zona della prenotazione rimossa.
• La quantità e i tipi di GPU specificati nella nuova prenotazione devono corrispondere alla prenotazione rimossa.
• I numeri e i tipi di dischi SSD locali specificati nella nuova prenotazione devono corrispondere a quelli rimossi.
• Puoi modificare solo fino a 100 VM per richiesta. Per apportare una modifica che riguarda più di 100 VM, suddividi la modifica in più richieste più piccole o contatta l'Assistenza Google Cloud.

La richiesta di sostituzione di una prenotazione dipende anche dalla disponibilità della capacità in quel momento. Se la capacità di una richiesta non è disponibile, la richiesta non riesce e restituisce un errore di disponibilità delle risorse, che puoi provare a risolvere modificando o posticipando la richiesta.

Se la richiesta di sostituzione di una prenotazione collegata non va a buon fine, la prenotazione collegata e le risorse prenotate esistenti rimangono inalterate. Per preservare la capacità, attendi di apportare le modifiche corrispondenti alle VM fino a quando la richiesta di sostituzione di una prenotazione non va a buon fine.

Passaggi per sostituire una prenotazione collegata

Puoi sostituire le prenotazioni di un impegno utilizzando Google Cloud CLI o REST.

gcloud

Per sostituire le prenotazioni associate a impegni:

1. Crea un file YAML nella directory attuale con le configurazioni delle seguenti prenotazioni allegate:

   • La prenotazione attuale che vuoi sostituire.

     Per recuperare i dettagli di questa prenotazione, vedi Visualizzare i dettagli di una prenotazione.

   • La nuova prenotazione sostitutiva.

   I contenuti del file YAML sono simili ai seguenti:

   - reservation: CURRENT_RESERVATION_NAME
     reservation_zone: CURRENT_RESERVATION_ZONE
     vm_count: 0
     machine_type: CURRENT_RESERVATION_MACHINE_TYPE
     accelerator:
     - count: CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS
       type: CURRENT_RESERVATION_ACCELERATOR_TYPE
     localssd:
     - interface: CURRENT_RESERVATION_INTERFACE_1
       size: 375
     - interface: CURRENT_RESERVATION_INTERFACE_2
       size: 375
     project: CURRENT_RESERVATION_PROJECT_ID
     share-setting: CURRENT_RESERVATION_SHARE_SETTING
     share-with:
     - CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1
     - CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2
   - reservation: REPLACEMENT_RESERVATION_NAME
     reservation_zone: REPLACEMENT_RESERVATION_ZONE
     vm_count: REPLACEMENT_RESERVATION_NUMBER_OF_VMs
     machine_type: REPLACEMENT_RESERVATION_MACHINE_TYPE
     accelerator:
     - count: REPLACEMENT_RESERVATION_ACCELERATOR_COUNT
       type: REPLACEMENT_RESERVATION_ACCELERATOR_TYPE
     localssd:
     - interface: REPLACEMENT_RESERVATION_INTERFACE_1
       size: 375
     - interface: REPLACEMENT_RESERVATION_INTERFACE_2
       size: 375
     project: REPLACEMENT_RESERVATION_PROJECT_ID
     share-setting: REPLACEMENT_RESERVATION_SHARE_SETTING
     share-with:
     - REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1
     - REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2
   
   

   Sostituisci quanto segue con le proprietà corrispondenti della prenotazione attuale e di quella sostitutiva:

   Prenotazione attuale

   Per la prenotazione attuale, tutte le seguenti proprietà devono essere esattamente le stesse di quando hai visualizzato la prenotazione. Ometti i campi per le proprietà che non sono ancora presenti nella prenotazione attuale.

   • CURRENT_RESERVATION_NAME: il nome della prenotazione associata corrente.
   • CURRENT_RESERVATION_ZONE: la zona della prenotazione collegata corrente.
   • CURRENT_RESERVATION_MACHINE_TYPE: il tipo di macchina della prenotazione collegata attuale.
   • CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS: il numero di GPU prenotate nell'attuale prenotazione collegata.
   • CURRENT_RESERVATION_ACCELERATOR_TYPE: il tipo di acceleratore prenotato nell'attuale prenotazione collegata.
   • CURRENT_RESERVATION_INTERFACE_1 e CURRENT_RESERVATION_INTERFACE_2: il tipo di interfaccia utilizzato dal disco SSD locale per ogni VM prenotata nella prenotazione attuale collegata. Le opzioni valide sono: scsi e nvme. Ogni disco SSD locale ha una dimensione di 375 GB. Ripeti il parametro local_ssd per tutti i dischi SSD locali riservati.
   • CURRENT_RESERVATION_PROJECT_ID: l'ID del progetto attuale a cui sono associati l'impegno e la prenotazione associata. Specifica questo campo se la prenotazione attuale collegata è condivisa tra più progetti consumer.
   • CURRENT_RESERVATION_SHARE_SETTING: il tipo di condivisione per la prenotazione attuale. Specifica questo campo con il valore projects se la prenotazione attuale collegata è condivisa tra più progetti consumer.
   • CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1 e CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2: gli ID progetto dei progetti con cui condividi la prenotazione collegata attuale, ad esempio project-1 e project-2.

   Prenotazione sostituzione

   Per la prenotazione sostitutiva, imposta le seguenti proprietà come obbligatorie. Assicurati di soddisfare tutti i requisiti quando specifichi queste proprietà. Ometti eventuali campi aggiuntivi che non vuoi utilizzare.

   • REPLACEMENT_RESERVATION_NAME: il nome della nuova prenotazione sostitutiva.
   • REPLACEMENT_RESERVATION_ZONE: la zona della nuova prenotazione sostitutiva.
   • REPLACEMENT_RESERVATION_NUMBER_OF_VMS: il numero di VM che vuoi prenotare nella nuova prenotazione di sostituzione.

   • REPLACEMENT_RESERVATION_MACHINE_TYPE: il tipo di macchina per le VM nella nuova prenotazione sostitutiva.

     • Per i tipi di macchine predefinite, utilizza il formato MACHINE_FAMILY-standard-CPUS, ad esempio n2-standard-4.
     • Per i tipi di macchine personalizzate, utilizza il formato MACHINE_FAMILY-custom-CPUS-MEMORY, ad esempio n2-custom-4-5120. Per un elenco completo delle limitazioni, leggi le specifiche per i tipi di macchine personalizzate.

     Sostituisci quanto segue:

     • MACHINE_FAMILY: la famiglia di tipi di macchine; ad esempio, specifica n2 per le VM N2.
     • CPUS: il numero di vCPUs.
     • MEMORY: la memoria totale per una VM prenotata. La memoria deve essere un multiplo di 256 MB e deve essere fornita in MB; ad esempio, per creare una VM N2 con 4 vCPU e 5 GB di memoria, ovvero 5120 MB, utilizza n2-custom-4-5120.

   • REPLACEMENT_RESERVATION_NUMBER_OF_ACCELERATORS: il numero di GPU che vuoi aggiungere, per VM, nella prenotazione della sostituzione.

   • REPLACEMENT_RESERVATION_ACCELERATOR_TYPE: il tipo di acceleratore che vuoi aggiungere nella prenotazione sostitutiva.

   • REPLACEMENT_RESERVATION_INTERFACE_1 e REPLACEMENT_RESERVATION_INTERFACE_2: il tipo di interfaccia che vuoi utilizzare i dischi SSD locali per ogni VM prenotata. Le opzioni valide sono: scsi e nvme. Ogni disco SSD locale ha una dimensione di 375 GB. Ripeti il parametro local_ssd per ogni disco SSD locale che vuoi aggiungere. Puoi specificare fino a 24 dischi SSD locali.

   • REPLACEMENT_RESERVATION_PROJECT_ID: l'ID del progetto attuale a cui sono associati l'impegno e la prenotazione associata. Specifica questo campo se vuoi condividere la prenotazione sostitutiva tra più progetti consumer.

   • REPLACEMENT_RESERVATION_SHARE_SETTING: il tipo di condivisione per la prenotazione sostitutiva. Specifica questo campo con il valore projects se vuoi condividere la prenotazione sostitutiva tra più progetti consumer.

   • REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1 e REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2: gli ID progetto dei progetti che possono condividere questa prenotazione, ad esempio project-1,project-2. Puoi includere fino a 100 progetti consumer. Questi progetti devono trovarsi nella stessa organizzazione del progetto proprietario. Non includere REPLACEMENT_RESERVATION_PROJECT_ID, che è già autorizzato a utilizzare questa prenotazione per impostazione predefinita.

2. Esegui il comando gcloud beta compute commitments update-reservations e specifica il percorso del file YAML utilizzando il flag --reservations-from-file.

   gcloud beta compute commitments update-reservations COMMITMENT_NAME \
       --project= PROJECT_ID \
       --region= REGION \
       --reservations-from-file= YAML_FILE
   

   Sostituisci quanto segue:

   • COMMITMENT_NAME: il nome dell'impegno con la prenotazione allegata.
   • PROJECT_ID: l'ID progetto dell'impegno con la prenotazione allegata.
   • REGION: la regione in cui si trova l'impegno.
   • YAML_FILE: il percorso del file YAML che contiene la configurazione delle prenotazioni attuali e sostitutive.

Esempio per la sostituzione di una prenotazione collegata a un impegno

Per dimostrarlo, questa sezione mostra un impegno di esempio con una prenotazione collegata e come sostituire la prenotazione collegata di esempio.

Esempio di impegno con una prenotazione collegata

Ad esempio, supponi di voler aggiornare le prenotazioni collegate per l'impegno my-commitment-with-reservations, acquistato utilizzando il seguente comando:

  gcloud beta compute commitments create my-commitment-with-reservations \
      --region=asia-east1 \
      --resources=vcpu=16,memory=60GB,local-ssd=3000 \
      --resources-accelerator=type=nvidia-tesla-p100,count=4 \
      --plan=12-month \
      --type=general-purpose \
      --reservations-from-file=one-reservation.yaml

Per questo esempio, supponi che, quando è stato eseguito il comando, one-reservation.yaml fosse un file nella directory attuale con i contenuti seguenti che definisce una prenotazione allegata denominata res-1.

  - reservation: res-1
    reservation_zone: asia-east1-a
    vm_count: 4
    machine_type: n1-standard-4
    accelerator:
    - count: 1
      type: nvidia-tesla-p100
    local_ssd:
    - interface: scsi
      size: 375
    - interface: scsi
      size: 375

Questo impegno my-commitment-with-reservations e la prenotazione res-1 collegata hanno generato le seguenti risorse impegnate e prenotate:

Tipo di risorsa	Risorse nell'impegno (my-commitment-with-reservations)	Risorse nella prenotazione attuale collegata (res-1)
vCPU e memoria	16 vCPU e 60 GB	16 vCPU e 60 GB (4 VM n1-standard-4 prenotate)^*
GPU	4 GPU P100	4 GPU P100 (1 GPU P100 per VM, per 4 VM)^*
Dischi SSD locali	3000 GB o 8 dischi SSD locali	3000 GB o 8 dischi SSD locali (750 GB o 2 dischi SSD locali per VM, per 4 VM)^*

^* Nello specifico, la prenotazione associata all'esempio, res-1, prenota 4 VM n1-standard-4, ciascuna con 1 GPU P100 e 2 dischi SSD locali di tipo di interfaccia scsi. Il tipo di macchina n1-standard-4 utilizza 4 vCPU e 15 GB per ogni VM.

Sostituisci la prenotazione collegata di esempio

Supponi di voler sostituire la prenotazione associata res-1 per con una nuova prenotazione collegata res-2 e di modificare le risorse prenotate come segue:

Tipo di risorsa	Risorse nell'impegno (my-commitment-with-reservations)	Risorse nella prenotazione attuale collegata (res-1)	Risorse nella prenotazione sostitutiva allegata (res-2)
vCPU e memoria	16 vCPU e 60 GB	16 vCPU e 60 GB (4 VM n1-standard-4 prenotate)^*	16 vCPU e 60 GB (2 VM n1-standard-8 prenotate e condivise)^†
GPU	4 GPU P100	4 GPU P100 (1 GPU P100 per VM, per 4 VM)^*	4 GPU P100 (2 GPU P100 per VM, per 2 VM)^†
Dischi SSD locali	3000 GB o 8 dischi SSD locali	3000 GB o 8 dischi SSD locali (750 GB o 2 dischi SSD locali per VM, per 4 VM)^*	3000 GB o 8 dischi SSD locali (1500 GB o 4 dischi SSD locali per VM, per 2 VM)^*

^* Nello specifico, la prenotazione associata all'esempio, res-1, prenota 4 VM n1-standard-4, ciascuna con 1 GPU P100 e 2 dischi SSD locali di tipo di interfaccia scsi. Il tipo di macchina n1-standard-4 utilizza 4 vCPU e 15 GB per ogni VM.

^†Nello specifico, la prenotazione associata alla sostituzione definisce res-2, che prenota 2 VM n1-standard-8, ciascuna con 1 GPU P100 e 4 dischi SSD locali di tipo di interfaccia scsi. Inoltre, res-2 è condiviso con altri due progetti, project-1 e project-2, ed è di proprietà del progetto attuale my-project. Il tipo di macchina n1-standard-8 utilizza 8 vCPU e 30 GB per ogni VM.

Per sostituire la prenotazione collegata res-1 con res-2 per l'impegno my-commitment-with-reservations:

1. Crea un file denominato two-reservations.yaml nella directory attuale il cui file contiene i seguenti contenuti:

   - reservation: res-1
     reservation_zone: asia-east1-a
     vm_count: 0
     machine_type: n1-standard-4
     accelerator:
     - count: 1
       type: nvidia-tesla-p100
     local_ssd:
     - interface: scsi
       size: 375
     - interface: scsi
       size: 375
   - reservation: res-2
     reservation_zone: asia-east1-a
     vm_count: 2
     machine_type: n1-standard-8
     accelerator:
     - count: 2
       type: nvidia-tesla-p100
     project: my-project
     share-setting: projects
     share-with:
     - project-1
     - project-2
     local_ssd:
     - interface: scsi
       size: 375
     - interface: scsi
       size: 375
     - interface: scsi
       size: 375
     - interface: scsi
       size: 375
   

2. Esegui questo comando:

   gcloud beta compute commitments update-reservations my-commitment-with-reservations \
       --region=asia-east1 \
       --reservations-from-file=two-reservations.yaml
   

REST

Per sostituire le prenotazioni associate a impegni, effettua una richiesta POST utilizzando il metodo regionCommitments.updateReservations.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/COMMITMENT_ZONE/commitments/COMMITMENT_NAME/updateReservations

{
  "reservations":
  [
    {
      "name": "REPLACEMENT_RESERVATION_NAME",
      "specificReservation":
      {
        "count": "REPLACEMENT_RESERVATION_NUMBER_OF_VMS",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": "REPLACEMENT_RESERVATION_NUMBER_OF_ACCELERATORS",
              "acceleratorType": "REPLACEMENT_RESERVATION_ACCELERATOR_TYPE"
            }
          ],
          "localSsds":
          [
            {
              "diskSizeGb": "375",
              "interface": "REPLACEMENT_RESERVATION_INTERFACE_1"
            },
            {
              "diskSizeGb": "375",
              "interface": "REPLACEMENT_RESERVATION_INTERFACE_2"
            }
          ],
          "machineType": "REPLACEMENT_RESERVATION_MACHINE_TYPE"

        }
      },
      "zone": "REPLACEMENT_RESERVATION_ZONE",
      "shareSettings":
      {
        "shareType": "SPECIFIC_PROJECTS",
        "projectMap":
        {
          "REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1":
          {
            "projectId": "REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1"
          },
          "REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2":
          {
            "projectId": "REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2"
          }
         }
      }
    },
    {
      "name": "CURRENT_RESERVATION_NAME",
      "specificReservation":
      {
        "count": "0",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": "CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS",
              "acceleratorType": "CURRENT_RESERVATION_ACCELERATOR_TYPE"
            }
          ],
          "localSsds":
          [
            {
              "diskSizeGb": "375",
              "interface": "CURRENT_RESERVATION_INTERFACE_1"
            },
            {
              "diskSizeGb": "375",
              "interface": "CURRENT_RESERVATION_INTERFACE_2"
            }
          ],
          "machineType": "CURRENT_RESERVATION_MACHINE_TYPE"

        }
      },
      "zone": "CURRENT_RESERVATION_ZONE",
      "shareSettings":
      {
        "shareType": "SPECIFIC_PROJECTS",
        "projectMap":
        {
          "CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1":
          {
            "projectId": "CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1"
          },
          "CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2":
          {
            "projectId": "CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2"
          }
         }
      }
    }
  ]
}

Sostituisci quanto segue con le proprietà corrispondenti dell'impegno, della prenotazione attuale e della prenotazione sostitutiva:

Impegno

• COMMITMENT_NAME: il nome dell'impegno con la prenotazione allegata.
• PROJECT_ID: l'ID progetto dell'impegno con la prenotazione collegata. Questo è anche l'ID progetto per le prenotazioni correnti e collegate.
• COMMITMENT_ZONE: la zona dell'impegno con la prenotazione collegata.

Prenotazione attuale

Per la prenotazione attuale, tutte le seguenti proprietà devono essere esattamente le stesse di quando hai visualizzato la prenotazione. Ometti i campi per tutte le proprietà che non sono già state specificate nella prenotazione attuale.

• CURRENT_RESERVATION_NAME: il nome della prenotazione associata corrente.
• CURRENT_RESERVATION_ZONE: la zona della prenotazione collegata corrente.
• CURRENT_RESERVATION_MACHINE_TYPE: il tipo di macchina della prenotazione collegata attuale.
• CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS: il numero di GPU prenotate nell'attuale prenotazione collegata.
• CURRENT_RESERVATION_ACCELERATOR_TYPE: il tipo di acceleratore prenotato nell'attuale prenotazione collegata.
• CURRENT_RESERVATION_INTERFACE_1 e CURRENT_RESERVATION_INTERFACE_2: il tipo di interfaccia utilizzato dai dischi SSD locali per ogni VM prenotata nella prenotazione attuale collegata. Le opzioni valide sono: scsi e nvme. Ogni disco SSD locale ha una dimensione di 375 GB. Ripeti il parametro localSsds per tutti i dischi SSD locali prenotati.
• CURRENT_RESERVATION_SHARE_SETTING: il tipo di condivisione per la prenotazione attuale. Specifica questo parametro con il valore projects se la prenotazione attuale collegata è condivisa tra più progetti consumer.
• CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1 e CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2: gli ID progetto dei progetti con cui condividi la prenotazione collegata attuale, ad esempio project-1 e project-2.

Prenotazione sostituzione

Per la prenotazione sostitutiva, imposta le seguenti proprietà come obbligatorie. Assicurati di soddisfare tutti i requisiti quando specifichi queste proprietà. Ometti eventuali campi aggiuntivi che non vuoi utilizzare.

• REPLACEMENT_RESERVATION_NAME: il nome della nuova prenotazione sostitutiva.
• REPLACEMENT_RESERVATION_ZONE: la zona della nuova prenotazione di sostituzione.
• REPLACEMENT_RESERVATION_NUMBER_OF_VMS: il numero di VM che vuoi prenotare nella nuova prenotazione sostitutiva.

• REPLACEMENT_RESERVATION_MACHINE_TYPE: il tipo di macchina desiderato per le VM nella nuova prenotazione sostitutiva.

  • Per i tipi di macchine predefinite, utilizza il formato MACHINE_FAMILY-standard-CPUS, ad esempio n2-standard-4.
  • Per i tipi di macchine personalizzate, utilizza il formato MACHINE_FAMILY-custom-CPUS-MEMORY, ad esempio n2-custom-4-5120. Per un elenco completo delle limitazioni, leggi le specifiche per i tipi di macchine personalizzate.

  Sostituisci quanto segue:

  • MACHINE_FAMILY: la famiglia di tipi di macchine; ad esempio, specifica n2 per le VM N2.
  • CPUS: il numero di vCPUs.
  • MEMORY: la memoria totale per una VM riservata. La memoria deve essere un multiplo di 256 MB e deve essere fornita in MB; ad esempio, per creare una VM N2 con 4 vCPU e 5 GB di memoria, ovvero 5120 MB, utilizza n2-custom-4-5120.

• REPLACEMENT_RESERVATION_NUMBER_OF_ACCELERATORS: il numero di GPU che vuoi aggiungere, per VM, nella prenotazione della sostituzione.

• REPLACEMENT_RESERVATION_ACCELERATOR_TYPE: il tipo di acceleratore che vuoi aggiungere nella prenotazione della sostituzione.

• REPLACEMENT_RESERVATION_INTERFACE_1 e REPLACEMENT_RESERVATION_INTERFACE_2: il tipo di interfaccia che vuoi utilizzare i dischi SSD locali per ogni VM prenotata. Le opzioni valide sono: scsi e nvme. Ogni disco SSD locale ha una dimensione di 375 GB. Ripeti il parametro localSsds per ogni disco SSD locale che vuoi aggiungere. Puoi specificare fino a 24 dischi SSD locali.

• REPLACEMENT_RESERVATION_SHARE_SETTING: il tipo di condivisione per la prenotazione sostitutiva. Specifica questo parametro con il valore projects se vuoi condividere la prenotazione della sostituzione tra più progetti consumer.

• REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1 e REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2: gli ID progetto dei progetti che possono condividere questa prenotazione, ad esempio project-1,project-2. Puoi includere fino a 100 progetti consumer. Questi progetti devono trovarsi nella stessa organizzazione del progetto proprietario. Non includere PROJECT_ID, che è già autorizzato a utilizzare questa prenotazione per impostazione predefinita.

Esempio per la sostituzione di una prenotazione collegata a un impegno

Per dimostrarlo, questa sezione mostra un impegno di esempio con una prenotazione collegata e come sostituire la prenotazione collegata di esempio.

Esempio di impegno con una prenotazione collegata

Ad esempio, supponi di voler sostituire la prenotazione collegata res-1 per l'impegno my-commitment-with-reservations, che è stato acquistato effettuando la seguente richiesta POST:

  POST https://compute.googleapis.com/compute/beta/projects/my-project/regions/asia-east1/commitments

  {
    "name": "my-commitment-with-reservations",
    "plan": "TWELVE_MONTH",
    "reservations":
    [
      {
        "name": "res-1",
        "specificReservation":
        {
          "count": "4",
          "instanceProperties":
          {
            "guestAccelerators":
            [
              {
                "acceleratorCount": "1",
                "acceleratorType": "nvidia-tesla-p100"
              }
            ],
            "localSsds":
            [
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              }
            ],
            "machineType": "n1-standard-4"
          }
        },
        "zone": "asia-east1-a"
      }
    ],
    "resources":
    [
      {
        "amount": "16",
        "type": "VCPU"
      },
      {
        "amount": "61440",
        "type": "MEMORY"
      },
      {
        "acceleratorType": "nvidia-tesla-p100",
        "amount": "4",
        "type": "ACCELERATOR"
      }
      {
        "amount": "3072000",
        "type": "LOCAL_SSD"
      }
    ],
    "type": "GENERAL_PURPOSE"
  }

Questo impegno my-commitment-with-reservations e la prenotazione res-1 collegata hanno generato le seguenti risorse impegnate e prenotate:

Tipo di risorsa	Risorse nell'impegno (my-commitment-with-reservations)	Risorse nella prenotazione attuale collegata (res-1)
vCPU e memoria	16 vCPU e 60 GB	16 vCPU e 60 GB (4 VM n1-standard-4 prenotate)^*
GPU	4 GPU P100	4 GPU P100 (1 GPU P100 per VM, per 4 VM)^*
Dischi SSD locali	3000 GB o 8 dischi SSD locali	3000 GB o 8 dischi SSD locali (750 GB o 2 dischi SSD locali per VM, per 4 VM)^*

^* Nello specifico, la prenotazione associata all'esempio, res-1, prenota 4 VM n1-standard-4, ciascuna con 1 GPU P100 e 2 dischi SSD locali di tipo di interfaccia scsi. Il tipo di macchina n1-standard-4 utilizza 4 vCPU e 15 GB per ogni VM.

Sostituisci la prenotazione collegata di esempio

Supponi di voler sostituire la prenotazione associata res-1 per con una nuova prenotazione collegata res-2 e di modificare le risorse prenotate come segue:

Tipo di risorsa	Risorse nell'impegno (my-commitment-with-reservations)	Risorse nella prenotazione attuale collegata (res-1)	Risorse nella prenotazione sostitutiva allegata (res-2)
vCPU e memoria	16 vCPU e 60 GB	16 vCPU e 60 GB (4 VM n1-standard-4 prenotate)^*	16 vCPU e 60 GB (2 VM n1-standard-8 prenotate e condivise)^†
GPU	4 GPU P100	4 GPU P100 (1 GPU P100 per VM, per 4 VM)^*	4 GPU P100 (2 GPU P100 per VM, per 2 VM)^†
Dischi SSD locali	3000 GB o 8 dischi SSD locali	3000 GB o 8 dischi SSD locali (750 GB o 2 dischi SSD locali per VM, per 4 VM)^*	3000 GB o 8 dischi SSD locali (1500 GB o 4 dischi SSD locali per VM, per 2 VM)^*

^* Nello specifico, la prenotazione associata all'esempio, res-1, prenota 4 VM n1-standard-4, ciascuna con 1 GPU P100 e 2 dischi SSD locali di tipo di interfaccia scsi. Il tipo di macchina n1-standard-4 utilizza 4 vCPU e 15 GB per ogni VM.

^†Nello specifico, la prenotazione associata alla sostituzione definisce res-2, che prenota 2 VM n1-standard-8, ciascuna con 1 GPU P100 e 4 dischi SSD locali di tipo di interfaccia scsi. Inoltre, res-2 è condiviso con altri due progetti, project-1 e project-2, ed è di proprietà del progetto attuale my-project. Il tipo di macchina n1-standard-8 utilizza 8 vCPU e 30 GB per ogni VM.

Per sostituire la prenotazione res-1 allegata con res-2 per l'impegno my-commitment-with-reservations, effettua la seguente richiesta POST utilizzando il metodo regionCommitments.updateReservations:

  POST https://compute.googleapis.com/compute/beta/projects/my-project/regions/asia-east1/commitments/my-commitment-with-reservations/updateReservations

  {
    "reservations":
    [
      {
        "name": "res-2",
        "specificReservation":
        {
          "count": "2",
          "instanceProperties":
          {
            "guestAccelerators":
            [
              {
                "acceleratorCount": 2,
                "acceleratorType": "nvidia-tesla-p100"
              }
            ],
            "localSsds":
            [
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              }
            ],
            "machineType": "n1-standard-8"
          }
        },
        "zone": "asia-east1-a"
      },
      {
        "name": "res-1",
        "specificReservation":
        {
          "count": "0",
          "instanceProperties":
          {
            "guestAccelerators":
            [
              {
                "acceleratorCount": 1,
                "acceleratorType": "nvidia-tesla-p100"
              }
            ],
            "localSsds":
            [
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              }
            ],
            "machineType": "n1-standard-4"
          }
        },
        "zone": "asia-east1-a"
      }
    ]
  }

Passaggi successivi

• Scopri di più sugli sconto per impegno di utilizzo (CUD) basati sulle risorse.
• Scopri come utilizzare le prenotazioni.
• Scopri come modificare le prenotazioni.
• Scopri come eliminare le prenotazioni.