Combina le prenotazioni con gli sconti per impegno di utilizzo

Sconti per impegno di utilizzo (CUD) offrire prezzi molto scontati per le tue risorse Compute Engine in cambio i contratti basati su impegno di utilizzo di 1 o 3 anni (noti anche come impegni). Tu impegnarsi a utilizzare un importo minimo delle risorse o a un importo minimo di spesa ricevono in cambio sconti per impegno di utilizzo (CUD) sui costi di utilizzo delle risorse. Tuttavia, gli impegni non riservare capacità di zona per le risorse impegnate. Per ottenere le risorse di zona sui prezzi scontati e assicura che venga prenotata la capacità per questi, devi sia impegni di acquisto sia creare prenotazioni di risorse di zona.

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

Prima di iniziare

• Rivedi le informazioni di base sulle prenotazioni, i relativi requisiti e limitazioni. Per ulteriori informazioni, vedi Prenotazioni delle risorse di zona Compute Engine.
• 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. Install the Google Cloud CLI, then initialize it by running the following command:

     gcloud init

     Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
  2. Set a default region and zone.

  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.

  Install the Google Cloud CLI, then initialize it by running the following command:

  gcloud init

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

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

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

• Non stai ricevendo altre forme di sconto per l'utilizzo delle risorse.
• Le VM devono utilizzare le prenotazioni mentre gli impegni sono attivi.

• Come minimo, le seguenti proprietà devono corrispondere ai valori attivi gli impegni 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 una o entrambe le risorse tipi, puoi acquistare impegni basati sulle risorse o sulla spesa che e includere i tipi di risorse richiesti. Quando le VM nel progetto utilizzano qualsiasi prenotazione con proprietà corrispondenti a questi impegni attivi, riceverai automaticamente gli sconti per impegno di utilizzo (CUD) applicabili per questi tipi di risorse prenotate. Se hai prenotato più risorse di che hai sottoscritto, 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 una o entrambe le opzioni di risorse, devi fare quanto segue:

  • Acquista impegni basati sulle risorse che includono la risorsa richiesta di testo.
  • Creare prenotazioni per tutte le risorse di cui è stato eseguito il commit con proprietà che corrispondere all'impegno e collegare queste prenotazioni all'impegno.

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

Collega le prenotazioni a impegni basati sulle risorse

Puoi collegare le prenotazioni a qualsiasi impegno basato sulle risorse e assicurarti che la capacità viene mantenuta in zone specifiche per le risorse impegnate che prevedi di per gli utilizzi odierni. Puoi collegare più prenotazioni a un singolo impegno. ma una prenotazione può essere collegata a un solo impegno. Quando acquisti un impegno, puoi collegare le prenotazioni a quell'impegno in uno dei seguenti modi:

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

Dopo aver acquistato un impegno con prenotazioni allegate, le prenotazioni e rimarranno attivi finché l'impegno sarà attivo. Alla scadenza dell'impegno, Compute Engine elimina automaticamente tutte le prenotazioni collegate. Eliminazione in corso... queste prenotazioni non hanno alcun effetto sulle VM in esecuzione che utilizzavano queste prenotazioni. Le VM in esecuzione continuano a essere eseguite e ti viene comunque addebitato l'importo per queste VM.

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

Risorse impegnate che non richiedono prenotazioni collegate

Le vCPU e la memoria impegnate non richiedono di collegare le prenotazioni corrispondenti i tuoi impegni. Tuttavia, quando acquisti un impegno che include vCPU, memoria o entrambe, puoi comunque scegliere di collegare le prenotazioni che specificano a queste risorse. Per scoprire come acquistare impegni esclusivamente per vCPU, memoria, o entrambe le cose, senza collegare prenotazioni, consulta Impegni di acquisto senza prenotazioni allegate.

Risorse impegnate che richiedono prenotazioni collegate

Per le GPU e i dischi SSD locali è necessario collegare le prenotazioni corrispondenti ai tuoi impegni. Quando acquisti un impegno che include qualsiasi GPU, Dischi SSD locali o entrambi, devi anche prenotare le risorse e collegarle le prenotazioni al tuo impegno. Puoi farlo utilizzando una singola prenotazione una combinazione di prenotazioni. Quando acquisti un impegno di questo tipo, puoi anche che includono vCPU, memoria o entrambe. Tuttavia, non è necessario prenotare le vCPU o memoria. Per scoprire come acquistare impegni che includono una o entrambe per le GPU e i dischi SSD locali, consulta Impegni di acquisto 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 Per i dischi SSD locali, consulta Tipi di impegno della documentazione relativa agli sconti per impegno di utilizzo (CUD) basati sulle risorse.

Quantità di risorse consentite nelle prenotazioni collegate

Per vCPU e memoria, puoi avere prenotazioni collegate specificando più meno risorse rispetto a quelle che ti impegni a raggiungere. Se ti impegni ad aumentare di vCPU o memoria rispetto a quella prenotata, Compute Engine prenota la capacità solo per queste risorse prenotate. Puoi però continuare a utilizzare impegnate risorse in base alla loro disponibilità nella regione. Se se prenoti più vCPU o memoria di quanto ti impegni, non riceverai sconti per impegno di utilizzo (CUD) per le risorse aggiuntive che prenoti.

Ad esempio, quando acquistare un impegno per 4 vCPU e 30 GB di memoria, puoi scegliere una delle seguenti opzioni:

• Non collegare affatto prenotazioni.

• collegare prenotazioni che specifichino una qualsiasi combinazione di questi tipi di risorse. della ad esempio:

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

