Combina le prenotazioni con gli sconti per impegno di utilizzo

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 del 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 impegno di utilizzo.

   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, che mostra la scheda Hardware.

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

4. Nel campo Regione, seleziona la regione in cui vuoi impegnarti per le risorse di 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 ottimizzata per l'acceleratore per le risorse del tipo di macchina A2
   • A3 ottimizzata per l'acceleratore per le risorse dei tipi di macchina A3 Edge e A3 High
   • A3 Mega ottimizzata per l'acceleratore per le risorse del tipo di macchina A3 Mega
   • C2 ottimizzata per il calcolo per le risorse del tipo di macchina C2
   • C2D ottimizzata 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 di tipo di macchina C3D
   • N1 per uso generico per le risorse di tipo di macchina N1
   • N2 per uso generico per le risorse di tipo di macchina N2
   • N2D per uso generico per le risorse delle macchine N2D
   • G2 ottimizzata per la grafica per le risorse del tipo di macchina G2
   • M3 ottimizzata per la memoria per le risorse del tipo di macchina M3
   • Z3 ottimizzata per l'archiviazione per le risorse del tipo di macchina Z3

6. Per Durata, segui questi passaggi:

   1. Per specificare il piano dell'impegno, seleziona 1 anno o 3 anni. Questa impostazione determina la durata predefinita 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 Estendi la durata degli impegni.

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

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

   Puoi specificare la memoria solo in incrementi di 0,25 GB. Per specificare un valore di memoria personalizzato per l'impegno, utilizza invece gcloud CLI o REST.

9. Per aggiungere le GPU all'impegno, 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 (vWS) NVIDIA RTX per i workload grafici e prevedi di eseguire workload ad alta intensità di grafica, seleziona la casella di controllo Abilita workstation virtuale (NVIDIA GRID).

10. Per aggiungere i dischi SSD locali all'impegno, 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 a quelli dell'impegno. Quindi:

    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 collegare all'impegno.

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

    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 collegando prenotazioni esistenti, esegui il comando gcloud compute commitments create. Nel comando, includi il flag --existing-reservation per specificare una prenotazione esistente che vuoi collegare al tuo impegno. Includi una nuova istanza di questo flag per ogni prenotazione esistente che vuoi collegare. Puoi collegare all'impegno un numero qualsiasi di prenotazioni esistenti.

Ad esempio, per acquistare un impegno collegando 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 collegate.
• DURATION: la durata dell'impegno, 12-month o 36-month.
• CUSTOM_END_DATE: (Facoltativo) una data di fine personalizzata per il tuo periodo, che deve essere formattata come YYYY-MM-DD. Ad esempio, per specificare una data di fine personalizzata il 20 aprile 2024, formattala come 2024-04-20.

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

  • accelerator-optimized per le risorse del tipo di macchina A2
  • accelerator-optimized-a3 per le risorse dei tipi di macchina A3 Edge e A3 High
  • accelerator-optimized-a3-mega per le risorse del 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 le risorse del tipo di macchina C3
  • compute-optimized-c3d per le risorse del tipo di macchina C3D
  • general-purpose per le risorse del tipo di macchina N1
  • general-purpose-n2 per le risorse del tipo di macchina N2
  • general-purpose-n2d per le risorse delle macchine N2D
  • graphics-optimized per le risorse del 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 nel tuo impegno. Il valore deve essere un numero intero positivo.

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

• COMMITTED_LOCAL_SSD: la quantità di spazio SSD locale, in GB, che vuoi inserire nell'impegno. Ogni disco SSD locale ha una capacità 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.

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

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

Esempio: acquista un impegno collegando 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 di 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 collegate, 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 collegando prenotazioni esistenti, effettua 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 collegare all'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 collegate.
• DURATION: la durata dell'impegno, TWELVE_MONTH o THIRTY_SIX_MONTH.

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

  • ACCELERATOR_OPTIMIZED per le risorse del tipo di macchina A2
  • ACCELERATOR_OPTIMIZED_A3 per le risorse dei tipi di macchina A3 Edge e A3 High
  • ACCELERATOR_OPTIMIZED_A3_MEGA per le risorse del 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 le risorse del tipo di macchina C3
  • COMPUTE_OPTIMIZED_C3D per le risorse del tipo di macchina C3D
  • GENERAL_PURPOSE per le risorse del tipo di macchina N1
  • GENERAL_PURPOSE_N2 per le risorse del tipo di macchina N2
  • GENERAL_PURPOSE_N2D per le risorse delle macchine N2D
  • GRAPHICS_OPTIMIZED per le risorse del 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 valore deve essere un numero intero positivo.

