Membeli komitmen hardware dengan pemesanan terlampir

Compute Engine memberikan diskon abonemen (DA) berbasis resource untuk workload yang dapat diprediksi. Saat membeli komitmen untuk GPU atau sebagian besar disk SSD Lokal, Anda harus memesan resource tersebut dan melampirkan pemesanan ke komitmen Anda.

Dokumen ini menjelaskan cara membeli komitmen berbasis resource dengan pemesanan terlampir menggunakan konsol Google Cloud , gcloud CLI, atau REST.

Untuk mempelajari lebih lanjut cara kerja reservasi terlampir, lihat Melampirkan reservasi ke komitmen berbasis resource.

Untuk membeli komitmen untuk vCPU dan memori tanpa reservasi terlampir, lihat Membeli komitmen berbasis resource tanpa reservasi terlampir.

Sebelum memulai

  • Siapkan autentikasi jika Anda belum melakukannya. Autentikasi memverifikasi identitas Anda untuk mengakses layanan Google Cloud dan API. Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine dengan memilih salah satu opsi berikut:

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

    Konsol

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

    gcloud

    1. Instal Google Cloud CLI. Setelah penginstalan, inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:

      gcloud init

      Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

  • Tetapkan 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.

      Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

    Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna membeli komitmen dan membuat reservasi, minta administrator untuk memberi Anda peran IAM Compute Admin (roles/compute.admin) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk membeli komitmen dan membuat reservasi. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk membeli komitmen dan membuat reservasi:

  • compute.commitments.create
  • compute.reservations.create

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Secara default, pemilik project memiliki izin untuk membeli komitmen berbasis resource. Namun, pemilik dapat membuat peran khusus yang mencakup atau mengecualikan pengguna tertentu. Baca kontrol akses untuk memastikan bahwa Anda memiliki izin untuk membeli komitmen berbasis resource.

Membeli komitmen berbasis resource hardware dengan reservasi terlampir

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

Setelah Anda membeli komitmen, komitmen tersebut akan aktif pada hari berikutnya pukul 00.00 Waktu Pasifik AS dan Kanada (UTC-8, atau UTC-7 selama waktu musim panas). Compute Engine mempertahankan hak gadai pada project Anda untuk setiap region di project Anda tempat Anda membeli komitmen. Saat Anda membeli komitmen baru untuk region mana pun di project Anda, Compute Engine akan mengaitkan hak gadai untuk region tersebut dengan komitmen yang baru dibuat.

Antara waktu pembelian komitmen dan waktu aktivasinya, status komitmen Anda tetap NOT_YET_ACTIVE (atau PENDING di konsolGoogle Cloud ). Setelah aktivasi, status komitmen Anda akan berubah menjadi ACTIVE. Misalnya, Anda membeli komitmen pada 20 Januari 2024, pukul 22.00 Waktu Pasifik AS dan Kanada (UTC-8 atau UTC-7). Compute Engine akan langsung membuat komitmen Anda dengan statusnya sebagai NOT_YET_ACTIVE. Komitmen Anda akan ACTIVE pada 21 Januari 2024, pukul 00.00 Waktu Pasifik AS dan Kanada (UTC-8 atau UTC-7).

Persyaratan

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

  • Anda harus membeli komitmen dan membuat pemesanan terlampir di project dan region yang sama.
  • Anda harus membeli komitmen dan membuat pemesanan terlampir untuk resource dari seri kelompok mesin yang sama.
  • Jika komitmen Anda menentukan jenis resource yang memerlukan pemesanan terlampir, Anda harus menonaktifkan opsi hapus otomatis pada pemesanan terlampir. Pelajari lebih lanjut jenis resource yang memerlukan reservasi terlampir.
  • Jika komitmen Anda memiliki GPU, jenis GPU yang ditentukan dalam reservasi dan komitmen harus cocok.
  • Untuk GPU dan sebagian besar disk SSD Lokal, jumlah resource yang dipesan untuk setiap jenis resource harus sama persis dengan jumlah resource terpakai untuk jenis resource tersebut. Namun, persyaratan ini tidak berlaku jika Anda menentukan disk SSD Titanium lokal dalam komitmen untuk digunakan dengan jenis mesin C4, C4A, C4D, C4N, G4, H4D, atau Z3.

    Misalnya, jika Anda ingin membeli komitmen untuk 4 GPU V100 dan 2 disk SSD Lokal, pemesanan terlampir komitmen Anda harus menentukan total 4 GPU V100 dan 2 SSD Lokal. Jumlah vCPU dan memori yang Anda pesan dapat lebih banyak atau lebih sedikit daripada jumlah komitmen yang Anda beli. Namun, jika Anda menentukan 4 vCPU C4A dan 2 disk SSD Titanium lokal dalam komitmen, Anda tidak perlu melampirkan reservasi apa pun ke komitmen.

  • 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 pemesanan terlampir adalah pemesanan bersama dan Anda ingin menerima CUD yang berlaku saat menggunakan pemesanan tersebut di luar project komitmen, Anda harus melakukan kedua hal berikut:

    • Bagikan pemesanan Anda hanya ke project yang termasuk dalam akun Penagihan Cloud yang sama dengan komitmen.
    • Pastikan pembagian CUD diaktifkan untuk akun Penagihan Cloud tersebut.