Tuttavia, se il tuo impegno contiene GPU, dischi SSD locali o entrambi, devono prenotare e collegare tutte queste risorse. Le prenotazioni allegate devono e specificare i numeri esatti e i tipi di GPU e dischi SSD locali che impegnarsi. Di conseguenza, non puoi avere numeri o tipi aggiuntivi di GPU o dischi SSD locali nelle prenotazioni collegate. Ad esempio, supponi di acquistare un impegno per 30 GB e 4 GPU NVIDIA P100. La prenotazione allegata (o la combinazione di prenotazioni collegate) può specificare qualsiasi quantità di vCPU o memoria, ma avere esattamente 4 GPU di tipo NVIDIA P100. In questo esempio, non puoi collegare prenotazioni che specifichino una 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 a l'impegno in uno dei seguenti modi:

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

Dopo aver acquistato un impegno, questo diventa attivo sulla il giorno successivo alle 00:00 US and Canadian Pacific Time (UTC-8 o UTC-7 durante ora legale). Tra il momento dell'acquisto dell'impegno e quello di attivazione, i dello stato dell'impegno rimane NOT_YET_ACTIVE (o PENDING nel console Google Cloud). Dopo l'attivazione, lo stato dell'impegno diventa ACTIVE. Ad esempio, supponi di acquistare l'impegno il 20 gennaio alle 22:00. Fuso orario del Pacifico - Stati Uniti e Canada (UTC-8 o UTC-7). Compute Engine crea immediatamente con il suo stato NOT_YET_ACTIVE. Tuttavia, l'impegno diventa ACTIVE solo il 21 gennaio alle 00:00 (USA) e ora del Pacifico canadese (UTC-8 o UTC-7).

Requisiti

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

• Devi acquistare l'impegno e creare le prenotazioni allegate nel lo stesso progetto e la stessa regione.
• Devi acquistare l'impegno e creare le prenotazioni allegate per di risorse della stessa serie di famiglie di macchine.
• Devi disattivare opzione di eliminazione automatica sulle prenotazioni allegate.
• Se il tuo impegno ha GPU, il tipo di GPU specificato nella prenotazione e l'impegno deve corrispondere.
• Per GPU e dischi SSD locali, il numero di risorse prenotate di ciascun il tipo di risorsa deve corrispondere esattamente al numero di risorse di cui è stato eseguito il commit per quel tipo di risorsa. Ad esempio, se vuoi acquistare un impegno per 4 GPU V100, le prenotazioni allegate al tuo impegno devono specificare di 4 GPU V100. Tuttavia, la quantità di vCPU e memoria può essere superiore o inferiore a quello che ti impegni a rispettare.
• 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 le GPU NVIDIA P100, per coprire le GPU NVIDIA V100.

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

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

Collega prenotazioni esistenti

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

Autorizzazioni richieste per questa attività

Per eseguire questa attività, devi disporre di quanto segue autorizzazioni:

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

Console

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

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

   Vai a Sconti per impegno di utilizzo

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

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

4. Nel campo Regione, seleziona la regione in cui vuoi impegnarti alle risorse di Compute Engine.

5. Nel campo Tipo di impegno, seleziona la serie di famiglie di macchine per le tue risorse impegnate. I seguenti tipi di impegno offrono per GPU, dischi SSD locali o entrambi:

   • A2 ottimizzata per l'acceleratore per le risorse tipo di macchina A2
   • A3 ottimizzato per l'acceleratore per le risorse tipo di macchina A3 Standard
   • A3 Mega ottimizzata per l'acceleratore per le risorse tipo di macchina A3 Mega
   • C2 ottimizzato per il calcolo per risorse tipo di macchina C2
   • C2D ottimizzato per il calcolo per risorse tipo di macchina C2D
   • C3 per uso generico per risorse tipo di macchina C3
   • C3D per uso generico per le risorse tipo di macchina C3D
   • N1 per uso generico per risorse di tipo di macchina N1
   • N2 per uso generico per risorse di tipo di macchina N2
   • N2D per uso generico per risorse macchina N2D
   • G2 ottimizzato per la grafica per risorse tipo di macchina G2
   • Risorse del tipo di macchina M3 ottimizzate per la memoria forM3
   • Z3 ottimizzato per lo spazio di archiviazione per le risorse del tipo di macchina Z3

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

7. Nel campo Core, inserisci il numero di vCPU che vuoi impegnarti.

8. Nel campo Memoria, inserisci la quantità di memoria, in GB, su cui vuoi impegnarti.

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

   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 modello GPU supporta Workstation virtuali (vWS) NVIDIA RTX per carichi di lavoro di grafica e prevedi di eseguire carichi di lavoro ad alta intensità di grafica, seleziona 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 poi, nel campo Numero di SSD, specifica la di dischi permanenti.

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

    La console Google Cloud mostra un elenco di tutte le prenotazioni in del progetto le cui regione, tipo di macchina e tipo di GPU corrispondono l'impegno di un'azienda. Poi segui questi passaggi:

    1. Facoltativo. Per visualizzare le prenotazioni con proprietà specifiche, nei Menu Filtra, aggiungi o rimuovi i filtri per le proprietà che desiderato.
    2. Seleziona tutte le prenotazioni che vuoi collegare al l'impegno di un'azienda.
    Importante: i tipi e il numero totale di GPU e dischi SSD locali specificato in tutte le prenotazioni allegate deve corrispondere a ciò che specificato nel tuo impegno. In caso contrario, non potrai effettuare l'acquisto l'impegno.

12. Per completare l'acquisto dell'impegno con le prenotazioni allegate: procedi nel seguente modo:

    1. Fai clic su Acquista.
    2. Nella finestra di dialogo Acquista uno sconto per impegno di utilizzo, se accetti con i termini specifici del servizio, fai clic su Effettua di nuovo l'acquisto.

gcloud

Per acquistare un impegno collegando le prenotazioni esistenti, esegui Comando gcloud compute commitments create. Nel comando, includi il flag --existing-reservation per specificare un per la prenotazione esistente da collegare al tuo impegno. Includi un'opzione di questo flag per ogni prenotazione esistente a cui vuoi allega. Puoi collegare un numero qualsiasi di prenotazioni esistenti al tuo l'impegno di un'azienda.

