Gabungkan reservasi dengan diskon abonemen

Konsol

Sebelum membeli komitmen menggunakan Konsol Google Cloud, pilih project yang ingin Anda gunakan untuk membeli komitmen. Jika berbagi CUD diaktifkan untuk akun Penagihan Cloud, Anda dapat membeli komitmen menggunakan project apa pun dari akun Penagihan Cloud tersebut. Setelah memilih project, lakukan hal berikut:

1. Di Konsol Google Cloud, buka halaman Diskon abonemen.

   Buka halaman Diskon abonemen

2. Untuk membeli komitmen, klik add_box Beli komitmen. Halaman Beli diskon abonemen akan terbuka dan menampilkan tab Hardware.

3. Di kolom Nama, masukkan nama untuk komitmen Anda.

4. Di kolom Region, pilih region tempat Anda ingin melakukan commit ke resource Compute Engine.

5. Di kolom Commitment type, pilih seri kelompok mesin untuk resource yang di-commit.

6. Di kolom Durasi, pilih durasi jangka waktu komitmen Anda.

7. Di kolom Cores, masukkan jumlah vCPU yang ingin Anda komitmen.

8. Di kolom Memory, masukkan jumlah memori yang ingin Anda komitmen, dalam GB.

9. Untuk berkomitmen pada GPU, di bagian GPU, klik add Add GPU, lalu lakukan tindakan berikut:

   1. Di kolom GPU type, pilih jenis GPU.
   2. Di kolom Jumlah GPU, masukkan jumlah GPU.
   3. Opsional: Jika model GPU Anda mendukung NVIDIA RTX Virtual Workstations (vWS) untuk workload grafis, dan Anda berencana menjalankan beban kerja grafis yang intensif, pilih kotak centang Enable Virtual Workstation (NVIDIA GRID).

10. Untuk berkomitmen pada disk SSD Lokal, di bagian Local SSDs, klik add Add SSD, lalu, di kolom Number of SSDs, tentukan jumlah disk.

11. Untuk melampirkan satu atau beberapa reservasi yang ada ke komitmen, di kolom Reservasi, pilih Lampirkan reservasi yang ada.

    Konsol Google Cloud menampilkan daftar semua reservasi di project Anda yang region, jenis mesin, dan jenis GPU-nya cocok dengan komitmen tersebut. Kemudian, lakukan hal berikut:

    1. Opsional. Untuk melihat reservasi dengan properti tertentu, pada menu Filter, tambahkan atau hapus filter untuk properti yang Anda inginkan.
    2. Pilih semua reservasi yang ingin Anda lampirkan ke komitmen.

12. Untuk menyelesaikan pembelian komitmen Anda dengan reservasi terlampir, lakukan langkah berikut:

    1. Klik Purchase.
    2. Dalam dialog Beli diskon abonemen, jika Anda setuju dengan persyaratan khusus layanan, klik Beli lagi.

gcloud

Untuk membeli komitmen dengan melampirkan reservasi yang ada, jalankan perintah gcloud compute commitments create. Dalam perintah Anda, sertakan tanda --existing-reservation untuk menentukan reservasi yang ada dan ingin dikaitkan ke komitmen Anda. Sertakan instance baru tanda ini untuk setiap reservasi yang ada yang ingin Anda lampirkan. Anda dapat menambahkan reservasi yang sudah ada dalam jumlah berapa pun ke komitmen Anda.

Misalnya, untuk membeli komitmen dengan melampirkan dua pemesanan ke dalamnya, jalankan perintah berikut:

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

Ganti kode berikut:

• COMMITMENT_NAME: nama komitmen.
• REGION: region tempat komitmen berada.
• PROJECT_ID: ID project tempat Anda ingin membeli komitmen dengan reservasi terlampir.
• DURATION: istilah durasi komitmen, 12-month atau 36-month.

• COMMITMENT_TYPE: jenis komitmen. Jenis komitmen berikut menyediakan opsi untuk GPU, disk SSD Lokal, atau keduanya:

  • accelerator-optimized untuk resource jenis mesin
  • compute-optimized untuk resource jenis mesin C2
  • compute-optimized-c2d untuk resource jenis mesin C2D
  • compute-optimized-c3 untuk resource jenis mesin C3
  • compute-optimized-c3d untuk resource jenis mesin C3D
  • general-purpose untuk resource jenis mesin N1
  • general-purpose-e2 untuk resource jenis mesin E2
  • general-purpose-n2 untuk resource jenis mesin N2
  • general-purpose-n2d untuk resource mesin N2D
  • general-purpose-t2d untuk resource jenis mesin Tau T2D
  • graphics-optimized untuk resource jenis mesin G2
  • memory-optimized untuk resource jenis mesin M1 atau M2
  • memory-optimized-m3 untuk jenis mesin M3 yang dioptimalkan untuk memori