Melampirkan reservasi yang ada

Anda dapat melampirkan pemesanan yang 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 DAS 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 Diskon abonemen

  2. Klik Purchase commitment. Halaman Purchase a commitment akan muncul.

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

  4. Di kolom Region, pilih region tempat Anda ingin membeli komitmen.

  5. Di kolom Commitment type, pilih seri kelompok mesin untuk komitmen Anda. Jenis komitmen berikut menyediakan opsi untuk GPU, disk SSD Lokal, atau keduanya:

    • Untuk jenis mesin A2, pilih A2 yang dioptimalkan akselerator
    • Untuk jenis mesin A3 Edge dan A3 High, pilih A3 yang dioptimalkan akselerator
    • Untuk jenis mesin A3 Mega, pilih A3 Mega yang dioptimalkan untuk akselerator
    • Untuk jenis mesin G2, pilih G2 yang dioptimalkan untuk grafis
    • Untuk jenis mesin G4, pilih G4 yang dioptimalkan untuk grafis
    • Untuk jenis mesin C2, pilih C2 yang dioptimalkan untuk komputasi
    • Untuk jenis mesin C2D, pilih C2D yang dioptimalkan untuk komputasi
    • Untuk jenis mesin C3, pilih General-Purpose C3
    • Untuk jenis mesin C3D, pilih General-Purpose C3D
    • Untuk jenis mesin C4, pilih General-Purpose C4
    • Untuk jenis mesin C4A, pilih General-Purpose C4A
    • Untuk jenis mesin C4D, pilih General-Purpose C4D
    • Untuk jenis mesin C4N, pilih Network-optimized C4N
    • Untuk jenis mesin N1, pilih N1 tujuan umum
    • Untuk jenis mesin N2, pilih N2 Tujuan Umum
    • Untuk jenis mesin N2D, pilih N2D Tujuan Umum
    • Untuk jenis mesin M1, pilih M1/M2 yang dioptimalkan untuk memori
    • Untuk jenis mesin M3, pilih M3 yang dioptimalkan untuk memori
    • Untuk jenis mesin Z3, pilih Z3 yang dioptimalkan untuk penyimpanan

  6. Untuk melampirkan satu atau beberapa reservasi yang ada ke komitmen, lakukan tindakan berikut:

    1. Pilih kotak centang Lampirkan reservasi baru atau yang sudah ada.

    2. Klik Lampirkan reservasi yang ada. Panel Lampirkan reservasi yang ada akan muncul dan menampilkan reservasi dari project Anda. Daftar ini difilter agar sesuai dengan region dan jenis komitmen yang Anda tentukan.

    3. Di panel Attach existing reservations, centang kotak untuk setiap reservasi yang ingin Anda lampirkan.

    4. Tinjau ringkasan resource untuk reservasi yang Anda pilih, lalu klik Lampirkan.

    Setelah Anda melampirkan reservasi, Compute Engine akan otomatis mengisi kolom di bagian Commitment details agar sesuai dengan jumlah dan jenis resource dari reservasi yang Anda lampirkan. Jika Anda memasukkan nilai secara manual untuk resource apa pun di bagian Detail komitmen sebelum melampirkan reservasi, nilai Anda akan digantikan dengan nilai dari reservasi.

  7. Di bagian Commitment details, lakukan hal berikut:

    1. Di kolom Cores, verifikasi nilai yang sudah diisi. Atau, Anda dapat menentukan jumlah vCPU yang berbeda.

    2. Di kolom Memory, verifikasi jumlah memori yang telah diisi otomatis dalam GB. Secara opsional, Anda dapat menentukan jumlah yang berbeda. Anda dapat menentukan memori hanya dengan kelipatan 0,25 GB. Untuk menentukan nilai memori kustom untuk komitmen, gunakan gcloud CLI atau REST.

    3. Luaskan bagian GPU dan SSD lokal, lalu pastikan jenis dan jumlahnya sama antara komitmen dan reservasi terlampir, sebagai berikut:

      1. Di kolom GPU type, verifikasi jenis GPU yang telah diisi sebelumnya.

      2. Di kolom Number of GPUs, verifikasi jumlah GPU yang telah diisi sebelumnya.

      3. Di kolom Local SSDs, verifikasi jumlah disk yang sudah diisi sebelumnya.

      Jika Anda secara manual menentukan nilai yang berbeda dari reservasi terlampir untuk salah satu kolom ini, pembelian komitmen Anda tidak akan berhasil. Untuk semua GPU dan sebagian besar disk SSD Lokal, jumlah dan jenis totalnya harus sama antara komitmen dan pemesanan terlampir Anda.

  8. Di bagian Term, lakukan tindakan berikut:

    1. Untuk menentukan paket untuk komitmen Anda, pilih 1 tahun atau 3 tahun. Paket menentukan tarif CUD dan durasi jangka waktu preset komitmen Anda.

    2. Tinjau kolom Tanggal mulai, yang menampilkan tanggal dan waktu saat komitmen Anda menjadi aktif. Kolom ini otomatis disetel ke pukul 00.00 Waktu Pasifik AS dan Kanada pada hari setelah tanggal saat ini.

    3. Opsional. Untuk memperpanjang masa berlaku komitmen di luar durasi masa berlaku preset yang ditentukan oleh paket komitmen, di kolom Tanggal berakhir, tentukan tanggal berakhir kustom untuk komitmen Anda. Untuk mengetahui informasi selengkapnya, lihat Memperpanjang jangka waktu komitmen.

    4. Opsional. Jika Anda ingin komitmen diperpanjang secara otomatis di akhir jangka waktunya, centang kotak Perpanjang komitmen secara otomatis.

  9. Di panel Ringkasan, tinjau detail komitmen dan potensi batasan kuota.

  10. Untuk menyelesaikan pembelian komitmen, lakukan langkah-langkah berikut:

    1. Buka bagian bawah halaman.

    2. Tinjau bagian Pengungkapan yang berisi informasi tentang biaya, kelayakan diskon, serta persyaratan dan ketentuan.

    3. Untuk mengonfirmasi penerimaan Anda atas harga komitmen dan persyaratan khusus layanan, centang kotak.

    4. Klik Purchase.

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 flag 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=PLAN \
    --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.
  • PLAN: paket komitmen, yang menentukan tarif CUD dan durasi jangka waktu preset Anda. Tentukan 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:

    • Untuk jenis mesin A2, gunakan accelerator-optimized
    • Untuk jenis mesin A3 Edge dan A3 High, gunakan accelerator-optimized-a3
    • Untuk jenis mesin A3 Mega, gunakan accelerator-optimized-a3-mega
    • Untuk jenis mesin G2, gunakan graphics-optimized
    • Untuk jenis mesin G4, gunakan graphics-optimized-g4
    • Untuk jenis mesin C2, gunakan compute-optimized
    • Untuk jenis mesin C2D, gunakan compute-optimized-c2d
    • Untuk jenis mesin C3, gunakan compute-optimized-c3
    • Untuk jenis mesin C3D, gunakan compute-optimized-c3d
    • Untuk jenis mesin N1, gunakan general-purpose
    • Untuk jenis mesin C4, gunakan general-purpose-c4
    • Untuk jenis mesin C4A, gunakan general-purpose-c4a
    • Untuk jenis mesin C4D, gunakan general-purpose-c4d
    • Untuk jenis mesin C4N, gunakan network-optimized-c4n
    • Untuk jenis mesin N2, gunakan general-purpose-n2
    • Untuk jenis mesin N2D, gunakan general-purpose-n2d
    • Untuk jenis mesin M1, gunakan memory-optimized
    • Untuk jenis mesin M3, gunakan memory-optimized-m3
    • Untuk jenis mesin Z3, gunakan storage-optimized-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 Anda. Contohnya, 10240MB atau 10GB. Untuk gcloud CLI, Anda dapat menentukan memori dalam MB atau GB. Jika Anda tidak menentukan unit, Compute Engine akan menggunakan GB sebagai unit default. Namun, perhatikan bahwa saat Anda menggunakan REST, Compute Engine menggunakan MB sebagai unit default.

  • COMMITTED_LOCAL_SSD: jumlah ruang SSD Lokal dalam GB yang Anda inginkan dalam komitmen Anda.

  • 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