• COMMITTED_MEMORY: la quantità di memoria, in MB, che vuoi inserire nell'impegno. Ad esempio, 10240MB.

• COMMITTED_LOCAL_SSD: la quantità di spazio di archiviazione SSD locale, in GB, che vuoi inserire 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 tuo periodo, che deve essere formattata come YYYY-MM-DD. Ad esempio, per specificare una data di fine personalizzata il 20 aprile 2024, formattala come 2024-04-20.

• END_TIME: 00:00 UTC-8 o UTC-7 (fuso orario del Pacifico), inteso come differenza di fuso rispetto al 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 collegare all'impegno. Ad esempio, per collegare due prenotazioni, res-1 e res-2, specifica quanto segue:

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

Esempio: acquista un impegno collegando 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 di 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 collegate, effettua la seguente richiesta POST. Tieni presente che l'impegno di esempio contiene anche vCPU e memoria.

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

{
  "name": "commitment-01",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE"
  "resources":
  [
    {
      "amount": "96",
      "type": "VCPU"
    },
    {
      "amount": "638976",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-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 del 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 impegno di utilizzo.

   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, che mostra la scheda Hardware.

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

4. Nel campo Regione, seleziona la regione in cui vuoi impegnarti per le risorse di 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 ottimizzata per l'acceleratore per le risorse del tipo di macchina A2
   • A3 ottimizzata per l'acceleratore per le risorse dei tipi di macchina A3 Edge e A3 High
   • A3 Mega ottimizzata per l'acceleratore per le risorse del tipo di macchina A3 Mega
   • C2 ottimizzata per il calcolo per le risorse del tipo di macchina C2
   • C2D ottimizzata 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 di tipo di macchina C3D
   • N1 per uso generico per le risorse di tipo di macchina N1
   • N2 per uso generico per le risorse di tipo di macchina N2
   • N2D per uso generico per le risorse delle macchine N2D
   • G2 ottimizzata per la grafica per le risorse del tipo di macchina G2
   • M3 ottimizzata per la memoria per le risorse del tipo di macchina M3
   • Z3 ottimizzata per l'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 per cui vuoi impegnarti.

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

9. Per aggiungere le GPU all'impegno, 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 (vWS) NVIDIA RTX per i workload grafici e prevedi di eseguire workload ad alta intensità di grafica, seleziona la casella di controllo Abilita workstation virtuale (NVIDIA GRID).

10. Per aggiungere i dischi SSD locali all'impegno, 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 da creare e collegare.

    1. Fai clic su Aggiungi una prenotazione. Viene visualizzata la sezione Nuova prenotazione.
    2. Nel campo Nome, inserisci un nome per la prenotazione 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 Locali.
       • Per creare una prenotazione condivisa con più progetti, seleziona Condivise. Per specificare i progetti con cui condividere questa prenotazione, fai clic su add Aggiungi progetti e poi seleziona i progetti dell'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 (valore predefinito).
       • Per utilizzare le risorse di questa prenotazione solo durante la creazione di VM con proprietà corrispondenti che hanno come target specifico questa prenotazione in base al nome, fai clic su Seleziona una prenotazione specifica.

    7. Nella sezione Dettagli 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 prenotate in uno dei seguenti modi:

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

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

          2. Per specificare manualmente le proprietà delle VM, seleziona Seleziona 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:

                • Per uso generico per le serie di macchine per uso generico
                • Ottimizzata 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 predefinita o personalizzata in uno dei seguenti modi:

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

             4. Per specificare una piattaforma CPU minima, le GPU o entrambe, espandi il menu expand_more Piattaforma CPU e GPU ed esegui 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. Quindi, 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 collegate:

    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 collegate durante l'acquisto dell'impegno, esegui il comando gcloud compute commitments create.

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 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. Facoltativamente, 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. Ad esempio, per specificare la configurazione di una prenotazione condivisa con due progetti che specifica GPU, due dischi SSD locali e una piattaforma CPU minima, includi il seguente testo nel file YAML:

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

     Per specificare la configurazione per più prenotazioni, ripeti queste proprietà per ogni prenotazione che vuoi creare. Puoi 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 collegate:

Compute Engine crea l'impegno e le prenotazioni collegate 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 creando nuove prenotazioni da collegare

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 collegare 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 include 4 GPU NVIDIA V100. Vuoi creare una nuova prenotazione reservation-01 come prenotazione collegata per queste GPU. Supponiamo che tu voglia anche indicare 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 collegata, 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 collegata e indicare 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 collegata, 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 collegare due prenotazioni nella zona us-central1-a. Nella prima prenotazione, res-01, vuoi prenotare 1 VM n1-standard-2 con 1 GPU. Vuoi rendere res-01 una prenotazione con target specifico, il che significa che devi scegliere come target specifico la prenotazione per nome per utilizzare le 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 collegate, 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 di 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 collegate durante l'acquisto del tuo impegno, effettua 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 collegare. Puoi collegare al tuo impegno un numero qualsiasi di prenotazioni esistenti.

• Per creare la nuova prenotazione specificando manualmente tutte le proprietà delle 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 template 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 collegate:

Compute Engine crea l'impegno e le prenotazioni collegate 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, Compute Engine restituisce lo stato 200 per la richiesta API REST.

Esempi per l'acquisto di impegni creando nuove prenotazioni da collegare

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 collegare 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 include 4 GPU NVIDIA V100. Vuoi creare una nuova prenotazione reservation-01 come prenotazione collegata per queste GPU. Supponiamo che tu voglia anche indicare a Compute Engine di utilizzare queste GPU prenotate su 2 VM n1-standard-8 nella zona us-central1-a. Per acquistare questo impegno di esempio con la prenotazione collegata, 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 collegata e indicare 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 collegata, effettua la seguente richiesta POST:

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

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

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

Supponiamo che tu voglia acquistare un impegno commitment-03 per 1 GPU NVIDIA V100 e 2 dischi SSD locali nella regione us-central1. Inoltre, vuoi creare e collegare due prenotazioni nella zona us-central1-a. Nella prima prenotazione, res-01, vuoi prenotare 1 VM n1-standard-2 con 1 GPU. Vuoi rendere res-01 una prenotazione con target specifico, il che significa che devi scegliere come target specifico la prenotazione per nome per utilizzare le 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 collegate, effettua la seguente richiesta POST. Tieni presente che l'impegno di esempio contiene anche risorse di 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"
    }
  ]
}

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 che vuoi sostituire.

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

   • La nuova prenotazione sostitutiva.

   I contenuti del file YAML sono simili ai seguenti:

   - reservation: CURRENT_RESERVATION_NAME
     reservation_zone: CURRENT_RESERVATION_ZONE
     vm_count: 0
     machine_type: CURRENT_RESERVATION_MACHINE_TYPE
     accelerator:
     - count: CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS
       type: CURRENT_RESERVATION_ACCELERATOR_TYPE
     local_ssd:
     - 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
     local_ssd:
     - 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 delle prenotazioni corrente e sostitutiva:

   Prenotazione attuale

   Per la prenotazione corrente, tutte le seguenti proprietà devono essere esattamente uguali a quando hai visualizzato la prenotazione. Ometti i campi per le proprietà che la prenotazione attuale non ha già.

   • CURRENT_RESERVATION_NAME: il nome della prenotazione collegata corrente.
   • CURRENT_RESERVATION_ZONE: la zona della prenotazione collegata attuale.
   • CURRENT_RESERVATION_MACHINE_TYPE: il tipo di macchina della prenotazione corrente collegata.
   • CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS: il numero di GPU prenotate nella prenotazione collegata corrente.
   • CURRENT_RESERVATION_ACCELERATOR_TYPE: il tipo di acceleratore prenotato nella prenotazione corrente collegata.
   • CURRENT_RESERVATION_INTERFACE_1 e CURRENT_RESERVATION_INTERFACE_2: il tipo di interfaccia utilizzata dal disco SSD locale per ogni VM riservata nella prenotazione collegata corrente. Le opzioni valide sono: scsi e nvme. Ogni disco SSD locale è da 375 GB. Ripeti il parametro local_ssd per tutti i dischi SSD locali riservati.
   • CURRENT_RESERVATION_PROJECT_ID: l'ID progetto del progetto corrente che include l'impegno e la prenotazione allegata. Specifica questo campo se la prenotazione collegata corrente è condivisa tra più progetti consumer.
   • CURRENT_RESERVATION_SHARE_SETTING: Il tipo di condivisione per la prenotazione attuale. Specifica questo campo con il valore projects se la prenotazione allegata attuale è 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 allegata corrente, ad esempio project-1 e project-2.

   Prenotazione sostitutiva

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

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

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

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

     Sostituisci quanto segue:

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

   • REPLACEMENT_RESERVATION_NUMBER_OF_ACCELERATORS: il numero di GPU che vuoi aggiungere per VM nella prenotazione sostitutiva.

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

   • REPLACEMENT_RESERVATION_INTERFACE_1 e REPLACEMENT_RESERVATION_INTERFACE_2: il tipo di interfaccia che vuoi che i dischi SSD locali per ogni VM riservata utilizzino. 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 progetto del progetto corrente che include l'impegno e la prenotazione allegata. Specifica questo campo se vuoi condividere la prenotazione sostitutiva in più progetti consumer.

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

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

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

   Sostituisci quanto segue:

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