• COMMITTED_VCPUS: jumlah vCPU yang diinginkan dalam komitmen Anda. Bilangan harus berupa bilangan bulat positif.

• COMMITTED_MEMORY: jumlah memori, dalam MB atau GB, yang Anda inginkan dalam komitmen. Misalnya, 10240MB atau 10GB. Jika Anda tidak menentukan unit, Compute Engine akan menggunakan GB sebagai unit. Anda dapat membeli memori dengan kelipatan 0,25 GB.

• COMMITTED_LOCAL_SSD: jumlah ruang SSD Lokal dalam GB yang diinginkan dalam komitmen Anda. Setiap disk SSD Lokal berukuran 375 GB.

• COMMITTED_ACCELERATOR_COUNT: jumlah GPU yang Anda inginkan dalam komitmen Anda.

• COMMITTED_ACCELERATOR_TYPE: jenis GPU yang diinginkan dalam komitmen Anda.

• RESERVATION_NAME_1 dan RESERVATION_NAME_2: Nama reservasi yang sudah ada yang ingin Anda lampirkan ke komitmen.

• RESERVATION_ZONE_1 dan RESERVATION_ZONE_2: Zona reservasi yang ada yang ingin Anda kaitkan ke komitmen.

Contoh: Membeli komitmen dengan melampirkan reservasi yang ada

Misalkan Anda memiliki dua pemesanan res-01 dan res-02 di zona us-central1-a dan us-central1-b dari project myproject. Misalkan reservasi ini memiliki kapasitas gabungan untuk 4 GPU NVIDIA P100 dan 4 disk SSD Lokal. Untuk membeli komitmen baru di region us-central1 project ini untuk disk GPU dan SSD Lokal ini, dan menggunakan pemesanan yang ada ini sebagai reservasi terlampir, jalankan perintah berikut. Perlu diperhatikan bahwa contoh komitmen juga berisi vCPU dan memori.

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

REST

Untuk membeli komitmen dengan melampirkan reservasi yang ada, buat permintaan POST ke metode regionCommitments.insert. Dalam permintaan, sertakan kolom existingReservations untuk menentukan daftar yang dipisahkan koma dari semua reservasi saat ini yang ingin Anda lampirkan ke komitmen Anda. Anda dapat melampirkan berapa pun reservasi yang ada ke komitmen Anda.

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

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

Ganti kode berikut:

• COMMITMENT_NAME: nama komitmen.
• REGION: region tempat komitmen berada.
• PROJECT_ID: ID project tempat Anda ingin membeli komitmen dengan reservasi terlampir.
• DURATION: durasi jangka waktu komitmen, TWELVE_MONTH atau THIRTY_SIX_MONTH.

• COMMITMENT_TYPE: jenis komitmen. Jenis komitmen berikut menyediakan opsi untuk GPU, disk SSD Lokal, atau keduanya:

  • GENERAL_PURPOSE_E2 untuk resource jenis mesin E2
  • GENERAL_PURPOSE_N2 untuk resource jenis mesin N2
  • GENERAL_PURPOSE_N2D untuk resource mesin N2D
  • COMPUTE_OPTIMIZED_C3 untuk resource jenis mesin C3
  • GENERAL_PURPOSE_C3D untuk resource jenis mesin C3D
  • GENERAL_PURPOSE_T2D untuk resource jenis mesin Tau T2D
  • GENERAL_PURPOSE untuk resource jenis mesin N1
  • COMPUTE_OPTIMIZED untuk resource jenis mesin C2
  • COMPUTE_OPTIMIZED_C2D untuk resource jenis mesin C2D
  • MEMORY_OPTIMIZED untuk resource jenis mesin M1 atau M2
  • MEMORY_OPTIMIZED_M3 untuk jenis mesin M3 yang dioptimalkan untuk memori
  • ACCELERATOR_OPTIMIZED untuk resource jenis mesin
  • GRAPHICS_OPTIMIZED untuk resource jenis mesin G2

• COMMITTED_VCPUS: jumlah vCPU yang Anda inginkan dalam komitmen Anda. Bilangan harus berupa bilangan bulat positif.

• COMMITTED_MEMORY: jumlah memori dalam MB yang diinginkan dalam komitmen Anda. Contoh, 10240MB. Anda dapat membeli memori dalam kelipatan 256 MB.

• COMMITTED_LOCAL_SSD: jumlah penyimpanan SSD lokal, dalam GB, yang diinginkan dalam komitmen Anda. Setiap disk SSD Lokal berukuran 375 GB.

