Gabungkan reservasi dengan diskon abonemen

Diskon abonemen (CUD) memberikan harga diskon besar untuk resource Compute Engine Anda sebagai imbalan atas kontrak abonemen 1 tahun atau 3 tahun (juga dikenal sebagai komitmen). Anda berkomitmen untuk jumlah minimum penggunaan resource atau jumlah minimum pengeluaran, dan menerima CUD atas biaya penggunaan resource Anda sebagai imbalan. Namun, komitmen tidak memenuhi kapasitas zona untuk resource komitmen Anda. Untuk mendapatkan resource zona dengan harga diskon dan juga memastikan kapasitas disediakan untuk resource tersebut, Anda harus membeli komitmen dan membuat reservasi untuk resource zona tersebut.

Dokumen ini menjelaskan cara menerima CUD untuk resource yang dicadangkan dan cara menambahkan reservasi ke komitmen berbasis resource.

Sebelum memulai

  • Tinjau dasar-dasar reservasi beserta persyaratan dan batasannya. Untuk mengetahui informasi selengkapnya, lihat Reservasi resource zona Compute Engine.
  • Siapkan autentikasi, jika Anda belum melakukannya. Autentikasi adalah proses verifikasi identitas Anda untuk akses ke layanan dan API Google Cloud. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine sebagai berikut.

    Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:

    Konsol

    Saat menggunakan Konsol Google Cloud untuk mengakses API dan layanan Google Cloud, Anda tidak perlu menyiapkan autentikasi.

    gcloud

    1. Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut: 

      gcloud init
    2. Menetapkan region dan zona default.

    REST

    Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

      Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut: 

      gcloud init

CUD untuk resource yang dicadangkan

Anda menerima CUD dari komitmen aktif untuk setiap penggunaan resource yang memenuhi syarat dalam project. Jika Anda juga memiliki reservasi untuk mempertahankan kapasitas resource dalam project tersebut, CUD dari komitmen aktif juga dapat berlaku untuk resource yang dicadangkan tersebut. Agar resource yang direservasi memenuhi syarat untuk menerima CUD, persyaratan berikut berlaku:

  • Anda tidak menerima bentuk diskon lainnya untuk penggunaan resource Anda.
  • VM Anda harus menggunakan reservasi selama komitmen aktif.

  • Setidaknya, properti berikut harus cocok antara komitmen aktif dan reservasi yang digunakan VM Anda:

    • Project dan region tempat penerapannya
    • Seri keluarga mesin

Bergantung pada jenis resource, Anda dapat menerima CUD untuk resource yang direservasi dengan salah satu cara berikut:

  • vCPU dan memori: Guna menerima CUD untuk salah satu atau kedua jenis resource tersebut, Anda dapat membeli komitmen berbasis resource atau berbasis pengeluaran yang mencakup jenis resource yang diperlukan. Jika VM di project Anda menggunakan semua reservasi yang propertinya cocok dengan komitmen aktif tersebut, Anda akan otomatis menerima CUD yang berlaku untuk jenis resource yang dicadangkan ini. Jika Anda mencadangkan lebih banyak resource daripada yang ditetapkan, Anda tidak akan menerima CUD untuk resource tambahan tersebut.

  • GPU dan disk SSD Lokal: Guna menerima CUD untuk salah satu atau kedua jenis resource ini, Anda harus melakukan langkah-langkah berikut:

    • Beli komitmen berbasis resource yang mencakup jenis resource yang diperlukan.
    • Buat reservasi untuk semua resource yang di-commit dengan properti yang cocok dengan komitmen Anda, dan tambahkan reservasi tersebut ke komitmen tersebut.

    Saat VM di project Anda menggunakan reservasi yang terpasang ini, Anda akan mulai menerima CUD yang berlaku untuk jenis resource yang dicadangkan ini.

Melampirkan reservasi ke komitmen berbasis resource

Anda dapat menambahkan reservasi ke komitmen berbasis resource dan memastikan kapasitas disimpan di zona tertentu untuk resource commit yang ingin Anda gunakan. Anda dapat menyertakan beberapa reservasi ke satu komitmen. Namun, reservasi hanya dapat disertakan ke satu komitmen. Saat membeli komitmen, Anda dapat melampirkan reservasi ke komitmen tersebut dengan salah satu cara berikut:

  • Menggunakan reservasi yang ada yang propertinya cocok dengan komitmen
  • Membuat reservasi baru yang cocok saat membeli komitmen Anda

