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 menerima CUD atas biaya penggunaan resource sebagai imbalan. Namun, komitmen tidak menyimpan kapasitas zona untuk resource terpakai 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 menerima CUD untuk resource yang Anda pesan dan cara menambahkan pemesanan ke komitmen berbasis resource.
Sebelum memulai
- Tinjau dasar-dasar pemesanan beserta persyaratan dan batasannya. Untuk mengetahui informasi selengkapnya, lihat Pemesanan resource zona Compute Engine.
-
Jika Anda belum melakukannya, siapkan autentikasi.
Autentikasi adalah
proses verifikasi identitas Anda untuk mengakses layanan dan API Google Cloud.
Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat mengautentikasi ke Compute Engine dengan memilih salah satu opsi berikut:
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
- Anda tidak menerima bentuk diskon lain untuk penggunaan resource.
- VM Anda harus menggunakan reservasi saat komitmen aktif.
Minimal, properti berikut harus cocok antara komitmen aktif dan pemesanan yang digunakan VM Anda:
- Project dan region tempat kebijakan tersebut berlaku
- Seri kelompok mesin
vCPU dan memori: Untuk menerima CUD untuk salah satu atau kedua jenis resource ini, Anda dapat membeli komitmen berbasis resource atau berbasis pembelanjaan yang menyertakan jenis resource yang diperlukan. Saat VM dalam project Anda menggunakan reservasi yang propertinya cocok dengan komitmen aktif tersebut, Anda akan otomatis menerima CUD yang berlaku untuk jenis resource yang direservasi ini. Jika Anda memesan lebih banyak resource daripada yang dikomitmenkan, Anda tidak akan menerima DA untuk resource tambahan tersebut.
GPU dan disk SSD Lokal: Untuk menerima DA untuk salah satu atau kedua jenis resource ini, Anda harus melakukan hal berikut:
- Membeli komitmen berbasis resource yang menyertakan jenis resource yang diperlukan.
- Buat reservasi untuk semua resource yang dipesan dengan properti yang cocok dengan komitmen Anda, dan lampirkan reservasi tersebut ke komitmen.
Saat VM dalam project Anda menggunakan reservasi terlampir ini, Anda mulai menerima DA yang berlaku untuk jenis resource yang dicadangkan ini.
- Menggunakan reservasi yang ada yang propertinya cocok dengan komitmen
- Membuat reservasi baru yang cocok saat membeli komitmen
- Tidak melampirkan reservasi apa pun.
Lampirkan pemesanan yang menentukan kombinasi jenis resource ini; misalnya, berikut:
- 4 vCPU dan memori 30 GB
- 2 vCPU dan memori 50 GB
- 10 vCPU dan memori 10 GB
- 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
- Menggunakan reservasi yang ada yang propertinya cocok dengan komitmen
- Membuat pemesanan baru yang cocok saat membeli komitmen
- Anda harus membeli komitmen dan membuat pemesanan yang terlampir di project dan region yang sama.
- Anda harus membeli komitmen dan membuat reservasi terlampir untuk resource dari seri keluarga mesin yang sama.
- Anda harus menonaktifkan opsi hapus otomatis pada pemesanan terlampir.
- Jika komitmen Anda memiliki GPU, jenis GPU yang ditentukan dalam pemesanan dan komitmen harus cocok.
- Untuk GPU dan disk SSD Lokal, jumlah resource yang dipesan untuk setiap jenis resource harus sama persis dengan jumlah resource terpakai untuk jenis resource tersebut. Misalnya, jika Anda ingin membeli komitmen untuk 4 GPU V100, pemesanan terlampir komitmen Anda harus menentukan total 4 GPU V100. Namun, jumlah vCPU dan memori yang Anda pesan dapat lebih banyak atau lebih sedikit daripada jumlah komitmen yang Anda beli.
- Untuk GPU, beli komitmen untuk jenis GPU tertentu yang ingin digunakan. Misalnya, Anda dapat membeli komitmen untuk NVIDIA P100 atau NVIDIA V100, tetapi Anda tidak dapat menggunakan komitmen yang dibeli untuk GPU NVIDIA P100 untuk mencakup GPU NVIDIA V100.
Jika pemesanan terlampir merupakan 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 di antara project yang termasuk dalam akun Penagihan Cloud yang sama dengan komitmen.
- Aktifkan pembagian CUD untuk akun Penagihan Cloud tersebut.
Di Konsol Google Cloud, buka halaman Committed use discounts.
Untuk membeli komitmen, klik
Purchase commitment. Halaman Purchase a committed use discount akan terbuka dan menampilkan tab Hardware.Di kolom Nama, masukkan nama untuk komitmen Anda.
Di kolom Region, pilih region tempat Anda ingin melakukan commit ke resource Compute Engine.
Di kolom Jenis komitmen, pilih seri kelompok mesin untuk resource yang dikomitmenkan. Jenis komitmen berikut menyediakan opsi untuk GPU, disk SSD Lokal, atau keduanya:
- A2 yang dioptimalkan akselerator untuk resource jenis mesin A2
- A3 yang dioptimalkan akselerator untuk resource jenis mesin A3 Edge dan High
- A3 Mega yang dioptimalkan akselerator untuk resource jenis mesin A3 Mega
- C2 yang dioptimalkan untuk komputasi untuk resource jenis mesin C2
- C2D yang dioptimalkan untuk komputasi untuk resource jenis mesin C2D
- General-Purpose C3 untuk resource jenis mesin C3
- General-Purpose C3D untuk resource jenis mesin C3D
- N1 tujuan umum untuk resource jenis mesin N1
- N2 Tujuan Umum untuk resource jenis mesin N2
- N2D Tujuan Umum untuk resource mesin N2D
- G2 yang dioptimalkan untuk grafis untuk resource jenis mesin G2
- M3 yang dioptimalkan untuk memori untuk resource jenis mesin M3
- Z3 yang dioptimalkan untuk penyimpanan untuk resource jenis mesin Z3
Untuk Durasi, lakukan hal berikut:
- Untuk menentukan paket komitmen, pilih 1 tahun atau 3 tahun. Setelan ini menentukan durasi periode preset komitmen Anda.
Opsional. Untuk menentukan durasi jangka waktu kustom untuk komitmen Anda, klik tombol Perpanjang tanggal akhir, lalu di kolom Tanggal, tentukan tanggal akhir kustom. Untuk informasi selengkapnya, lihat Memperpanjang jangka waktu komitmen.
Di kolom Cores, masukkan jumlah vCPU yang ingin Anda komit.
Di kolom Memory, masukkan jumlah memori dalam GB yang ingin Anda commit.
Untuk membeli komitmen GPU, di bagian GPUs, klik
Add GPU, lalu lakukan hal berikut:- Di kolom GPU type, pilih jenis GPU.
- Di kolom Number of GPUs, masukkan jumlah GPU.
- Opsional: Jika model GPU Anda mendukung NVIDIA RTX Virtual Workstations (vWS) untuk workload grafis, dan Anda berencana menjalankan workload yang intensif grafis, pilih kotak centang Enable Virtual Workstation (NVIDIA GRID).
Untuk melakukan komitmen pada disk SSD Lokal, di bagian Local SSDs, klik
Add SSD, lalu, di kolom Number of SSDs, tentukan jumlah disk.Untuk melampirkan satu atau beberapa reservasi yang ada ke komitmen, di kolom Reservations, pilih Attach existing reservations.
Konsol Google Cloud menampilkan daftar semua reservasi di project Anda yang region, jenis mesin, dan jenis GPU-nya cocok dengan komitmen. Kemudian, lakukan hal berikut:
- Opsional. Untuk melihat reservasi dengan properti tertentu, di menu Filter, tambahkan atau hapus filter untuk properti yang Anda inginkan.
- Pilih semua reservasi yang ingin Anda lampirkan ke komitmen.
Untuk menyelesaikan pembelian komitmen dengan reservasi terlampir, lakukan tindakan berikut:
- Klik Purchase.
- Pada dialog Beli diskon abonemen, jika Anda setuju dengan persyaratan khusus layanan, klik Beli lagi.
COMMITMENT_NAME
: nama komitmen.REGION
: region tempat komitmen berada.PROJECT_ID
: ID project tempat Anda ingin membeli komitmen dengan pemesanan terlampir.DURATION
: durasi jangka waktu komitmen,12-month
atau36-month
.CUSTOM_END_DATE
: Opsional. Tanggal akhir kustom untuk masa berlaku Anda, yang harus diformat sebagaiYYYY-MM-DD
. Misalnya, untuk menentukan tanggal akhir kustom 20 April 2024, formatnya sebagai2024-04-20
.COMMITMENT_TYPE
: jenis komitmen. Jenis komitmen berikut menyediakan opsi untuk GPU, disk SSD Lokal, atau keduanya:accelerator-optimized
untuk resource jenis mesin A2accelerator-optimized-a3
untuk resource jenis mesin A3 Edge dan Highaccelerator-optimized-a3-mega
untuk resource jenis mesin A3 Megacompute-optimized
untuk resource jenis mesin C2compute-optimized-c2d
untuk resource jenis mesin C2Dcompute-optimized-c3
untuk resource jenis mesin C3compute-optimized-c3d
untuk resource jenis mesin C3Dgeneral-purpose
untuk resource jenis mesin N1general-purpose-n2
untuk resource jenis mesin N2general-purpose-n2d
untuk resource mesin N2Dgraphics-optimized
untuk resource jenis mesin G2memory-optimized-m3
untuk resource jenis mesin M3storage-optimized-z3
untuk resource jenis mesin Z3
COMMITTED_VCPUS
: jumlah vCPU yang Anda inginkan dalam komitmen. Angka harus berupa bilangan bulat positif.COMMITTED_MEMORY
: jumlah memori, dalam MB atau GB, yang Anda inginkan dalam komitmen. Misalnya,10240MB
atau10GB
. Jika Anda tidak menentukan satuan, Compute Engine akan menggunakan GB sebagai unit. Anda dapat membeli memori dengan kelipatan 0,25 GB.COMMITTED_LOCAL_SSD
: jumlah ruang SSD Lokal dalam GB yang Anda inginkan dalam komitmen. Setiap disk SSD Lokal berukuran 375 GB.COMMITTED_ACCELERATOR_COUNT
: jumlah GPU yang Anda inginkan dalam komitmen.COMMITTED_ACCELERATOR_TYPE
: jenis GPU yang Anda inginkan dalam komitmen.RESERVATION_NAME_1
danRESERVATION_NAME_2
: Nama pemesanan yang ada yang ingin Anda lampirkan ke komitmen.RESERVATION_ZONE_1
danRESERVATION_ZONE_2
: Zona pemesanan yang ada yang ingin Anda lampirkan ke komitmen.COMMITMENT_NAME
: nama komitmen.REGION
: region tempat komitmen berada.PROJECT_ID
: ID project tempat Anda ingin membeli komitmen dengan pemesanan terlampir.DURATION
: durasi jangka waktu komitmen,TWELVE_MONTH
atauTHIRTY_SIX_MONTH
.COMMITMENT_TYPE
: jenis komitmen. Jenis komitmen berikut menyediakan opsi untuk GPU, disk SSD Lokal, atau keduanya:ACCELERATOR_OPTIMIZED
untuk resource jenis mesin A2ACCELERATOR_OPTIMIZED_A3
untuk resource jenis mesin A3 Edge dan HighACCELERATOR_OPTIMIZED_A3_MEGA
untuk resource jenis mesin A3 MegaCOMPUTE_OPTIMIZED
untuk resource jenis mesin C2COMPUTE_OPTIMIZED_C2D
untuk resource jenis mesin C2DCOMPUTE_OPTIMIZED_C3
untuk resource jenis mesin C3COMPUTE_OPTIMIZED_C3D
untuk resource jenis mesin C3DGENERAL_PURPOSE
untuk resource jenis mesin N1GENERAL_PURPOSE_N2
untuk resource jenis mesin N2GENERAL_PURPOSE_N2D
untuk resource mesin N2DGRAPHICS_OPTIMIZED
untuk resource jenis mesin G2MEMORY_OPTIMIZED_M3
untuk resource jenis mesin M3STORAGE_OPTIMIZED_Z3
untuk resource jenis mesin Z3
COMMITTED_VCPUS
: jumlah vCPU yang Anda inginkan dalam komitmen. Angka harus berupa bilangan bulat positif.COMMITTED_MEMORY
: jumlah memori, dalam MB, yang Anda inginkan dalam komitmen. Contoh,10240MB
. Anda dapat membeli memori dengan kelipatan 256 MB.COMMITTED_LOCAL_SSD
: jumlah penyimpanan SSD Lokal dalam GB yang Anda inginkan dalam komitmen. Setiap disk SSD Lokal berukuran 375 GB.COMMITTED_ACCELERATOR_COUNT
: jumlah GPU yang Anda inginkan dalam komitmen.COMMITTED_ACCELERATOR_TYPE
: jenis GPU yang Anda inginkan dalam komitmen.CUSTOM_END_DATE
: Opsional. Tanggal akhir kustom untuk masa berlaku Anda, yang harus diformat sebagaiYYYY-MM-DD
. Misalnya, untuk menentukan tanggal akhir kustom 20 April 2024, formatkan sebagai2024-04-20
.END_TIME
: 00.00 Waktu Pasifik AS dan Kanada (UTC-8 atau UTC-7), sebagai offset Waktu Universal Terkoordinasi (UTC). Tentukan nilai ini hanya jika Anda menentukan tanggal akhir kustom untuk komitmen Anda. Tentukan salah satu nilai berikut:- Selama waktu musim panas:
07:00:00
- Pada waktu lainnya:
08:00:00
- Selama waktu musim panas:
RESERVATION_URLs
: daftar URL pemesanan yang ada yang dipisahkan koma yang ingin Anda lampirkan ke komitmen. Misalnya, untuk melampirkan dua reservasi,res-1
danres-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"
Di Konsol Google Cloud, buka halaman Committed use discounts.
Untuk membeli komitmen, klik
Purchase commitment. Halaman Purchase a committed use discount akan terbuka dan menampilkan tab Hardware.Di kolom Nama, masukkan nama untuk komitmen Anda.
Di kolom Region, pilih region tempat Anda ingin melakukan commit ke resource Compute Engine.
Di kolom Jenis komitmen, pilih seri kelompok mesin untuk resource yang dikomitmenkan. Jenis komitmen berikut menyediakan opsi untuk GPU, disk SSD Lokal, atau keduanya:
- A2 yang dioptimalkan akselerator untuk resource jenis mesin A2
- A3 yang dioptimalkan akselerator untuk resource jenis mesin A3 Edge dan High
- A3 Mega yang dioptimalkan akselerator untuk resource jenis mesin A3 Mega
- C2 yang dioptimalkan untuk komputasi untuk resource jenis mesin C2
- C2D yang dioptimalkan untuk komputasi untuk resource jenis mesin C2D
- General-Purpose C3 untuk resource jenis mesin C3
- General-Purpose C3D untuk resource jenis mesin C3D
- N1 tujuan umum untuk resource jenis mesin N1
- N2 Tujuan Umum untuk resource jenis mesin N2
- N2D Tujuan Umum untuk resource mesin N2D
- G2 yang dioptimalkan untuk grafis untuk resource jenis mesin G2
- M3 yang dioptimalkan untuk memori untuk resource jenis mesin M3
- Z3 yang dioptimalkan untuk penyimpanan untuk resource jenis mesin Z3
Untuk Durasi, pilih 1 tahun atau 3 tahun sebagai durasi persyaratan komitmen Anda.
Di kolom Cores, masukkan jumlah vCPU yang ingin Anda komit.
Di kolom Memory, masukkan jumlah memori dalam GB yang ingin Anda commit.
Untuk membeli komitmen GPU, di bagian GPUs, klik
Add GPU, lalu lakukan hal berikut:- Di kolom GPU type, pilih jenis GPU.
- Di kolom Number of GPUs, masukkan jumlah GPU.
- Opsional: Jika model GPU Anda mendukung NVIDIA RTX Virtual Workstations (vWS) untuk workload grafis, dan Anda berencana menjalankan workload yang intensif grafis, pilih kotak centang Enable Virtual Workstation (NVIDIA GRID).
Untuk melakukan komitmen pada disk SSD Lokal, di bagian Local SSDs, klik
Add SSD, lalu, di kolom Number of SSDs, tentukan jumlah disk.Untuk membuat reservasi baru dan melampirkannya ke komitmen, di kolom Reservations, pilih Create reservations, lalu lakukan hal berikut. Ulangi langkah ini untuk setiap reservasi baru yang ingin Anda buat dan lampirkan.
- Klik Tambahkan reservasi. Bagian New reservation akan muncul.
- Di kolom Nama, masukkan nama untuk pemesanan yang Anda lampirkan.
- Di kolom Region, pilih region yang sama dengan komitmen Anda.
- Di kolom Zone, pilih zona tempat Anda ingin memesan resource.
Di bagian Share type, tentukan cara Anda ingin membagikan pemesanan ini dengan salah satu cara berikut:
- Untuk membuat reservasi satu project, pilih Lokal.
- Untuk membuat reservasi yang dibagikan dengan beberapa project, pilih Dibagikan. Kemudian, untuk menentukan project yang akan diajak berbagi pemesanan ini, klik Add projects, lalu pilih project yang Anda inginkan dari organisasi project saat ini.
Di kolom Gunakan dengan instance VM, pilih cara yang Anda inginkan untuk VM menggunakan cadangan dengan salah satu cara berikut:
- Untuk mengizinkan VM dengan properti yang cocok otomatis menggunakan pemesanan ini, klik Gunakan pemesanan secara otomatis (default).
- Untuk menggunakan resource pemesanan ini hanya saat membuat VM dengan properti yang cocok yang secara khusus menargetkan pemesanan ini berdasarkan nama, klik Pilih pemesanan tertentu.
Di bagian Resource details, lakukan hal berikut:
- Di kolom Number of VM instances, masukkan jumlah instance VM yang ingin Anda pesan.
Di bagian Machine configuration, tentukan properti VM yang direservasi dengan salah satu cara berikut:
Untuk menentukan properti VM Anda menggunakan template instance yang ada, pilih Gunakan template instance.
Di kolom Instance template, pilih template instance yang menentukan seri kelompok mesin yang sama dengan komitmen Anda. Jika Anda memilih template instance regional, region template instance tersebut juga harus cocok dengan region yang ditentukan dalam komitmen Anda.
Untuk menentukan properti VM secara manual, pilih Select machine type, lalu lakukan hal berikut:
Pilih kelompok mesin yang berlaku untuk seri mesin yang Anda tentukan untuk komitmen:
- Tujuan umum untuk seri mesin tujuan umum
- Dioptimalkan untuk komputasi untuk seri mesin yang dioptimalkan untuk komputasi
- Dioptimalkan untuk memori untuk seri mesin yang dioptimalkan untuk memori
- GPU untuk seri mesin yang dioptimalkan akselerator
Dalam tabel yang memiliki kolom Series, pilih seri mesin yang sama dengan yang Anda tentukan untuk komitmen.
Di kolom Machine type, tentukan jenis mesin kustom atau yang telah ditetapkan dengan salah satu cara berikut:
- Untuk memilih jenis mesin yang telah ditentukan, pilih Preset, lalu pilih jenis mesin yang Anda inginkan.
- Untuk memilih jenis mesin kustom, pilih Custom, lalu tentukan Cores dan Memory yang Anda inginkan.
Untuk menentukan platform CPU, GPU, atau keduanya, luaskan menu
CPU Platform and GPU, lalu lakukan hal berikut:- Opsional: Untuk menentukan platform CPU minimum, dalam daftar Platform CPU, pilih salah satu opsi.
Opsional: Untuk memesan GPU, klik
Tambahkan GPU. Kemudian, di kolom GPU type dan Number of GPUs, pilih jenis dan jumlah GPU untuk setiap VM.
Untuk memesan disk SSD lokal, lakukan langkah berikut:
- Di kolom Number of disks, pilih jumlah disk SSD lokal yang Anda inginkan untuk setiap VM.
- Di kolom Interface type, pilih antarmuka untuk disk SSD lokal.
Untuk menyelesaikan penetapan properti pemesanan ini, klik Done.
Untuk menyelesaikan pembelian komitmen dengan reservasi terlampir, lakukan tindakan berikut:
- Klik Purchase.
- Pada dialog Beli diskon abonemen, jika Anda setuju dengan persyaratan khusus layanan, klik Beli lagi.
Untuk membuat dan melampirkan satu reservasi ke komitmen Anda, tentukan properti reservasi yang dilampirkan dengan menjalankan perintah berikut:
gcloud compute commitments create COMMITMENT_NAME \ --region=REGION \ --project=PROJECT_ID \ --plan DURATION \ --type COMMITMENT_TYPE --resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \ --resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \ --custom-end-time=CUSTOM_END_DATE \ --reservation=RESERVATION_NAME \ --reservation-zone=RESERVATION_ZONE \ --machine-type=RESERVED_MACHINE_TYPE \ --require-specific-reservation=REQUIRE_SPECIFIC_RESERVATION_VALUE \ --vm-count=NUMBER_OF_RESERVED_VMs \ --accelerator=type=RESERVED_ACCELERATOR_TYPE,count=RESERVED_ACCELERATOR_COUNT \ --local-ssd=interface=INTERFACE_1,size=375 \ --local-ssd=interface=INTERFACE_2,size=375 \ --minimum-cpu-platform=MINIMUM_CPU_PLATFORM \ --share-setting=SHARE_SETTING \ --share-with=CONSUMER_PROJECT_ID_1,CONSUMER_PROJECT_ID_2
Untuk membuat dan melampirkan beberapa reservasi ke komitmen Anda, tentukan properti pemesanan 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:
Buat file YAML di direktori saat ini dan tentukan konfigurasi yang Anda inginkan untuk setiap reservasi 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 yang Anda inginkan ke komitmen Anda.
Jalankan perintah
gcloud compute commitments create
dan sertakan flag--reservation-from-file
.gcloud compute commitments create COMMITMENT_NAME \ --region REGION \ --project PROJECT_ID \ --plan DURATION \ --type COMMITMENT_TYPE \ --resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \ --resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \ --reservations-from-file=YAML_FILE
COMMITMENT_NAME
: nama komitmen.REGION
: region tempat komitmen berada.PROJECT_ID
: ID project tempat Anda ingin membeli komitmen dengan pemesanan terlampir.DURATION
: durasi jangka waktu komitmen,12-month
atau36-month
.CUSTOM_END_DATE
: Opsional. Tanggal akhir kustom untuk masa berlaku Anda, yang harus diformat sebagaiYYYY-MM-DD
. Misalnya, untuk menentukan tanggal akhir kustom 20 April 2024, formatnya sebagai2024-04-20
.COMMITMENT_TYPE
: jenis komitmen. Jenis komitmen berikut menyediakan opsi untuk GPU, disk SSD Lokal, atau keduanya:accelerator-optimized
untuk resource jenis mesin A2accelerator-optimized-a3
untuk resource jenis mesin A3 Edge dan Highaccelerator-optimized-a3-mega
untuk resource jenis mesin A3 Megacompute-optimized
untuk resource jenis mesin C2compute-optimized-c2d
untuk resource jenis mesin C2Dcompute-optimized-c3
untuk resource jenis mesin C3compute-optimized-c3d
untuk resource jenis mesin C3Dgeneral-purpose
untuk resource jenis mesin N1general-purpose-n2
untuk resource jenis mesin N2general-purpose-n2d
untuk resource mesin N2Dgraphics-optimized
untuk resource jenis mesin G2memory-optimized-m3
untuk resource jenis mesin M3storage-optimized-z3
untuk resource jenis mesin Z3
COMMITTED_VCPUS
: jumlah vCPU yang Anda inginkan dalam komitmen. Angka harus berupa bilangan bulat positif.COMMITTED_MEMORY
: jumlah memori, dalam MB atau GB, yang Anda inginkan dalam komitmen. Misalnya,10GB
atau10240MB
. Jika Anda tidak menentukan unit, Compute Engine akan menggunakan GB sebagai unit. Anda dapat membeli memori dengan kelipatan 0,25 GB.COMMITTED_LOCAL_SSD
: jumlah penyimpanan SSD Lokal dalam GB yang Anda inginkan dalam komitmen. Setiap disk SSD Lokal berukuran 375 GB.COMMITTED_ACCELERATOR_COUNT
: jumlah GPU yang Anda inginkan dalam komitmen.COMMITTED_ACCELERATOR_TYPE
: jenis GPU yang Anda inginkan dalam komitmen.YAML_FILE
: Jalur ke file YAML yang berisi konfigurasi pemesanan terlampir.RESERVATION_NAME
: nama pemesanan terlampir.RESERVATION_ZONE
: zona pemesanan terlampir.REQUIRE_SPECIFIC_RESERVATION_VALUE
: menentukan apakah reservasi terlampir adalah reservasi yang ditargetkan secara khusus;true
ataufalse
. Untuk 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 di pemesanan terlampir.- Untuk jenis mesin yang telah ditentukan, gunakan format
MACHINE_FAMILY-standard-CPUS
; misalnya,n2-standard-4
. Untuk jenis mesin kustom, gunakan format
MACHINE_FAMILY-custom-CPUS-MEMORY
; misalnyan2-custom-4-5120
. Untuk daftar lengkap batasan, baca spesifikasi untuk jenis mesin kustom.Ganti kode berikut:
MACHINE_FAMILY
: kelompok jenis mesin; misalnya, tentukann2
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, gunakann2-custom-4-5120
.
- Untuk jenis mesin yang telah ditentukan, gunakan format
RESERVED_ACCELERATOR_COUNT
: jumlah GPU yang ingin Anda tambahkan, per VM, dalam pemesanan yang dilampirkan.RESERVED_ACCELERATOR_TYPE
: jenis akselerator yang ingin Anda tambahkan dalam pemesanan terlampir.INTERFACE_1
danINTERFACE_2
: jenis antarmuka yang Anda inginkan untuk digunakan Disk SSD Lokal untuk setiap VM yang dipesan. Opsi yang valid adalah:scsi
dannvme
. Setiap disk SSD Lokal berukuran 375 GB. Ulangi parameterlocal_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 tentukan untuk pemesanan terlampir.SHARE_SETTING
: jenis berbagi untuk pemesanan terlampir. Tentukan kolom ini dengan nilai sebagaiprojects
jika Anda ingin membagikan pemesanan terlampir ke beberapa project konsumen. Kecualikan kolom ini jika Anda ingin membuat pemesanan satu project.CONSUMER_PROJECT_ID_1
danCONSUMER_PROJECT_ID_2
: project ID dari project yang dapat membagikan pemesanan ini, misalnyaproject-1
danproject-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.Untuk membuat reservasi baru dengan menentukan semua properti VM secara manual, sertakan kolom
instanceProperties
dan kecualikan kolomsourceInstanceTemplate
.Misalnya, untuk menentukan konfigurasi pemesanan bersama secara manual yang dibagikan dengan dua project yang menentukan GPU, dua disk SSD Lokal, dan platform CPU minimum, buat permintaan berikut:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments { "name": "COMMITMENT_NAME", "plan": "DURATION", "type": COMMITMENT_TYPE, "resources": [ { "amount": "COMMITTED_VCPUS", "type": "VCPU" }, { "amount": "COMMITTED_MEMORY", "type": "MEMORY" }, { "acceleratorType": "COMMITTED_ACCELERATOR_TYPE", "amount": "COMMITTED_ACCELERATOR_COUNT", "type": "ACCELERATOR" } { "amount": "COMMITTED_LOCAL_SSD", "type": "LOCAL_SSD" } ], "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 pemesanan baru dengan menentukan template instance, sertakan kolom
sourceInstanceTemplate
dan kecualikan kolominstanceProperties
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments { "name": "COMMITMENT_NAME", "plan": "DURATION", "type": COMMITMENT_TYPE, "resources": [ { "amount": "COMMITTED_VCPUS", "type": "VCPU" }, { "amount": "COMMITTED_MEMORY", "type": "MEMORY" }, { "acceleratorType": "COMMITTED_ACCELERATOR_TYPE", "amount": "COMMITTED_ACCELERATOR_COUNT", "type": "ACCELERATOR" } { "amount": "COMMITTED_LOCAL_SSD", "type": "LOCAL_SSD" } ], "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ", "reservations": [ { "name": "RESERVATION_NAME", "specificReservation": { "count": "NUMBER_OF_RESERVED_VMS", "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME" }, "specificReservationRequired": REQUIRE_SPECIFIC_RESERVATION_VALUE", "zone": "RESERVED_ZONE", "shareSettings": { "shareType": "SPECIFIC_PROJECTS", "projectMap": { "CONSUMER_PROJECT_ID_1": { "projectId": "CONSUMER_PROJECT_ID_1" }, "CONSUMER_PROJECT_ID_2": { "projectId": "CONSUMER_PROJECT_ID_2" } } } } ] }
COMMITMENT_NAME
: nama komitmen.REGION
: region tempat komitmen berada.PROJECT_ID
: ID project tempat Anda ingin membeli komitmen dengan pemesanan terlampir.DURATION
: durasi jangka waktu komitmen,TWELVE_MONTH
atauTHIRTY_SIX_MONTH
.COMMITMENT_TYPE
: jenis komitmen. Jenis komitmen berikut menyediakan opsi untuk GPU, disk SSD Lokal, atau keduanya:ACCELERATOR_OPTIMIZED
untuk resource jenis mesin A2ACCELERATOR_OPTIMIZED_A3
untuk resource jenis mesin A3 Edge dan HighACCELERATOR_OPTIMIZED_A3_MEGA
untuk resource jenis mesin A3 MegaCOMPUTE_OPTIMIZED
untuk resource jenis mesin C2COMPUTE_OPTIMIZED_C2D
untuk resource jenis mesin C2DCOMPUTE_OPTIMIZED_C3
untuk resource jenis mesin C3COMPUTE_OPTIMIZED_C3D
untuk resource jenis mesin C3DGENERAL_PURPOSE
untuk resource jenis mesin N1GENERAL_PURPOSE_N2
untuk resource jenis mesin N2GENERAL_PURPOSE_N2D
untuk resource mesin N2DGRAPHICS_OPTIMIZED
untuk resource jenis mesin G2MEMORY_OPTIMIZED_M3
untuk resource jenis mesin M3STORAGE_OPTIMIZED_Z3
untuk resource jenis mesin Z3
COMMITTED_VCPUS
: jumlah vCPU yang Anda inginkan dalam komitmen. Angka harus berupa bilangan bulat positif.COMMITTED_MEMORY
: jumlah memori, dalam MB, yang Anda inginkan dalam komitmen. Contoh,10240MB
. Anda dapat membeli memori dengan kelipatan 256 MB.COMMITTED_LOCAL_SSD
: jumlah penyimpanan SSD Lokal dalam GB yang Anda inginkan dalam komitmen. Setiap disk SSD Lokal berukuran 375 GB.COMMITTED_ACCELERATOR_COUNT
: jumlah GPU yang Anda inginkan dalam komitmen.COMMITTED_ACCELERATOR_TYPE
: jenis GPU yang Anda inginkan dalam komitmen.CUSTOM_END_DATE
: Opsional. Tanggal akhir kustom untuk masa berlaku Anda, yang harus diformat sebagaiYYYY-MM-DD
. Misalnya, untuk menentukan tanggal akhir kustom 20 April 2024, formatnya sebagai2024-04-20
.END_TIME
: 00.00 Waktu Pasifik AS dan Kanada (UTC-8 atau UTC-7), sebagai offset Waktu Universal Terkoordinasi (UTC). Tentukan nilai ini hanya jika Anda menentukan tanggal akhir kustom untuk komitmen Anda. Tentukan salah satu nilai berikut:- Selama waktu musim panas:
07:00:00
- Pada waktu lainnya:
08:00:00
- Selama waktu musim panas:
RESERVATION_NAME
: nama pemesanan terlampir.RESERVATION_ZONE
: zona pemesanan terlampir.REQUIRE_SPECIFIC_RESERVATION_VALUE
: menentukan apakah reservasi terlampir adalah reservasi yang ditargetkan secara khusus;true
ataufalse
. Untuk 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 di pemesanan terlampir.- Untuk jenis mesin yang telah ditentukan, gunakan format
MACHINE_FAMILY-standard-CPUS
; misalnya,n2-standard-4
. Untuk jenis mesin kustom, gunakan format
MACHINE_FAMILY-custom-CPUS-MEMORY
; misalnyan2-custom-4-5120
. Untuk daftar lengkap batasan, baca spesifikasi untuk jenis mesin kustom.Ganti kode berikut:
MACHINE_FAMILY
: kelompok jenis mesin; misalnya, tentukann2
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, gunakann2-custom-4-5120
.
- Untuk jenis mesin yang telah ditentukan, gunakan format
RESERVED_ACCELERATOR_COUNT
: jumlah GPU yang ingin Anda tambahkan, per VM, dalam pemesanan yang dilampirkan.RESERVED_ACCELERATOR_TYPE
: jenis akselerator yang ingin Anda tambahkan dalam pemesanan terlampir.INTERFACE_1
danINTERFACE_2
: jenis antarmuka yang Anda inginkan Disk SSD Lokal untuk setiap VM yang dipesan. Opsi yang valid adalah:scsi
dannvme
. Setiap disk SSD Lokal berukuran 375 GB. Ulangi parameterlocalSsds
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 tentukan untuk pemesanan terlampir.INSTANCE_TEMPLATE_NAME
: nama template instance yang ingin Anda gunakan untuk membuat reservasi yang dilampirkan.SHARE_SETTING
: jenis berbagi untuk pemesanan terlampir. Tentukan kolom ini dengan nilai sebagaiSPECIFIC_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
danCONSUMER_PROJECT_ID_2
: project ID dari project yang dapat membagikan pemesanan ini; misalnya,project-1
danproject-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.- 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 lokal atau bersama.
- 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 pemesanan baru harus sama dengan pemesanan yang dihapus.
- Anda hanya dapat mengubah maksimum 100 VM per permintaan. Untuk membuat perubahan yang melibatkan lebih dari 100 VM, bagi perubahan menjadi beberapa permintaan yang lebih kecil atau hubungi Dukungan Google Cloud.
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
danCURRENT_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
dannvme
. Setiap disk SSD Lokal berukuran 375 GB. Ulangi parameterlocal_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 sebagaiprojects
jika pemesanan terlampir saat ini dibagikan ke beberapa project konsumen.CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1
danCURRENT_RESERVATION_CONSUMER_PROJECT_ID_2
: project ID dari project yang Anda bagikan dengan pemesanan terlampir saat ini, misalnyaproject-1
danproject-2
.
Pemesanan pengganti
Untuk pemesanan pengganti, tetapkan properti berikut sesuai yang diperlukan. 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
; misalnyan2-custom-4-5120
. Untuk daftar lengkap batasan, baca spesifikasi untuk jenis mesin kustom.
Ganti kode berikut:
MACHINE_FAMILY
: kelompok jenis mesin; misalnya, tentukann2
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, gunakann2-custom-4-5120
.
- Untuk jenis mesin predefined, gunakan format
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
danREPLACEMENT_RESERVATION_INTERFACE_2
: jenis antarmuka yang Anda inginkan digunakan Disk SSD Lokal untuk setiap VM yang dipesan. Opsi yang valid adalah:scsi
dannvme
. Ukuran setiap disk SSD Lokal adalah 375 GB. Ulangi parameterlocal_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 sebagaiprojects
jika Anda ingin membagikan pemesanan pengganti ke beberapa project konsumen.REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1
danREPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2
: project ID dari project yang dapat membagikan pemesanan ini, misalnyaproject-1,project-2
. Anda dapat menyertakan hingga 100 project konsumen. Project ini harus berada dalam organisasi yang sama dengan project pemilik. Jangan sertakanREPLACEMENT_RESERVATION_PROJECT_ID
, yang sudah diizinkan untuk menggunakan pemesanan ini secara default.
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.
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
Jalankan perintah berikut:
gcloud beta compute commitments update-reservations my-commitment-with-reservations \ --region=asia-east1 \ --reservations-from-file=two-reservations.yaml
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.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
danCURRENT_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
dannvme
. Ukuran setiap disk SSD Lokal adalah 375 GB. Ulangi parameterlocalSsds
untuk semua disk SSD Lokal yang dipesan.CURRENT_RESERVATION_SHARE_SETTING
: Jenis berbagi untuk pemesanan saat ini. Tentukan parameter ini dengan nilai sebagaiprojects
jika pemesanan terlampir saat ini dibagikan ke beberapa project konsumen.CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1
danCURRENT_RESERVATION_CONSUMER_PROJECT_ID_2
: project ID dari project yang Anda bagikan dengan pemesanan terlampir saat ini, misalnyaproject-1
danproject-2
.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
; misalnyan2-custom-4-5120
. Untuk daftar lengkap batasan, baca spesifikasi untuk jenis mesin kustom.
Ganti kode berikut:
MACHINE_FAMILY
: kelompok jenis mesin; misalnya, tentukann2
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, gunakann2-custom-4-5120
.
- Untuk jenis mesin yang telah ditentukan, gunakan format
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
danREPLACEMENT_RESERVATION_INTERFACE_2
: jenis antarmuka yang Anda ingin digunakan Disk SSD Lokal untuk setiap VM yang dipesan. Opsi yang valid adalah:scsi
dannvme
. Ukuran setiap disk SSD Lokal adalah 375 GB. Ulangi parameterlocalSsds
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 sebagaiprojects
jika Anda ingin membagikan pemesanan penggantian ke beberapa project konsumen.REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1
danREPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2
: project ID dari project yang dapat membagikan pemesanan ini, misalnyaproject-1,project-2
. Anda dapat menyertakan hingga 100 project konsumen. Project ini harus berada dalam organisasi yang sama dengan project pemilik. Jangan sertakanPROJECT_ID
, yang sudah diizinkan untuk menggunakan pemesanan ini secara default.- Pelajari DA berbasis resource lebih lanjut.
- Pelajari cara menggunakan pemesanan.
- Pelajari cara mengubah pemesanan.
- Pelajari cara menghapus pemesanan.
REST
Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Untuk informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud.
CUD untuk resource yang Anda pesan
Anda menerima DA dari komitmen aktif untuk setiap penggunaan resource yang memenuhi syarat dalam project Anda. Jika Anda juga memiliki pemesanan untuk menyimpan kapasitas untuk resource di project tersebut, CUD dari komitmen aktif juga dapat berlaku untuk resource yang dipesan tersebut. Agar resource yang direservasi memenuhi syarat untuk menerima DA, persyaratan berikut berlaku:
Bergantung pada jenis resource, Anda dapat menerima DA untuk resource yang Anda pesan dengan salah satu cara berikut:
Melampirkan pemesanan ke komitmen berbasis resource
Anda dapat melampirkan pemesanan ke komitmen berbasis resource 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:
Setelah Anda membeli komitmen dengan pemesanan terlampir, pemesanan tersebut akan tetap aktif selama komitmen aktif. Saat komitmen Anda berakhir, Compute Engine akan otomatis menghapus semua pemesanan terlampir. Menghapus pemesanan ini tidak memengaruhi VM yang berjalan dan menggunakan pemesanan tersebut. VM yang berjalan akan terus berjalan dan Anda tetap dikenai biaya untuk VM tersebut.
Alokasi resource yang tidak memerlukan pemesanan terlampir
vCPU dan memori yang dikomitmenkan tidak mengharuskan Anda melampirkan pemesanan yang cocok ke komitmen. Meskipun demikian, saat membeli komitmen yang mencakup vCPU, memori, atau keduanya, Anda masih dapat memilih untuk melampirkan reservasi yang menentukan resource tersebut. Untuk mempelajari cara membeli komitmen hanya untuk vCPU, memori, atau keduanya, tanpa melampirkan reservasi, lihat Membeli komitmen tanpa reservasi terlampir.
Alokasi resource yang memerlukan pemesanan terlampir
GPU yang di-commit dan disk SSD Lokal mengharuskan Anda melampirkan reservasi yang cocok ke komitmen Anda. Saat membeli komitmen yang menyertakan GPU, disk SSD Lokal, atau keduanya, Anda juga harus memesan resource tersebut dan melampirkan reservasi tersebut ke komitmen Anda. Anda dapat melakukannya menggunakan satu pemesanan atau kombinasi pemesanan. Saat membeli komitmen tersebut, Anda juga dapat menyertakan vCPU, memori, atau keduanya. Namun, Anda tidak perlu memesan vCPU atau memori tersebut. Untuk mempelajari cara membeli komitmen yang menyertakan salah satu atau kedua disk GPU dan SSD Lokal, lihat Membeli komitmen dengan reservasi terlampir dalam dokumen ini.
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.
Jumlah resource yang diizinkan dalam pemesanan terlampir
Untuk vCPU dan memori, Anda dapat melampirkan reservasi yang menentukan jumlah resource yang lebih banyak atau lebih sedikit daripada jumlah komitmen Anda. Jika Anda berkomitmen untuk menggunakan lebih banyak vCPU atau memori daripada yang Anda pesan, Compute Engine hanya akan menyediakan kapasitas untuk resource yang dipesan ini. Namun, Anda masih dapat menggunakan resource tambahan yang di-commit, bergantung pada ketersediaannya di wilayah Anda. Jika Anda memesan lebih banyak vCPU atau memori daripada yang Anda beli, Anda tidak akan menerima CUD untuk resource tambahan yang Anda pesan.
Misalnya, saat Anda membeli komitmen untuk 4 vCPU dan memori 30 GB, Anda dapat memilih untuk melakukan salah satu hal berikut:
Namun, jika komitmen Anda berisi GPU, disk SSD Lokal, atau keduanya, Anda harus memesan dan melampirkan semua resource tersebut. Pemesanan yang Anda lampirkan harus menentukan jumlah dan jenis GPU dan disk SSD Lokal yang tepat sesuai komitmen Anda. Oleh karena itu, Anda juga tidak dapat memiliki jumlah atau jenis GPU atau disk SSD Lokal tambahan dalam reservasi yang dilampirkan. 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 yang berjenis NVIDIA P100. Dalam contoh ini, Anda tidak dapat melampirkan reservasi yang menentukan salah satu kombinasi resource berikut:
Membeli komitmen 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). Antara waktu pembelian komitmen dan waktu aktivasinya, status komitmen Anda tetap
NOT_YET_ACTIVE
(atauPENDING
di konsol Google Cloud). Setelah aktivasi, status komitmen Anda akan berubah menjadiACTIVE
. Misalnya, Anda membeli komitmen pada 20 Januari pukul 22.00 Waktu Pasifik AS dan Kanada (UTC-8 atau UTC-7). Compute Engine akan segera membuat commitmen Anda dengan statusNOT_YET_ACTIVE
. Namun, komitmen Anda akan menjadiACTIVE
hanya pada 21 Januari 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:
Melampirkan reservasi yang ada
Anda dapat melampirkan reservasi 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:
gcloud
Untuk membeli komitmen dengan melampirkan reservasi yang ada, jalankan perintah
gcloud compute commitments create
. Dalam perintah Anda, sertakan tanda--existing-reservation
untuk menentukan reservasi yang ada yang ingin Anda lampirkan ke komitmen Anda. Sertakan instance baru flag ini untuk setiap reservasi yang ada yang ingin Anda lampirkan. Anda dapat melampirkan sejumlah pemesanan yang ada ke komitmen Anda.Misalnya, untuk membeli komitmen dengan melampirkan dua reservasi ke dalamnya, jalankan perintah berikut:
gcloud compute commitments create COMMITMENT_NAME \ --region=REGION \ --project=PROJECT_ID \ --resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \ --resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \ --plan=DURATION \ --type=COMMITMENT_TYPE \ --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:
Contoh: Membeli komitmen dengan melampirkan reservasi yang ada
Misalnya, Anda memiliki dua reservasi
res-01
danres-02
di zonaus-central1-a
danus-central1-b
projectmyproject
. Misalkan pemesanan ini memiliki kapasitas gabungan untuk 4 GPU NVIDIA P100 dan 4 disk SSD Lokal. Untuk membeli komitmen baru di regionus-central1
project ini untuk disk SSD Lokal dan GPU ini, dan menggunakan reservasi yang ada ini sebagai reservasi terlampir, jalankan perintah berikut. Perhatikan bahwa contoh komitmen juga berisi vCPU dan memori.gcloud compute commitments create commitment-01 \ --region=us-central1 \ --project=myproject \ --resources=vcpu=96,memory=624GB,local-ssd=1500 \ --resources-accelerator=type=nvidia-tesla-p100,count=4 \ --plan 12-month \ --existing-reservation=name=res-01,zone=us-central1-a \ --existing-reservation=name=res-02,zone=us-central1-b
REST
Untuk membeli komitmen dengan melampirkan reservasi yang ada, buat permintaan
POST
ke metoderegionCommitments.insert
. Dalam permintaan Anda, sertakan kolomexistingReservations
untuk menentukan daftar yang dipisahkan koma dari semua reservasi yang ada yang ingin Anda lampirkan ke komitmen Anda. Anda dapat melampirkan sejumlah pemesanan yang ada ke komitmen Anda.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments { "name": "COMMITMENT_NAME", "plan": "DURATION", "type": COMMITMENT_TYPE, "resources": [ { "amount": "COMMITTED_VCPUS", "type": "VCPU" }, { "amount": "COMMITTED_MEMORY", "type": "MEMORY" }, { "acceleratorType": "COMMITTED_ACCELERATOR_TYPE", "amount": "COMMITTED_ACCELERATOR_COUNT", "type": "ACCELERATOR" } { "amount": "COMMITTED_LOCAL_SSD", "type": "LOCAL_SSD" } ], "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ", "existingReservations": "RESERVATION_URLs" }
Ganti kode berikut:
Contoh: Membeli komitmen dengan melampirkan reservasi yang ada
Misalnya, Anda memiliki dua reservasi
res-01
danres-02
di zonaus-central1-a
danus-central1-b
projectmyproject
. Misalkan pemesanan ini memiliki kapasitas gabungan untuk 4 GPU NVIDIA P100 dan 4 disk SSD Lokal. Untuk membeli komitmen baru di regionus-central1
project ini untuk GPU dan disk SSD Lokal ini serta menggunakan reservasi yang ada sebagai reservasi terlampir, buat permintaanPOST
berikut. Perhatikan bahwa contoh komitmen juga berisi vCPU dan memori.POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments { "name": "commitment-01", "plan": "TWELVE_MONTH", "type": "GENERAL_PURPOSE" "resources": [ { "amount": "96", "type": "VCPU" }, { "amount": "638976", "type": "MEMORY" }, { "acceleratorType": "nvidia-tesla-p100", "amount": "4", "type": "ACCELERATOR" }, { "amount": "1536000", "type": "LOCAL_SSD" } ], "existingReservations": [ "https://www.googleapis.com/compute/v1/projects/my-project/zone/us-central1-a/reservations/res-01", "https://www.googleapis.com/compute/v1/projects/my-project/zone/us-central1-b/reservations/res-02" ] }
Membuat reservasi baru untuk dilampirkan
Anda dapat membuat reservasi terlampir saat membeli komitmen menggunakan Konsol Google Cloud, Google Cloud CLI, atau REST.
Konsol
Sebelum membeli komitmen menggunakan Konsol Google Cloud, pilih project yang ingin Anda gunakan untuk membeli komitmen. Jika berbagi 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:
gcloud
Untuk membuat reservasi terlampir saat membeli komitmen, jalankan perintah
gcloud compute commitments create
.Bergantung pada apakah Anda ingin melampirkan satu pemesanan atau beberapa pemesanan, jalankan perintah dengan salah satu cara berikut:
Ganti kode berikut dengan properti yang sesuai dari komitmen dan pemesanan yang terlampir:
Komitmen
Reservasi yang dilampirkan
Compute Engine membuat komitmen dan pemesanan terlampir hanya jika ada cukup resource untuk jenis mesin yang ditentukan di zona target, dan kuota yang memadai, pada saat permintaan Anda dibuat. Jika pembelian 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 untuk membeli komitmen dengan membuat reservasi baru yang akan dilampirkan
Contoh skenario dan perintah berikut menunjukkan cara membeli komitmen untuk GPU, disk SSD Lokal, atau keduanya dengan membuat reservasi baru untuk dilampirkan ke komitmen tersebut.
Contoh 1: Membeli komitmen untuk GPU dengan melampirkan satu reservasi baru
Misalnya, Anda ingin membeli komitmen
commitment-01
di regionus-central1
yang mencakup 4 GPU NVIDIA V100. Anda ingin membuat pemesanan barureservation-01
sebagai pemesanan terlampir untuk GPU tersebut. Misalnya, Anda juga ingin menentukan Compute Engine untuk menggunakan GPU yang dicadangkan tersebut di 2 VMn1-standard-32
di zonaus-central1-a
. Untuk membeli contoh komitmen ini dengan reservasi terlampir, jalankan perintah berikut:gcloud compute commitments create commitment-01 \ --region=us-central1 \ --project=myproject \ --resources=vcpu=96,memory=624GB \ --resources-accelerator=type=nvidia-tesla-v100,count=4 \ --plan 12-month \ --reservation=reservation-01 \ --reservation-zone=us-central1-a \ --machine-type=n1-standard-32 \ --accelerator=type=nvidia-tesla-v100,count=2 \ --vm-count=2
Contoh 2: Membeli komitmen untuk GPU tanpa membeli komitmen untuk vCPU atau memori
Untuk membeli komitmen dan memesan GPU serta disk SSD Lokal tanpa membeli komitmen untuk vCPU atau memori, tentukan
0
sebagai nilai untuk jumlah vCPU dan memori. Misalnya, Anda ingin membeli komitmencommitment-02
untuk satu GPU NVIDIA P4 di regionus-west2
. Anda juga ingin membuat pemesanan baru sebagai pemesanan yang terpasang dan menentukan Compute Engine untuk menggunakan GPU yang direservasi di VMn1-standard-2
di zonaus-west2-b
. Untuk membeli contoh komitmen ini dengan pemesanan terlampir, jalankan perintah berikut:gcloud compute commitments create commitment-02 \ --region=us-west2 \ --project=myproject \ --resources=vcpu=0,memory=0 \ --resources-accelerator=type=nvidia-tesla-p4,count=1 \ --plan 12-month \ --reservation=reservation-01 \ --reservation-zone=us-west2-b \ --machine-type=n1-standard-2 \ --accelerator=type=nvidia-tesla-p4,count=1 \ --vm-count=1
Contoh 3: Membeli komitmen untuk GPU dan disk SSD Lokal dengan melampirkan beberapa reservasi baru
Misalnya, Anda ingin membeli komitmen
commitment-03
untuk 1 GPU NVIDIA V100 dan 2 disk SSD Lokal di regionus-central1
. Anda juga ingin membuat dan melampirkan dua reservasi di zonaus-central1-a
. Dalam pemesanan pertama,res-01
, Anda ingin memesan 1 VMn1-standard-2
dengan 1 GPU. Anda ingin menjadikanres-01
sebagai pemesanan yang ditargetkan, yang berarti Anda harus secara khusus menargetkan pemesanan tersebut berdasarkan nama untuk menggunakan VM yang direservasi. Dalam pemesanan kedua,res-02
, Anda ingin memesan 1 VMn1-standard-8
dengan 2 jenis disk SSD Lokal yang terpasang.Untuk membeli contoh komitmen ini dengan pemesanan terlampir, buat file YAML terlebih dahulu dengan properti kedua pemesanan.
- reservation: res-01 reservation_zone: us-central1-a require_specific_reservation: true vm_count: 1 machine_type: n1-standard-2 accelerator: - count: 1 type: nvidia-tesla-v100 - reservation: res-02 reservation_zone: us-central1-a vm_count: 1 machine_type: n1-standard-8 local_ssd: - interface: scsi size: 375 - interface: nvme size: 375
Setelah Anda membuat file YAML, untuk menyelesaikan pembelian komitmen dengan reservasi terlampir, jalankan perintah berikut. Perhatikan bahwa contoh komitmen juga berisi resource vCPU dan memori.
gcloud compute commitments create commitment-03 \ --region=us-central1 \ --project=myproject \ --resources=vcpu=96,memory=624,local-ssd=750 \ --resources-accelerator=type=nvidia-tesla-v100,count=1 \ --plan 12-month \ --reservations-from-file=YAML_FILE
REST
Untuk membuat pemesanan yang terlampir saat membeli komitmen, buat permintaan
POST
ke metoderegionCommitments.insert
. Dalam permintaan Anda, sertakan kolomreservations
untuk menentukan daftar semua reservasi baru yang ingin Anda buat dan lampirkan. Anda dapat melampirkan sejumlah pemesanan yang ada ke komitmen Anda.Ganti kode berikut dengan properti yang sesuai dari komitmen dan pemesanan yang terlampir:
Komitmen
Reservasi yang dilampirkan
Compute Engine membuat komitmen dan reservasi terlampir hanya jika ada cukup resource untuk jenis mesin yang ditentukan di zona target, dan kuota yang memadai, pada saat permintaan Anda dibuat. Jika pembelian Anda berhasil, Compute Engine akan menampilkan status
200
untuk permintaan REST API Anda.Contoh untuk membeli komitmen dengan membuat reservasi baru yang akan dilampirkan
Contoh skenario dan perintah berikut menunjukkan cara membeli komitmen untuk GPU, disk SSD Lokal, atau keduanya dengan membuat reservasi baru untuk dilampirkan ke komitmen tersebut.
Contoh 1: Membeli komitmen untuk GPU dengan melampirkan satu reservasi baru
Misalnya, Anda ingin membeli komitmen
commitment-01
di regionus-central1
yang mencakup 4 GPU NVIDIA V100. Anda ingin membuat pemesanan barureservation-01
sebagai pemesanan terlampir untuk GPU tersebut. Misalnya, Anda juga ingin menentukan Compute Engine untuk menggunakan GPU yang dicadangkan tersebut di 2 VMn1-standard-8
di zonaus-central1-a
. Untuk membeli contoh komitmen ini dengan reservasi terlampir, buat permintaanPOST
berikut:POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments { "name": "commitment-01", "plan": "TWELVE_MONTH", "type": "GENERAL_PURPOSE" "resources": [ { "amount": "96", "type": "VCPU" }, { "amount": "638976", "type": "MEMORY" }, { "acceleratorType": "nvidia-tesla-v100", "amount": "4", "type": "ACCELERATOR" } ], "reservations": [ { "name": "reservation-01", "specificReservation": { "count": "2", "instanceProperties": { "guestAccelerators": [ { "acceleratorCount": 2, "acceleratorType": "nvidia-tesla-v100" } ], "machineType": "n1-standard-8" } }, "specificReservationRequired": false, "zone": "us-central1-a" } ] }
Contoh 2: Membeli komitmen untuk GPU tanpa membeli komitmen untuk vCPU atau memori
Untuk membeli komitmen dan memesan GPU serta disk SSD Lokal tanpa membeli komitmen untuk vCPU atau memori, tentukan
0
sebagai nilai untuk jumlah vCPU dan memori. Misalnya, Anda ingin membeli komitmencommitment-02
untuk satu GPU NVIDIA P4 di regionus-west2
. Anda juga ingin membuat pemesanan baru sebagai pemesanan yang terpasang dan menentukan Compute Engine untuk menggunakan GPU yang direservasi di VMn1-standard-2
di zonaus-west2-b
. Untuk membeli contoh komitmen ini dengan pemesanan terlampir, buat permintaanPOST
berikut:POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-west2/commitments { "name": "commitment-02", "plan": "TWELVE_MONTH", "type": "GENERAL_PURPOSE", "resources": [ { "amount": "0", "type": "VCPU" }, { "amount": "0", "type": "MEMORY" }, { "acceleratorType": "nvidia-tesla-p4", "amount": "4", "type": "ACCELERATOR" } ], "reservations": [ { "name": "reservation-01", "specificReservation": { "count": "1", "instanceProperties": { "guestAccelerators": [ { "acceleratorCount": 4, "acceleratorType": "nvidia-tesla-p4" } ], "machineType": "n1-standard-2" } }, "specificReservationRequired": false, "zone": "us-west2-b" } ] }
Contoh 3: Membeli komitmen untuk GPU dan disk SSD Lokal dengan melampirkan beberapa reservasi baru
Misalnya, Anda ingin membeli komitmen
commitment-03
untuk 1 GPU NVIDIA V100 dan 2 disk SSD Lokal di regionus-central1
. Anda juga ingin membuat dan melampirkan dua reservasi di zonaus-central1-a
. Dalam pemesanan pertama,res-01
, Anda ingin memesan 1 VMn1-standard-2
dengan 1 GPU. Anda ingin menjadikanres-01
sebagai pemesanan yang ditargetkan, yang berarti Anda harus secara khusus menargetkan pemesanan tersebut berdasarkan nama untuk menggunakan VM yang direservasi. Dalam pemesanan kedua,res-02
, Anda ingin memesan 1 VMn1-standard-8
dengan 2 jenis disk SSD Lokal yang terpasang. Untuk membeli contoh komitmen ini dengan reservasi terlampir, buat permintaanPOST
berikut. Perhatikan bahwa contoh komitmen juga berisi resource vCPU dan memori.POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments { "name": "commitment-03", "plan": "TWELVE_MONTH", "type": "GENERAL_PURPOSE", "resources": [ { "amount": "96", "type": "VCPU" }, { "amount": "638976", "type": "MEMORY" }, { "acceleratorType": "nvidia-tesla-v100", "amount": "1", "type": "ACCELERATOR" }, { "amount": "768000", "type": "LOCAL_SSD" } ], "reservations": [ { "name": "res-01", "specificReservation": { "count": "1", "instanceProperties": { "guestAccelerators": [ { "acceleratorCount": 1, "acceleratorType": "nvidia-tesla-v100" } ], "machineType": "n1-standard-2" } }, "specificReservationRequired": true, "zone": "us-central1-a" }, { "name": "res-02", "specificReservation": { "count": "1", "instanceProperties": { "localSsds": [ { "diskSizeGb": "375", "interface": "SCSI" }, { "diskSizeGb": "375", "interface": "NVME" } ] "machineType": "n1-standard-8" } }, "specificReservationRequired": false, "zone": "us-central1-a" } ] }
Mengganti pemesanan yang terikat komitmen
Ganti pemesanan terlampir komitmen Anda yang sudah ada dengan pemesanan baru jika Anda ingin mengubah jenis dan jumlah VM yang menggunakan resource yang di-alokasikan.
Pemesanan pengganti akan selalu berupa pemesanan yang baru dibuat. Untuk mengganti pemesanan yang terlampir, Anda harus menentukan properti pemesanan yang ingin digunakan sebagai pengganti. Compute Engine kemudian akan otomatis membuat pemesanan baru dengan properti ini dan menggunakannya untuk mengganti pemesanan yang Anda lampirkan. Anda tidak dapat menggunakan pemesanan yang ada untuk mengganti pemesanan terlampir.
Perubahan yang diizinkan
Saat mengganti pemesanan yang ada di komitmen dengan pemesanan baru, Anda dapat meminta salah satu perubahan berikut:
Persyaratan
Saat mengganti pemesanan yang terlampir di komitmen Anda dengan pemesanan baru, permintaan Anda harus memenuhi semua persyaratan berikut:
Permintaan Anda untuk mengganti pemesanan juga bergantung pada ketersediaan kapasitas pada saat itu. Jika kapasitas untuk permintaan tidak tersedia, permintaan akan gagal dan menampilkan error ketersediaan resource, yang dapat Anda coba atasi dengan mengubah atau menunda permintaan. Untuk mengetahui informasi selengkapnya, lihat dokumentasi untuk memecahkan masalah ketersediaan resource.
Jika permintaan Anda untuk mengganti pemesanan yang terlampir gagal, pemesanan yang terlampir dan resource yang dipesan yang ada tetap tidak terpengaruh. Untuk mempertahankan kapasitas Anda, tunggu untuk membuat perubahan yang sesuai pada VM Anda hingga permintaan untuk mengganti pemesanan Anda berhasil.
Langkah-langkah untuk mengganti pemesanan yang terlampir
Anda dapat mengganti pemesanan komitmen menggunakan Google Cloud CLI atau REST.
gcloud
Untuk mengganti pemesanan yang terlampir dengan komitmen, lakukan tindakan berikut:
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 bernamares-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 danres-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 VMn1-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 VMn1-standard-4
, masing-masing dengan 1 GPU P100 dan 2 disk SSD Lokal dengan jenis antarmukascsi
.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 barures-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 VMn1-standard-4
yang dipesan)*16 vCPU dan 60 GB
(2 VMn1-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 VMn1-standard-4
, masing-masing dengan 1 GPU P100 dan 2 disk SSD Lokal dengan jenis antarmukascsi
.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 VMn1-standard-8
, masing-masing dengan 1 GPU P100 dan 4 disk SSD Lokal jenis antarmukascsi
. Selain itu,res-2
dibagikan dengan 2 project lainnya,project-1
danproject-2
, serta dimiliki oleh project saat ini,my-project
. Jenis mesinn1-standard-8
menggunakan 8 vCPU dan 30 GB untuk setiap VM.Untuk mengganti pemesanan
res-1
yang terlampir denganres-2
untuk komitmenmy-commitment-with-reservations
, lakukan tindakan berikut:REST
Untuk mengganti pemesanan yang terlampir dengan komitmen, buat permintaan
POST
menggunakan metoderegionCommitments.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
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 pemesanan saat ini.
Pemesanan pengganti
Untuk pemesanan pengganti, tetapkan properti berikut sesuai yang diperlukan. Pastikan Anda memenuhi semua persyaratan saat menentukan properti ini. Hapus kolom tambahan yang tidak ingin Anda gunakan.
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 komitmenmy-commitment-with-reservations
, yang dibeli dengan membuat permintaanPOST
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 danres-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 VMn1-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 VMn1-standard-4
, masing-masing dengan 1 GPU P100 dan 2 disk SSD Lokal dengan jenis antarmukascsi
.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 barures-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 VMn1-standard-4
yang dipesan)*16 vCPU dan 60 GB
(2 VMn1-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 VMn1-standard-4
, masing-masing dengan 1 GPU P100 dan 2 disk SSD Lokal dengan jenis antarmukascsi
.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 VMn1-standard-8
, masing-masing dengan 1 GPU P100 dan 4 disk SSD Lokal jenis antarmukascsi
. Selain itu,res-2
dibagikan dengan 2 project lainnya,project-1
danproject-2
, serta dimiliki oleh project saat ini,my-project
. Jenis mesinn1-standard-8
menggunakan 8 vCPU dan 30 GB untuk setiap VM.Untuk mengganti pemesanan terlampir
res-1
denganres-2
untuk komitmenmy-commitment-with-reservations
, buat permintaanPOST
berikut menggunakan metoderegionCommitments.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
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2024-12-22 UTC.
-