Esempio di sostituzione di una prenotazione associata a un impegno

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

Esempio di impegno con una prenotazione allegata

Ad esempio, supponiamo che tu voglia aggiornare le prenotazioni collegate per l'impegno my-commitment-with-reservations, acquistato utilizzando il seguente comando:

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

Per questo esempio, supponiamo che quando è stato eseguito questo comando, one-reservation.yaml fosse un file nella directory corrente con il seguente contenuto, che definisce una prenotazione allegata denominata res-1.

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

Questo impegno my-commitment-with-reservations e la prenotazione res-1 allegata hanno comportato le seguenti risorse impegnate e riservate:

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

Sostituisci la prenotazione di esempio allegata

Supponiamo che tu voglia sostituire la prenotazione allegata res-1 con una nuova prenotazione allegata res-2 e modificare le risorse prenotate come segue:

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

^†Nello specifico, la prenotazione allegata di sostituzione definisce res-2, che riserva 2 VM n1-standard-8, ognuna con una GPU P100 e 4 dischi SSD locali di tipo di interfaccia scsi. Inoltre, res-2 è condiviso con altri due progetti, project-1 e project-2 e di proprietà del progetto corrente, 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, segui questi passaggi:

1. Crea un file denominato two-reservations.yaml nella directory attuale con il seguente contenuto:

   - 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, invia una richiesta POST utilizzando il metodo regionCommitments.updateReservations.

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

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

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

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

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

Esempio di sostituzione di una prenotazione associata a un impegno

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

Esempio di impegno con una prenotazione allegata

Ad esempio, supponiamo che tu voglia sostituire la prenotazione allegata res-1 per l'impegno my-commitment-with-reservations, che è stato acquistato effettuando la seguente richiesta POST:

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

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

Questo impegno my-commitment-with-reservations e la prenotazione res-1 allegata hanno comportato le seguenti risorse impegnate e riservate:

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

Sostituisci la prenotazione di esempio allegata

Supponiamo che tu voglia sostituire la prenotazione allegata res-1 con una nuova prenotazione allegata res-2 e modificare le risorse prenotate come segue:

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

^†Nello specifico, la prenotazione allegata di sostituzione definisce res-2, che riserva 2 VM n1-standard-8, ognuna con una GPU P100 e 4 dischi SSD locali di tipo di interfaccia scsi. Inoltre, res-2 è condiviso con altri due progetti, project-1 e project-2 e di proprietà del progetto corrente, 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, invia la seguente richiesta POST utilizzando il metodo regionCommitments.updateReservations:

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

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