Sconti per impegno di utilizzo basati sulle risorse

Console

Prima di acquistare un impegno utilizzando la console Google Cloud, seleziona il progetto che vuoi utilizzare per l'acquisto dell'impegno. Se la condivisione dei dati CUD è abilitata per un account di fatturazione Cloud, puoi acquistare l'impegno utilizzando qualsiasi progetto di quell'account di fatturazione Cloud. Dopo aver selezionato il progetto:

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

   Vai a Sconti per impegno di utilizzo

2. Per acquistare un impegno, fai clic su add_box Acquista impegno. Viene visualizzata la pagina Acquista uno sconto per impegno di utilizzo, con 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 per le risorse Compute Engine.

5. Nel campo Tipo di impegno, seleziona la serie della famiglia di macchine per le risorse impegnate. Per le vCPU, la memoria o entrambe, puoi scegliere tra i seguenti tipi di impegno:

   • A2 ottimizzato per l'acceleratore per le risorse del tipo di macchina A2
   • A3 ottimizzato per l'acceleratore per le risorse tipo di macchina A3 Edge e High
   • A3 Mega ottimizzato per l'acceleratore per le risorse del tipo di macchina A3 Mega
   • C2 ottimizzate per il calcolo per le risorse del tipo di macchina C2
   • C2D ottimizzato per il calcolo per le risorse di tipo di macchina C2D
   • H3 ottimizzato per il calcolo per le risorse del tipo di macchina H3
   • C3 per uso generico per le risorse del tipo di macchina C3
   • C3D per uso generico per le risorse del tipo di macchina C3D
   • C4 per uso generico per le risorse del tipo di macchina C4
   • C4A per uso generico per le risorse del tipo di macchina C4A
   • E2 per uso generico per le risorse di tipo di macchina E2
   • N1 per uso generico per le risorse di tipo di macchina N1
   • Uso generico N2 per le risorse di tipo di macchina N2
   • N2D per uso generico per le risorse delle macchine N2D
   • N4 per uso generico per le risorse di tipo di macchina N4
   • T2D per uso generico per le risorse di tipo di macchina Tau T2D
   • G2 ottimizzate per la grafica per le risorse del tipo di macchina G2
   • M1/M2 ottimizzate per la memoria per le risorse di tipo di macchina M1 o M2
   • M3 con ottimizzazione per la memoria per le risorse del tipo di macchina M3
   • Z3 ottimizzata per lo spazio di archiviazione per le risorse del tipo di macchina Z3

6. Nella sezione Durata:

   1. Per specificare il piano del tuo impegno, seleziona 1 anno o 3 anni. Questa impostazione determina la durata preimpostata del tuo impegno.

   2. Facoltativo. Per specificare una durata del termine personalizzata per l'impegno, fai clic sul pulsante di attivazione/disattivazione Estendi data di fine e poi, nel campo Data, specifica la data di fine personalizzata che preferisci. Per ulteriori informazioni, consulta Prolungare la durata degli impegni.

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

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

9. Per completare l'acquisto del tuo impegno:

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

gcloud

Utilizzando gcloud CLI, esegui il comando gcloud compute commitments create:

gcloud compute commitments create COMMITMENT_NAME \
    --region REGION \
    --project PROJECT_ID \
    --resources vcpu=NUMBER_VCPUS,memory=MEMORY \
    --plan DURATION \
    --type COMMITMENT_TYPE

Sostituisci quanto segue:

• COMMITMENT_NAME: il nome con cui vuoi identificare questo impegno.
• REGION: la regione a cui si applica questo impegno. Ogni regione ha prezzi di impegno diversi. Per i prezzi attuali, consulta il listino prezzi.
• PROJECT_ID: l'ID progetto per il quale vuoi creare l'impegno.
• NUMBER_VCPUS: il numero di vCPU per le quali vuoi acquistare impegni. Il numero di vCPU deve essere un numero intero maggiore o uguale a 0 e può essere pari o dispari.
• MEMORY: la quantità, in MB o GB, di memoria per la quale sei disposto ad acquistare impegni. Ad esempio, 1000MB. Se le unità non sono specificate, l'unità predefinita utilizzata è GB. La memoria può essere acquistata con incrementi di 0,25 GB.
• DURATION: la durata dell'impegno, 12-month o 36-month.