Ad esempio, per acquistare un impegno allegando 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 è applicato l'impegno individuarlo.
• PROJECT_ID: l'ID del progetto in cui vuoi acquistare l'impegno con le prenotazioni allegate.
• DURATION: la durata del periodo dell'impegno, 12-month o 36-month.

• COMMITMENT_TYPE: tipo di impegno. La i seguenti tipi di impegno offrono opzioni per GPU, dischi SSD locali entrambi:

  • accelerator-optimized per risorse di tipo di macchina A2
  • accelerator-optimized-a3 per le risorse di tipo di macchina standard A3
  • accelerator-optimized-a3-mega per risorse di tipo di macchina A3 Mega
  • compute-optimized per le risorse del tipo di macchina C2
  • compute-optimized-c2d per le risorse del tipo di macchina C2D
  • compute-optimized-c3 per risorse di tipo di macchina C3
  • compute-optimized-c3d per le risorse di tipo di macchina C3D
  • general-purpose per risorse di tipo di macchina N1
  • general-purpose-n2 per risorse di tipo di macchina N2
  • general-purpose-n2d per le risorse macchina N2D
  • graphics-optimized per risorse di tipo di macchina G2
  • memory-optimized-m3 per risorse di tipo di macchina M3
  • storage-optimized-z3 per risorse di tipo di macchina Z3

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

• COMMITTED_MEMORY: l'importo, 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: l'importo, in GB, di Spazio SSD locale che vuoi includere nell'impegno. Ogni disco SSD locale è di 375 GB.

• COMMITTED_ACCELERATOR_COUNT: il numero di GPU che vuoi includere nell'impegno.

• COMMITTED_ACCELERATOR_TYPE: il tipo di GPU che vuoi includere nel tuo impegno.

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

• RESERVATION_ZONE_1 e RESERVATION_ZONE_2: le zone del alle 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 nel us-central1-a e us-central1-b zone del progetto myproject. Supponiamo che queste prenotazioni contengano una capacità combinata per 4 NVIDIA P100 GPU e 4 dischi SSD locali. Per acquistare un nuovo impegno nel us-central1 regione di questo progetto per queste GPU e dischi SSD locali, e utilizza queste prenotazioni esistenti come prenotazioni collegate, esegui . Tieni presente che l'impegno di esempio contiene anche vCPU la 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 POST al metodo regionCommitments.insert. Nella richiesta, includi il campo existingReservations per specificare un elenco separato da virgole di tutte le prenotazioni esistenti che vuoi al tuo impegno. Puoi collegare un numero qualsiasi di le prenotazioni 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 è applicato l'impegno individuarlo.
• 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: tipo di impegno. La i seguenti tipi di impegno offrono opzioni per GPU, dischi SSD locali entrambi:

  • ACCELERATOR_OPTIMIZED per risorse di tipo di macchina A2
  • ACCELERATOR_OPTIMIZED_A3 per le risorse di tipo di macchina standard A3
  • ACCELERATOR_OPTIMIZED_A3_MEGA per risorse di tipo di macchina A3 Mega
  • COMPUTE_OPTIMIZED per le risorse del tipo di macchina C2
  • COMPUTE_OPTIMIZED_C2D per le risorse del tipo di macchina C2D
  • COMPUTE_OPTIMIZED_C3 per risorse di tipo di macchina C3
  • COMPUTE_OPTIMIZED_C3D per le risorse di tipo di macchina C3D
  • GENERAL_PURPOSE per risorse di tipo di macchina N1
  • GENERAL_PURPOSE_N2 per risorse di tipo di macchina N2
  • GENERAL_PURPOSE_N2D per le risorse macchina N2D
  • GRAPHICS_OPTIMIZED per risorse di tipo di macchina G2
  • MEMORY_OPTIMIZED_M3 per risorse di tipo di macchina M3
  • STORAGE_OPTIMIZED_Z3 per risorse di tipo di macchina Z3

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

• COMMITTED_MEMORY: l'importo, in MB, di che vuoi includere nell'impegno. Ad esempio, 10240MB. Tu possono acquistare memoria in incrementi di 256 MB.

• COMMITTED_LOCAL_SSD: l'importo, in GB, di Spazio di archiviazione SSD locale che vuoi includere nell'impegno. Ogni disco SSD locale è di 375 GB.

• COMMITTED_ACCELERATOR_COUNT: il numero di le GPU che vuoi includere nell'impegno.

• COMMITTED_ACCELERATOR_TYPE: il tipo di GPU che vuoi includere nel tuo impegno.

• RESERVATION_URLs: un elenco separato da virgole di URL delle prenotazioni esistenti che vuoi collegare al l'impegno di un'azienda. Ad esempio, per collegare due prenotazioni, res-1 e res-2, specificare 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 nel us-central1-a e us-central1-b zone del progetto myproject. Supponiamo che queste prenotazioni contengano una capacità combinata per 4 NVIDIA P100 GPU e 4 dischi SSD locali. Per acquistare un nuovo impegno nel us-central1 regione di questo progetto per queste GPU e dischi SSD locali e per utilizzare queste prenotazioni esistenti come prenotazioni collegate, effettua la seguente richiesta POST. Tieni presente che anche l'impegno di esempio contiene 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 allegate durante l'acquisto del tuo impegno utilizzando la console Google Cloud, Google Cloud CLI o REST.

Autorizzazioni richieste per questa attività

Per eseguire questa attività, devi disporre di quanto segue autorizzazioni:

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

Console

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

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

   Vai a Sconti per impegno di utilizzo

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

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

4. Nel campo Regione, seleziona la regione in cui vuoi impegnarti alle risorse di Compute Engine.