• COMMITTED_ACCELERATOR_COUNT: jumlah GPU yang diinginkan dalam komitmen Anda.

• COMMITTED_ACCELERATOR_TYPE: jenis GPU yang diinginkan dalam komitmen Anda.

• RESERVATION_URLs: daftar yang dipisahkan koma untuk URL reservasi yang ada yang ingin Anda lampirkan ke komitmen. Misalnya, untuk melampirkan dua reservasi, res-1 dan res-2, tentukan hal berikut:

  "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"
  

Contoh: Membeli komitmen dengan melampirkan reservasi yang ada

Misalkan Anda memiliki dua pemesanan res-01 dan res-02 di zona us-central1-a dan us-central1-b dari project myproject. Misalkan reservasi ini memiliki kapasitas gabungan untuk 4 GPU NVIDIA P100 dan 4 disk SSD Lokal. Untuk membeli komitmen baru di region us-central1 project ini untuk disk GPU dan SSD Lokal ini serta untuk menggunakan reservasi yang ada ini sebagai reservasi terlampir, buat permintaan POST berikut. Perlu diperhatikan bahwa contoh komitmen juga berisi vCPU dan memori.

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

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

Konsol

Sebelum membeli komitmen menggunakan Konsol Google Cloud, pilih project yang ingin Anda gunakan untuk membeli komitmen. Jika berbagi CUD diaktifkan untuk akun Penagihan Cloud, Anda dapat membeli komitmen menggunakan project apa pun dari akun Penagihan Cloud tersebut. Setelah memilih project, lakukan hal berikut:

1. Di Konsol Google Cloud, buka halaman Diskon abonemen.

   Buka halaman Diskon abonemen

2. Untuk membeli komitmen, klik add_box Beli komitmen. Halaman Beli diskon abonemen akan terbuka dan menampilkan tab Hardware.

3. Di kolom Nama, masukkan nama untuk komitmen Anda.

4. Di kolom Region, pilih region tempat Anda ingin melakukan commit ke resource Compute Engine.

5. Di kolom Commitment type, pilih seri kelompok mesin untuk resource yang di-commit.

6. Di kolom Durasi, pilih durasi jangka waktu komitmen Anda.

7. Di kolom Cores, masukkan jumlah vCPU yang ingin Anda komitmen.

8. Di kolom Memory, masukkan jumlah memori yang ingin Anda komitmen, dalam GB.

9. Untuk berkomitmen pada GPU, di bagian GPU, klik add Add GPU, lalu lakukan tindakan berikut:

   1. Di kolom GPU type, pilih jenis GPU.
   2. Di kolom Jumlah GPU, masukkan jumlah GPU.
   3. Opsional: Jika model GPU Anda mendukung NVIDIA RTX Virtual Workstations (vWS) untuk workload grafis, dan Anda berencana menjalankan beban kerja grafis yang intensif, pilih kotak centang Enable Virtual Workstation (NVIDIA GRID).

10. Untuk berkomitmen pada disk SSD Lokal, di bagian Local SSDs, klik add Add SSD, lalu, di kolom Number of SSDs, tentukan jumlah disk.