• COMMITMENT_TYPE: uno dei seguenti:

  • accelerator-optimized per le risorse di tipo di macchina A2
  • accelerator-optimized-a3 per le risorse tipo di macchina A3 Edge e High
  • accelerator-optimized-a3-mega per le risorse del tipo di macchina A3 Mega
  • 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 di tipo di macchina C3D
  • compute-optimized-h3 per le risorse del tipo di macchina H3
  • general-purpose per le risorse di tipo di macchina N1
  • general-purpose-c4 per le risorse del tipo di macchina C4
  • general-purpose-c4a per le risorse del tipo di macchina C4A
  • general-purpose-e2 per le risorse relative tipo di macchina E2
  • general-purpose-n2 per le risorse di tipo di macchina N2
  • general-purpose-n2d per le risorse delle macchine N2D
  • general-purpose-n4 per le risorse di tipo di macchina N4
  • general-purpose-t2d per le risorse di tipo di macchina Tau T2D
  • graphics-optimized per le risorse di tipo di macchina G2
  • memory-optimized per le risorse di tipo di macchina M1 o M2
  • memory-optimized-m3 per le risorse del tipo di macchina M3
  • storage-optimized-z3 per le risorse del tipo di macchina Z3

  Se non specifichi il flag --type, il valore predefinito utilizzato è general-purpose.

Esempi

• Per creare un impegno per uso generico per i tipi di macchine N1, puoi utilizzare il seguente esempio:

  gcloud compute commitments create example-commitment --region us-central1 \
    --resources vcpu=5,memory=33280MB --plan 12-month \
    --project=myproject
  

• Per creare un impegno ottimizzato per il calcolo, utilizza il comando gcloud compute commitments create, che consente di acquistare un impegno di 1 anno per un tipo di macchina ottimizzato per il calcolo:

  gcloud compute commitments create example-compute-optimized-commitment \
    --region us-central1 --resources vcpu=2,memory=3814GB --plan 12-month \
    --type compute-optimized --project=myproject
  

• Per creare un impegno ottimizzato per la memoria:

  gcloud compute commitments create example-memory-optimized-commitment \
    --region us-central1 --resources vcpu=96,memory=1434MB \
    --plan 12-month --type memory-optimized \
    --project=myproject
  

• Per creare un impegno ottimizzato per l'acceleratore, devi acquistare l'impegno con una prenotazione allegata di supporto utilizzando il gcloud compute commitments create comando. Devi anche specificare il numero totale di risorse (incluse le GPU) di cui hai bisogno.

  Quando crei gli impegni GPU, devi specificare i flag --accelerator e --resources-accelerator. Il flag --accelerator specifica il numero di GPU collegate a ogni VM. Il flag --resources-accelerator specifica il numero totale di GPU nell'impegno.

  Ad esempio, l'impegno riportato di seguito include 96 vCPU, 680 GB di memoria, 8 GPU e una prenotazione per l'utilizzo di queste GPU in 2 VM in us-central1-a.

  gcloud compute commitments create example-accelerator-optimized-commitment \
    --region=us-central1 \
    --project=myproject \
    --resources=vcpu=96,memory=680GB \
    --resources-accelerator=count=8,type=nvidia-tesla-a100 \
    --plan 12-month \
    --type accelerator-optimized \
  
    --reservation=reservation-01 \
    --reservation-zone=us-central1-a \
    --machine-type=a2-highgpu-4g \
    --accelerator=count=4,type=nvidia-tesla-a100 \
    --vm-count=2
  
  

• Per creare un impegno per GPU, dischi SSD locali o entrambi, devi acquistare l'impegno con una prenotazione allegata utilizzando il comando gcloud compute commitments create.

  Quando crei gli impegni GPU, devi specificare i flag --accelerator e --resources-accelerator. Il flag --accelerator specifica il numero di GPU collegate a ogni VM. Il flag --resources-accelerator specifica il numero totale di GPU nell'impegno.

  Ad esempio, l'impegno riportato di seguito include 4 GPU e una prenotazione per l'utilizzo di queste GPU in 2 istanze in us-central1-a.

  gcloud compute commitments create example-reservation-commitment \
    --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
    
  

REST