Misalkan Anda memiliki dua reservasi res-01 dan res-02 di zona us-central1-a dan us-central1-b 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 GPU dan disk SSD Lokal ini, dan menggunakan reservasi yang ada ini sebagai reservasi terlampir, jalankan perintah berikut. Komitmen ini menentukan 96 vCPU, 624 GB memori, 4 GPU NVIDIA P100, dan 1.500 GB penyimpanan SSD Lokal (setara dengan 4 disk SSD Lokal). Nilai penyimpanan SSD Lokal harus ditentukan dalam GB (misalnya, 375GB). Untuk gcloud CLI, Anda dapat menentukan memori dalam MB atau GB. Jika Anda tidak menentukan unit, Compute Engine akan menggunakan GB sebagai unit default. Namun, perhatikan bahwa saat Anda menggunakan REST, Compute Engine menggunakan MB sebagai unit default.

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": "PLAN",
  "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.
  • PLAN: paket komitmen, yang menentukan tarif CUD dan durasi jangka waktu preset Anda. Tentukan TWELVE_MONTH atau THIRTY_SIX_MONTH.
  • COMMITMENT_TYPE: jenis komitmen. Jenis komitmen berikut menyediakan opsi untuk GPU, disk SSD Lokal, atau keduanya:

    • Untuk jenis mesin A2, gunakan ACCELERATOR_OPTIMIZED
    • Untuk jenis mesin A3 Edge dan A3 High, gunakan ACCELERATOR_OPTIMIZED_A3
    • Untuk jenis mesin A3 Mega, gunakan ACCELERATOR_OPTIMIZED_A3_MEGA
    • Untuk jenis mesin G2, gunakan GRAPHICS_OPTIMIZED
    • Untuk jenis mesin G4, gunakan GRAPHICS_OPTIMIZED_G4
    • Untuk jenis mesin C2, gunakan COMPUTE_OPTIMIZED
    • Untuk jenis mesin C2D, gunakan COMPUTE_OPTIMIZED_C2D
    • Untuk jenis mesin C3, gunakan COMPUTE_OPTIMIZED_C3
    • Untuk jenis mesin C3D, gunakan COMPUTE_OPTIMIZED_C3D
    • Untuk jenis mesin N1, gunakan GENERAL_PURPOSE
    • Untuk jenis mesin C4, gunakan GENERAL_PURPOSE_C4
    • Untuk jenis mesin C4A, gunakan GENERAL_PURPOSE_C4A
    • Untuk jenis mesin C4D, gunakan GENERAL_PURPOSE_C4D
    • Untuk jenis mesin C4N, gunakan NETWORK_OPTIMIZED_C4N
    • Untuk jenis mesin N2, gunakan GENERAL_PURPOSE_N2
    • Untuk jenis mesin N2D, gunakan GENERAL_PURPOSE_N2D
    • Untuk jenis mesin M1, gunakan MEMORY_OPTIMIZED
    • Untuk jenis mesin M3, gunakan MEMORY_OPTIMIZED_M3
    • Untuk jenis mesin Z3, gunakan STORAGE_OPTIMIZED_Z3

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

  • COMMITTED_MEMORY: jumlah memori yang Anda inginkan dalam komitmen Anda. Untuk REST, Compute Engine menggunakan MB sebagai unit default. Namun, perhatikan bahwa saat Anda menggunakan gcloud CLI, Compute Engine menggunakan GB sebagai unit default.

  • COMMITTED_LOCAL_SSD: jumlah penyimpanan SSD Lokal dalam GB yang Anda inginkan dalam komitmen.

  • 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. 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 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 reservasi res-01 dan res-02 di zona us-central1-a dan us-central1-b 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 GPU dan disk SSD Lokal ini, serta menggunakan reservasi yang ada ini sebagai reservasi terlampir, buat permintaan POST berikut. Komitmen ini menentukan 96 vCPU, 624 GB memori, 4 GPU NVIDIA P100, dan 1.500 GB penyimpanan SSD Lokal. Perhatikan bahwa nilai penyimpanan SSD Lokal harus ditentukan dalam GB. Untuk memori, Anda harus menentukan nilai dalam MB. Namun, perhatikan bahwa saat Anda menggunakan gcloud CLI, Compute Engine menggunakan GB sebagai unit default untuk 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": "1500",
      "type": "LOCAL_SSD"
    }
  ],
  "existingReservations":
  [
    "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/res-01",
    "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-b/reservations/res-02"
  ]
}