Setelah Anda membeli komitmen dengan reservasi yang terlampir, reservasi akan tetap aktif selama komitmen aktif. Saat komitmen Anda berakhir, Compute Engine akan otomatis menghapus semua pemesanan terlampir. Menghapus reservasi ini tidak akan memengaruhi VM yang berjalan dan memakai reservasi tersebut. VM yang sedang berjalan akan terus berjalan dan Anda tetap dikenai biaya untuk VM tersebut.

Resource abonemen yang tidak memerlukan reservasi terlampir

vCPU dan memori yang di-commit tidak mengharuskan Anda menambahkan reservasi yang cocok ke komitmen Anda. Meskipun demikian, saat membeli komitmen yang mencakup vCPU, memori, atau keduanya, Anda masih dapat memilih untuk melampirkan reservasi yang menentukan resource tersebut. Untuk mempelajari cara membeli komitmen hanya untuk vCPU, memori, atau keduanya, tanpa melampirkan reservasi, lihat Membeli komitmen tanpa reservasi terlampir.

Alokasi resource yang memerlukan pemesanan terlampir

GPU abonemen dan disk SSD Lokal mengharuskan Anda untuk menambahkan reservasi yang cocok pada komitmen Anda. Saat membeli komitmen yang menyertakan GPU, disk SSD Lokal, atau keduanya, Anda juga harus mencadangkan resource tersebut dan melampirkannya ke komitmen Anda. Anda dapat melakukannya dengan menggunakan satu reservasi atau kombinasi pemesanan. Saat membeli komitmen tersebut, Anda juga dapat menyertakan vCPU, memori, atau keduanya. Namun, Anda tidak perlu mencadangkan vCPU atau memori tersebut. Untuk mempelajari cara membeli komitmen yang mencakup salah satu atau kedua disk GPU dan SSD Lokal, lihat Komitmen pembelian dengan reservasi terlampir dalam dokumen ini.

Untuk melihat daftar lengkap rangkaian mesin yang mendukung CUD untuk disk GPU dan SSD Lokal, lihat bagian Jenis komitmen dalam dokumentasi CUD berbasis resource.

Jumlah resource yang diizinkan dalam reservasi yang terlampir

Untuk vCPU dan memori, Anda dapat membuat reservasi terpasang yang menentukan jumlah resource yang lebih banyak atau lebih sedikit daripada yang ditetapkan. Jika Anda berkomitmen untuk menggunakan lebih banyak vCPU atau memori dari yang dicadangkan, Compute Engine akan mencadangkan kapasitas hanya untuk resource yang dicadangkan ini. Namun, Anda masih dapat menggunakan resource berkomitmen tambahan, bergantung pada ketersediaannya di region Anda. Jika Anda mencadangkan lebih banyak vCPU atau memori dari jumlah yang ditetapkan, Anda tidak akan menerima CUD untuk resource tambahan yang Anda pesan.

Misalnya, jika Anda membeli komitmen untuk 4 vCPU dan memori 30 GB, Anda dapat memilih untuk melakukan salah satu hal berikut ini:

  • Tidak melampirkan reservasi apa pun.

  • Lampirkan reservasi yang menentukan kombinasi jenis resource ini; misalnya, berikut ini:

    • 4 vCPU dan memori 30 GB
    • 2 vCPU dan memori 50 GB
    • 10 vCPU dan memori 10 GB

Namun, jika komitmen Anda berisi GPU, disk SSD Lokal, atau keduanya, Anda harus mencadangkan dan memasang semua resource tersebut. Reservasi terpasang harus menentukan jumlah dan jenis persis GPU dan disk SSD Lokal yang akan Anda gunakan. Akibatnya, Anda juga tidak dapat memiliki jumlah atau jenis GPU tambahan atau disk SSD Lokal di reservasi yang terpasang. Misalnya, Anda membeli komitmen untuk memori sebesar 30 GB dan 4 GPU NVIDIA P100. Reservasi yang terpasang (atau kombinasi reservasi yang terpasang) dapat menentukan jumlah vCPU atau memori, tetapi harus memiliki tepat 4 GPU yang berasal dari jenis NVIDIA P100. Dalam contoh ini, Anda tidak dapat melampirkan reservasi yang menentukan salah satu kombinasi resource berikut:

  • 6 GPU NVIDIA P100
  • 2 GPU NVIDIA P100
  • 4 GPU NVIDIA P100 dan 2 GPU NVIDIA V100
  • 4 GPU NVIDIA P100 dan 4 disk SSD Lokal

