Menggabungkan pemesanan dengan diskon abonemen

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

Dokumen ini menjelaskan cara Anda dapat menerima DA untuk resource yang Anda pesan dan cara menambahkan pemesanan ke komitmen berbasis resource.

Sebelum memulai

  • Tinjau dasar-dasar pemesanan beserta persyaratan dan pembatasannya. Untuk mengetahui informasi selengkapnya, lihat Tentang reservasi.
  • 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 .

DA untuk resource yang Anda pesan

Anda menerima DAS dari komitmen aktif untuk setiap penggunaan resource yang memenuhi syarat dalam project Anda. Jika Anda juga memiliki pemesanan untuk menahan kapasitas resource dalam project tersebut, DA dari komitmen aktif juga dapat berlaku untuk resource yang dipesan tersebut. Agar resource yang dipesan memenuhi syarat untuk menerima DA, persyaratan berikut berlaku:

  • Anda tidak menerima bentuk diskon lain untuk penggunaan resource.
  • VM Anda harus menggunakan pemesanan saat komitmen aktif.

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

    • Project dan region tempat kebijakan berlaku
    • Seri kelompok mesin

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

  • vCPU dan memori: Untuk menerima DA untuk salah satu atau kedua jenis resource ini, Anda dapat membeli komitmen berbasis resource atau berbasis pembelanjaan yang mencakup jenis resource yang diperlukan. Saat VM di project Anda menggunakan pemesanan yang cocok dengan properti komitmen aktif tersebut, Compute Engine akan otomatis menerapkan diskon pada penggunaan yang memenuhi syarat.

    Khusus untuk komitmen berbasis resource, Anda dapat mengaktifkan pembagian CUD. Dengan melakukannya, Anda dapat berbagi DAS dari suatu project untuk mencakup penggunaan di project lain yang ditautkan ke akun Penagihan Cloud komitmen tersebut.

    Jika Anda memesan lebih banyak resource daripada yang Anda komitmen untuk dibeli, Anda tidak akan menerima DA untuk resource tambahan tersebut.

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

    • Membeli komitmen berbasis resource yang mencakup jenis resource yang diperlukan.
    • Buat reservasi untuk semua resource terpakai dengan properti yang cocok dengan komitmen Anda, dan lampirkan reservasi tersebut ke komitmen.

    Saat VM di project Anda menggunakan reservasi terlampir ini, Anda mulai menerima DA yang berlaku untuk jenis resource yang dicadangkan ini. Jika Anda mengaktifkan berbagi CUD dan melampirkan reservasi bersama, penggunaan dari project konsumen lain juga dapat memenuhi syarat untuk CUD berbasis resource bersama. Namun, agar penggunaan dari project lain memenuhi syarat, Anda harus membatasi berbagi pemesanan hanya dalam akun Penagihan Cloud komitmen. Jika project di luar akun Penagihan Cloud menggunakan pemesanan bersama tersebut, penggunaan tersebut tidak akan memenuhi syarat untuk CUD bersama akun Penagihan Cloud ini dan mungkin ditagihkan dengan tarif sesuai permintaan.

Melampirkan reservasi ke komitmen berbasis resource

Anda dapat melampirkan pemesanan ke komitmen berbasis resource apa pun dan memastikan bahwa kapasitas ditahan di zona tertentu untuk resource komitmen yang akan Anda gunakan. Anda dapat melampirkan beberapa pemesanan ke satu komitmen; namun, pemesanan hanya dapat dilampirkan ke satu komitmen. Saat membeli komitmen, Anda dapat melampirkan pemesanan ke komitmen tersebut dengan salah satu cara berikut:

  • Menggunakan pemesanan yang ada yang cocok dengan properti komitmen
  • Membuat reservasi yang cocok saat membeli komitmen

Jenis resource yang tidak memerlukan pemesanan terlampir

Untuk vCPU, memori, dan disk SSD titanium lokal yang digunakan dengan beberapa seri mesin, Anda tidak perlu melampirkan reservasi yang cocok ke komitmen Anda. Khusus untuk disk titanium lokal, Anda tidak memerlukan pemesanan terlampir saat membeli jenis komitmen yang berlaku untuk seri mesin berikut:

  • H4D yang dioptimalkan untuk komputasi
  • C4 tujuan umum
  • C4A tujuan umum
  • C4D tujuan umum
  • Z3 yang dioptimalkan untuk penyimpanan

Jika ingin membeli komitmen yang mencakup jenis resource ini, Anda dapat membeli komitmen tersebut tanpa melampirkan reservasi untuk resource tersebut. Jika ingin melampirkan reservasi untuk vCPU, memori, atau disk SSD titanium lokal ini, Anda dapat memilih untuk melampirkan reservasi tersebut.