Nell'API, invia una richiesta POST al metodo regionCommitments.insert, con un corpo della richiesta contenente informazioni sull'impegno:

https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments?requestId=OPTIONAL_UNIQUE_ID

Il corpo della risorsa deve contenere quanto segue:

• name per il nome dell'impegno
• plan per la durata dell'impegno, TWELVE_MONTH o THIRTY_SIX_MONTH
• resources per specificare la quantità di memoria e vCPU. La memoria deve essere specificata in MB. Devi specificare sia VCPU che MEMORY nella sezione resources.

• type di impegno, uno dei seguenti:

  • ACCELERATOR_OPTIMIZED per le risorse di tipo di macchina A2
  • ACCELERATOR_OPTIMIZED_A3 per le risorse tipo di macchina A3 Edge e High
  • ACCELERATOR_OPTIMIZED_A3_MEGA per le risorse del tipo di macchina A3 Mega
  • 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 di tipo di macchina C3D
  • COMPUTE_OPTIMIZED_H3 per le risorse del tipo di macchina H3
  • GENERAL_PURPOSE per le risorse di tipo di macchina N1
  • GENERAL_PURPOSE_C4 per le risorse del tipo di macchina C4
  • GENERAL_PURPOSE_C4A per le risorse del tipo di macchina C4A
  • GENERAL_PURPOSE_E2 per le risorse relative tipo di macchina E2
  • GENERAL_PURPOSE_N2 per le risorse di tipo di macchina N2
  • GENERAL_PURPOSE_N2D per le risorse delle macchine N2D
  • GENERAL_PURPOSE_N4 per le risorse di tipo di macchina N4
  • GENERAL_PURPOSE_T2D per le risorse di tipo di macchina Tau T2D
  • GRAPHICS_OPTIMIZED per le risorse di tipo di macchina G2
  • MEMORY_OPTIMIZED per le risorse di tipo di macchina M1 o M2
  • MEMORY_OPTIMIZED_M3 per le risorse del tipo di macchina M3
  • STORAGE_OPTIMIZED_Z3 per le risorse del tipo di macchina Z3

Ad esempio, il seguente comando crea un impegno di 1 anno con 5 vCPU e 18,75 GB di memoria:

{
    "name": "example-commitment",
    "plan": "TWELVE_MONTH",
    "type": "GENERAL_PURPOSE",
    "resources": [
        {
            "amount": "5",
            "type": "VCPU"
        },
        {
            "amount": "19200",
            "type": "MEMORY"
        }
    ]
}

Per creare un impegno ottimizzato per la memoria, includi la proprietà type. L'esempio seguente mostra un acquisto di un impegno di 1 anno per un tipo di macchina m1-megamem-96:

{
    "name": "example-memory-optimized-commitment",
    "plan": "TWELVE_MONTH",
    "type": "MEMORY_OPTIMIZED",
    "resources": [
        {
            "amount": "96",
            "type": "VCPU"
        },
        {
            "amount": "1434",
            "type": "MEMORY"
        }
      ]
}```

To create a compute-optimized commitment, include the `type` property. The
following example, purchases a 1 year commitment for a `c2-standard-16`
machine type:

```json
{
    "name": "example-compute-optimized-commitment",
    "plan": "TWELVE_MONTH",
    "type": "COMPUTE_OPTIMIZED",
    "resources": [
        {
            "amount": "16",
            "type": "VCPU"
        },
        {
            "amount": "1434",
            "type": "MEMORY"
        }
    ]
}

Console

Prima di acquistare un impegno utilizzando la console Google Cloud, seleziona il progetto che vuoi utilizzare per l'acquisto dell'impegno. Se la condivisione dei dati CUD è abilitata per un account di fatturazione Cloud, puoi acquistare l'impegno utilizzando qualsiasi progetto di quell'account di fatturazione Cloud. Dopo aver selezionato il progetto:

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

   Vai a Sconti per impegno di utilizzo

2. Per acquistare un impegno, fai clic su add_box Acquista impegno. Viene visualizzata la pagina Acquista uno sconto per impegno di utilizzo, con 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 per le risorse Compute Engine.

