Menggabungkan pemesanan 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 mana pun dari akun Penagihan Cloud tersebut. Setelah memilih project, lakukan hal berikut:

1. Di konsol Google Cloud , buka halaman Committed use discounts.

   Buka halaman Committed use discounts

2. Untuk membeli komitmen, klik add_box Beli komitmen. Halaman Purchase a committed use discount 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 komitmen terhadap resource Compute Engine.

5. Di kolom Jenis komitmen, pilih seri kelompok mesin untuk resource yang di-commit. Jenis komitmen berikut menyediakan opsi untuk GPU, disk SSD Lokal, atau keduanya:

   • A2 yang dioptimalkan akselerator untuk resource jenis mesin A2
   • A3 yang dioptimalkan akselerator untuk resource jenis mesin A3 Edge dan A3 High
   • A3 Mega yang dioptimalkan akselerator untuk resource jenis mesin A3 Mega
   • C2 yang dioptimalkan untuk komputasi untuk resource jenis mesin C2
   • C2D yang dioptimalkan untuk komputasi untuk resource jenis mesin C2D
   • General-Purpose C3 untuk resource jenis mesin C3
   • General-Purpose C3D untuk resource jenis mesin C3D
   • N1 tujuan umum untuk resource jenis mesin N1
   • N2 Tujuan Umum untuk resource jenis mesin N2
   • N2D Tujuan Umum untuk resource mesin N2D
   • G2 yang dioptimalkan untuk grafis untuk resource jenis mesin G2
   • M3 yang dioptimalkan untuk memori untuk resource jenis mesin M3
   • Z3 yang dioptimalkan untuk penyimpanan untuk resource jenis mesin Z3

6. Untuk Durasi, lakukan hal berikut:

   1. Untuk menentukan paket komitmen, pilih 1 tahun atau 3 tahun. Setelan ini menentukan panjang jangka waktu preset komitmen Anda.

   2. Opsional. Untuk menentukan durasi komitmen kustom, klik tombol Perpanjang tanggal akhir, lalu di kolom Tanggal, tentukan tanggal akhir kustom. Untuk informasi selengkapnya, lihat Memperpanjang durasi jangka waktu komitmen.

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

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

9. Untuk membeli komitmen GPU, di bagian GPUs, klik add Add GPU, lalu lakukan hal berikut:

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

10. Untuk melakukan komitmen pada disk SSD Lokal, di bagian SSD Lokal, klik add Tambahkan SSD, lalu di kolom Jumlah SSD, 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. Kemudian, lakukan hal berikut:

    1. Opsional. Untuk melihat reservasi dengan properti tertentu, di 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 dengan reservasi terlampir, lakukan tindakan berikut:

    1. Klik Purchase.
    2. Pada dialog Beli diskon penggunaan berkomitmen, jika Anda menyetujui persyaratan khusus layanan, klik Beli lagi.

gcloud

Untuk membeli komitmen dengan melampirkan reservasi yang ada, jalankan perintah gcloud compute commitments create. Dalam perintah, sertakan tanda --existing-reservation untuk menentukan reservasi yang ada yang ingin Anda lampirkan ke komitmen. Sertakan instance baru dari tanda ini untuk setiap reservasi yang ada yang ingin Anda pasang. Anda dapat melampirkan sejumlah pemesanan yang ada ke komitmen Anda.

Misalnya, untuk membeli komitmen dengan melampirkan dua reservasi ke komitmen tersebut, 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 \
    --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'

Ganti kode berikut:

• COMMITMENT_NAME: nama komitmen.
• REGION: region tempat komitmen berada.
• PROJECT_ID: ID project tempat Anda ingin membeli komitmen dengan pemesanan terlampir.
• DURATION: durasi jangka waktu komitmen, 12-month atau 36-month.
• CUSTOM_END_DATE: Opsional. Tanggal akhir kustom untuk jangka waktu Anda, yang harus diformat sebagai YYYY-MM-DD. Misalnya, untuk menentukan tanggal berakhir kustom 20 April 2024, formatnya sebagai 2024-04-20.

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

  • accelerator-optimized untuk resource jenis mesin A2
  • accelerator-optimized-a3 untuk resource jenis mesin A3 Edge dan A3 High
  • accelerator-optimized-a3-mega untuk resource jenis mesin A3 Mega
  • 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-n2 untuk resource jenis mesin N2
  • general-purpose-n2d untuk resource mesin N2D
  • graphics-optimized untuk resource jenis mesin G2
  • memory-optimized-m3 untuk resource jenis mesin M3
  • storage-optimized-z3 untuk resource jenis mesin Z3