Membeli komitmen dengan pemesanan terlampir

Saat membeli komitmen baru, Anda dapat melampirkan reservasi ke komitmen Anda dengan salah satu cara berikut:

Setelah membeli komitmen, komitmen Anda akan aktif pada hari berikutnya pukul 00.00 Waktu Pasifik AS dan Kanada (UTC-8, atau UTC-7 selama waktu musim panas). Antara waktu pembelian komitmen dan waktu aktivasinya, status komitmen Anda tetap NOT_YET_ACTIVE (atau sebagai PENDING di Konsol Google Cloud). Setelah aktivasi, status komitmen Anda akan berubah menjadi ACTIVE. Misalnya, Anda membeli komitmen pada tanggal 20 Januari pukul 22.00 Waktu Pasifik AS dan Kanada (UTC-8 atau UTC-7). Compute Engine segera membuat komitmen Anda dengan statusnya sebagai NOT_YET_ACTIVE. Namun, komitmen Anda akan menjadi ACTIVE hanya pada 21 Januari pukul 00.00 Waktu Pasifik AS dan Kanada (UTC-8 atau UTC-7).

Persyaratan

Sebelum Anda membeli komitmen dengan reservasi terlampir, tinjau persyaratan berikut dan pastikan komitmen dan reservasi Anda memenuhi kriteria berikut:

  • Anda harus membeli komitmen dan membuat reservasi terlampir di project dan region yang sama.
  • Anda harus membeli komitmen dan membuat reservasi terlampir untuk resource dari seri kelompok mesin yang sama.
  • Anda harus menonaktifkan opsi hapus otomatis pada reservasi yang terlampir.
  • Jika komitmen Anda memiliki GPU, jenis GPU yang ditentukan dalam reservasi dan komitmen harus cocok.
  • Untuk disk GPU dan SSD Lokal, jumlah resource yang dicadangkan untuk setiap jenis resource harus sama persis dengan jumlah resource yang di-commit untuk jenis resource tersebut. Misalnya, jika Anda ingin membeli abonemen untuk 4 GPU V100, reservasi yang terlampir di komitmen Anda harus menentukan total 4 GPU V100. Namun, jumlah vCPU dan memori yang Anda pesan dapat lebih banyak atau lebih sedikit daripada jumlah komitmen yang Anda beli.
  • Untuk GPU, beli komitmen untuk jenis GPU tertentu yang ingin digunakan. Misalnya, Anda dapat membeli komitmen untuk NVIDIA P100 atau NVIDIA V100, tetapi Anda tidak dapat menggunakan komitmen yang dibeli untuk GPU NVIDIA P100 untuk mencakup GPU NVIDIA V100.

  • Jika reservasi yang terlampir adalah reservasi bersama dan Anda ingin menerima CUD yang berlaku saat menggunakan reservasi tersebut di luar project komitmen, Anda harus melakukan kedua tindakan berikut:

    • Bagikan reservasi Anda hanya antar-project yang termasuk dalam akun Penagihan Cloud yang sama dengan komitmen.
    • Aktifkan berbagi CUD untuk akun Penagihan Cloud tersebut.

Lampirkan reservasi yang sudah ada

Anda dapat melampirkan reservasi yang sudah ada saat membeli komitmen menggunakan Konsol Google Cloud, Google Cloud CLI, atau REST.

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

Buat reservasi baru untuk dilampirkan

Anda dapat membuat reservasi terlampir saat membeli komitmen menggunakan Konsol Google Cloud, Google Cloud CLI, atau REST.

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

Komitmen

  • 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, 12-month atau 36-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 diinginkan dalam komitmen Anda. Bilangan harus berupa bilangan bulat positif.

  • COMMITTED_MEMORY: jumlah memori, dalam MB atau GB, yang Anda inginkan dalam komitmen. Misalnya, 10GB atau 10240MB. 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 penyimpanan SSD lokal, dalam GB, yang diinginkan dalam komitmen Anda. Setiap {i>disk<i} 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.

  • YAML_FILE: Jalur ke file YAML yang berisi konfigurasi reservasi yang terlampir.