5. Nel campo Tipo di impegno, seleziona la serie della famiglia di macchine per le risorse impegnate. I seguenti tipi di impegno forniscono opzioni per GPU, dischi SSD locali o entrambi:

   • A2 ottimizzato per l'acceleratore per le risorse del tipo di macchina A2
   • A3 ottimizzato per l'acceleratore per le risorse tipo di macchina A3 Edge e High
   • A3 Mega ottimizzato per l'acceleratore per le risorse del tipo di macchina A3 Mega
   • C2 ottimizzate per il calcolo per le risorse del tipo di macchina C2
   • C2D ottimizzato per il calcolo per le risorse di tipo di macchina C2D
   • C3 per uso generico per le risorse del tipo di macchina C3
   • C3D per uso generico per le risorse del tipo di macchina C3D
   • N1 per uso generico per le risorse di tipo di macchina N1
   • Uso generico N2 per le risorse di tipo di macchina N2
   • N2D per uso generico per le risorse delle macchine N2D
   • G2 ottimizzate per la grafica per le risorse del tipo di macchina G2
   • M3 con ottimizzazione per la memoria per le risorse del tipo di macchina M3
   • Z3 ottimizzata per lo spazio di archiviazione per le risorse del tipo di macchina Z3

6. Per Durata:

   1. Per specificare il piano del tuo impegno, seleziona 1 anno o 3 anni. Questa impostazione determina la durata preimpostata del tuo impegno.

   2. Facoltativo. Per specificare una durata del termine personalizzata per l'impegno, fai clic sul pulsante di attivazione/disattivazione Estendi data di fine e poi, nel campo Data, specifica una data di fine personalizzata. Per ulteriori informazioni, consulta Prolungare la durata degli impegni.

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

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

9. Per eseguire il commit delle GPU, nella sezione GPU, fai clic su add Aggiungi GPU e poi 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 modello di GPU supporta le workstation virtuali NVIDIA RTX (vWS) per i carichi di lavoro grafici e prevedi di eseguire carichi di lavoro ad alta intensità di grafica, seleziona la casella di controllo Abilita workstation virtuale (NVIDIA GRID).

10. Per impegnarti a utilizzare i dischi SSD locali, nella sezione SSD locali, fai clic su add Aggiungi SSD e poi, nel campo Numero di SSD, specifica il numero di dischi.

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 nel tuo progetto la cui regione, il tipo di macchina e il tipo di GPU corrispondono all'impegno. Poi:

    1. Facoltativo. Per visualizzare le prenotazioni con proprietà specifiche, nel menu Filtra aggiungi o rimuovi i filtri per le proprietà che ti interessano.
    2. Seleziona tutte le prenotazioni da associare all'impegno.

12. Per completare l'acquisto dell'impegno con le prenotazioni allegate:

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

gcloud

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

Ad esempio, per acquistare un impegno allegando due prenotazioni, esegui il seguente 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 \
    --custom-end-time=CUSTOM_END_DATE \
    --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 del committmento, 12-month o 36-month.
• CUSTOM_END_DATE: facoltativo. Una data di fine personalizzata per il periodo di validità, che deve essere formattata come YYYY-MM-DD. Ad esempio, per specificare una data di fine personalizzata del 20 aprile 2024, formattala come 2024-04-20.

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

  • accelerator-optimized per le risorse di tipo di macchina A2
  • accelerator-optimized-a3 per le risorse tipo di macchina A3 Edge e High
  • accelerator-optimized-a3-mega per le risorse del tipo di macchina A3 Mega
  • 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 di tipo di macchina C3D
  • general-purpose per le risorse di tipo di macchina N1
  • general-purpose-n2 per le risorse di tipo di macchina N2
  • general-purpose-n2d per le risorse delle macchine N2D
  • graphics-optimized per le risorse di tipo di macchina G2
  • memory-optimized-m3 per le risorse del tipo di macchina M3
  • storage-optimized-z3 per le risorse del tipo di macchina Z3

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

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

• COMMITTED_LOCAL_SSD: la quantità, in GB, di spazio SSD locale che vuoi inserire nell'impegno. Ogni disco SSD locale ha una capacità di 375 GB.

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

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

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

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

Esempio: acquista un impegno collegando prenotazioni esistenti