5. Nel campo Tipo di impegno, seleziona la serie di famiglie di macchine per le tue risorse impegnate. I seguenti tipi di impegno offrono per GPU, dischi SSD locali o entrambi:

   • A2 ottimizzata per l'acceleratore per le risorse tipo di macchina A2
   • A3 ottimizzato per l'acceleratore per le risorse tipo di macchina A3 Standard
   • A3 Mega ottimizzata per l'acceleratore per le risorse tipo di macchina A3 Mega
   • C2 ottimizzato per il calcolo per risorse tipo di macchina C2
   • C2D ottimizzato per il calcolo per risorse tipo di macchina C2D
   • C3 per uso generico per risorse tipo di macchina C3
   • C3D per uso generico per le risorse tipo di macchina C3D
   • N1 per uso generico per risorse di tipo di macchina N1
   • N2 per uso generico per risorse di tipo di macchina N2
   • N2D per uso generico per risorse macchina N2D
   • G2 ottimizzato per la grafica per risorse tipo di macchina G2
   • Risorse del tipo di macchina M3 ottimizzate per la memoria forM3
   • Z3 ottimizzato per lo spazio di archiviazione per le risorse del tipo di macchina Z3

6. Per Durata, scegli 1 anno o 3 anni come durata dell'impegno.

7. Nel campo Core, inserisci il numero di vCPU che vuoi impegnarti.

8. Nel campo Memoria, inserisci la quantità di memoria, in GB, su cui vuoi impegnarti.

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

   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 modello GPU supporta Workstation virtuali (vWS) NVIDIA RTX per carichi di lavoro di grafica e prevedi di eseguire carichi di lavoro ad alta intensità di grafica, seleziona 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 poi, nel campo Numero di SSD, specifica la di dischi permanenti.

11. Per creare una nuova prenotazione e collegarla all'impegno, nel Nel campo Prenotazioni, seleziona Crea prenotazioni ed esegui le seguire. Ripeti questo passaggio per ogni nuova prenotazione da creare e allegare.

    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 tue risorse.

    5. Nella sezione Tipo di condivisione, specifica la modalità di condivisione in uno dei seguenti modi:

       • Per creare una prenotazione per un singolo progetto, seleziona Locale.
       • Per creare una prenotazione condivisa con più progetti, Seleziona Condivisi. Quindi, per specificare i progetti con cui condividere per questa prenotazione, fai clic Aggiungere progetti e quindi seleziona i progetti che ti interessano dall'elenco dell'organizzazione del progetto.

    6. Nel campo Utilizza con istanza VM, seleziona come vuoi che le VM usufruire della prenotazione in uno dei seguenti modi:

       • Consentire il consumo automatico delle VM con proprietà corrispondenti questa prenotazione, fai clic su Utilizza la prenotazione automaticamente (impostazione predefinita).
       • Per utilizzare le risorse di questa prenotazione solo durante la creazione delle VM con proprietà corrispondenti che scelgono come target questo una prenotazione per nome, fai clic su Seleziona una prenotazione specifica.

    7. Nella sezione Dettagli risorsa, segui questi passaggi:

       1. Nel campo Numero di istanze VM, inserisci il numero di VM le istanze 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 modello di istanza, seleziona Utilizza modello di istanza.

             Nel campo Modello di istanza, seleziona un'istanza che specifica la stessa serie di famiglie di macchine il tuo impegno. Se selezioni un modello di istanza regionale, anche la regione di quel modello di istanza deve corrispondere la regione specificata nell'impegno.

          2. Per specificare manualmente le proprietà delle VM, seleziona Seleziona il tipo di macchina, quindi:

             1. Seleziona la famiglia di macchine applicabile che hai specificato per l'impegno:

                • Uso generico per serie di macchine per uso generico
                • Ottimizzato per il calcolo per macchine ottimizzate per il calcolo serie
                • Ottimizzata per la memoria per macchina ottimizzato per la memoria serie
                • GPU per serie di macchine ottimizzate per l'acceleratore

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

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

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

             4. Per specificare una piattaforma CPU minima, GPU o entrambe: espandi Menu Piattaforma CPU e GPU ed eseguire le operazioni seguenti:

                1. (Facoltativo) Per specificare una piattaforma CPU minima, nel campo Plaform CPU, seleziona un'opzione.

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

                   Importante: i tipi e il numero totale di GPU specificato in tutte le prenotazioni allegate deve corrispondano a quanto specificato nell'impegno. In caso contrario, non potrai acquistare il per l'impegno.

             5. Per prenotare dischi SSD locali:

                1. Nel campo Numero di dischi, seleziona il numero il numero di dischi SSD locali che vuoi per ogni VM.
                2. Nel campo Tipo di interfaccia, seleziona la per i dischi SSD locali.
                Importante: il numero totale di dischi SSD locali specificati in tutte le prenotazioni allegate devono corrispondere in base a quanto specificato nell'impegno. Altrimenti, 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: procedi nel seguente modo:

    1. Fai clic su Acquista.
    2. Nella finestra di dialogo Acquista uno sconto per impegno di utilizzo, se accetti con i termini specifici del servizio, fai clic su Effettua di nuovo l'acquisto.

gcloud

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

Nota: non puoi utilizzare Google Cloud CLI per creare le prenotazioni collegate utilizzando i modelli di istanza. Devi invece specificare manualmente la VM proprietà 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 al tuo impegno, definisci le proprietà della prenotazione collegata eseguendo questo :

  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 collegare più prenotazioni al tuo impegno, definisci le proprietà della prenotazione utilizzando un file YAML e quindi specificare YAML nel comando che utilizzi per acquistare il tuo impegno. Facoltativamente, puoi anche utilizzare questo approccio basato sui file YAML per creare collegare una singola prenotazione al tuo impegno. Per creare il file allegato usando questo approccio, segui questi passaggi:

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

     - 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 questi passaggi per ogni prenotazione che vuoi creare. Puoi collegare il numero di prenotazioni esistenti che vuoi l'impegno di un'azienda.

  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 le prenotazioni allegate:

Impegno