• COMMITTED_VCPUS: jumlah vCPU yang Anda inginkan dalam komitmen. Angka 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 Anda inginkan dalam komitmen. Setiap disk SSD Lokal berukuran 375 GB.

• COMMITTED_ACCELERATOR_COUNT: jumlah GPU yang Anda inginkan dalam komitmen.

• COMMITTED_ACCELERATOR_TYPE: jenis GPU yang Anda inginkan dalam komitmen Anda.

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

• RESERVATION_ZONE_1 dan RESERVATION_ZONE_2: Zona pemesanan yang ada yang ingin Anda lampirkan ke komitmen.

Contoh: Membeli komitmen dengan melampirkan reservasi yang ada

Misalnya, Anda memiliki dua reservasi res-01 dan res-02 di zona us-central1-a dan us-central1-b dari project myproject. Misalkan, pemesanan 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 GPU dan disk SSD Lokal ini, dan menggunakan reservasi yang ada ini sebagai reservasi terlampir, jalankan perintah berikut. Perhatikan bahwa contoh komitmen juga berisi vCPU dan memori.

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

Untuk membeli komitmen dengan melampirkan reservasi yang ada, buat permintaan POST ke metode regionCommitments.insert. Dalam permintaan Anda, sertakan kolom existingReservations untuk menentukan daftar yang dipisahkan koma dari semua reservasi yang ada yang ingin Anda lampirkan ke komitmen Anda. Anda dapat melampirkan sejumlah pemesanan 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"
    }
  ],
  "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
  "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 pemesanan 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:

  • ACCELERATOR_OPTIMIZED untuk resource jenis mesin A2
  • ACCELERATOR_OPTIMIZED_A3 untuk resource jenis mesin A3 Edge dan A3 High
  • ACCELERATOR_OPTIMIZED_A3_MEGA untuk resource jenis mesin A3 Mega
  • 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_N2 untuk resource jenis mesin N2
  • GENERAL_PURPOSE_N2D untuk resource mesin N2D
  • GRAPHICS_OPTIMIZED untuk resource jenis mesin G2
  • MEMORY_OPTIMIZED_M3 untuk resource jenis mesin M3
  • STORAGE_OPTIMIZED_Z3 untuk resource jenis mesin Z3

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

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

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

• COMMITTED_ACCELERATOR_COUNT: jumlah GPU yang Anda inginkan dalam komitmen.

• COMMITTED_ACCELERATOR_TYPE: jenis GPU yang Anda inginkan dalam komitmen Anda.

• CUSTOM_END_DATE: Opsional. Tanggal akhir kustom untuk jangka waktu Anda, yang harus diformat sebagai YYYY-MM-DD. Misalnya, untuk menentukan tanggal akhir kustom 20 April 2024, formatnya sebagai 2024-04-20.

• END_TIME: 00.00 Waktu Pasifik AS dan Kanada (UTC-8 atau UTC-7), sebagai offset Waktu Universal Terkoordinasi (UTC). Tentukan nilai ini hanya jika Anda menentukan tanggal akhir kustom untuk komitmen Anda. Tentukan salah satu nilai berikut:

  • Selama waktu musim panas: 07:00:00
  • Pada waktu lainnya: 08:00:00

• RESERVATION_URLs: daftar URL yang dipisahkan koma dari pemesanan 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

Misalnya, Anda memiliki dua reservasi res-01 dan res-02 di zona us-central1-a dan us-central1-b dari project myproject. Misalkan, pemesanan 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 GPU dan disk SSD Lokal ini, serta menggunakan reservasi yang ada ini sebagai reservasi terlampir, buat permintaan POST berikut. Perhatikan 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-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"
  ]
}

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 mana pun dari akun Penagihan Cloud tersebut. Setelah memilih project, lakukan hal berikut:

1. Di konsol Google Cloud , buka halaman Committed use discounts.

   Buka halaman Committed use discounts

2. Untuk membeli komitmen, klik add_box Beli komitmen. Halaman Purchase a committed use discount 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 komitmen terhadap resource Compute Engine.

5. Di kolom Jenis komitmen, pilih seri kelompok mesin untuk resource yang di-commit. Jenis komitmen berikut menyediakan opsi untuk GPU, disk SSD Lokal, atau keduanya:

   • A2 yang dioptimalkan akselerator untuk resource jenis mesin A2
   • A3 yang dioptimalkan akselerator untuk resource jenis mesin A3 Edge dan A3 High
   • A3 Mega yang dioptimalkan akselerator untuk resource jenis mesin A3 Mega
   • C2 yang dioptimalkan untuk komputasi untuk resource jenis mesin C2
   • C2D yang dioptimalkan untuk komputasi untuk resource jenis mesin C2D
   • General-Purpose C3 untuk resource jenis mesin C3
   • General-Purpose C3D untuk resource jenis mesin C3D
   • N1 tujuan umum untuk resource jenis mesin N1
   • N2 Tujuan Umum untuk resource jenis mesin N2
   • N2D Tujuan Umum untuk resource mesin N2D
   • G2 yang dioptimalkan untuk grafis untuk resource jenis mesin G2
   • M3 yang dioptimalkan untuk memori untuk resource jenis mesin M3
   • Z3 yang dioptimalkan untuk penyimpanan untuk resource jenis mesin Z3

6. Untuk Durasi, pilih 1 tahun atau 3 tahun sebagai durasi jangka waktu komitmen Anda.

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

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

9. Untuk membeli komitmen GPU, di bagian GPUs, klik add Add GPU, lalu lakukan hal berikut:

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

10. Untuk melakukan komitmen pada disk SSD Lokal, di bagian SSD Lokal, klik add Tambahkan SSD, lalu di kolom Jumlah SSD, tentukan jumlah disk.

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

    1. Klik Tambahkan reservasi. Bagian New reservation akan muncul.
    2. Di kolom Nama, masukkan nama untuk pemesanan terlampir Anda.
    3. Di kolom Region, pilih region yang sama dengan komitmen Anda.
    4. Di kolom Zone, pilih zona tempat Anda ingin memesan resource.

    5. Di bagian Share type, tentukan cara Anda ingin membagikan reservasi ini dengan salah satu cara berikut:

       • Untuk membuat reservasi satu project, pilih Lokal.
       • Untuk membuat pemesanan yang dibagikan dengan beberapa project, pilih Dibagikan. Kemudian, untuk menentukan project yang akan menggunakan pemesanan bersama ini, klik add Tambahkan project, lalu pilih project yang Anda inginkan dari organisasi project saat ini.

    6. Di kolom Gunakan dengan instance VM, pilih cara yang Anda inginkan agar VM menggunakan reservasi dengan salah satu cara berikut:

       • Untuk mengizinkan VM dengan properti yang cocok menggunakan pemesanan ini secara otomatis, klik Gunakan pemesanan secara otomatis (default).
       • Untuk menggunakan resource pemesanan ini hanya saat membuat VM dengan properti yang cocok yang secara khusus menargetkan pemesanan ini berdasarkan nama, klik Pilih pemesanan tertentu.

    7. Di bagian Detail resource, lakukan hal berikut:

       1. Di kolom Number of VM instances, masukkan jumlah instance VM yang ingin Anda pesan.

       2. Di bagian Konfigurasi mesin, tentukan properti VM yang dipesan dengan salah satu cara berikut:

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

             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 hal berikut:

             1. Pilih kelompok mesin yang berlaku untuk seri mesin yang Anda tentukan untuk komitmen:

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

             2. Di tabel yang memiliki kolom Series, pilih seri 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 bawaan, pilih Preset, lalu pilih jenis mesin yang Anda inginkan.
                2. Untuk memilih jenis mesin kustom, pilih Kustom, lalu tentukan Inti dan Memori yang Anda inginkan.

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

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

                2. Opsional: Untuk mencadangkan GPU, klik add Tambahkan GPU. Kemudian, di kolom Jenis GPU dan Jumlah GPU, pilih jenis dan jumlah GPU untuk setiap VM.

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

                1. Di kolom Number of disks, pilih jumlah disk SSD Lokal yang Anda inginkan untuk setiap VM.
                2. Di kolom Jenis antarmuka, pilih antarmuka untuk disk SSD Lokal.

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

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

    1. Klik Purchase.
    2. Pada dialog Beli diskon penggunaan berkomitmen, jika Anda menyetujui persyaratan khusus layanan, klik Beli lagi.