11. Untuk membuat reservasi baru dan melampirkannya ke komitmen, di kolom Reservasi, pilih Create reservation, lalu lakukan hal berikut. Ulangi langkah ini untuk setiap reservasi baru yang ingin Anda buat dan lampirkan.

    1. Klik Tambahkan reservasi. Bagian Reservasi baru akan muncul.
    2. Di kolom Nama, masukkan nama untuk reservasi yang Anda lampiran.
    3. Di kolom Region, pilih region yang sama dengan komitmen Anda.
    4. Di kolom Zone, pilih zona tempat Anda ingin mencadangkan resource.

    5. Di bagian Jenis berbagi, tentukan cara membagikan reservasi ini dengan salah satu cara berikut:

       • Untuk membuat reservasi satu project, pilih Lokal.
       • Untuk membuat reservasi yang dibagikan ke beberapa project, pilih Dibagikan. Kemudian, untuk menentukan project yang akan dibagikan reservasi ini, klik add Add projects, lalu pilih project yang Anda inginkan dari organisasi project saat ini.

    6. Di kolom Use with VM instance, pilih cara Anda ingin VM menggunakan reservasi dengan salah satu cara berikut:

       • Agar VM dengan properti yang cocok dapat otomatis menggunakan reservasi ini, klik Use reservation automatically (default).
       • Untuk menggunakan resource reservasi ini hanya saat membuat VM dengan properti yang cocok dan secara khusus menargetkan reservasi ini menurut nama, klik Select specific reservation.

    7. Di bagian Resource details, lakukan tindakan berikut:

       1. Di kolom Jumlah instance VM, masukkan jumlah instance VM yang ingin Anda pesan.

       2. Di bagian Machine configuration, tentukan properti VM yang dicadangkan dengan salah satu cara berikut:

          1. Untuk menentukan properti VM Anda menggunakan instance template yang ada, pilih Use instance template.

             Di kolom Instance template, pilih template instance yang menentukan seri kelompok mesin yang sama dengan komitmen Anda. Jika Anda memilih template instance regional, region template instance tersebut juga harus cocok dengan region yang ditentukan dalam komitmen Anda.

          2. Untuk menentukan properti VM secara manual, pilih Pilih jenis mesin, lalu lakukan langkah berikut:

             1. Pilih jenis mesin yang berlaku untuk rangkaian mesin yang Anda tentukan untuk komitmen:

                • Tujuan umum untuk seri mesin tujuan umum
                • Dioptimalkan untuk komputasi untuk seri mesin yang dioptimalkan komputasi
                • Memori yang dioptimalkan untuk seri mesin yang dioptimalkan untuk memori
                • GPU untuk rangkaian mesin yang dioptimalkan untuk akselerator

             2. Pada tabel yang memiliki kolom Series, pilih rangkaian mesin yang sama dengan yang Anda tentukan untuk komitmen.

             3. Di kolom Machine type, tentukan jenis mesin yang telah ditetapkan atau kustom dengan salah satu cara berikut:

                1. Untuk memilih jenis mesin yang telah ditetapkan, pilih Preset, lalu pilih jenis mesin yang Anda inginkan.
                2. Untuk memilih jenis mesin kustom, pilih Custom, lalu tentukan Cores dan Memory yang Anda inginkan.

             4. Untuk menentukan platform CPU minimum, GPU, atau keduanya, luaskan menu expand_more CPU Platform dan GPU dan lakukan hal berikut:

                1. Opsional: Untuk menentukan platform CPU minimum, dalam daftar Platform CPU, pilih salah satu opsi.

                2. Opsional: Untuk mereservasi GPU, klik add Tambahkan GPU. Kemudian, di kolom GPU type dan Number of GPU, pilih jenis dan jumlah GPU untuk setiap VM.

             5. Untuk mencadangkan disk SSD lokal, lakukan langkah berikut:

                1. Di kolom Number of disk, pilih jumlah disk SSD lokal yang Anda inginkan untuk setiap VM.
                2. Di kolom Interface type, pilih antarmuka untuk disk SSD lokal.

    8. Untuk menyelesaikan penetapan properti pemesanan ini, klik Done.

12. Untuk menyelesaikan pembelian komitmen Anda dengan reservasi terlampir, lakukan langkah berikut:

    1. Klik Purchase.
    2. Dalam dialog Beli diskon abonemen, jika Anda setuju dengan persyaratan khusus layanan, klik Beli lagi.

gcloud

Untuk membuat reservasi terlampir saat membeli komitmen Anda, jalankan perintah gcloud compute commitments create.

Bergantung pada apakah Anda ingin melampirkan satu atau beberapa reservasi, jalankan perintah dengan salah satu cara berikut:

• Untuk membuat dan menambahkan satu reservasi ke komitmen Anda, tentukan properti reservasi yang terlampir dengan menjalankan perintah berikut:

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

• Untuk membuat dan melampirkan beberapa reservasi ke komitmen Anda, tentukan properti reservasi menggunakan file YAML, lalu tentukan file YAML dalam perintah yang akan digunakan untuk membeli komitmen Anda. Secara opsional, Anda juga dapat menggunakan pendekatan file YAML ini untuk membuat dan melampirkan satu reservasi ke komitmen Anda. Untuk membuat reservasi terlampir menggunakan pendekatan ini, lakukan langkah berikut:

  1. Buat file YAML di direktori saat ini dan tentukan konfigurasi yang Anda inginkan untuk setiap reservasi yang terlampir. Misalnya, untuk menentukan konfigurasi reservasi bersama yang dibagikan ke dua project yang menentukan GPU, dua disk SSD Lokal, dan platform CPU minimum, sertakan teks berikut dalam 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
     
     

     Untuk menentukan konfigurasi beberapa reservasi, ulangi properti ini untuk setiap reservasi yang ingin Anda buat. Anda dapat melampirkan sejumlah reservasi yang ada yang diinginkan ke komitmen Anda.

  2. Jalankan perintah gcloud compute commitments create dan sertakan 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
     

Ganti properti berikut dengan properti komitmen dan reservasi terlampir:

Compute Engine membuat komitmen dan reservasi yang terpasang hanya jika ada cukup resource dari jenis mesin yang ditentukan dalam zona target, dan kuota yang cukup, pada saat permintaan Anda. Jika pembelian berhasil, Anda akan melihat pesan berhasil seperti berikut:

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