• COMMITMENT_NAME: il nome dell'impegno.
• REGION: la regione in cui è applicato l'impegno individuarlo.
• 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: tipo di impegno. La i seguenti tipi di impegno offrono opzioni per GPU, dischi SSD locali o entrambi:

  • accelerator-optimized per risorse di tipo di macchina A2
  • accelerator-optimized-a3 per le risorse di tipo di macchina standard A3
  • accelerator-optimized-a3-mega per risorse di tipo di macchina A3 Mega
  • compute-optimized per le risorse del tipo di macchina C2
  • compute-optimized-c2d per le risorse del tipo di macchina C2D
  • compute-optimized-c3 per risorse di tipo di macchina C3
  • compute-optimized-c3d per le risorse di tipo di macchina C3D
  • general-purpose per risorse di tipo di macchina N1
  • general-purpose-n2 per risorse di tipo di macchina N2
  • general-purpose-n2d per le risorse macchina N2D
  • graphics-optimized per risorse di tipo di macchina G2
  • memory-optimized-m3 per risorse di tipo di macchina M3
  • storage-optimized-z3 per risorse di tipo di macchina Z3

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

• COMMITTED_MEMORY: l'importo, 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: l'importo, in GB, di Spazio di archiviazione SSD locale che vuoi includere nell'impegno. Ogni SSD locale sia di 375 GB.

• COMMITTED_ACCELERATOR_COUNT: il numero di le GPU che vuoi includere nell'impegno.

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

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

Prenotazioni collegate

• RESERVATION_NAME: il nome del token allegato prenotazione.
• RESERVATION_ZONE: la zona del prenotazione.
• REQUIRE_SPECIFIC_RESERVATION_VALUE: specifica se la prenotazione allegata è una prenotazione con targeting specifico; true o false. Per ulteriori informazioni sulle specifiche per le prenotazioni con targeting, consulta Come funzionano le prenotazioni.
• NUMBER_OF_RESERVED_VMS: il numero di VM che vuoi prenotare nella prenotazione allegata.

• RESERVED_MACHINE_TYPE: il tipo di macchina desiderato VM nella prenotazione collegata.

  • Per i tipi di macchina predefiniti, 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 tipi di macchine personalizzate.

    Sostituisci quanto segue:

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

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

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

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

• OWNER_PROJECT_ID: l'ID del progetto in cui vuoi acquistare l'impegno con prenotazione. Specifica questo campo se desideri condividere i tuoi allegati su più progetti consumer.

• MINIMUM_CPU_PLATFORM: il minimo Piattaforma CPU che vuoi specificare per la prenotazione collegata.

• SHARE_SETTING: il tipo di condivisione per alla prenotazione allegata. Specifica questo campo con il valore projects se vuoi condividere la prenotazione allegata tra più per i progetti consumer. Escludi questo campo se vuoi creare un 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 segmenti di pubblico in modo programmatico a gestire i progetti. Questi progetti devono trovarsi nella stessa organizzazione progetto proprietario. Non includere l'ID del progetto in cui crei per questa prenotazione, poiché il progetto può utilizzare questo per impostazione predefinita. Escludi questi campi se vuoi creare per un singolo progetto.

Compute Engine crea l'impegno e le prenotazioni collegate solo se ci sono risorse sufficienti per il tipo di macchina specificato zona target e una quota sufficiente al momento della richiesta. Se le tue l'acquisto è andato a buon fine, viene visualizzato un messaggio di operazione riuscita 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

I seguenti scenari di esempio e comandi mostrano come acquistare un per GPU, dischi SSD locali o entrambi creando nuove prenotazioni da collegare a questo impegno.

Esempio 1: acquistare un impegno per le GPU mediante il collegamento di una nuova prenotazione

Supponiamo di voler acquistare un impegno commitment-01 nel Regione us-central1 che include 4 GPU NVIDIA V100. Vuoi creare un'istanza nuova prenotazione reservation-01 come prenotazione allegata per per le GPU. Supponiamo anche di voler specificare che Compute Engine utilizza queste GPU prenotate su 2 VM n1-standard-32 in us-central1-a zona di destinazione. Per acquistare questo impegno di esempio con la prenotazione allegata, esegui il seguente 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 le GPU senza impegnarti in vCPU o memoria

Eseguire il commit e la prenotazione di GPU e dischi SSD locali senza impegnarsi a vCPU o memoria, specifica 0 come valore per le quantità di vCPU e memoria. Ad esempio, supponi di voler acquistare un impegno commitment-02 per un singola GPU NVIDIA P4 nella regione us-west2. Devi inoltre creare un nuovo come prenotazione allegata e specificare Compute Engine per utilizzare la GPU prenotata su una VM n1-standard-2 nel us-west2-b zona. Per acquistare questo impegno di esempio con i relativi allegati 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 di voler acquistare un impegno commitment-03 per 1 GPU NVIDIA V 100 e 2 dischi SSD locali nella regione us-central1. Inoltre creare e collegare due prenotazioni us-central1-a zona. Nella prima prenotazione, res-01, vuoi riserva 1 VM n1-standard-2 con 1 GPU. Vuoi rendere res-01 un con targeting, perciò devi scegliere come target in modo specifico per nome al fine di usare le rispettive 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, devi prima creare 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 la relativa alle prenotazioni collegate, esegui il comando seguente. Tieni presente che l'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 prenotazioni allegate durante l'acquisto del tuo impegno, invia una richiesta POST a Metodo regionCommitments.insert. Nella richiesta, includi il campo reservations per definire un elenco di tutte le nuove prenotazioni che vuoi creare e collegare. Puoi allegare qualsiasi di prenotazioni esistenti per le quali vuoi sottoscrivere l'impegno.

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

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

  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 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 le prenotazioni allegate:

Impegno

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