gcloud

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

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

• Untuk membuat dan melampirkan satu reservasi ke komitmen, tentukan properti reservasi yang dilampirkan 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 \
      --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
  

• Untuk membuat dan melampirkan beberapa reservasi ke komitmen, tentukan properti reservasi menggunakan file YAML, lalu tentukan file YAML tersebut dalam perintah yang Anda gunakan untuk membeli komitmen. Jika ingin, Anda juga dapat menggunakan pendekatan file YAML ini untuk membuat dan melampirkan satu reservasi ke komitmen Anda. Untuk membuat pemesanan terlampir menggunakan pendekatan ini, lakukan hal berikut:

  1. Buat file YAML di direktori saat ini dan tentukan konfigurasi yang Anda inginkan untuk setiap pemesanan 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 Anda:

     - 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 pemesanan yang ada 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 kode berikut dengan properti komitmen dan pemesanan terlampir yang sesuai:

Compute Engine membuat komitmen dan pemesanan terlampir hanya jika ada cukup resource untuk jenis mesin yang ditentukan di zona target, serta kuota yang memadai pada saat permintaan Anda dibuat. Jika pembelian Anda berhasil, Anda akan melihat pesan sukses yang mirip dengan berikut ini:

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

Contoh pembelian komitmen dengan membuat pemesanan baru untuk dilampirkan

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

Contoh 1: Membeli komitmen untuk GPU dengan melampirkan satu pemesanan 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 contoh komitmen ini dengan reservasi terlampirnya, 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 membeli komitmen untuk vCPU atau memori

Untuk membeli komitmen dan memesan GPU dan disk SSD Lokal tanpa membeli komitmen untuk vCPU atau memori, tentukan 0 sebagai nilai untuk jumlah 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 contoh komitmen ini dengan pemesanan terlampirnya, 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 GPU dan disk SSD Lokal dengan melampirkan beberapa reservasi baru

Misalnya, Anda ingin membeli komitmen commitment-03 untuk 1 GPU NVIDIA V100 dan 2 disk SSD Lokal di region us-central1. Anda juga ingin membuat dan melampirkan dua pemesanan di zona us-central1-a. Dalam pemesanan 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 berdasarkan nama untuk menggunakan VM yang direservasinya. Dalam pemesanan kedua, res-02, Anda ingin memesan 1 VM n1-standard-8 dengan 2 jenis disk SSD Lokal yang terpasang.

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

- 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 membuat file YAML, untuk menyelesaikan pembelian komitmen dengan pemesanan terlampirnya, jalankan perintah berikut. Perhatikan 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 pemesanan terlampir saat membeli komitmen, buat permintaan POST ke metode regionCommitments.insert. Dalam permintaan Anda, sertakan kolom reservations untuk menentukan daftar semua reservasi baru yang ingin Anda buat dan lampirkan. Anda dapat melampirkan sejumlah pemesanan yang ada ke komitmen.

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

  Misalnya, untuk menentukan konfigurasi pemesanan bersama yang dibagikan dengan dua project yang menentukan GPU, dua disk SSD Lokal, dan platform CPU minimum secara manual, 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"
    }
  ],
  "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"
          }
        }
      }
    }
  ]
  }
  
  

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

Ganti kode berikut dengan properti komitmen dan pemesanan terlampir yang sesuai:

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

Contoh pembelian komitmen dengan membuat pemesanan baru untuk dilampirkan

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

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