Supponiamo che tu abbia due prenotazioni res-01 e res-02 nelle zone us-central1-a e us-central1-b del progetto myproject. Supponiamo che queste prenotazioni abbiano 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 questi dischi SSD locali e utilizzare queste prenotazioni esistenti come prenotazioni allegate, esegui il seguente comando. 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,local-ssd=1500 \
    --resources-accelerator=type=nvidia-tesla-p100,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 allegando prenotazioni esistenti, invia una richiesta 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 collegare al tuo impegno. Puoi associare al tuo impegno un numero qualsiasi di prenotazioni esistenti.

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"
    }
  ],
  "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
  "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 offrono opzioni per GPU, dischi SSD locali o entrambi:

  • ACCELERATOR_OPTIMIZED per le risorse di tipo di macchina A2
  • ACCELERATOR_OPTIMIZED_A3 per le risorse tipo di macchina A3 Edge e High
  • ACCELERATOR_OPTIMIZED_A3_MEGA per le risorse del tipo di macchina A3 Mega
  • 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 di tipo di macchina C3D
  • GENERAL_PURPOSE per le risorse di tipo di macchina N1
  • GENERAL_PURPOSE_N2 per le risorse di tipo di macchina N2
  • GENERAL_PURPOSE_N2D per le risorse delle macchine N2D
  • GRAPHICS_OPTIMIZED per le risorse di tipo di macchina G2
  • MEMORY_OPTIMIZED_M3 per le risorse del tipo di macchina M3
  • STORAGE_OPTIMIZED_Z3 per le risorse del tipo di macchina Z3

• COMMITTED_VCPUS: il numero di vCPU che vuoi inserire nell'impegno. Il numero deve essere un numero intero positivo.

• COMMITTED_MEMORY: la quantità di memoria, in MB, che vuoi includere nell'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 nell'impegno. Ogni disco SSD locale ha una dimensione di 375 GB.

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

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

• CUSTOM_END_DATE: facoltativo. Una data di fine personalizzata per il periodo di validità, che deve essere formattata come YYYY-MM-DD. Ad esempio, per specificare una data di fine personalizzata del 20 aprile 2024, formattala come 2024-04-20.

• END_TIME: 00:00 UTC-8 o UTC-7 (fuso orario del Pacifico degli Stati Uniti e del Canada), come offset del tempo universale coordinato (UTC). Specifica questo valore solo se hai specificato una data di fine personalizzata per il tuo impegno. Specifica uno dei seguenti valori:

  • Durante l'ora legale: 07:00:00
  • In altri orari: 08:00:00

• RESERVATION_URLs: un elenco separato da virgole di URL delle prenotazioni esistenti che vuoi allegare all'impegno. Ad esempio, per allegare 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 prenotazioni esistenti

Supponiamo che tu abbia due prenotazioni res-01 e res-02 nelle zone us-central1-a e us-central1-b del progetto myproject. Supponiamo che queste prenotazioni abbiano 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 questi dischi SSD locali e per utilizzare queste prenotazioni esistenti come prenotazioni allegate, 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-p100",
      "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"
  ]
}

Console

Prima di acquistare un impegno utilizzando la console Google Cloud, seleziona il progetto che vuoi utilizzare per l'acquisto dell'impegno. Se la condivisione dei dati CUD è abilitata per un account di fatturazione Cloud, puoi acquistare l'impegno utilizzando qualsiasi progetto di quell'account di fatturazione Cloud. Dopo aver selezionato il progetto:

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

   Vai a Sconti per impegno di utilizzo

2. Per acquistare un impegno, fai clic su add_box Acquista impegno. Viene visualizzata la pagina Acquista uno sconto per impegno di utilizzo, con 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 per le risorse Compute Engine.

5. Nel campo Tipo di impegno, seleziona la serie della famiglia di macchine per le risorse impegnate. I seguenti tipi di impegno forniscono opzioni per GPU, dischi SSD locali o entrambi:

   • A2 ottimizzato per l'acceleratore per le risorse del tipo di macchina A2
   • A3 ottimizzato per l'acceleratore per le risorse tipo di macchina A3 Edge e High
   • A3 Mega ottimizzato per l'acceleratore per le risorse del tipo di macchina A3 Mega
   • C2 ottimizzate per il calcolo per le risorse del tipo di macchina C2
   • C2D ottimizzato per il calcolo per le risorse di tipo di macchina C2D
   • C3 per uso generico per le risorse del tipo di macchina C3
   • C3D per uso generico per le risorse del tipo di macchina C3D
   • N1 per uso generico per le risorse di tipo di macchina N1
   • Uso generico N2 per le risorse di tipo di macchina N2
   • N2D per uso generico per le risorse delle macchine N2D
   • G2 ottimizzate per la grafica per le risorse del tipo di macchina G2
   • M3 con ottimizzazione per la memoria per le risorse del tipo di macchina M3
   • Z3 ottimizzata per lo spazio di archiviazione per le risorse del tipo di macchina Z3