• COMMITMENT_TYPE: tipo di impegno. La i seguenti tipi di impegno offrono opzioni per GPU, dischi SSD locali o entrambi:

  • ACCELERATOR_OPTIMIZED per risorse di tipo di macchina A2
  • ACCELERATOR_OPTIMIZED_A3 per le risorse di tipo di macchina standard A3
  • ACCELERATOR_OPTIMIZED_A3_MEGA per risorse di tipo di macchina A3 Mega
  • COMPUTE_OPTIMIZED per le risorse del tipo di macchina C2
  • COMPUTE_OPTIMIZED_C2D per le risorse del tipo di macchina C2D
  • COMPUTE_OPTIMIZED_C3 per risorse di tipo di macchina C3
  • COMPUTE_OPTIMIZED_C3D per le risorse di tipo di macchina C3D
  • GENERAL_PURPOSE per risorse di tipo di macchina N1
  • GENERAL_PURPOSE_N2 per risorse di tipo di macchina N2
  • GENERAL_PURPOSE_N2D per le risorse macchina N2D
  • GRAPHICS_OPTIMIZED per risorse di tipo di macchina G2
  • MEMORY_OPTIMIZED_M3 per risorse di tipo di macchina M3
  • STORAGE_OPTIMIZED_Z3 per risorse di tipo di macchina Z3

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

• COMMITTED_MEMORY: l'importo, in MB, di che vuoi includere nell'impegno. Ad esempio, 10240MB. Tu possono acquistare memoria in incrementi di 256 MB.

• COMMITTED_LOCAL_SSD: l'importo, in GB, di Spazio di archiviazione SSD locale che vuoi includere nell'impegno. Ogni SSD locale sia di 375 GB.

• COMMITTED_ACCELERATOR_COUNT: il numero di le GPU che vuoi includere nell'impegno.

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

Prenotazioni collegate

• RESERVATION_NAME: il nome del token allegato prenotazione.
• RESERVATION_ZONE: la zona del prenotazione.
• REQUIRE_SPECIFIC_RESERVATION_VALUE: specifica se la prenotazione allegata è una prenotazione con targeting specifico; true o false. Per ulteriori informazioni sulle specifiche per le prenotazioni con targeting, consulta Come funzionano le prenotazioni.
• NUMBER_OF_RESERVED_VMS: il numero di VM che vuoi prenotare nella prenotazione allegata.

• RESERVED_MACHINE_TYPE: il tipo di macchina desiderato VM nella prenotazione collegata.

  • Per i tipi di macchina predefiniti, 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 tipi di macchine personalizzate.

    Sostituisci quanto segue:

    • MACHINE_FAMILY: la famiglia di macchine tipi; Ad esempio, specifica n2 per le VM N2.
    • CPUS: il numero di vCPUs.
    • MEMORY: la memoria totale per un VM. La memoria deve essere un multiplo di 256 MB e deve essere fornito 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 allegata.

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

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

• MINIMUM_CPU_PLATFORM: il minimo Piattaforma CPU che vuoi specificare per la prenotazione collegata.

• INSTANCE_TEMPLATE_NAME: il nome del che vuoi utilizzare per creare i tuoi file prenotazione.

• SHARE_SETTING: il tipo di condivisione per alla prenotazione allegata. Specifica questo campo con il valore SPECIFIC_PROJECTS se vuoi condividere la prenotazione allegata in più progetti consumer. Escludi questo campo se vuoi per 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 segmenti di pubblico in modo programmatico a gestire i progetti. Questi progetti devono trovarsi nella stessa organizzazione progetto proprietario. Non includere l'ID del progetto in cui crei per questa prenotazione, poiché il progetto può utilizzare questo per impostazione predefinita. Escludi questi campi se vuoi creare un per un singolo progetto.

Compute Engine crea solo l'impegno e le prenotazioni allegate se nella destinazione sono presenti risorse sufficienti del tipo di macchina specificato e una quota sufficiente al momento della richiesta. Se il tuo acquisto è riuscita, Compute Engine restituisce uno stato 200 per Richiesta API REST.

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

I seguenti scenari di esempio e comandi mostrano come acquistare un per GPU, dischi SSD locali o entrambi creando nuove prenotazioni da collegare a questo impegno.

Esempio 1: acquistare un impegno per le GPU mediante il collegamento di una nuova prenotazione

Supponiamo di voler acquistare un impegno commitment-01 nel Regione us-central1 che include 4 GPU NVIDIA V100. Vuoi crea una nuova prenotazione reservation-01 come allegato per quelle GPU. Supponiamo di voler specificare anche Compute Engine per utilizzare le GPU prenotate su 2 n1-standard-8 VM nella zona us-central1-a. Per acquistare questo impegno di esempio con la 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 le GPU senza impegnarti in vCPU o memoria

Eseguire il commit e la prenotazione di GPU e dischi SSD locali senza impegnarsi a vCPU o memoria, 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. Devi inoltre creare una nuova prenotazione come prenotazione allegata e specificare Compute Engine per utilizzare la GPU prenotata su una VM n1-standard-2 in zona us-west2-b. Per acquistare questo impegno di esempio con i relativi allegati 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 di voler acquistare un impegno commitment-03 per 1 GPU NVIDIA V 100 e 2 dischi SSD locali nella regione us-central1. Inoltre creare e collegare due prenotazioni us-central1-a zona. Nella prima prenotazione, res-01, vuoi riserva 1 VM n1-standard-2 con 1 GPU. Vuoi rendere res-01 un con targeting, perciò devi scegliere come target in modo specifico per nome al fine di usare le rispettive 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 per 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 agli impegni

Sostituisci le prenotazioni collegate all'impegno con nuove prenotazioni se modificare i tipi e i numeri di VM che utilizzano le risorse sottoposte a commit.

Modifiche consentite

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

• Puoi prenotare le VM da un tipo di macchina diverso. Tuttavia, devi comunque prenotare 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 che vuoi prenotare.
• Puoi modificare la quantità di GPU e dischi SSD locali collegati per VM purché la quantità totale di GPU e dischi SSD locali prenotati rimangono invariati.

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

  Importante: se una prenotazione associata a un impegno viene utilizzata da un progetto non incluso nell'impegno, non riceverai prezzo scontato. Se le prenotazioni allegate sono prenotazioni condivise, per condividere le prenotazioni solo con i progetti inclusi a garantire la ricezione degli sconti per impegno di utilizzo.