Pemesanan terlampir Anda untuk resource ini tidak harus cocok dengan jenis dan jumlah resource yang ditentukan oleh komitmen. Secara khusus, hal berikut terjadi saat Anda menentukan jumlah resource yang lebih banyak atau lebih sedikit daripada komitmen Anda:

  • Jika komitmen Anda menentukan lebih banyak jenis resource ini daripada reservasi yang terlampir, Compute Engine hanya mencadangkan kapasitas untuk resource yang ditentukan oleh komitmen. Namun, Anda masih dapat menggunakan sisa resource yang di-commit, bergantung pada ketersediaannya di wilayah Anda.
  • Jika pemesanan Anda menentukan lebih banyak resource ini daripada komitmen Anda, Anda tetap menerima DA hanya untuk penggunaan resource yang memenuhi syarat. Jika pembagian CUD diaktifkan, komitmen berbasis resource di akun Penagihan Cloud Anda akan digabungkan dan diterapkan ke penggunaan yang memenuhi syarat. Jika pemesanan terlampir menentukan lebih banyak resource daripada yang dapat dicakup oleh komitmen Anda, maka penggunaan tambahan dapat dikenai biaya tarif sesuai permintaan.

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

  • Tidak melampirkan pemesanan sama sekali.

  • 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 menentukan jenis resource tambahan yang memerlukan pemesanan terlampir, maka Anda tetap harus melampirkan pemesanan untuk resource tersebut.

Untuk mempelajari cara membeli komitmen untuk resource yang tidak memerlukan reservasi, lihat Membeli komitmen berbasis resource tanpa reservasi terlampir.

Jenis resource yang memerlukan pemesanan terlampir

Untuk semua GPU dan sebagian besar disk SSD Lokal, Anda juga harus memesan resource tersebut dan melampirkan pemesanan ke komitmen Anda. Tanpa reservasi terlampir untuk resource ini, pembelian komitmen Anda akan gagal. Beberapa disk SSD titanium lokal untuk digunakan dengan pilihan seri mesin dikecualikan dari lampiran reservasi wajib ini.

Saat membeli komitmen yang mencakup GPU, atau disk SSD Lokal yang berlaku, atau keduanya, Anda juga harus memesan resource tersebut dan melampirkan reservasi ke komitmen Anda. Anda dapat melakukannya dengan menggunakan satu pemesanan atau kombinasi beberapa pemesanan.

Saat membeli komitmen untuk resource yang memerlukan pemesanan terlampir ini, Anda juga dapat menyertakan resource yang tidak memerlukan pemesanan terlampir dalam komitmen yang sama. Dalam skenario tersebut, Anda dapat memilih untuk melakukan salah satu tindakan berikut:

  • Cadangkan resource opsional dalam jumlah yang sesuai dengan komitmen.
  • Cadangkan resource opsional dalam jumlah yang berbeda dibandingkan dengan komitmen.
  • Tidak memesan resource opsional sama sekali.

Untuk mempelajari cara membeli komitmen untuk GPU atau disk SSD Lokal, lihat bagian berikut:

Jika komitmen Anda menentukan jenis resource yang memerlukan pemesanan terlampir, pemesanan terlampir Anda harus menentukan jumlah dan jenis resource tersebut secara persis. Akibatnya, Anda juga tidak dapat memiliki jumlah atau jenis tambahan sumber daya ini dalam reservasi terlampir.

Misalnya, Anda membeli komitmen untuk memori 30 GB dan 4 GPU NVIDIA P100. Pemesanan terlampir (atau kombinasi pemesanan terlampir) dapat menentukan jumlah vCPU atau memori apa pun, tetapi harus memiliki tepat 4 GPU jenis NVIDIA P100. Dalam contoh ini, Anda tidak dapat melampirkan reservasi yang menentukan 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

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

Perilaku reservasi setelah pembelian komitmen