Misalnya, Anda ingin membeli komitmen commitment-01 di region us-central1 yang mencakup 4 GPU NVIDIA V100. Anda ingin membuat pemesanan baru reservation-01 sebagai pemesanan terlampir untuk GPU tersebut. Misalkan Anda juga ingin menentukan Compute Engine untuk menggunakan GPU yang dicadangkan tersebut di 2 VM n1-standard-8 di zona us-central1-a. Untuk membeli contoh komitmen ini dengan reservasi terlampirnya, 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 membeli komitmen untuk vCPU atau memori

Untuk membeli komitmen dan memesan GPU dan disk SSD Lokal tanpa membeli komitmen untuk vCPU atau memori, tentukan 0 sebagai nilai untuk jumlah vCPU dan memori. Misalnya, Anda ingin membeli komitmen commitment-02 untuk satu GPU NVIDIA P4 di region us-west2. Anda juga ingin membuat pemesanan baru sebagai pemesanan terlampir dan menentukan Compute Engine untuk menggunakan GPU yang dipesan pada VM n1-standard-2 di zona us-west2-b. Untuk membeli contoh komitmen ini dengan pemesanan terlampirnya, 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 GPU dan disk SSD Lokal dengan melampirkan beberapa reservasi baru

Misalnya, Anda ingin membeli komitmen commitment-03 untuk 1 GPU NVIDIA V100 dan 2 disk SSD Lokal di region us-central1. Anda juga ingin membuat dan melampirkan dua pemesanan di zona us-central1-a. Dalam pemesanan 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 berdasarkan nama untuk menggunakan VM yang direservasinya. Dalam pemesanan kedua, res-02, Anda ingin memesan 1 VM n1-standard-8 dengan 2 jenis disk SSD Lokal yang terpasang. Untuk membeli contoh komitmen ini dengan reservasi terlampir, buat permintaan POST berikut. Perhatikan 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
     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
   
   

   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 digunakan disk SSD Lokal untuk setiap VM yang dipesan dalam pemesanan terlampir 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 dipesan.
   • 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 pemesanan pengganti, tetapkan properti berikut sesuai kebutuhan. Pastikan Anda memenuhi semua persyaratan saat menentukan properti ini. Hapus kolom 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 vCPU.
     • MEMORY: total memori untuk VM yang dipesan. Ukuran memori harus kelipatan 256 MB dan harus ditulis dalam satuan MB. Misalnya, untuk membuat VM N2 dengan 4 vCPU dan memori 5 GB, yaitu 5.120 MB, gunakan n2-custom-4-5120.

   • REPLACEMENT_RESERVATION_NUMBER_OF_ACCELERATORS: jumlah GPU yang ingin Anda tambahkan, per VM, dalam pemesanan pengganti.

   • 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 ingin digunakan disk SSD Lokal untuk setiap VM yang dipesan. 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 pemesanan 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=3000 \
      --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 pemesanan terlampir, res-1, memesan 4 VM n1-standard-4, masing-masing dengan 1 GPU P100 dan 2 disk SSD Lokal dengan 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 pemesanan terlampir, res-1, memesan 4 VM n1-standard-4, masing-masing dengan 1 GPU P100 dan 2 disk SSD Lokal dengan jenis antarmuka scsi. n1-standard-4 Jenis mesin menggunakan 4 vCPU dan 15 GB untuk setiap VM.

^†Secara khusus, pemesanan terlampir pengganti menentukan res-2, yang memesan 2 n1-standard-8 VM, masing-masing dengan 1 GPU P100 dan 4 disk SSD Lokal 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 \
       --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 pemesanan terlampir, res-1, memesan 4 VM n1-standard-4, masing-masing dengan 1 GPU P100 dan 2 disk SSD Lokal dengan 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 pemesanan terlampir, res-1, memesan 4 VM n1-standard-4, masing-masing dengan 1 GPU P100 dan 2 disk SSD Lokal dengan jenis antarmuka scsi. n1-standard-4 Jenis mesin menggunakan 4 vCPU dan 15 GB untuk setiap VM.

^†Secara khusus, pemesanan terlampir pengganti menentukan res-2, yang memesan 2 n1-standard-8 VM, masing-masing dengan 1 GPU P100 dan 4 disk SSD Lokal 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"
      }
    ]
  }