Membuat reservasi baru untuk dilampirkan

Anda dapat membuat pemesanan 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 DAS 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 Diskon abonemen

  2. Klik Purchase commitment. Halaman Purchase a commitment akan muncul.

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

  4. Di kolom Region, pilih region tempat Anda ingin membeli komitmen.

  5. Di kolom Commitment type, pilih seri kelompok mesin untuk komitmen Anda. Jenis komitmen berikut menyediakan opsi untuk GPU, disk SSD Lokal, atau keduanya:

    • Untuk jenis mesin A2, pilih A2 yang dioptimalkan akselerator
    • Untuk jenis mesin A3 Edge dan A3 High, pilih A3 yang dioptimalkan akselerator
    • Untuk jenis mesin A3 Mega, pilih A3 Mega yang dioptimalkan untuk akselerator
    • Untuk jenis mesin G2, pilih G2 yang dioptimalkan untuk grafis
    • Untuk jenis mesin G4, pilih G4 yang dioptimalkan untuk grafis
    • Untuk jenis mesin C2, pilih C2 yang dioptimalkan untuk komputasi
    • Untuk jenis mesin C2D, pilih C2D yang dioptimalkan untuk komputasi
    • Untuk jenis mesin C3, pilih General-Purpose C3
    • Untuk jenis mesin C3D, pilih General-Purpose C3D
    • Untuk jenis mesin C4, pilih General-Purpose C4
    • Untuk jenis mesin C4A, pilih General-Purpose C4A
    • Untuk jenis mesin C4D, pilih General-Purpose C4D
    • Untuk jenis mesin C4N, pilih Network-optimized C4N
    • Untuk jenis mesin N1, pilih N1 tujuan umum
    • Untuk jenis mesin N2, pilih N2 Tujuan Umum
    • Untuk jenis mesin N2D, pilih N2D Tujuan Umum
    • Untuk jenis mesin M1, pilih M1/M2 yang dioptimalkan untuk memori
    • Untuk jenis mesin M3, pilih M3 yang dioptimalkan untuk memori
    • Untuk jenis mesin Z3, pilih Z3 yang dioptimalkan untuk penyimpanan

  6. Untuk membuat reservasi baru dan melampirkannya ke komitmen, lakukan tindakan berikut:

    1. Pilih kotak centang Lampirkan reservasi baru atau yang sudah ada.

    2. Klik Buat reservasi baru. Panel Buat reservasi baru akan muncul.

    3. Di kolom Nama, masukkan nama untuk reservasi.

    4. Opsional: Di kolom Description, masukkan deskripsi.

    5. Di kolom Zone, pilih zona tempat Anda ingin resource yang dipesan tersedia.

    6. Di bagian Share type, tentukan cara Anda ingin membagikan reservasi ini:

      • Untuk membuat reservasi satu project, pilih Lokal.
      • Untuk membuat reservasi yang dibagikan dengan beberapa project, pilih Dibagikan. Kemudian, klik Tambahkan project dan pilih project yang Anda inginkan.
    7. Di bagian Google Cloud Services, tentukan apakah akan membagikan reservasi ini dengan layanan lain seperti Google Kubernetes Engine atau Vertex AI.

    8. Di bagian Gunakan dengan instance VM, pilih cara yang Anda inginkan agar VM menggunakan reservasi Anda:

      • Untuk mengizinkan VM dengan properti yang cocok otomatis menggunakan reservasi ini, pilih Gunakan reservasi secara otomatis.
      • Untuk menggunakan resource dari pemesanan ini hanya saat secara khusus ditargetkan berdasarkan nama, pilih Select specific reservation.
    9. Di bagian Detail resource, lakukan hal berikut:

      1. Di kolom Number of VM instances, masukkan jumlah VM.

      2. Di bagian Konfigurasi mesin, tentukan properti dengan memilih Jenis mesin. Pilih jenis mesin dari daftar, atau pilih Kustom untuk menentukan jumlah Inti dan jumlah Memori.

      3. Opsional: Jika Anda ingin mencadangkan GPU, klik Tambahkan GPU, lalu tentukan Jenis GPU dan Jumlah GPU untuk setiap VM.

      4. Opsional: Jika Anda ingin memesan disk SSD Lokal, tentukan Jumlah disk dan Jenis antarmuka.

      5. Opsional: Jika Anda ingin menentukan kebijakan penempatan grup, maka dalam daftar Kebijakan penempatan grup, pilih atau buat kebijakan.

    10. Untuk menyelesaikan penentuan properti pemesanan ini, klik Buat dan lampirkan.

    11. Opsional: Jika Anda ingin membuat dan melampirkan lebih banyak reservasi baru, klik Buat reservasi baru lagi dan ulangi langkah-langkah ini.

    Setelah Anda melampirkan reservasi, Compute Engine akan otomatis mengisi kolom di bagian Commitment details agar sesuai dengan jumlah dan jenis resource dari reservasi yang Anda lampirkan. Jika Anda memasukkan nilai secara manual untuk resource apa pun di bagian Detail komitmen sebelum melampirkan reservasi, nilai Anda akan digantikan dengan nilai dari reservasi.

  7. Di bagian Commitment details, lakukan hal berikut:

    1. Di kolom Cores, verifikasi nilai yang sudah diisi. Atau, Anda dapat menentukan jumlah vCPU yang berbeda.

    2. Di kolom Memory, verifikasi jumlah memori yang telah diisi otomatis dalam GB. Secara opsional, Anda dapat menentukan jumlah yang berbeda. Anda dapat menentukan memori hanya dengan kelipatan 0,25 GB. Untuk menentukan nilai memori kustom untuk komitmen, gunakan gcloud CLI atau REST.

    3. Luaskan bagian GPU dan SSD lokal, lalu pastikan jenis dan jumlahnya sama antara komitmen dan reservasi terlampir, sebagai berikut:

      1. Di kolom GPU type, verifikasi jenis GPU yang telah diisi sebelumnya.

      2. Di kolom Number of GPUs, verifikasi jumlah GPU yang telah diisi sebelumnya.

      3. Di kolom Local SSDs, verifikasi jumlah disk yang sudah diisi sebelumnya.

      Jika Anda secara manual menentukan nilai yang berbeda dari reservasi terlampir untuk salah satu kolom ini, pembelian komitmen Anda tidak akan berhasil. Untuk semua GPU dan sebagian besar disk SSD Lokal, jumlah dan jenis totalnya harus sama antara komitmen dan pemesanan terlampir Anda.

  8. Di bagian Term, lakukan tindakan berikut:

    1. Untuk menentukan paket untuk komitmen Anda, pilih 1 tahun atau 3 tahun. Paket menentukan tarif CUD dan durasi jangka waktu preset komitmen Anda.

    2. Tinjau kolom Tanggal mulai, yang menampilkan tanggal dan waktu saat komitmen Anda menjadi aktif. Kolom ini otomatis disetel ke pukul 00.00 Waktu Pasifik AS dan Kanada pada hari setelah tanggal saat ini.

    3. Opsional. Untuk memperpanjang masa berlaku komitmen di luar durasi masa berlaku preset yang ditentukan oleh paket komitmen, di kolom Tanggal berakhir, tentukan tanggal berakhir kustom untuk komitmen Anda. Untuk mengetahui informasi selengkapnya, lihat Memperpanjang jangka waktu komitmen.

    4. Opsional. Jika Anda ingin komitmen diperpanjang secara otomatis di akhir jangka waktunya, centang kotak Perpanjang komitmen secara otomatis.

  9. Di panel Ringkasan, tinjau detail komitmen dan potensi batasan kuota.

  10. Untuk menyelesaikan pembelian komitmen, lakukan langkah-langkah berikut:

    1. Buka bagian bawah halaman.

    2. Tinjau bagian Pengungkapan yang berisi informasi tentang biaya, kelayakan diskon, serta persyaratan dan ketentuan.

    3. Untuk mengonfirmasi penerimaan Anda atas harga komitmen dan persyaratan khusus layanan, centang kotak.

    4. Klik Purchase.

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 terlampir dengan menjalankan perintah berikut:

    gcloud compute commitments create COMMITMENT_NAME \
        --region=REGION \
        --project=PROJECT_ID \
        --plan PLAN \
        --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 dengan 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 PLAN \
          --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:

Komitmen

  • COMMITMENT_NAME: nama komitmen.
  • REGION: region tempat komitmen berada.
  • PROJECT_ID: ID project tempat Anda ingin membeli komitmen dengan pemesanan terlampir.
  • PLAN: paket komitmen, yang menentukan tarif CUD dan durasi jangka waktu preset Anda. Tentukan 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:

    • Untuk jenis mesin A2, gunakan accelerator-optimized
    • Untuk jenis mesin A3 Edge dan A3 High, gunakan accelerator-optimized-a3
    • Untuk jenis mesin A3 Mega, gunakan accelerator-optimized-a3-mega
    • Untuk jenis mesin G2, gunakan graphics-optimized
    • Untuk jenis mesin G4, gunakan graphics-optimized-g4
    • Untuk jenis mesin C2, gunakan compute-optimized
    • Untuk jenis mesin C2D, gunakan compute-optimized-c2d
    • Untuk jenis mesin C3, gunakan compute-optimized-c3
    • Untuk jenis mesin C3D, gunakan compute-optimized-c3d
    • Untuk jenis mesin N1, gunakan general-purpose
    • Untuk jenis mesin C4, gunakan general-purpose-c4
    • Untuk jenis mesin C4A, gunakan general-purpose-c4a
    • Untuk jenis mesin C4D, gunakan general-purpose-c4d
    • Untuk jenis mesin C4N, gunakan network-optimized-c4n
    • Untuk jenis mesin N2, gunakan general-purpose-n2
    • Untuk jenis mesin N2D, gunakan general-purpose-n2d
    • Untuk jenis mesin M1, gunakan memory-optimized
    • Untuk jenis mesin M3, gunakan memory-optimized-m3
    • Untuk jenis mesin Z3, gunakan storage-optimized-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 Anda. Contohnya, 10GB atau 10240MB. Untuk gcloud CLI, Anda dapat menentukan memori dalam MB atau GB. Jika Anda tidak menentukan satuan, Compute Engine akan menggunakan GB sebagai satuan default. Namun, perhatikan bahwa saat Anda menggunakan REST, Compute Engine menggunakan MB sebagai unit default.

  • COMMITTED_LOCAL_SSD: jumlah penyimpanan SSD Lokal, yang harus ditentukan dalam GB; misalnya, 375GB.

  • COMMITTED_ACCELERATOR_COUNT: jumlah GPU yang Anda inginkan dalam komitmen.

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

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