Contoh untuk membeli komitmen dengan membuat reservasi baru yang dapat dilampirkan

Contoh skenario dan perintah berikut menunjukkan cara membeli komitmen untuk GPU, disk SSD Lokal, atau keduanya dengan membuat reservasi baru untuk dilampirkan pada komitmen tersebut.

Contoh 1: Membeli komitmen untuk GPU dengan melampirkan satu reservasi baru

Misalnya Anda ingin membeli komitmen commitment-01 di region us-central1 yang mencakup 4 GPU NVIDIA V100. Anda ingin membuat reservasi baru reservation-01 sebagai reservasi terlampir untuk GPU tersebut. Misalkan Anda juga ingin menentukan Compute Engine untuk menggunakan GPU yang dicadangkan tersebut di 2 VM n1-standard-32 di zona us-central1-a. Untuk membeli komitmen contoh ini dengan reservasi yang terlampir, jalankan perintah berikut:

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

Contoh 2: Membeli komitmen untuk GPU tanpa terikat pada vCPU atau memori

Untuk berkomitmen pada dan memesan disk GPU dan SSD Lokal tanpa terikat pada vCPU atau memori, tentukan 0 sebagai nilai untuk kuantitas vCPU dan memori. Misalnya, Anda ingin membeli komitmen commitment-02 untuk satu GPU NVIDIA P4 di region us-west2. Anda juga ingin membuat reservasi baru sebagai reservasi terlampir dan menentukan Compute Engine untuk menggunakan GPU yang dicadangkan pada VM n1-standard-2 di zona us-west2-b. Untuk membeli komitmen contoh ini dengan reservasi yang terlampir, jalankan perintah berikut:

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

Contoh 3: Membeli komitmen untuk disk GPU dan SSD Lokal dengan melampirkan beberapa reservasi baru

Misalnya Anda ingin membeli komitmen commitment-03 untuk 1 disk NVIDIA V 100 GPU dan 2 disk SSD Lokal di region us-central1. Anda juga ingin membuat dan melampirkan dua reservasi di zona us-central1-a. Pada reservasi pertama, res-01, Anda ingin memesan 1 VM n1-standard-2 dengan 1 GPU. Anda ingin menjadikan res-01 sebagai reservasi yang ditargetkan, yang berarti Anda harus secara khusus menargetkan reservasi tersebut menurut nama untuk menggunakan VM yang dicadangkannya. Di reservasi kedua, res-02, Anda ingin mencadangkan 1 VM n1-standard-8 dengan 2 jenis disk SSD Lokal yang terpasang.

Untuk membeli komitmen contoh ini dengan reservasi yang terlampir, buat file YAML dengan properti kedua reservasi terlebih dahulu.

- 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

Setelah Anda membuat file YAML, untuk menyelesaikan pembelian komitmen dengan reservasi yang terlampir, jalankan perintah berikut. Perlu diperhatikan bahwa contoh komitmen juga berisi resource vCPU dan memori.

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

Untuk membuat reservasi terlampir saat membeli komitmen Anda, buat permintaan POST ke metode regionCommitments.insert. Dalam permintaan, sertakan kolom reservations untuk menentukan daftar semua reservasi baru yang ingin Anda buat dan lampirkan. Anda dapat melampirkan berapa pun reservasi yang ada ke komitmen Anda.

• Untuk membuat reservasi baru dengan menentukan semua properti VM secara manual, sertakan kolom instanceProperties dan kecualikan kolom sourceInstanceTemplate.

  Misalnya, untuk menentukan secara manual konfigurasi reservasi bersama yang dibagikan dengan dua project yang menentukan GPU, dua disk SSD Lokal, dan satu platform CPU minimum, buat permintaan berikut:

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

• Untuk membuat reservasi baru dengan menentukan template instance, sertakan kolom sourceInstanceTemplate dan kecualikan kolom instanceProperties.

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

Ganti properti berikut dengan properti komitmen dan reservasi terlampir:

Compute Engine membuat komitmen dan reservasi yang terpasang hanya jika ada cukup resource dari jenis mesin yang ditentukan di zona target, dan kuota yang cukup, pada saat permintaan Anda. Jika pembelian Anda berhasil, Compute Engine akan menampilkan status 200 untuk permintaan REST API Anda.

Contoh untuk membeli komitmen dengan membuat reservasi baru yang dapat dilampirkan

Contoh skenario dan perintah berikut menunjukkan cara membeli komitmen untuk GPU, disk SSD Lokal, atau keduanya dengan membuat reservasi baru untuk dilampirkan pada komitmen tersebut.