Setelah Anda membeli komitmen dengan pemesanan terlampir, perilaku pemesanan bergantung pada apakah komitmen menentukan jenis resource yang memerlukan pemesanan terlampir:

  • Komitmen yang memerlukan pemesanan terlampir: Jika komitmen menentukan salah satu jenis resource ini, Anda tidak dapat melakukan hal berikut:
    • Menghapus, mengubah ukuran, atau mengubah reservasi terlampir selama siklus proses komitmen. Namun, Anda dapat mengganti pemesanan terlampir yang ada dengan yang baru.
    • Aktifkan setelan hapus otomatis pada pemesanan terlampir tersebut. Saat komitmen yang menentukan jenis resource ini berakhir, semua pemesanan yang terlampir akan otomatis dihapus.
  • Komitmen dengan reservasi opsional: Jika komitmen ditujukan untuk jenis resource dengan reservasi opsional, Anda dapat menghapus reservasi, mengubah jumlah VM yang dipesan, atau mengubah properti seperti penghapusan otomatis kapan saja. Saat komitmen ini berakhir, semua pemesanan yang terlampir akan terus ada kecuali jika Anda mengonfigurasinya agar dihapus secara otomatis. Penghapusan pemesanan ini tidak memengaruhi VM yang sedang berjalan yang menggunakan kapasitas yang dicadangkan. VM yang sedang berjalan akan terus berjalan dan Anda akan menerima cakupan CUD hingga komitmen Anda berakhir.

Untuk mengetahui informasi selengkapnya tentang hal yang dapat dan tidak dapat diubah untuk pemesanan yang dilampirkan, lihat bagian Perubahan yang diizinkan dalam dokumen ini.

Membeli komitmen berbasis resource dengan pemesanan 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, 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.
    • Aktifkan berbagi CUD 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 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 diganti 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 Anda di luar durasi masa berlaku preset yang ditentukan oleh paket komitmen Anda, 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 persetujuan Anda terhadap 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 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, serta 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 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 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 diganti 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 Anda di luar durasi masa berlaku preset yang ditentukan oleh paket komitmen Anda, 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 persetujuan Anda terhadap 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 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 terlampir, 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 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 reservasi terlampir hanya jika ada cukup resource jenis mesin yang ditentukan di zona target, dan kuota yang memadai, pada saat permintaan Anda. 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 mencadangkan 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 reservasi 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 reservasi 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"
    }
  ]
}

Mengganti pemesanan yang terikat komitmen

Untuk komitmen yang memerlukan reservasi terlampir, Anda tidak dapat menghapus, mengubah ukuran, atau mengubah reservasi terlampir secara langsung. Namun, Anda dapat mengubah jenis mesin dan jumlah VM yang ditentukan dalam pemesanan terlampir. Anda dapat melakukan perubahan ini dengan mengganti pemesanan terlampir yang ada di komitmen dengan pemesanan terlampir yang baru.

Untuk komitmen yang pemesanan terlampirnya bersifat opsional, Anda dapat menghapus atau mengubah ukuran pemesanan terlampir secara langsung. Untuk mengetahui informasi selengkapnya tentang perbedaan perilaku, lihat Perilaku reservasi setelah pembelian komitmen.

Pemesanan pengganti akan selalu menjadi pemesanan yang baru dibuat. Untuk mengganti pemesanan terlampir, Anda harus menentukan properti pemesanan yang ingin digunakan sebagai pengganti. Kemudian, Compute Engine akan otomatis membuat pemesanan baru dengan properti ini dan menggunakannya untuk menggantikan pemesanan yang terlampir. Anda tidak dapat menggunakan pemesanan yang ada untuk menggantikan pemesanan terlampir Anda.

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 GPU dan disk SSD Lokal yang terlampir per VM selama jumlah total GPU yang dipesan dan disk SSD Lokal tetap sama.
  • Anda dapat menentukan pemesanan yang diganti sebagai pemesanan satu project (juga disebut lokal di konsol Google Cloud ) atau pemesanan 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.
  • Pemesanan baru harus ada dalam project yang sama dengan komitmen.
  • Pemesanan baru harus berada di zona yang sama dengan pemesanan yang dihapus.
  • Jumlah dan jenis GPU yang ditentukan dalam pemesanan baru harus sama dengan pemesanan yang dihapus.
  • Jumlah dan jenis disk SSD Lokal yang ditentukan dalam reservasi baru harus sama 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 Google Cloud Dukungan.

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 pemecahan 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 pemesanan 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
  local_ssd:
  - interface: CURRENT_RESERVATION_INTERFACE_1
    size: 375
  - interface: CURRENT_RESERVATION_INTERFACE_2
    size: 375
  project: CURRENT_RESERVATION_PROJECT_ID
  share_setting: CURRENT_RESERVATION_SHARE_SETTING
  share_with:
  - CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1
  - CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2