Reservasi yang dilampirkan

  • RESERVATION_NAME: nama pemesanan terlampir.
  • RESERVATION_ZONE: zona pemesanan terlampir.
  • REQUIRE_SPECIFIC_RESERVATION_VALUE: menentukan apakah pemesanan terlampir adalah pemesanan yang ditargetkan secara khusus; true atau false. Untuk mengetahui informasi selengkapnya tentang pemesanan yang ditargetkan secara khusus, lihat Cara kerja pemesanan.
  • NUMBER_OF_RESERVED_VMS: jumlah VM yang ingin Anda pesan dalam pemesanan terlampir.
  • RESERVED_MACHINE_TYPE: jenis mesin yang diinginkan untuk VM dalam pemesanan terlampir 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 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.
  • RESERVED_ACCELERATOR_COUNT: jumlah GPU yang ingin Anda tambahkan, per VM, dalam pemesanan terlampir.

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

  • INTERFACE_1 dan INTERFACE_2: jenis antarmuka yang Anda inginkan untuk digunakan disk SSD Lokal untuk setiap VM yang dipesan. Opsi yang valid adalah: scsi dan nvme. Ulangi parameter local_ssd untuk setiap disk SSD Lokal yang ingin Anda tambahkan. Anda dapat menentukan hingga 24 disk SSD Lokal.

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

  • MINIMUM_CPU_PLATFORM: platform CPU minimum yang ingin Anda tetapkan untuk pemesanan terlampir.

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

  • CONSUMER_PROJECT_ID_1 dan CONSUMER_PROJECT_ID_2: project ID dari project yang dapat membagikan pemesanan 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 pemesanan ini, karena project tersebut diizinkan untuk menggunakan pemesanan ini secara default. Kecualikan kolom ini jika Anda ingin membuat pemesanan satu project.

Compute Engine akan 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

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 reservasi baru