Contoh 1: Membeli komitmen untuk GPU dengan melampirkan satu reservasi baru

Misalnya Anda ingin membeli komitmen commitment-01 di region us-central1 yang mencakup 4 GPU NVIDIA V100. Anda ingin membuat reservation-01 reservasi baru sebagai reservasi terlampir untuk GPU tersebut. Misalkan Anda juga ingin menentukan Compute Engine untuk menggunakan GPU yang dicadangkan tersebut di 2 VM n1-standard-8 dalam zona us-central1-a. Untuk membeli contoh komitmen ini dengan reservasi yang terlampir, buat permintaan POST berikut:

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"
    }
  ]
}

Contoh 2: Membeli komitmen untuk GPU tanpa terikat pada vCPU atau memori

Untuk berkomitmen pada dan memesan disk GPU dan SSD Lokal tanpa terikat pada vCPU atau memori, tentukan 0 sebagai nilai untuk kuantitas vCPU dan memori. Misalnya, Anda ingin membeli commitment-02 komitmen untuk satu GPU NVIDIA P4 di region us-west2. Anda juga ingin membuat reservasi baru sebagai reservasi terlampir dan menentukan Compute Engine untuk menggunakan GPU yang dicadangkan pada VM n1-standard-2 di zona us-west2-b. Untuk membeli komitmen contoh ini dengan reservasi yang terlampir, buat permintaan POST berikut:

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"
    }
  ]
}

Contoh 3: Membeli komitmen untuk disk GPU dan SSD Lokal dengan melampirkan beberapa reservasi baru

Misalnya Anda ingin membeli komitmen commitment-03 untuk 1 disk NVIDIA V 100 GPU dan 2 disk SSD Lokal di region us-central1. Anda juga ingin membuat dan melampirkan dua reservasi di zona us-central1-a. Pada reservasi pertama, res-01, Anda ingin memesan 1 VM n1-standard-2 dengan 1 GPU. Anda ingin menjadikan res-01 sebagai reservasi yang ditargetkan, yang berarti Anda harus secara khusus menargetkan reservasi tersebut menurut nama untuk menggunakan VM yang dicadangkannya. Di reservasi kedua, res-02, Anda ingin mencadangkan 1 VM n1-standard-8 dengan 2 jenis disk SSD Lokal yang terpasang. Untuk membeli komitmen contoh ini dengan reservasi terlampir, buat permintaan POST berikut. Perlu diperhatikan bahwa contoh komitmen juga berisi resource vCPU dan memori.

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

Untuk mengganti pemesanan yang terlampir dengan komitmen, lakukan tindakan berikut:

1. Buat file YAML di direktori saat ini dengan konfigurasi pemesanan terlampir berikut:

   • Pemesanan saat ini yang ingin Anda ganti.

     Untuk mengambil detail pemesanan ini, lihat Melihat detail pemesanan.

   • Pemesanan pengganti baru.

   Isi file YAML mirip dengan berikut ini:

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

   Ganti kode berikut dengan properti yang sesuai dari pemesanan saat ini dan pengganti:

   Pemesanan saat ini

   Untuk pemesanan saat ini, semua properti berikut harus sama persis dengan saat Anda melihat pemesanan. Hapus kolom untuk properti apa pun yang belum dimiliki pemesanan saat ini.

   • CURRENT_RESERVATION_NAME: nama pemesanan terlampir saat ini.
   • CURRENT_RESERVATION_ZONE: zona pemesanan terlampir saat ini.
   • CURRENT_RESERVATION_MACHINE_TYPE: jenis mesin dari pemesanan terlampir saat ini.
   • CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS: jumlah GPU yang dipesan dalam pemesanan terlampir saat ini.
   • CURRENT_RESERVATION_ACCELERATOR_TYPE: jenis akselerator yang dipesan dalam pesanan terlampir saat ini.
   • CURRENT_RESERVATION_INTERFACE_1 dan CURRENT_RESERVATION_INTERFACE_2: jenis antarmuka yang disk SSD Lokal untuk setiap penggunaan VM yang dicadangkan dalam reservasi yang terpasang saat ini. Opsi yang valid adalah: scsi dan nvme. Setiap disk SSD Lokal berukuran 375 GB. Ulangi parameter local_ssd untuk semua disk SSD Lokal yang dicadangkan.
   • CURRENT_RESERVATION_PROJECT_ID: project ID dari project saat ini yang memiliki komitmen dan pemesanan terlampir. Tentukan kolom ini jika pemesanan terlampir saat ini dibagikan ke beberapa project konsumen.
   • CURRENT_RESERVATION_SHARE_SETTING: Jenis berbagi untuk pemesanan saat ini. Tentukan kolom ini dengan nilai sebagai projects jika pemesanan terlampir saat ini dibagikan ke beberapa project konsumen.
   • CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1 dan CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2: project ID dari project yang Anda bagikan dengan pemesanan terlampir saat ini, misalnya project-1 dan project-2.

   Pemesanan pengganti

   Untuk reservasi pengganti, tetapkan properti berikut sesuai kebutuhan. Pastikan Anda memenuhi semua persyaratan saat menentukan properti ini. Hapus isian tambahan yang tidak ingin Anda gunakan.

   • REPLACEMENT_RESERVATION_NAME: nama pemesanan pengganti baru.
   • REPLACEMENT_RESERVATION_ZONE: zona pemesanan pengganti baru.
   • REPLACEMENT_RESERVATION_NUMBER_OF_VMS: jumlah VM yang ingin Anda pesan di pemesanan pengganti baru.

   • REPLACEMENT_RESERVATION_MACHINE_TYPE: jenis mesin yang diinginkan untuk VM di pemesanan pengganti baru Anda.

     • Untuk jenis mesin predefined, gunakan format MACHINE_FAMILY-standard-CPUS; misalnya, n2-standard-4.
     • Untuk jenis mesin kustom, gunakan format MACHINE_FAMILY-custom-CPUS-MEMORY; misalnya n2-custom-4-5120. Untuk daftar lengkap batasan, baca spesifikasi untuk jenis mesin kustom.

     Ganti kode berikut:

     • MACHINE_FAMILY: kelompok jenis mesin; misalnya, tentukan n2 untuk VM N2.
     • CPUS: jumlah vCPUs.
     • MEMORY: total memori untuk VM yang dicadangkan. Memori harus berukuran kelipatan 256 MB dan harus disediakan dalam MB. Misalnya, untuk membuat VM N2 dengan 4 vCPU dan memori 5 GB, atau 5.120 MB, gunakan n2-custom-4-5120.

   • REPLACEMENT_RESERVATION_NUMBER_OF_ACCELERATORS: jumlah GPU yang ingin Anda tambahkan, per VM, di reservasi penggantian.

   • REPLACEMENT_RESERVATION_ACCELERATOR_TYPE: jenis akselerator yang ingin Anda tambahkan dalam pemesanan pengganti.

   • REPLACEMENT_RESERVATION_INTERFACE_1 dan REPLACEMENT_RESERVATION_INTERFACE_2: jenis antarmuka yang Anda inginkan disk SSD Lokal untuk setiap VM yang dicadangkan untuk digunakan. Opsi yang valid adalah: scsi dan nvme. Setiap disk SSD Lokal berukuran 375 GB. Ulangi parameter local_ssd untuk setiap disk SSD Lokal yang ingin Anda tambahkan. Anda dapat menentukan hingga 24 disk SSD Lokal.

   • REPLACEMENT_RESERVATION_PROJECT_ID: project ID dari project saat ini yang memiliki komitmen dan pemesanan terlampir. Tentukan kolom ini jika Anda ingin membagikan pemesanan pengganti ke beberapa project konsumen.

   • REPLACEMENT_RESERVATION_SHARE_SETTING: jenis berbagi untuk pemesanan pengganti. Tentukan kolom ini dengan nilai sebagai projects jika Anda ingin membagikan pemesanan pengganti ke beberapa project konsumen.

   • REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1 dan REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2: project ID dari project yang dapat membagikan pemesanan ini, misalnya project-1,project-2. Anda dapat menyertakan hingga 100 project konsumen. Project ini harus berada dalam organisasi yang sama dengan project pemilik. Jangan sertakan REPLACEMENT_RESERVATION_PROJECT_ID, yang sudah diizinkan untuk menggunakan reservasi ini secara default.

2. Jalankan perintah gcloud beta compute commitments update-reservations dan tentukan jalur ke file YAML menggunakan flag --reservations-from-file.

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

   Ganti kode berikut:

   • COMMITMENT_NAME: nama komitmen dengan pemesanan terlampir.
   • PROJECT_ID: project ID dari komitmen dengan pemesanan terlampir.
   • REGION: Region tempat komitmen berada.
   • YAML_FILE: Jalur ke file YAML yang berisi konfigurasi pemesanan saat ini dan pemesanan pengganti.

Contoh penggantian pemesanan yang dilampirkan ke komitmen

Untuk menunjukkannya, bagian ini menampilkan contoh komitmen dengan pemesanan terlampir dan cara mengganti contoh pemesanan terlampir.

Contoh komitmen dengan pemesanan terlampir