Reservasi terlampir

  • RESERVATION_NAME: nama reservasi yang dilampirkan.
  • RESERVATION_ZONE: zona reservasi yang dilampirkan.
  • REQUIRE_SPECIFIC_RESERVATION_VALUE: menentukan apakah reservasi yang terlampir adalah reservasi yang ditargetkan secara khusus; true atau false. Untuk mengetahui informasi selengkapnya tentang reservasi yang ditargetkan secara khusus, lihat Cara kerja reservasi.
  • NUMBER_OF_RESERVED_VMS: jumlah VM yang ingin Anda reservasi di reservasi terlampir.

  • RESERVED_MACHINE_TYPE: jenis mesin yang Anda inginkan untuk VM di reservasi terlampir.

    • Untuk jenis mesin yang telah ditentukan, 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.

  • RESERVED_ACCELERATOR_COUNT: jumlah GPU yang ingin Anda tambahkan, per VM, dalam reservasi terlampir.

  • RESERVED_ACCELERATOR_TYPE: jenis akselerator yang ingin Anda tambahkan di pemesanan yang terlampir.

  • INTERFACE_1 dan INTERFACE_2: jenis antarmuka yang Anda inginkan disk SSD Lokal untuk setiap VM yang dicadangkan 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 ditambahkan. Anda dapat menentukan hingga 24 disk SSD Lokal.

  • OWNER_PROJECT_ID: ID project tempat Anda ingin membeli komitmen dengan reservasi terlampir. Tentukan kolom ini jika Anda ingin membagikan reservasi terlampir ke beberapa project konsumen.

  • MINIMUM_CPU_PLATFORM: platform CPU minimum yang ingin Anda tentukan untuk reservasi yang terpasang.

  • SHARE_SETTING: jenis berbagi untuk reservasi yang terlampir. Tentukan kolom ini dengan nilai sebagai projects jika Anda ingin membagikan reservasi terlampir ke beberapa project konsumen. Kecualikan kolom ini jika Anda ingin membuat reservasi satu project.

  • CONSUMER_PROJECT_ID_1 dan CONSUMER_PROJECT_ID_2: project ID project yang dapat membagikan reservasi ini, misalnya project-1 dan project-2. Anda dapat menyertakan hingga 100 project konsumen. Project ini harus berada dalam organisasi yang sama dengan project pemilik. Jangan sertakan ID project tempat Anda membuat reservasi ini karena project tersebut diizinkan untuk menggunakan reservasi ini secara default. Kecualikan kolom ini jika Anda ingin membuat reservasi satu project.

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:

Komitmen

  • 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, 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
    • 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 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 {i>disk<i} 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.

Reservasi terlampir

  • RESERVATION_NAME: nama reservasi yang dilampirkan.
  • RESERVATION_ZONE: zona reservasi yang dilampirkan.
  • REQUIRE_SPECIFIC_RESERVATION_VALUE: menentukan apakah reservasi yang terlampir adalah reservasi yang ditargetkan secara khusus; true atau false. Untuk mengetahui informasi selengkapnya tentang reservasi yang ditargetkan secara khusus, lihat Cara kerja reservasi.
  • NUMBER_OF_RESERVED_VMS: jumlah VM yang ingin Anda reservasi di reservasi terlampir.

  • RESERVED_MACHINE_TYPE: jenis mesin yang Anda inginkan untuk VM di reservasi terlampir.

    • Untuk jenis mesin yang telah ditentukan, 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. 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.

  • RESERVED_ACCELERATOR_COUNT: jumlah GPU yang ingin Anda tambahkan, per VM, dalam reservasi terlampir.

  • RESERVED_ACCELERATOR_TYPE: jenis akselerator yang ingin Anda tambahkan di pemesanan yang terlampir.

  • INTERFACE_1 dan 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 localSsds untuk setiap disk SSD Lokal yang ingin ditambahkan. Anda dapat menentukan hingga 24 disk SSD Lokal.

  • MINIMUM_CPU_PLATFORM: platform CPU minimum yang ingin Anda tentukan untuk reservasi yang terpasang.

  • INSTANCE_TEMPLATE_NAME: nama template instance yang ingin Anda gunakan untuk membuat reservasi terlampir.

  • SHARE_SETTING: jenis berbagi untuk reservasi yang terlampir. Tentukan kolom ini dengan nilai sebagai SPECIFIC_PROJECTS jika Anda ingin membagikan reservasi terlampir ke beberapa project konsumen. Kecualikan kolom ini jika Anda ingin membuat pemesanan project tunggal.

  • CONSUMER_PROJECT_ID_1 dan CONSUMER_PROJECT_ID_2: project ID project yang dapat membagikan reservasi ini; misalnya, project-1 dan project-2. Anda dapat menyertakan hingga 100 project konsumen. Project ini harus berada dalam organisasi yang sama dengan project pemilik. Jangan sertakan ID project tempat Anda membuat reservasi ini karena project tersebut diizinkan untuk menggunakan reservasi ini secara default. Kecualikan kolom ini jika Anda ingin membuat reservasi satu project.

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