Misalkan Anda ingin membeli komitmen 1 tahun untuk resource tujuan umum (atau resource GPU) di region us-central1 dengan 96 vCPU, memori 624 GB, dan 4 GPU NVIDIA V100. Anda ingin membuat reservasi reservation-01 baru di zona us-central1-a yang memesan 2 VM n1-standard-32 (setiap VM dengan 32 vCPU, memori 120 GB, dan 2 GPU NVIDIA V100) untuk menggunakan resource yang di-commit ini. Untuk membeli contoh komitmen ini dengan pemesanan terlampirnya, jalankan perintah berikut. Untuk gcloud CLI, Anda dapat menentukan memori dalam MB atau GB. Jika Anda tidak menentukan satuan, Compute Engine akan menggunakan GB sebagai satuan default. Namun, perhatikan bahwa saat Anda menggunakan REST, Compute Engine menggunakan MB sebagai unit default.

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 menentukan 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 1 tahun untuk resource GPU di region us-west2 dengan 0 vCPU, memori 0 GB, dan 1 GPU NVIDIA P4. Anda juga ingin membuat reservasi baru reservation-01 di zona us-west2-b yang mencadangkan 1 VM n1-standard-2 (dengan 2 vCPU, memori 7,5 GB, dan 1 GPU NVIDIA P4) untuk dilampirkan ke komitmen. Untuk membeli contoh komitmen ini dengan pemesanan terlampirnya, jalankan perintah berikut. Untuk gcloud CLI, Anda dapat menentukan memori dalam MB atau GB. Jika Anda tidak menentukan unit, Compute Engine akan menggunakan GB sebagai unit default. Namun, perhatikan bahwa saat Anda menggunakan REST, Compute Engine menggunakan MB sebagai unit default.

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

Misalkan Anda ingin membeli komitmen 1 tahun untuk resource serbaguna (atau resource GPU dan SSD Lokal) di region us-central1. Anda menginginkan komitmen untuk 96 vCPU, memori 624 GB, 1 GPU NVIDIA V100, dan penyimpanan SSD Lokal 750 GB (sesuai dengan 2 disk SSD Lokal). 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 2 vCPU, memori 7,5 GB, dan 1 GPU NVIDIA V100); ini adalah pemesanan tertarget. Pada pemesanan kedua, res-02, Anda ingin memesan 1 VM n1-standard-8 (dengan 8 vCPU, memori 30 GB) dan melampirkan 2 disk SSD Lokal (satu antarmuka SCSI, satu antarmuka NVMe).

Untuk membeli contoh komitmen ini dengan pemesanan terlampir, pertama-tama buat file YAML dengan properti kedua pemesanan sebagai berikut:

- 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 reservasi terlampirnya, jalankan perintah berikut. Nilai penyimpanan SSD Lokal harus ditentukan dalam GB (misalnya, 375GB). Untuk gcloud CLI, Anda dapat menentukan memori dalam MB atau GB. Jika Anda tidak menentukan unit, Compute Engine akan menggunakan GB sebagai unit default. Namun, perhatikan bahwa saat Anda menggunakan REST, Compute Engine menggunakan MB sebagai unit default untuk 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": "PLAN",
    "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": "PLAN",
    "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:

Komitmen

  • COMMITMENT_NAME: nama komitmen.
  • REGION: region tempat komitmen berada.
  • PROJECT_ID: ID project tempat Anda ingin membeli komitmen dengan pemesanan terlampir.
  • PLAN: paket komitmen, yang menentukan tarif CUD dan durasi jangka waktu preset Anda. Tentukan TWELVE_MONTH atau THIRTY_SIX_MONTH.
  • COMMITMENT_TYPE: jenis komitmen. Jenis komitmen berikut menyediakan opsi untuk GPU, disk SSD Lokal, atau keduanya:

    • Untuk jenis mesin A2, gunakan ACCELERATOR_OPTIMIZED
    • Untuk jenis mesin A3 Edge dan A3 High, gunakan ACCELERATOR_OPTIMIZED_A3
    • Untuk jenis mesin A3 Mega, gunakan ACCELERATOR_OPTIMIZED_A3_MEGA
    • Untuk jenis mesin G2, gunakan GRAPHICS_OPTIMIZED
    • Untuk jenis mesin G4, gunakan GRAPHICS_OPTIMIZED_G4
    • Untuk jenis mesin C2, gunakan COMPUTE_OPTIMIZED
    • Untuk jenis mesin C2D, gunakan COMPUTE_OPTIMIZED_C2D
    • Untuk jenis mesin C3, gunakan COMPUTE_OPTIMIZED_C3
    • Untuk jenis mesin C3D, gunakan COMPUTE_OPTIMIZED_C3D
    • Untuk jenis mesin N1, gunakan GENERAL_PURPOSE
    • Untuk jenis mesin C4, gunakan GENERAL_PURPOSE_C4
    • Untuk jenis mesin C4A, gunakan GENERAL_PURPOSE_C4A
    • Untuk jenis mesin C4D, gunakan GENERAL_PURPOSE_C4D
    • Untuk jenis mesin C4N, gunakan NETWORK_OPTIMIZED_C4N
    • Untuk jenis mesin N2, gunakan GENERAL_PURPOSE_N2
    • Untuk jenis mesin N2D, gunakan GENERAL_PURPOSE_N2D
    • Untuk jenis mesin M1, gunakan MEMORY_OPTIMIZED
    • Untuk jenis mesin M3, gunakan MEMORY_OPTIMIZED_M3
    • Untuk jenis mesin Z3, gunakan STORAGE_OPTIMIZED_Z3

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

  • COMMITTED_MEMORY: jumlah memori yang Anda inginkan dalam komitmen Anda. Untuk REST, Compute Engine menggunakan MB sebagai unit default. Namun, perhatikan bahwa saat Anda menggunakan gcloud CLI, Compute Engine menggunakan GB sebagai unit default.

  • COMMITTED_LOCAL_SSD: jumlah penyimpanan SSD Lokal dalam GB yang Anda inginkan dalam komitmen.

  • 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 berakhir 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. Tentukan salah satu nilai berikut:

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