Requisiti

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

• Puoi sostituire una sola prenotazione allegata alla volta con una sola prenotazione nuova prenotazione allegata. Per sostituire una prenotazione collegata, contemporaneamente Rimuovi una prenotazione collegata esistente impostando il conteggio delle relative VM su 0 e definisci una nuova prenotazione allegata con cui sostituirla.
• La nuova prenotazione deve esistere nello stesso progetto dell'impegno.
• La nuova prenotazione deve trovarsi nella stessa zona dell'area rimossa prenotazione.
• Il numero e i tipi di GPU specificati nella nuova prenotazione devono corrispondere ai valori prenotazione rimossa.
• I numeri e i tipi di dischi SSD locali specificati nella nuova prenotazione deve corrispondere alla prenotazione rimossa.
• Puoi modificare solo fino a 100 VM per richiesta. Per apportare una modifica comporta più di 100 VM, dividi la modifica in più VM richieste o contattare l'assistenza Google Cloud.

La richiesta di sostituzione di una prenotazione dipende anche dalla disponibilità della capacità in quel momento. Se la capacità per una richiesta non è disponibile, la richiesta non va a buon fine. 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 allegata non va a buon fine, le risorse prenotate esistenti non subiranno modifiche. Per preservare la tua capacità, attendi di apportare le modifiche corrispondenti alle tue VM fino a quando la tua richiesta di sostituzione di una prenotazione va a buon fine.

Procedura per sostituire una prenotazione allegata

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

gcloud

Per sostituire le prenotazioni collegate agli impegni:

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

   • La prenotazione attuale da sostituire.

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

   • La nuova prenotazione della sostituzione.

   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 dello stato attuale e le prenotazioni di sostituzione:

   Prenotazione attuale

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

   • CURRENT_RESERVATION_NAME: il nome del è attualmente associata alla prenotazione.
   • CURRENT_RESERVATION_ZONE: la zona del è attualmente associata alla prenotazione.
   • CURRENT_RESERVATION_MACHINE_TYPE: il tipo di macchina del modello prenotazione.
   • CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS: il numero di GPU prenotate nell'attuale prenotazione collegata.
   • CURRENT_RESERVATION_ACCELERATOR_TYPE: il tipo di acceleratore prenotato nell'elenco alla prenotazione allegata.
   • CURRENT_RESERVATION_INTERFACE_1 e CURRENT_RESERVATION_INTERFACE_2: il tipo dell'interfaccia utente del disco SSD locale per ogni utilizzo della VM prenotata nell'attuale prenotazione allegata. Le opzioni valide sono: scsi e nvme. Ogni disco SSD locale 375 GB. Ripeti il parametro local_ssd per tutte le risorse prenotate Dischi SSD locali.
   • CURRENT_RESERVATION_PROJECT_ID: l'ID del progetto attuale con e la prenotazione allegata. Specifica questo campo se la prenotazione attuale allegata è condivisa tra più per i progetti consumer.
   • CURRENT_RESERVATION_SHARE_SETTING: Il tipo di condivisione per la prenotazione corrente. Specifica questo campo con il valore projects se la prenotazione attuale allegata è 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 attuale collegata, ad esempio project-1 e project-2.

   Prenotazione sostituzione

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

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

   • REPLACEMENT_RESERVATION_MACHINE_TYPE: il tipo di macchina desiderato VM nella nuova prenotazione di sostituzione.

     • Per i tipi di macchina predefiniti, 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 tipi di macchine personalizzate.

     Sostituisci quanto segue:

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

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

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

   • REPLACEMENT_RESERVATION_INTERFACE_1 e REPLACEMENT_RESERVATION_INTERFACE_2: il il tipo di interfaccia su cui desideri 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 con e la prenotazione allegata. Specifica questo campo se vuoi condividere la prenotazione per la sostituzione tra più per i progetti consumer.

   • REPLACEMENT_RESERVATION_SHARE_SETTING: il tipo di condivisione per la prenotazione della sostituzione. Specifica questo campo con il valore projects se vuoi condividere la prenotazione della sostituzione in 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 del proprietario. Non includere REPLACEMENT_RESERVATION_PROJECT_ID, che è già autorizzato a utilizzare questa prenotazione per impostazione predefinita.

2. Esegui gcloud beta compute commitments update-reservations. e specificare il percorso del file YAML utilizzando 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 del con la prenotazione allegata.
   • PROJECT_ID: l'ID progetto del con la prenotazione allegata.
   • REGION: la regione in cui è applicato l'impegno individuarlo.
   • YAML_FILE: il percorso del file YAML contiene la configurazione del modello attuale e di quello sostitutivo prenotazioni.

Esempio per la sostituzione di una prenotazione collegata a un impegno

Per dimostrarlo, questa sezione mostra impegno di esempio con una prenotazione allegata e su come sostituire l'esempio di prenotazione collegata.

Impegno di esempio con una prenotazione allegata

Ad esempio, supponiamo che tu voglia aggiornare le prenotazioni allegate per l'impegno my-commitment-with-reservations, acquistato con 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, supponiamo che al momento dell'esecuzione del comando one-reservation.yaml era un file nella directory corrente con seguenti, che definiscono 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 gli allegati la prenotazione res-1 ha comportato il commit e l'utilizzo delle seguenti opzioni di risorse:

Tipo di risorsa	Risorse nell'impegno (my-commitment-with-reservations)	Risorse nella prenotazione attuale allegata (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)^*

^*In particolare, l'esempio prenotazione allegata, res-1, prenota 4 n1-standard-4 VM, ciascuna con 1 GPU P100 e 2 dischi SSD locali di scsi tipo di interfaccia. n1-standard-4 tipo di macchina utilizza 4 vCPU e 15 GB per ogni VM.

Sostituisci la prenotazione collegata di esempio