6. In Durata, scegli 1 anno o 3 anni come durata del termine dell'impegno.

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

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

9. Per eseguire il commit delle GPU, nella sezione GPU, fai clic su add Aggiungi GPU e poi 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 modello di GPU supporta le workstation virtuali NVIDIA RTX (vWS) per i carichi di lavoro grafici e prevedi di eseguire carichi di lavoro ad alta intensità di grafica, seleziona la casella di controllo Abilita workstation virtuale (NVIDIA GRID).

10. Per impegnarti a utilizzare i dischi SSD locali, nella sezione SSD locali, fai clic su add Aggiungi SSD e poi, nel campo Numero di SSD, specifica il numero di dischi.

11. Per creare una nuova prenotazione e collegarla all'impegno, nel campo Prenotazioni, seleziona Crea prenotazioni e segui la procedura riportata di seguito. Ripeti questo passaggio per ogni nuova prenotazione che vuoi 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 collegata.
    3. Nel campo Regione, seleziona la stessa regione del tuo impegno.
    4. Nel campo Zona, seleziona la zona in cui vuoi prenotare le risorse.

    5. Nella sezione Tipo di condivisione, specifica come vuoi condividere la 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. Per specificare i progetti con cui condividere questa prenotazione, fai clic su add Aggiungi progetti e poi seleziona i progetti che ti interessano dall'organizzazione del progetto corrente.

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

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

    7. Nella sezione Dettagli della risorsa:

       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 riservate in uno dei seguenti modi:

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

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

          2. Per specificare manualmente le proprietà delle VM, seleziona Seleziona il tipo di macchina e poi procedi nel seguente modo:

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

                • General purpose per le serie di macchine per uso generico
                • Ottimizzato per il calcolo per le serie di macchine ottimizzate per il calcolo
                • Ottimizzata per la memoria per le serie di macchine ottimizzate per la memoria
                • GPU per le serie di macchine ottimizzate per l'acceleratore

             2. Nella tabella con la colonna Serie, seleziona la stessa serie di macchine specificata per l'impegno.

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

                1. Per scegliere un tipo di macchina predefinita, seleziona Preimpostato e poi il tipo di macchina che ti interessa.
                2. Per scegliere un tipo di macchina personalizzata, seleziona Personalizzato e poi specifica i Core e la Memoria che ti interessano.

             4. Per specificare una piattaforma CPU minima, le GPU o entrambe, espandi il menu expand_more Piattaforma CPU e GPU e svolgi i seguenti passaggi:

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

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

             5. Per prenotare i 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.

    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:

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

gcloud

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

A seconda che tu voglia allegare 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 il seguente 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 \
      --custom-end-time=CUSTOM_END_DATE \
      --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 poi specifica questo file YAML nel comando che utilizzi per acquistare l'impegno. Se vuoi, puoi anche utilizzare questo approccio con file YAML per creare e collegare una singola prenotazione al tuo impegno. Per creare le prenotazioni collegate utilizzando questo approccio:

  1. Crea il file YAML nella directory corrente e specifica la configurazione che preferisci per ogni prenotazione collegata. Per example, 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 collegare al tuo impegno un numero qualsiasi di prenotazioni esistenti.

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

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

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

Esempi per l'acquisto di impegni mediante la creazione di nuove prenotazioni da allegare

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

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

Supponiamo che tu voglia acquistare un impegno commitment-01 nella regione us-central1 che includa 4 GPU NVIDIA V100. Vuoi creare una nuova prenotazione reservation-01 come prenotazione collegata per queste GPU. Supponiamo che tu voglia anche specificare a Compute Engine di utilizzare queste GPU prenotate su 2 VM n1-standard-32 nella zona us-central1-a. 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 a utilizzare vCPU o memoria