Mengganti pemesanan yang terikat komitmen

Ganti pemesanan terlampir komitmen Anda yang sudah ada dengan yang baru jika Anda ingin mengubah jenis dan jumlah VM yang menggunakan resource yang di-alokasikan.

Perubahan yang diizinkan

Saat mengganti pemesanan yang ada di komitmen dengan pemesanan baru, Anda dapat meminta salah satu perubahan berikut:

  • Anda dapat memesan VM dari jenis mesin lain. Namun, Anda tetap harus memesan VM dari seri mesin yang sama agar dapat terus menerima DA untuk resource yang dipesan.
  • Anda dapat mengubah jumlah VM yang ingin dipesan.
  • Anda dapat mengubah jumlah disk GPU dan SSD Lokal yang terpasang per VM selama jumlah total GPU yang dicadangkan dan disk SSD Lokal tetap sama.

  • Anda dapat menentukan reservasi yang telah diganti sebagai reservasi lokal atau bersama.

Persyaratan

Saat mengganti pemesanan yang terlampir di komitmen Anda dengan pemesanan baru, permintaan Anda harus memenuhi semua persyaratan berikut:

  • Anda hanya dapat mengganti satu pemesanan terlampir pada satu waktu dengan tepat satu pemesanan baru yang terlampir. Untuk mengganti pemesanan yang terlampir, hapus pemesanan terlampir yang ada secara bersamaan dengan menetapkan jumlah VM-nya ke 0 dan tentukan pemesanan terlampir baru yang menggantikannya.
  • Reservasi baru harus ada dalam project yang sama dengan komitmen.
  • Reservasi baru harus berada di zona yang sama dengan reservasi yang dihapus.
  • Jumlah dan jenis GPU yang ditentukan dalam reservasi baru harus cocok dengan reservasi yang dihapus.
  • Jumlah dan jenis disk SSD Lokal yang ditentukan dalam reservasi baru harus cocok dengan reservasi yang dihapus.
  • Anda hanya dapat mengubah maksimum 100 VM per permintaan. Untuk membuat perubahan yang melibatkan lebih dari 100 VM, bagi perubahan menjadi beberapa permintaan yang lebih kecil atau hubungi Dukungan Google Cloud.

Permintaan Anda untuk mengganti pemesanan juga bergantung pada ketersediaan kapasitas pada saat itu. Jika kapasitas untuk permintaan tidak tersedia, permintaan akan gagal dan menampilkan error ketersediaan resource, yang dapat Anda coba atasi dengan mengubah atau menunda permintaan. Untuk mengetahui informasi selengkapnya, lihat dokumentasi untuk memecahkan masalah ketersediaan resource.

Jika permintaan Anda untuk mengganti pemesanan yang terlampir gagal, pemesanan yang terlampir dan resource yang dipesan yang ada tetap tidak terpengaruh. Untuk mempertahankan kapasitas Anda, tunggu untuk membuat perubahan yang sesuai pada VM Anda hingga permintaan untuk mengganti pemesanan Anda berhasil.

Langkah-langkah untuk mengganti pemesanan yang terlampir

Anda dapat mengganti reservasi komitmen menggunakan Google Cloud CLI atau REST.

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:

Jenis aset Resource dalam komitmen
(my-commitment-with-reservations)		 Resource dalam pemesanan yang terlampir saat ini
(res-1)
vCPU dan memori 16 vCPU dan 60 GB 16 vCPU dan 60 GB
(4 VM n1-standard-4 yang dipesan)*
GPU 4 GPU P100 4 GPU P100
(1 GPU P100 per VM, untuk 4 VM)*
Disk SSD lokal 3.000 GB atau 8 disk SSD Lokal 3.000 GB atau 8 disk SSD Lokal
(750 GB atau 2 disk SSD Lokal per VM, untuk 4 VM)*

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