Supponiamo di voler sostituire la prenotazione allegata res-1 per con una nuova prenotazione res-2 collegata e modifica le risorse prenotate a:

Tipo di risorsa	Risorse nell'impegno (my-commitment-with-reservations)	Risorse nella prenotazione attuale allegata (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)^*

^*In particolare, l'esempio prenotazione allegata, res-1, prenota 4 n1-standard-4 VM, ciascuna con 1 GPU P100 e 2 dischi SSD locali di scsi tipo di interfaccia. n1-standard-4 tipo di macchina utilizza 4 vCPU e 15 GB per ogni VM.

^†In particolare, la sostituzione la prenotazione allegata definisce res-2, che ne riserva 2 n1-standard-8 VM, ciascuna con 1 GPU P100 e 4 dischi SSD locali di tipo di interfaccia scsi. Inoltre, res-2 è condiviso con altri 2 progetti, project-1 e project-2 e di proprietà del progetto attuale, my-project. La macchina n1-standard-8 utilizza 8 vCPU e 30 GB per ogni VM.

Per sostituire la prenotazione allegata res-1 con res-2 per l'impegno my-commitment-with-reservations, segui questi passaggi:

1. Crea un file denominato two-reservations.yaml nella directory corrente tale file include 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 collegate agli impegni, crea un POST tramite 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, la prenotazione corrente e la prenotazione sostitutiva:

Impegno

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

Prenotazione attuale

Per la prenotazione corrente, tutte le seguenti proprietà devono essere esattamente come quando hai visualizzato la prenotazione. Ometti i campi per tutte le proprietà non già specificate nella prenotazione corrente.

• CURRENT_RESERVATION_NAME: il nome del è attualmente associata alla prenotazione.
• CURRENT_RESERVATION_ZONE: la zona del è attualmente associata alla prenotazione.
• CURRENT_RESERVATION_MACHINE_TYPE: il tipo di macchina del modello prenotazione.
• CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS: il di GPU prenotate nell'attuale prenotazione collegata.
• CURRENT_RESERVATION_ACCELERATOR_TYPE: il tipo di acceleratore prenotato nell'elenco alla prenotazione allegata.
• CURRENT_RESERVATION_INTERFACE_1 e CURRENT_RESERVATION_INTERFACE_2: il tipo dell'interfaccia utente dei dischi SSD locali per ogni utilizzo della VM prenotata nell'attuale prenotazione allegata. 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 corrente. Specifica questo parametro con il valore projects se la prenotazione attuale allegata è 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 attuale collegata, ad esempio project-1 e project-2.

Prenotazione sostituzione

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

• REPLACEMENT_RESERVATION_NAME: il nome del nuova prenotazione di sostituzione.
• REPLACEMENT_RESERVATION_ZONE: la zona del nuova prenotazione di sostituzione.
• REPLACEMENT_RESERVATION_NUMBER_OF_VMS: il di VM da prenotare nella nuova prenotazione di sostituzione.

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

  • Per i tipi di macchina predefiniti, 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 tipi di macchine personalizzate.

  Sostituisci quanto segue:

  • MACHINE_FAMILY: la famiglia di tipi di macchina; 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 fornito in MB; ad esempio, per creare una VM N2 con 4 vCPU 5 GB di memoria, che è 5120 MB, utilizza n2-custom-4-5120.

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

• REPLACEMENT_RESERVATION_ACCELERATOR_TYPE: il tipo di acceleratore che desideri aggiungere nella prenotazione di una sostituzione.

• REPLACEMENT_RESERVATION_INTERFACE_1 e REPLACEMENT_RESERVATION_INTERFACE_2: il tipo di interfaccia con 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 della sostituzione. Specifica questo con il valore projects se vuoi condividere i tuoi una prenotazione di sostituzione in 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 del 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 impegno di esempio con una prenotazione allegata e su come sostituire l'esempio di prenotazione collegata.

Impegno di esempio con una prenotazione allegata

Ad esempio, supponiamo che tu voglia sostituire la prenotazione allegata res-1 per l'impegno my-commitment-with-reservations, ovvero acquistato presentando 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 gli allegati la prenotazione res-1 ha comportato il commit e l'utilizzo delle seguenti opzioni di risorse:

Tipo di risorsa	Risorse nell'impegno (my-commitment-with-reservations)	Risorse nella prenotazione attuale allegata (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)^*

^*In particolare, l'esempio prenotazione allegata, res-1, prenota 4 n1-standard-4 VM, ciascuna con 1 GPU P100 e 2 dischi SSD locali con interfaccia scsi di testo. n1-standard-4 tipo di macchina utilizza 4 vCPU e 15 GB per ogni VM.

Sostituisci la prenotazione collegata di esempio

Supponiamo di voler sostituire la prenotazione allegata res-1 per con una nuova prenotazione res-2 collegata e modifica le risorse prenotate a:

Tipo di risorsa	Risorse nell'impegno (my-commitment-with-reservations)	Risorse nella prenotazione attuale allegata (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)^*

^*In particolare, l'esempio prenotazione allegata, res-1, prenota 4 n1-standard-4 VM, ciascuna con 1 GPU P100 e 2 dischi SSD locali di scsi tipo di interfaccia. n1-standard-4 tipo di macchina utilizza 4 vCPU e 15 GB per ogni VM.

^†In particolare, la sostituzione la prenotazione allegata definisce res-2, che ne riserva 2 n1-standard-8 VM, ciascuna con 1 GPU P100 e 4 dischi SSD locali di tipo di interfaccia scsi. Inoltre, res-2 è condiviso con altri 2 progetti, project-1 e project-2 e 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 allegata res-1 con res-2 per l'impegno my-commitment-with-reservations, esegui quanto segue richiesta POST utilizzando 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 sconti per impegno di utilizzo (CUD) basati sulle risorse.
• Scopri come utilizzare le prenotazioni.
• Scopri come modificare le prenotazioni.
• Scopri come eliminare le prenotazioni.