Per impegnarti a utilizzare e prenotare GPU e dischi SSD locali senza impegnarti a utilizzare vCPU o memoria, specifica 0 come valore per le quantità di vCPU e memoria. Ad esempio, supponiamo che tu voglia acquistare un impegno commitment-02 per una singola GPU NVIDIA P4 nella regione us-west2. Inoltre, vuoi creare una nuova prenotazione come prenotazione allegata e specificare a Compute Engine di utilizzare la GPU prenotata su una VM n1-standard-2 nella zona us-west2-b. Per acquistare questo impegno di esempio con la prenotazione associata, esegui il seguente 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 V100 e 2 dischi SSD locali nella regione us-central1. Inoltre, vuoi creare e allegare due prenotazioni nella us-central1-a. Nella prima prenotazione, res-01, vuoi prenotare 1 VM n1-standard-2 con 1 GPU. Vuoi creare una prenotazione res-01 mirata, il che significa che devi scegliere come target specifico la prenotazione per nome per utilizzare le VM riservate. 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, innanzitutto crea 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 relative prenotazioni collegate, esegui il seguente 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, invia una richiesta POST al metodo regionCommitments.insert. Nella richiesta, includi il campo reservations per definire un elenco di tutte le nuove prenotazioni che vuoi creare e allegare. Puoi allegare al tuo impegno un qualsiasi numero di prenotazioni esistenti.

• 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"
    }
  ],
  "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
  "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"
    }
  ],
  "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
  "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 allegate:

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

Esempi per l'acquisto di impegni mediante la creazione di nuove prenotazioni da allegare

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

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

Supponiamo che tu voglia acquistare un impegno commitment-01 nella regione us-central1 che includa 4 GPU NVIDIA V100. Vuoi creare una nuova prenotazione reservation-01 come prenotazione allegata per queste GPU. Supponiamo che tu voglia anche specificare a Compute Engine di utilizzare queste GPU riservate su 2 VM n1-standard-8 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 a utilizzare vCPU o memoria

Per impegnarti a utilizzare e prenotare GPU e dischi SSD locali senza impegnarti a utilizzare vCPU o memoria, specifica 0 come valore per le quantità di vCPU e memoria. Ad esempio, supponiamo che tu voglia acquistare un impegno commitment-02 per una singola GPU NVIDIA P4 nella regione us-west2. Inoltre, vuoi creare una nuova prenotazione come prenotazione allegata e specificare Compute Engine in modo da utilizzare la GPU prenotata su una VM n1-standard-2 nella zona us-west2-b. 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-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 V100 e 2 dischi SSD locali nella regione us-central1. Inoltre, vuoi creare e allegare due prenotazioni nella us-central1-a. Nella prima prenotazione, res-01, vuoi prenotare 1 VM n1-standard-2 con 1 GPU. Vuoi creare una prenotazione res-01 mirata, il che significa che devi scegliere come target specifico la prenotazione per nome per utilizzare le VM riservate. 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"
    }
  ]
}

Console

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