Jenis aset Resource dalam komitmen
(my-commitment-with-reservations)		 Resource dalam pemesanan yang terlampir saat ini
(res-1)		 Resource dalam pemesanan terlampir pengganti
(res-2)
vCPU dan memori 16 vCPU dan 60 GB 16 vCPU dan 60 GB
(4 VM n1-standard-4 yang dipesan)*		 16 vCPU dan 60 GB
(2 VM n1-standard-8 yang dipesan dan digunakan bersama)†
GPU 4 GPU P100 4 GPU P100
(1 GPU P100 per VM, untuk 4 VM)*		 4 GPU P100
(2 GPU P100 per VM, untuk 2 VM)†
Disk SSD lokal 3.000 GB atau 8 disk SSD Lokal 3.000 GB atau 8 disk SSD Lokal
(750 GB atau 2 disk SSD Lokal per VM, untuk 4 VM)*		 3.000 GB atau 8 disk SSD Lokal
(1.500 GB atau 4 disk SSD Lokal per VM, untuk 2 VM)*

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

Komitmen

  • COMMITMENT_NAME: nama komitmen dengan pemesanan terlampir.
  • PROJECT_ID: project ID untuk komitmen dengan pemesanan terlampir. Ini juga merupakan project ID untuk pemesanan saat ini dan terlampir.
  • COMMITMENT_ZONE: zona komitmen dengan pemesanan terlampir.

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 ditentukan oleh reservasi 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 localSsds untuk semua disk SSD Lokal yang dicadangkan.
  • CURRENT_RESERVATION_SHARE_SETTING: Jenis berbagi untuk pemesanan saat ini. Tentukan parameter 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 dalam pemesanan pengganti baru.

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

    • Untuk jenis mesin yang telah ditentukan, 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 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, 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 diinginkan untuk menggunakan disk SSD Lokal untuk setiap VM yang dicadangkan. Opsi yang valid adalah: scsi dan nvme. Setiap disk SSD Lokal berukuran 375 GB. Ulangi parameter localSsds untuk setiap disk SSD Lokal yang ingin Anda tambahkan. Anda dapat menentukan hingga 24 disk SSD Lokal.

  • REPLACEMENT_RESERVATION_SHARE_SETTING: Jenis berbagi untuk pemesanan pengganti. Tentukan parameter ini dengan nilai sebagai projects jika Anda ingin membagikan pemesanan penggantian 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 PROJECT_ID, yang sudah diizinkan untuk menggunakan reservasi ini secara default.

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:

Jenis aset Resource dalam komitmen
(my-commitment-with-reservations)		 Resource dalam pemesanan yang terlampir saat ini
(res-1)
vCPU dan memori 16 vCPU dan 60 GB 16 vCPU dan 60 GB
(4 VM n1-standard-4 yang dipesan)*
GPU 4 GPU P100 4 GPU P100
(1 GPU P100 per VM, untuk 4 VM)*
Disk SSD lokal 3.000 GB atau 8 disk SSD Lokal 3.000 GB atau 8 disk SSD Lokal
(750 GB atau 2 disk SSD Lokal per VM, untuk 4 VM)*

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

Jenis aset Resource dalam komitmen
(my-commitment-with-reservations)		 Resource dalam pemesanan yang terlampir saat ini
(res-1)		 Resource dalam pemesanan terlampir pengganti
(res-2)
vCPU dan memori 16 vCPU dan 60 GB 16 vCPU dan 60 GB
(4 VM n1-standard-4 yang dipesan)*		 16 vCPU dan 60 GB
(2 VM n1-standard-8 yang dipesan dan digunakan bersama)†
GPU 4 GPU P100 4 GPU P100
(1 GPU P100 per VM, untuk 4 VM)*		 4 GPU P100
(2 GPU P100 per VM, untuk 2 VM)†
Disk SSD lokal 3.000 GB atau 8 disk SSD Lokal 3.000 GB atau 8 disk SSD Lokal
(750 GB atau 2 disk SSD Lokal per VM, untuk 4 VM)*		 3.000 GB atau 8 disk SSD Lokal
(1.500 GB atau 4 disk SSD Lokal per VM, untuk 2 VM)*

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

Langkah selanjutnya