- reservation: REPLACEMENT_RESERVATION_NAME
  reservation_zone: REPLACEMENT_RESERVATION_ZONE
  vm_count: REPLACEMENT_RESERVATION_NUMBER_OF_VMs
  machine_type: REPLACEMENT_RESERVATION_MACHINE_TYPE
  accelerator:
  - count: REPLACEMENT_RESERVATION_ACCELERATOR_COUNT
    type: REPLACEMENT_RESERVATION_ACCELERATOR_TYPE
  local_ssd:
  - interface: REPLACEMENT_RESERVATION_INTERFACE_1
    size: 375
  - interface: REPLACEMENT_RESERVATION_INTERFACE_2
    size: 375
  project: REPLACEMENT_RESERVATION_PROJECT_ID
  share_setting: REPLACEMENT_RESERVATION_SHARE_SETTING
  share_with:
  - REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1
  - REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2

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

    Pemesanan saat ini

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

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

    Pemesanan pengganti

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

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

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

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

      Ganti kode berikut:

      • MACHINE_FAMILY: kelompok jenis mesin; misalnya, tentukan n2 untuk VM N2.
      • CPUS: jumlah vCPU.
      • MEMORY: total memori untuk VM yang dipesan. Ukuran memori harus kelipatan 256 MB dan harus ditulis dalam satuan MB. Misalnya, untuk membuat VM N2 dengan 4 vCPU dan memori 5 GB, yaitu 5.120 MB, gunakan n2-custom-4-5120.

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

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

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

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

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

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

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

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

    Ganti kode berikut:

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

Contoh penggantian pemesanan yang dilampirkan ke komitmen

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

Contoh komitmen dengan pemesanan terlampir

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

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

Untuk contoh ini, misalnya saat perintah ini dijalankan, one-reservation.yaml adalah file dalam direktori saat ini dengan konten berikut, yang menentukan pemesanan terlampir bernama res-1.

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

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

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

Ganti contoh pemesanan terlampir

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

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

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

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

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

    - reservation: res-1
  reservation_zone: asia-east1-a
  vm_count: 0
  machine_type: n1-standard-4
  accelerator:
  - count: 1
    type: nvidia-tesla-p100
  local_ssd:
  - interface: scsi
    size: 375
  - interface: scsi
    size: 375
- reservation: res-2
  reservation_zone: asia-east1-a
  vm_count: 2
  machine_type: n1-standard-8
  accelerator:
  - count: 2
    type: nvidia-tesla-p100
  project: my-project
  share_setting: projects
  share_with:
  - project-1
  - project-2
  local_ssd:
  - interface: scsi
    size: 375
  - interface: scsi
    size: 375
  - interface: scsi
    size: 375
  - interface: scsi
    size: 375

  2. Jalankan perintah berikut:

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

REST

Untuk mengganti pemesanan yang terlampir dengan komitmen, buat permintaan POST menggunakan metode regionCommitments.updateReservations.

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

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

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

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

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

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 pemesanan saat ini.

  • CURRENT_RESERVATION_NAME: nama pemesanan terlampir saat ini.
  • CURRENT_RESERVATION_ZONE: zona pemesanan terlampir saat ini.
  • CURRENT_RESERVATION_MACHINE_TYPE: jenis mesin dari pemesanan terlampir saat ini.
  • CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS: jumlah GPU yang dipesan dalam pemesanan terlampir saat ini.
  • CURRENT_RESERVATION_ACCELERATOR_TYPE: jenis akselerator yang dipesan dalam pesanan terlampir saat ini.
  • CURRENT_RESERVATION_INTERFACE_1 dan CURRENT_RESERVATION_INTERFACE_2: jenis antarmuka yang digunakan disk SSD Lokal untuk setiap VM yang dipesan dalam pemesanan terlampir saat ini. Opsi yang valid adalah: scsi dan nvme. Setiap disk SSD Lokal berukuran 375 GB. Ulangi parameter localSsds untuk semua disk SSD Lokal yang dipesan.
  • 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 pemesanan pengganti, tetapkan properti berikut sesuai kebutuhan. Pastikan Anda memenuhi semua persyaratan saat menentukan properti ini. Hapus kolom tambahan yang tidak ingin Anda gunakan.

  • REPLACEMENT_RESERVATION_NAME: nama pemesanan pengganti baru.
  • REPLACEMENT_RESERVATION_ZONE: zona pemesanan pengganti baru.
  • REPLACEMENT_RESERVATION_NUMBER_OF_VMS: jumlah VM yang ingin Anda pesan 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 vCPU.
    • MEMORY: total memori untuk VM yang dipesan. Ukuran memori harus kelipatan 256 MB dan harus ditulis dalam satuan MB. Misalnya, untuk membuat VM N2 dengan 4 vCPU dan memori 5 GB, yaitu 5.120 MB, gunakan n2-custom-4-5120.

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

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

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

Ganti contoh pemesanan terlampir

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

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

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

Untuk mengganti pemesanan terlampir res-1 dengan res-2 untuk komitmen my-commitment-with-reservations, buat permintaan POST berikut menggunakan metode regionCommitments.updateReservations :

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

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

Langkah berikutnya