1. Nella console Google Cloud, vai alla pagina Discounts for Committed Use (Sconti per l'utilizzo a livello di impegno).

   Vai alla pagina Sconti per impegno di utilizzo

2. Fai clic su Acquista impegno per acquistare un nuovo impegno.
3. Fai clic su Nuovo sconto per impegno di utilizzo delle licenze per acquistare un nuovo impegno di utilizzo delle licenze.
4. Assegna un nome all'impegno e scegli la regione in cui vuoi che venga applicato.
5. Scegli una durata dell'impegno, 1 o 3 anni.
6. Scegli una Famiglia di licenze.
7. Scegli il Tipo di licenza e quantità.
8. Scegli il Numero di licenze.
9. Fai clic su Acquista.

gcloud

Utilizzando l'interfaccia a riga di comando gcloud, esegui il comando gcloud compute commitments create-license per acquistare un impegno di licenza.

gcloud compute commitments create-license COMMITMENT_NAME \
    --license `LICENSE_URI`
    --amount NUMBER_OF_LICENSES \
    --cores-per-license CORES_PER_LICENSE \
    --plan PLAN \
    --region REGION \

Sostituisci quanto segue:

• COMMITMENT_NAME: il nome del tuo impegno.
• LICENSE_URI: l'URI della licenza. Ad esempio: https://www.googleapis.com/compute/v1/projects/myproject/global/licenses/sles-sap-12
• NUMBER_OF_LICENSES: il numero di licenze che hai intenzione di acquistare.
• CORES_PER_LICENSE: il numero di core per licenza. Inserisci 1-2, 3-4 o 5+.
• PLAN: inserisci la durata del piano: 12-month o 36-month.
• REGION: la regione in cui si applica questo impegno.

Ad esempio, l'impegno seguente riguarda 4 licenze SAP con 3-4 core per licenza per 36 mesi nella regione us-central1:

gcloud compute commitments create-license commitment-1
    --license https://www.googleapis.com/compute/v1/projects/myproject/global/licenses/sles-12
    --amount=4
    --cores-per-license=3-4
    --plan=36-month
    --region=us-central1

Ad esempio, l'impegno seguente riguarda 2 licenze SLES for SAP con 1-2 core per licenza per 12 mesi nella regione us-central1:

gcloud compute commitments create-license commitment-2
    --license https://www.googleapis.com/compute/v1/projects/myproject/global/licenses/sles-sap-12
    --amount=2
    --cores-per-license=1-2
    --plan=12-month
    --region=us-central1

REST

Utilizza il metodo regionCommitments.insert e includi il campo licenseResource per definire le proprietà dell'impegno di licenza.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments?requestId=OPTIONAL_UNIQUE_ID

{
    "name": COMMITMENT_NAME,
    "plan": PLAN,
    "category": "LICENSE",
    "licenseResource": {
      "coresPerLicense": CORES_PER_LICENSE,
      "amount": NUMBER_OF_LICENSES,
      "license": `LICENSE_URI`
      }
}

Sostituisci quanto segue:

• COMMITMENT_NAME: il nome del tuo impegno.
• LICENSE_URI: l'URI della licenza. Ad esempio: https://www.googleapis.com/compute/v1/projects/myproject/global/licenses/sles-sap-12
• NUMBER_OF_LICENSES: il numero di licenze che hai intenzione di acquistare.
• CORES_PER_LICENSE: il numero di core per licenza. Inserisci 1-2, 3-4 o 5+.
• PLAN: inserisci la durata del piano: 12-month o 36-month.
• REGION: la regione in cui si applica questo impegno.

Ad esempio, l'impegno seguente riguarda 4 licenze SLES for SAP con 3-4 core per licenza per 36 mesi nella regione us-central1.

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

{
    "name": "commitment-3",
    "plan": "THIRTY_SIX_MONTH",
    "category": "LICENSE",
    "licenseResource": {
      "coresPerLicense": "3-4",
      "amount": "4",
      "license": "https://www.googleapis.com/compute/v1/projects/suse-sap-cloud/global/licenses/sles-sap-12"
      }
}

Console

Nella console Google Cloud, visualizza un elenco di impegni nella pagina Sconti per utilizzo a livello di impegno.

Vai a Sconti per impegno di utilizzo

gcloud

Fai una richiesta utilizzando il comando commitments list:

gcloud compute commitments list

Lo strumento restituisce un elenco di impegni:

 NAME              REGION    END_TIMESTAMP                  STATUS
 my-commitment     us-east1  2018-03-17T00:00:00.000-07:00  NOT_YET_ACTIVE

REST

Puoi ottenere un elenco degli impegni in tutte le regioni inviando una aggregatedList richiesta al seguente URL:

https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/commitments

che restituisce un elenco di impegni:

"commitments": [
{
  "kind": "compute#commitment",
  "id": "3294122326373778983",
  "creationTimestamp": "2017-02-09T15:18:32.411-08:00",
  "name": "example-commitment",
  "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/commitments/example-commitment",
  "status": "NOT_YET_ACTIVE",
  "statusMessage": "The commitment is not yet active (its startTimestamp is in the future). It will not apply to current resource usage.",
  "plan": "TWELVE_MONTH",
  "startTimestamp": "2017-02-10T00:00:00.000-08:00",
  "endTimestamp": "2018-02-10T00:00:00.000-08:00",
  "resources": [
    {
      "type": "VCPU",
      "amount": "5"
    },
    {
      "type": "MEMORY",
      "amount": "32500"
    }]
  }
]