Misalnya, Anda ingin memperbarui pemesanan terlampir untuk komitmen my-commitment-with-reservations, yang dibeli menggunakan perintah berikut:

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

Untuk contoh ini, misalnya saat perintah ini dijalankan, one-reservation.yaml adalah file dalam direktori saat ini dengan konten berikut, yang menentukan pemesanan terlampir bernama 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

Komitmen my-commitment-with-reservations ini dan res-1 pemesanan yang terlampir menghasilkan resource komitmen dan dipesan berikut:

^*Secara khusus, contoh reservasi terlampir, res-1, mencadangkan 4 VM n1-standard-4, masing-masing dengan 1 disk GPU P100 dan 2 disk SSD Lokal dari jenis antarmuka scsi. n1-standard-4 Jenis mesin menggunakan 4 vCPU dan 15 GB untuk setiap VM.

Ganti contoh pemesanan terlampir

Misalnya Anda ingin mengganti pemesanan terlampir res-1 dengan pemesanan terlampir yang baru res-2 dan mengubah resource yang dipesan menjadi seperti berikut:

^*Secara khusus, contoh reservasi terlampir, res-1, mencadangkan 4 VM n1-standard-4, masing-masing dengan 1 disk GPU P100 dan 2 disk SSD Lokal dari jenis antarmuka scsi. n1-standard-4 Jenis mesin menggunakan 4 vCPU dan 15 GB untuk setiap VM.

^†Secara khusus, reservasi penggantian terlampir menentukan res-2, yang mencadangkan 2 n1-standard-8 VM, masing-masing dengan 1 disk GPU P100 dan 4 disk SSD Lokal dari jenis antarmuka scsi. Selain itu, res-2 dibagikan dengan 2 project lainnya, project-1 dan project-2, serta dimiliki oleh project saat ini, my-project. Jenis mesin n1-standard-8 menggunakan 8 vCPU dan 30 GB untuk setiap VM.

Untuk mengganti pemesanan res-1 yang terlampir dengan res-2 untuk komitmen my-commitment-with-reservations, lakukan tindakan berikut:

1. Buat file bernama two-reservations.yaml di direktori saat ini yang filenya berisi konten berikut:

   - 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. Jalankan perintah berikut:

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

REST

Untuk mengganti pemesanan yang terlampir dengan komitmen, buat permintaan POST menggunakan metode 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"
          }
         }
      }
    }
  ]
}

Ganti elemen berikut dengan properti komitmen yang sesuai, pemesanan saat ini, dan pemesanan pengganti:

Contoh penggantian pemesanan yang dilampirkan ke komitmen

Untuk menunjukkannya, bagian ini menampilkan contoh komitmen dengan pemesanan terlampir dan cara mengganti contoh pemesanan terlampir.

Contoh komitmen dengan pemesanan terlampir

Misalnya, Anda ingin mengganti res-1 pemesanan yang terlampir untuk komitmen my-commitment-with-reservations, yang dibeli dengan membuat permintaan POST berikut:

  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"
  }

Komitmen my-commitment-with-reservations ini dan res-1 pemesanan yang terlampir menghasilkan resource komitmen dan dipesan berikut:

^*Secara khusus, contoh reservasi terlampir, res-1, mencadangkan 4 VM n1-standard-4, masing-masing dengan 1 disk GPU P100 dan 2 disk SSD Lokal dari jenis antarmuka scsi. n1-standard-4 Jenis mesin menggunakan 4 vCPU dan 15 GB untuk setiap VM.

Ganti contoh pemesanan terlampir

Misalnya Anda ingin mengganti pemesanan terlampir res-1 dengan pemesanan terlampir yang baru res-2 dan mengubah resource yang dipesan menjadi seperti berikut:

^*Secara khusus, contoh reservasi terlampir, res-1, mencadangkan 4 VM n1-standard-4, masing-masing dengan 1 disk GPU P100 dan 2 disk SSD Lokal dari jenis antarmuka scsi. n1-standard-4 Jenis mesin menggunakan 4 vCPU dan 15 GB untuk setiap VM.

^†Secara khusus, reservasi penggantian terlampir menentukan res-2, yang mencadangkan 2 n1-standard-8 VM, masing-masing dengan 1 disk GPU P100 dan 4 disk SSD Lokal dari jenis antarmuka scsi. Selain itu, res-2 dibagikan dengan 2 project lainnya, project-1 dan project-2, serta dimiliki oleh project saat ini, my-project. Jenis mesin n1-standard-8 menggunakan 8 vCPU dan 30 GB untuk setiap VM.

Untuk mengganti pemesanan terlampir res-1 dengan res-2 untuk komitmen my-commitment-with-reservations, buat permintaan POST berikut menggunakan metode 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"
      }
    ]
  }