Reservasi yang dilampirkan

  • RESERVATION_NAME: nama pemesanan terlampir.
  • RESERVATION_ZONE: zona pemesanan terlampir.
  • REQUIRE_SPECIFIC_RESERVATION_VALUE: menentukan apakah pemesanan terlampir adalah pemesanan yang ditargetkan secara khusus; true atau false. Untuk mengetahui informasi selengkapnya tentang pemesanan yang ditargetkan secara khusus, lihat Cara kerja pemesanan.
  • NUMBER_OF_RESERVED_VMS: jumlah VM yang ingin Anda pesan dalam pemesanan terlampir.
  • RESERVED_MACHINE_TYPE: jenis mesin yang diinginkan untuk VM dalam pemesanan terlampir 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 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.
  • RESERVED_ACCELERATOR_COUNT: jumlah GPU yang ingin Anda tambahkan, per VM, dalam pemesanan terlampir.

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

  • INTERFACE_1 dan INTERFACE_2: jenis antarmuka yang Anda inginkan untuk disk SSD Lokal untuk digunakan setiap VM yang dipesan. Opsi yang valid adalah: scsi dan nvme. Ulangi parameter localSsds untuk setiap disk SSD Lokal yang ingin Anda tambahkan. Anda dapat menentukan hingga 24 disk SSD Lokal.

  • MINIMUM_CPU_PLATFORM: platform CPU minimum yang ingin Anda tetapkan untuk pemesanan terlampir.

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

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

  • CONSUMER_PROJECT_ID_1 dan CONSUMER_PROJECT_ID_2: project ID dari project yang dapat membagikan pemesanan 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 pemesanan ini, karena project tersebut diizinkan untuk menggunakan pemesanan ini secara default. Kecualikan kolom ini jika Anda ingin membuat pemesanan satu project.

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

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 reservasi baru

Misalkan Anda ingin membeli komitmen 1 tahun untuk resource tujuan umum di region us-central1 yang mencakup 96 vCPU, 624 GB memori (setara dengan 638976 MB), dan 4 GPU NVIDIA V100. Anda ingin membuat reservasi baru reservation-01 di zona us-central1-a yang memesan 2 VM n1-standard-8 (setiap VM dengan 8 vCPU, memori 30 GB, dan 2 GPU NVIDIA V100) untuk dilampirkan ke komitmen tersebut. Untuk membeli contoh komitmen ini dengan pemesanan yang terlampir, buat permintaan POST berikut. Untuk REST, Anda harus menentukan memori dalam MB. Namun, perhatikan bahwa saat Anda menggunakan gcloud CLI, Compute Engine menggunakan GB sebagai unit default.

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 menentukan 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, anggaplah Anda ingin membeli komitmen 1 tahun hanya untuk resource GPU di region us-west2, dengan 0 vCPU, memori 0 MB, dan 4 GPU NVIDIA P4. Anda juga ingin membuat reservasi baru reservation-01 di zona us-west2-b yang memesan 1 VM n1-standard-2 (dengan 2 vCPU, memori 7,5 GB, dan 4 GPU NVIDIA P4) untuk dilampirkan ke komitmen. Untuk membeli contoh komitmen ini dengan pemesanan terlampirnya, buat permintaan POST berikut. Untuk REST, Anda harus menentukan memori dalam MB. Namun, perhatikan bahwa saat Anda menggunakan gcloud CLI, Compute Engine menggunakan GB sebagai unit default.

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

Misalkan Anda ingin membeli komitmen 1 tahun untuk resource tujuan umum di region us-central1, dengan 96 vCPU, memori 624 GB (setara dengan 638976 MB), 1 GPU NVIDIA V100, dan penyimpanan SSD Lokal 750 GB. 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 2 vCPU, memori 7,5 GB, dan 1 GPU NVIDIA V100); ini adalah pemesanan tertarget. Dalam pemesanan kedua, res-02, Anda ingin memesan 1 VM n1-standard-8 (dengan 8 vCPU, memori 30 GB) dan melampirkan 2 disk SSD Lokal (satu antarmuka SCSI, satu antarmuka NVMe). Untuk membeli contoh komitmen ini dengan reservasi terlampir, buat permintaan POST berikut. Perhatikan bahwa nilai penyimpanan SSD Lokal harus ditentukan dalam GB. Untuk memori, Anda harus menentukan nilai dalam MB. Namun, perhatikan bahwa saat Anda menggunakan gcloud CLI, Compute Engine menggunakan GB sebagai unit default untuk 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": "750",
      "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"
    }
  ]
}