Dokumen ini menjelaskan cara membeli komitmen berbasis resource dengan pemesanan terlampir menggunakan konsol Google Cloud , gcloud CLI, atau REST.
Untuk mempelajari lebih lanjut cara kerja reservasi terlampir, lihat Melampirkan reservasi ke komitmen berbasis resource.
Untuk membeli komitmen untuk vCPU dan memori tanpa pemesanan terlampir, lihat Membeli komitmen berbasis resource tanpa pemesanan terlampir.
Sebelum memulai
-
Siapkan autentikasi jika Anda belum melakukannya.
Autentikasi memverifikasi identitas Anda untuk mengakses layanan Google Cloud dan API. Untuk menjalankan
kode atau contoh 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 dan API Google Cloud , Anda tidak perlu menyiapkan autentikasi.
gcloud
-
Instal Google Cloud CLI. Setelah penginstalan, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:
gcloud initJika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.
-
- Tetapkan region dan zona default.
REST
Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.
Instal Google Cloud CLI.
Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.
Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .
Peran yang diperlukan
Untuk mendapatkan izin yang
diperlukan guna membeli komitmen dan membuat pemesanan,
minta administrator untuk memberi Anda
peran IAM Compute Admin (roles/compute.admin) di project Anda.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Peran bawaan ini berisi izin yang diperlukan untuk membeli komitmen dan membuat pemesanan. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk membeli komitmen dan membuat pemesanan:
-
compute.commitments.create -
compute.reservations.create
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Secara default, pemilik project memiliki izin untuk membeli komitmen berbasis resource. Namun, pemilik dapat membuat peran khusus yang mencakup atau mengecualikan pengguna tertentu. Baca kontrol akses untuk memastikan Anda memiliki izin untuk membeli komitmen berbasis resource.
Membeli komitmen berbasis resource hardware dengan pemesanan terlampir
Saat membeli komitmen baru, Anda dapat melampirkan pemesanan ke komitmen dengan salah satu cara berikut:- Menggunakan pemesanan yang ada yang sesuai dengan properti komitmen
- Membuat pemesanan baru yang cocok saat membeli komitmen
Setelah Anda membeli komitmen, komitmen Anda akan aktif pada hari berikutnya pukul 00.00 Waktu Pasifik AS dan Kanada (UTC-8, atau UTC-7 selama waktu musim panas). Compute Engine mempertahankan lien pada project Anda untuk setiap region dalam project tempat Anda membeli komitmen. Saat Anda membeli komitmen baru untuk region mana pun dalam project, Compute Engine akan mengaitkan lien untuk region tersebut dengan komitmen yang baru dibuat.
Antara waktu pembelian komitmen dan waktu aktivasinya, status komitmen Anda tetap sebagai NOT_YET_ACTIVE (atau sebagai 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 segera membuat komitmen Anda dengan status NOT_YET_ACTIVE. Komitmen Anda akan menjadi 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 pemesanan 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 yang di-commit untuk jenis resource tersebut. Namun, persyaratan ini tidak berlaku jika Anda menentukan disk Titanium SSD lokal dalam komitmen Anda untuk digunakan dengan jenis mesin C4, C4A, C4D, C4N, G4, H4D, atau Z3.
Misalnya, jika Anda ingin membeli komitmen untuk 4 GPU V100 dan 2 disk SSD Lokal, pemesanan terlampir komitmen Anda harus menentukan total 4 GPU V100 dan 2 SSD Lokal. Jumlah vCPU dan memori yang Anda pesan dapat lebih banyak atau lebih sedikit daripada jumlah komitmen yang Anda beli. Namun, jika Anda menentukan 4 vCPU C4A dan 2 disk Titanium SSD lokal dalam komitmen, Anda tidak perlu melampirkan pemesanan apa pun ke komitmen tersebut.
Untuk GPU, beli komitmen untuk jenis GPU tertentu yang ingin digunakan. Misalnya, Anda dapat membeli komitmen untuk NVIDIA A100 atau NVIDIA V100, tetapi Anda tidak dapat menggunakan komitmen yang dibeli untuk GPU NVIDIA A100 untuk mencakup GPU NVIDIA V100.
Jika pemesanan terlampir Anda adalah pemesanan bersama dan Anda ingin menerima DA yang berlaku saat Anda menggunakan pemesanan tersebut di luar project komitmen, Anda harus melakukan kedua hal berikut:
- Bagikan pemesanan Anda hanya ke project lain yang termasuk dalam akun Penagihan Cloud yang sama dengan komitmen.
- Pastikan pembagian DA diaktifkan untuk akun Penagihan Cloud tersebut.
Melampirkan pemesanan 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 sebuah akun Penagihan Cloud, Anda dapat membeli komitmen menggunakan project mana pun dari akun Penagihan Cloud tersebut. Setelah memilih project, lakukan hal berikut:
Di konsol Google Cloud , buka halaman Committed use discounts. Buka halaman Diskon abonemen
Klik Purchase commitment. Halaman Purchase a commitment akan muncul.
Di kolom Name, masukkan nama untuk komitmen Anda.
Di kolom Region, pilih region tempat Anda ingin membeli komitmen.
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 Accelerator-optimized A2
- Untuk jenis mesin A3 Edge dan A3 High, pilih Accelerator-optimized A3
- Untuk jenis mesin A3 Mega, pilih Accelerator-optimized A3 Mega
- Untuk jenis mesin G2, pilih Graphics-optimized G2
- Untuk jenis mesin G4, pilih Graphics-optimized G4
- Untuk jenis mesin C2, pilih Compute-optimized C2
- Untuk jenis mesin C2D, pilih Compute-optimized C2D
- Untuk jenis mesin C3, pilih C3 Tujuan Umum
- Untuk jenis mesin C3D, pilih General-Purpose C3D
- Untuk jenis mesin C4, pilih General-Purpose C4
- Untuk jenis mesin C4A, pilih General-Purpose C4A
- Untuk jenis mesin C4D, pilih General-Purpose C4D
- Untuk jenis mesin C4N, pilih Network-optimized C4N
- Untuk jenis mesin N1, pilih N1 tujuan umum
- Untuk jenis mesin N2, pilih N2 tujuan umum
- Untuk jenis mesin N2D, pilih General-Purpose N2D
- Untuk jenis mesin M1, pilih Memory-optimized M1/M2
- Untuk jenis mesin M3, pilih dioptimalkan untuk memori M3
- Untuk jenis mesin Z3, pilih Storage-optimized Z3
- Untuk jenis mesin Z4D, pilih Storage-optimized Z4D
- Untuk jenis mesin Z4M, pilih Storage-optimized Z4M
Untuk melampirkan satu atau beberapa pemesanan yang ada ke komitmen, lakukan hal berikut:
Centang kotak Attach a new or existing reservation.
Klik Attach an existing reservation. Panel Attach existing reservations akan muncul dan menampilkan pemesanan dari project Anda. Daftar ini difilter agar sesuai dengan region dan jenis komitmen yang Anda tentukan.
Di panel Attach existing reservations, centang kotak untuk setiap pemesanan yang ingin Anda lampirkan.
Tinjau ringkasan resource untuk pemesanan yang Anda pilih, lalu klik Attach.
Setelah Anda melampirkan pemesanan, Compute Engine akan otomatis mengisi kolom di bagian Commitment details agar sesuai dengan jumlah dan jenis resource dari pemesanan yang Anda lampirkan. Jika Anda memasukkan nilai secara manual untuk resource apa pun di bagian Detail komitmen sebelum melampirkan pemesanan, nilai Anda akan ditimpa dengan nilai dari pemesanan.
Di bagian Commitment details, lakukan tindakan berikut:
Di kolom Cores, verifikasi nilai yang telah diisi otomatis. Atau, Anda dapat menentukan jumlah vCPU yang berbeda.
Di kolom Memory, verifikasi jumlah memori yang telah diisi otomatis dalam GB. Secara opsional, Anda dapat menentukan jumlah yang berbeda. Anda hanya dapat menentukan memori dalam kelipatan 0,25 GB. Untuk menentukan nilai memori kustom untuk komitmen Anda, gunakan gcloud CLI atau REST.
Luaskan bagian GPUs and local SSDs dan pastikan jenis dan jumlahnya cocok antara komitmen dan pemesanan yang dilampirkan, sebagai berikut:
Di kolom GPU type, verifikasi jenis GPU yang diisi otomatis.
Di kolom Number of GPUs, verifikasi jumlah GPU yang telah diisi otomatis.
Di kolom Local SSDs, verifikasi jumlah disk yang telah diisi otomatis.
Jika Anda menentukan nilai yang berbeda secara manual dari pemesanan yang dilampirkan untuk salah satu kolom ini, pembelian komitmen Anda tidak akan berhasil. Untuk semua GPU dan sebagian besar disk SSD Lokal, jumlah dan jenis total harus sama antara komitmen dan pemesanan yang dilampirkan.
Di bagian Term, lakukan tindakan berikut:
Untuk menentukan paket untuk komitmen Anda, pilih 1 tahun atau 3 tahun. Paket ini menentukan tarif CUD dan durasi jangka waktu preset komitmen Anda.
Tinjau kolom Tanggal mulai, yang menampilkan tanggal dan waktu saat komitmen Anda aktif. Kolom ini otomatis ditetapkan ke pukul 00.00 Waktu Pasifik AS dan Kanada pada hari setelah tanggal saat ini.
Opsional. Untuk memperpanjang masa berlaku komitmen Anda melebihi durasi masa berlaku yang telah ditetapkan oleh paket komitmen Anda, di kolom Tanggal akhir, tentukan tanggal akhir kustom untuk komitmen Anda. Untuk mengetahui informasi selengkapnya, lihat Memperpanjang jangka waktu komitmen.
Opsional. Jika Anda ingin komitmen Anda diperpanjang secara otomatis di akhir masa berlakunya, centang kotak Auto-renew commitment.
Di panel Summary, tinjau detail komitmen Anda dan potensi batasan kuota.
Untuk menyelesaikan pembelian komitmen, lakukan hal berikut:
Buka bagian bawah halaman.
Tinjau bagian Pengungkapan yang berisi informasi tentang biaya, kelayakan diskon, serta persyaratan dan ketentuan.
Untuk mengonfirmasi persetujuan Anda atas harga komitmen dan persyaratan spesifik per layanan, centang kotak.
Klik Purchase.
gcloud
Untuk membeli komitmen dengan melampirkan pemesanan yang ada, jalankan
perintah gcloud compute commitments create.
Dalam perintah Anda, sertakan flag --existing-reservation untuk menentukan pemesanan yang ada yang ingin Anda lampirkan ke komitmen. Sertakan instance baru flag ini untuk setiap pemesanan yang ada yang ingin Anda lampirkan. Anda dapat melampirkan sejumlah pemesanan yang ada ke komitmen Anda.
Misalnya, untuk membeli komitmen dengan melampirkan dua pemesanan, 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 Anda dan durasi jangka waktu yang telah ditetapkan. Tentukan12-monthatau36-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 adalah2024-04-20.COMMITMENT_TYPE: jenis komitmen. Jenis komitmen berikut menyediakan opsi untuk GPU, disk SSD Lokal, atau keduanya:- Untuk jenis mesin A2, gunakan
accelerator-optimized - Untuk jenis mesin A3 Edge dan A3 High, gunakan
accelerator-optimized-a3 - Untuk jenis mesin A3 Mega, gunakan
accelerator-optimized-a3-mega - Untuk jenis mesin G2, gunakan
graphics-optimized - Untuk jenis mesin G4, gunakan
graphics-optimized-g4 - Untuk jenis mesin C2, gunakan
compute-optimized - Untuk jenis mesin C2D, gunakan
compute-optimized-c2d - Untuk jenis mesin C3, gunakan
compute-optimized-c3 - Untuk jenis mesin C3D, gunakan
compute-optimized-c3d - Untuk jenis mesin N1, gunakan
general-purpose - Untuk jenis mesin C4, gunakan
general-purpose-c4 - Untuk jenis mesin C4A, gunakan
general-purpose-c4a - Untuk jenis mesin C4D, gunakan
general-purpose-c4d - Untuk jenis mesin C4N, gunakan
network-optimized-c4n - Untuk jenis mesin N2, gunakan
general-purpose-n2 - Untuk jenis mesin N2D, gunakan
general-purpose-n2d - Untuk jenis mesin M1, gunakan
memory-optimized - Untuk jenis mesin M3, gunakan
memory-optimized-m3 - Untuk jenis mesin Z3, gunakan
storage-optimized-z3 - Untuk jenis mesin Z4D, gunakan
storage-optimized-z4d - Untuk jenis mesin Z4M, gunakan
storage-optimized-z4m
- Untuk jenis mesin A2, gunakan
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,10240MBatau10GB. 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, dalam GB, ruang SSD Lokal 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.RESERVATION_NAME_1danRESERVATION_NAME_2: Nama pemesanan yang ada yang ingin Anda lampirkan ke komitmen.RESERVATION_ZONE_1danRESERVATION_ZONE_2: Zona pemesanan yang ada yang ingin Anda lampirkan ke komitmen.
Contoh: Membeli komitmen dengan melampirkan pemesanan yang ada
Misalkan Anda memiliki dua pemesanan res-01 dan res-02 di zona us-central1-a dan us-central1-b dari project myproject.
Misalkan pemesanan ini memiliki kapasitas gabungan untuk 4 GPU NVIDIA T4 dan 4 disk SSD Lokal. Untuk membeli komitmen baru di region us-central1 project ini untuk GPU dan disk SSD Lokal ini, serta menggunakan pemesanan yang ada ini sebagai pemesanan terlampir, jalankan perintah berikut. Komitmen ini menentukan 96 vCPU, memori 624 GB, 4 GPU NVIDIA T4, dan penyimpanan SSD Lokal 1.500 GB (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-t4,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 pemesanan yang ada, buat permintaan POST
ke metode regionCommitments.insert.
Dalam permintaan Anda, sertakan kolom existingReservations untuk menentukan daftar yang dipisahkan koma dari semua pemesanan 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 Anda dan durasi jangka waktu yang telah ditetapkan. TentukanTWELVE_MONTHatauTHIRTY_SIX_MONTH.COMMITMENT_TYPE: jenis komitmen. Jenis komitmen berikut menyediakan opsi untuk GPU, disk SSD Lokal, atau keduanya:- Untuk jenis mesin A2, gunakan
ACCELERATOR_OPTIMIZED - Untuk jenis mesin A3 Edge dan A3 High, gunakan
ACCELERATOR_OPTIMIZED_A3 - Untuk jenis mesin A3 Mega, gunakan
ACCELERATOR_OPTIMIZED_A3_MEGA - Untuk jenis mesin G2, gunakan
GRAPHICS_OPTIMIZED - Untuk jenis mesin G4, gunakan
GRAPHICS_OPTIMIZED_G4 - Untuk jenis mesin C2, gunakan
COMPUTE_OPTIMIZED - Untuk jenis mesin C2D, gunakan
COMPUTE_OPTIMIZED_C2D - Untuk jenis mesin C3, gunakan
COMPUTE_OPTIMIZED_C3 - Untuk jenis mesin C3D, gunakan
COMPUTE_OPTIMIZED_C3D - Untuk jenis mesin N1, gunakan
GENERAL_PURPOSE - Untuk jenis mesin C4, gunakan
GENERAL_PURPOSE_C4 - Untuk jenis mesin C4A, gunakan
GENERAL_PURPOSE_C4A - Untuk jenis mesin C4D, gunakan
GENERAL_PURPOSE_C4D - Untuk jenis mesin C4N, gunakan
NETWORK_OPTIMIZED_C4N - Untuk jenis mesin N2, gunakan
GENERAL_PURPOSE_N2 - Untuk jenis mesin N2D, gunakan
GENERAL_PURPOSE_N2D - Untuk jenis mesin M1, gunakan
MEMORY_OPTIMIZED - Untuk jenis mesin M3, gunakan
MEMORY_OPTIMIZED_M3 - Untuk jenis mesin Z3, gunakan
STORAGE_OPTIMIZED_Z3 - Untuk jenis mesin Z4D, gunakan
STORAGE_OPTIMIZED_Z4D - Untuk jenis mesin Z4M, gunakan
STORAGE_OPTIMIZED_Z4M
- Untuk jenis mesin A2, gunakan
COMMITTED_VCPUS: jumlah vCPU yang Anda inginkan dalam komitmen. Angka harus berupa bilangan bulat positif.COMMITTED_MEMORY: jumlah memori yang Anda inginkan dalam komitmen. 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 Anda.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: 12 AM 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 yang dipisahkan koma dari pemesanan yang ada yang ingin Anda lampirkan ke komitmen. Misalnya, untuk melampirkan dua pemesanan,res-1danres-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 pemesanan yang ada
Misalkan Anda memiliki dua pemesanan res-01 dan res-02 di zona us-central1-a dan us-central1-b dari project myproject.
Misalkan pemesanan ini memiliki kapasitas gabungan untuk 4 GPU NVIDIA T4 dan 4 disk SSD Lokal. Untuk membeli komitmen baru di region us-central1 project ini untuk GPU dan disk SSD Lokal ini, serta untuk menggunakan pemesanan yang ada ini sebagai pemesanan terlampir, buat permintaan POST berikut. Komitmen ini menentukan 96 vCPU, memori 624 GB, 4 GPU NVIDIA T4, dan penyimpanan SSD Lokal 1.500 GB.
Perlu diperhatikan bahwa nilai penyimpanan SSD Lokal harus ditentukan dalam GB. Untuk memori,
Anda harus menentukan nilainya 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-t4",
"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 pemesanan 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 sebuah akun Penagihan Cloud, Anda dapat membeli komitmen menggunakan project mana pun dari akun Penagihan Cloud tersebut. Setelah memilih project, lakukan hal berikut:
Di konsol Google Cloud , buka halaman Committed use discounts. Buka halaman Diskon abonemen
Klik Purchase commitment. Halaman Purchase a commitment akan muncul.
Di kolom Name, masukkan nama untuk komitmen Anda.
Di kolom Region, pilih region tempat Anda ingin membeli komitmen.
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 Accelerator-optimized A2
- Untuk jenis mesin A3 Edge dan A3 High, pilih Accelerator-optimized A3
- Untuk jenis mesin A3 Mega, pilih Accelerator-optimized A3 Mega
- Untuk jenis mesin G2, pilih Graphics-optimized G2
- Untuk jenis mesin G4, pilih Graphics-optimized G4
- Untuk jenis mesin C2, pilih Compute-optimized C2
- Untuk jenis mesin C2D, pilih Compute-optimized C2D
- Untuk jenis mesin C3, pilih C3 Tujuan Umum
- Untuk jenis mesin C3D, pilih General-Purpose C3D
- Untuk jenis mesin C4, pilih General-Purpose C4
- Untuk jenis mesin C4A, pilih General-Purpose C4A
- Untuk jenis mesin C4D, pilih General-Purpose C4D
- Untuk jenis mesin C4N, pilih Network-optimized C4N
- Untuk jenis mesin N1, pilih N1 tujuan umum
- Untuk jenis mesin N2, pilih N2 tujuan umum
- Untuk jenis mesin N2D, pilih General-Purpose N2D
- Untuk jenis mesin M1, pilih Memory-optimized M1/M2
- Untuk jenis mesin M3, pilih dioptimalkan untuk memori M3
- Untuk jenis mesin Z3, pilih Storage-optimized Z3
- Untuk jenis mesin Z4D, pilih Storage-optimized Z4D
- Untuk jenis mesin Z4M, pilih Storage-optimized Z4M
Untuk membuat pemesanan baru dan melampirkannya ke komitmen, lakukan tindakan berikut:
Centang kotak Attach a new or existing reservation.
Klik Create new reservation. Panel Create a new reservation akan muncul.
Di kolom Name, masukkan nama untuk pemesanan.
Opsional: Di kolom Description, masukkan deskripsi.
Di kolom Zone, pilih zona tempat Anda ingin resource yang dipesan tersedia.
Di bagian Share type, tentukan cara Anda ingin membagikan pemesanan ini:
- Untuk membuat reservasi project tunggal, pilih Local.
- Untuk membuat pemesanan yang dibagikan dengan beberapa project, pilih Shared. Kemudian, klik Add projects dan pilih project yang Anda inginkan.
Di bagian Google Cloud Services, tentukan apakah akan membagikan pemesanan ini ke layanan lain seperti Google Kubernetes Engine atau Vertex AI.
Di bagian Use with VM instance, pilih cara yang Anda inginkan agar VM menggunakan reservasi Anda:
- Agar VM dengan properti yang cocok dapat otomatis menggunakan pemesanan ini, pilih Use reservation automatically.
- Untuk menggunakan resource dari pemesanan ini hanya saat ditargetkan secara spesifik berdasarkan nama, pilih Select specific reservation.
Di bagian Resource details, lakukan hal berikut:
Di kolom Number of VM instances, masukkan jumlah VM.
Di bagian Machine configuration, tentukan properti dengan memilih Machine type. Pilih jenis mesin dari daftar, atau pilih Custom untuk menentukan jumlah Cores dan jumlah Memory.
Opsional: Jika Anda ingin memesan GPU, klik Add GPU, lalu tentukan GPU type dan Number of GPUs untuk setiap VM.
Opsional: Jika Anda ingin memesan disk SSD Lokal, tentukan Jumlah disk dan Jenis antarmuka.
Opsional: Jika Anda ingin menentukan kebijakan penempatan grup, pilih atau buat kebijakan dalam daftar Group placement policy.
Untuk menyelesaikan penetapan properti pemesanan ini, klik Create and attach.
Opsional: Jika Anda ingin membuat dan melampirkan lebih banyak pemesanan baru, klik Create new reservation lagi dan ulangi langkah-langkah ini.
Setelah Anda melampirkan pemesanan, Compute Engine akan otomatis mengisi kolom di bagian Commitment details agar sesuai dengan jumlah dan jenis resource dari pemesanan yang Anda lampirkan. Jika Anda memasukkan nilai secara manual untuk resource apa pun di bagian Detail komitmen sebelum melampirkan pemesanan, nilai Anda akan ditimpa dengan nilai dari pemesanan.
Di bagian Commitment details, lakukan tindakan berikut:
Di kolom Cores, verifikasi nilai yang telah diisi otomatis. Atau, Anda dapat menentukan jumlah vCPU yang berbeda.
Di kolom Memory, verifikasi jumlah memori yang telah diisi otomatis dalam GB. Secara opsional, Anda dapat menentukan jumlah yang berbeda. Anda hanya dapat menentukan memori dalam kelipatan 0,25 GB. Untuk menentukan nilai memori kustom untuk komitmen Anda, gunakan gcloud CLI atau REST.
Luaskan bagian GPUs and local SSDs dan pastikan jenis dan jumlahnya cocok antara komitmen dan pemesanan yang dilampirkan, sebagai berikut:
Di kolom GPU type, verifikasi jenis GPU yang diisi otomatis.
Di kolom Number of GPUs, verifikasi jumlah GPU yang telah diisi otomatis.
Di kolom Local SSDs, verifikasi jumlah disk yang telah diisi otomatis.
Jika Anda menentukan nilai yang berbeda secara manual dari pemesanan yang dilampirkan untuk salah satu kolom ini, pembelian komitmen Anda tidak akan berhasil. Untuk semua GPU dan sebagian besar disk SSD Lokal, jumlah dan jenis total harus sama antara komitmen dan pemesanan yang dilampirkan.
Di bagian Term, lakukan tindakan berikut:
Untuk menentukan paket untuk komitmen Anda, pilih 1 tahun atau 3 tahun. Paket ini menentukan tarif CUD dan durasi jangka waktu preset komitmen Anda.
Tinjau kolom Tanggal mulai, yang menampilkan tanggal dan waktu saat komitmen Anda aktif. Kolom ini otomatis ditetapkan ke pukul 00.00 Waktu Pasifik AS dan Kanada pada hari setelah tanggal saat ini.
Opsional. Untuk memperpanjang masa berlaku komitmen Anda melebihi durasi masa berlaku yang telah ditetapkan oleh paket komitmen Anda, di kolom Tanggal akhir, tentukan tanggal akhir kustom untuk komitmen Anda. Untuk mengetahui informasi selengkapnya, lihat Memperpanjang jangka waktu komitmen.
Opsional. Jika Anda ingin komitmen Anda diperpanjang secara otomatis di akhir masa berlakunya, centang kotak Auto-renew commitment.
Di panel Summary, tinjau detail komitmen Anda dan potensi batasan kuota.
Untuk menyelesaikan pembelian komitmen, lakukan hal berikut:
Buka bagian bawah halaman.
Tinjau bagian Pengungkapan yang berisi informasi tentang biaya, kelayakan diskon, serta persyaratan dan ketentuan.
Untuk mengonfirmasi persetujuan Anda atas harga komitmen dan persyaratan spesifik per layanan, centang kotak.
Klik Purchase.
gcloud
Untuk membuat pemesanan 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:
Untuk membuat dan melampirkan satu pemesanan ke komitmen Anda, tentukan properti pemesanan yang dilampirkan 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_2Untuk membuat dan melampirkan beberapa pemesanan 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 pemesanan 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 pemesanan terlampir. Misalnya, untuk menentukan konfigurasi pemesanan 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 local_ssd: - 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_2Untuk menentukan konfigurasi beberapa pemesanan, ulangi properti ini untuk setiap pemesanan yang ingin Anda buat. Anda dapat melampirkan sejumlah pemesanan yang ada yang Anda inginkan ke komitmen Anda.
Jalankan perintah
gcloud compute commitments createdan sertakan flag--reservations-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 yang sesuai dan pemesanan yang dilampirkan:
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 Anda dan durasi jangka waktu yang telah ditetapkan. Tentukan12-monthatau36-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 adalah2024-04-20.COMMITMENT_TYPE: jenis komitmen. Jenis komitmen berikut menyediakan opsi untuk GPU, disk SSD Lokal, atau keduanya:- Untuk jenis mesin A2, gunakan
accelerator-optimized - Untuk jenis mesin A3 Edge dan A3 High, gunakan
accelerator-optimized-a3 - Untuk jenis mesin A3 Mega, gunakan
accelerator-optimized-a3-mega - Untuk jenis mesin G2, gunakan
graphics-optimized - Untuk jenis mesin G4, gunakan
graphics-optimized-g4 - Untuk jenis mesin C2, gunakan
compute-optimized - Untuk jenis mesin C2D, gunakan
compute-optimized-c2d - Untuk jenis mesin C3, gunakan
compute-optimized-c3 - Untuk jenis mesin C3D, gunakan
compute-optimized-c3d - Untuk jenis mesin N1, gunakan
general-purpose - Untuk jenis mesin C4, gunakan
general-purpose-c4 - Untuk jenis mesin C4A, gunakan
general-purpose-c4a - Untuk jenis mesin C4D, gunakan
general-purpose-c4d - Untuk jenis mesin C4N, gunakan
network-optimized-c4n - Untuk jenis mesin N2, gunakan
general-purpose-n2 - Untuk jenis mesin N2D, gunakan
general-purpose-n2d - Untuk jenis mesin M1, gunakan
memory-optimized - Untuk jenis mesin M3, gunakan
memory-optimized-m3 - Untuk jenis mesin Z3, gunakan
storage-optimized-z3 - Untuk jenis mesin Z4D, gunakan
storage-optimized-z4d - Untuk jenis mesin Z4M, gunakan
storage-optimized-z4m
- Untuk jenis mesin A2, gunakan
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,10GBatau10240MB. 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 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.YAML_FILE: Jalur ke file YAML yang berisi konfigurasi pemesanan terlampir.
Pemesanan terlampir
RESERVATION_NAME: nama pemesanan terlampir.RESERVATION_ZONE: zona pemesanan terlampir.REQUIRE_SPECIFIC_RESERVATION_VALUE: menentukan apakah pemesanan yang dilampirkan adalah pemesanan yang ditargetkan secara khusus;trueataufalse. 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 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, tentukann2untuk 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_1danINTERFACE_2: jenis antarmuka yang Anda inginkan untuk digunakan disk SSD Lokal bagi setiap VM yang dipesan. Opsi yang valid adalah:scsidannvme. Ulangi parameterlocal_ssduntuk 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 sebagaiprojectsjika Anda ingin membagikan pemesanan terlampir ke beberapa project konsumen. Kecualikan kolom ini jika Anda ingin membuat reservasi project tunggal.CONSUMER_PROJECT_ID_1danCONSUMER_PROJECT_ID_2: project ID dari project yang dapat membagikan pemesanan ini, misalnyaproject-1danproject-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 project tunggal.
Compute Engine membuat komitmen dan pemesanan terlampir hanya jika ada cukup resource untuk jenis mesin yang ditentukan di zona target, serta kuota yang memadai, pada saat permintaan Anda dibuat. Jika pembelian berhasil, Anda akan melihat pesan berhasil 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 pemesanan baru untuk dilampirkan ke komitmen tersebut.
Contoh 1: Membeli komitmen untuk GPU dengan melampirkan satu pemesanan baru
Misalnya, 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 pemesanan baru reservation-01 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 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-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 pemesanan baru reservation-01 di
zona us-west2-b yang memesan 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 pemesanan baru
Misalnya, Anda ingin membeli komitmen 1 tahun untuk resource tujuan umum (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 (cocok 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 yang ditargetkan. Dalam pemesanan kedua, res-02, Anda
ingin memesan 1 VM n1-standard-8 (dengan 8 vCPU, memori 30 GB) dan
memasang 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 Anda membuat file YAML, untuk menyelesaikan pembelian komitmen dengan
pemesanan terlampir, 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
pemesanan baru yang ingin Anda buat dan lampirkan. Anda dapat melampirkan sejumlah pemesanan yang ada yang Anda inginkan ke komitmen Anda.
Untuk membuat pemesanan baru dengan menentukan semua properti VM secara manual, sertakan kolom
instancePropertiesdan 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": "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": "INTERFACE_1" }, { "diskSizeGb": "375", "interface": "INTERFACE_2" } ], "machineType": "RESERVED_MACHINE_TYPE", "minCpuPlatform": "MINIMUM_CPU_PLATFORM" } }, "specificReservationRequired": "REQUIRE_SPECIFIC_RESERVATION_VALUE", "zone": "RESERVATION_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
sourceInstanceTemplatedan kecualikan kolominstanceProperties.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": "RESERVATION_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 yang sesuai dan pemesanan yang dilampirkan:
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 Anda dan durasi jangka waktu yang telah ditetapkan. TentukanTWELVE_MONTHatauTHIRTY_SIX_MONTH.COMMITMENT_TYPE: jenis komitmen. Jenis komitmen berikut menyediakan opsi untuk GPU, disk SSD Lokal, atau keduanya:- Untuk jenis mesin A2, gunakan
ACCELERATOR_OPTIMIZED - Untuk jenis mesin A3 Edge dan A3 High, gunakan
ACCELERATOR_OPTIMIZED_A3 - Untuk jenis mesin A3 Mega, gunakan
ACCELERATOR_OPTIMIZED_A3_MEGA - Untuk jenis mesin G2, gunakan
GRAPHICS_OPTIMIZED - Untuk jenis mesin G4, gunakan
GRAPHICS_OPTIMIZED_G4 - Untuk jenis mesin C2, gunakan
COMPUTE_OPTIMIZED - Untuk jenis mesin C2D, gunakan
COMPUTE_OPTIMIZED_C2D - Untuk jenis mesin C3, gunakan
COMPUTE_OPTIMIZED_C3 - Untuk jenis mesin C3D, gunakan
COMPUTE_OPTIMIZED_C3D - Untuk jenis mesin N1, gunakan
GENERAL_PURPOSE - Untuk jenis mesin C4, gunakan
GENERAL_PURPOSE_C4 - Untuk jenis mesin C4A, gunakan
GENERAL_PURPOSE_C4A - Untuk jenis mesin C4D, gunakan
GENERAL_PURPOSE_C4D - Untuk jenis mesin C4N, gunakan
NETWORK_OPTIMIZED_C4N - Untuk jenis mesin N2, gunakan
GENERAL_PURPOSE_N2 - Untuk jenis mesin N2D, gunakan
GENERAL_PURPOSE_N2D - Untuk jenis mesin M1, gunakan
MEMORY_OPTIMIZED - Untuk jenis mesin M3, gunakan
MEMORY_OPTIMIZED_M3 - Untuk jenis mesin Z3, gunakan
STORAGE_OPTIMIZED_Z3 - Untuk jenis mesin Z4D, gunakan
STORAGE_OPTIMIZED_Z4D - Untuk jenis mesin Z4M, gunakan
STORAGE_OPTIMIZED_Z4M
- Untuk jenis mesin A2, gunakan
COMMITTED_VCPUS: jumlah vCPU yang Anda inginkan dalam komitmen. Angka harus berupa bilangan bulat positif.COMMITTED_MEMORY: jumlah memori yang Anda inginkan dalam komitmen. 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 Anda.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 adalah2024-04-20.END_TIME: 12 AM 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:
Pemesanan terlampir
RESERVATION_NAME: nama pemesanan terlampir.RESERVATION_ZONE: zona pemesanan terlampir.REQUIRE_SPECIFIC_RESERVATION_VALUE: menentukan apakah pemesanan yang dilampirkan adalah pemesanan yang ditargetkan secara khusus;trueataufalse. 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 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, tentukann2untuk 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_1danINTERFACE_2: jenis antarmuka yang Anda ingin digunakan disk SSD Lokal untuk setiap VM yang dipesan. Opsi yang valid adalah:scsidannvme. Ulangi parameterlocalSsdsuntuk 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 pemesanan terlampir.SHARE_SETTING: jenis berbagi untuk pemesanan terlampir. Tentukan kolom ini dengan nilai sebagaiSPECIFIC_PROJECTSjika Anda ingin membagikan pemesanan terlampir ke beberapa project konsumen. Kecualikan kolom ini jika Anda ingin membuat reservasi project tunggal.CONSUMER_PROJECT_ID_1danCONSUMER_PROJECT_ID_2: project ID dari project yang dapat membagikan pemesanan ini; misalnya,project-1danproject-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 reservasi project tunggal.
Compute Engine hanya akan membuat komitmen dan pemesanan terlampir jika ada cukup resource untuk jenis mesin yang ditentukan di zona target, serta kuota yang memadai pada saat permintaan Anda dibuat. Jika pembelian Anda berhasil, Compute Engine akan menampilkan status 200 untuk permintaan REST API Anda.
Contoh
Contoh skenario dan perintah berikut menunjukkan cara membeli komitmen untuk GPU, disk SSD Lokal, atau keduanya dengan membuat pemesanan baru untuk dilampirkan ke komitmen tersebut.
Contoh 1: Membeli komitmen untuk GPU dengan melampirkan satu pemesanan baru
Misalnya, Anda ingin membeli komitmen 1 tahun untuk resource untuk tujuan umum di region us-central1 yang mencakup 96 vCPU, memori 624 GB (setara dengan 638.976 MB), dan 4 GPU NVIDIA V100.
Anda ingin membuat pemesanan 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 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, 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 pemesanan baru reservation-01
di zona us-west2-b yang memesan 1 VM n1-standard-2 (dengan 2 vCPU,
memori 7,5 GB, dan 4 GPU NVIDIA P4) untuk dilampirkan ke komitmen. Untuk membeli contoh komitmen ini dengan pemesanan 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-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 pemesanan baru
Misalnya, Anda ingin membeli komitmen 1 tahun untuk resource tujuan umum di region us-central1, dengan 96 vCPU, memori 624 GB (setara dengan 638.976 MB), 1 GPU NVIDIA V100, dan penyimpanan SSD Lokal sebesar 750 GB. Anda juga ingin membuat dan melampirkan dua pemesanan di zona us-central1-a. Dalam pemesanan pertama, res-01, Anda ingin memesan 1 VM n1-standard-2 (dengan 2 vCPU, memori 7,5 GB, dan 1 GPU NVIDIA V100); ini adalah pemesanan yang ditargetkan. Dalam pemesanan kedua, res-02, Anda ingin memesan 1 VM n1-standard-8 (dengan 8 vCPU, memori 30 GB) dan memasang 2 disk SSD Lokal (satu antarmuka SCSI, satu antarmuka NVMe). Untuk membeli contoh komitmen ini dengan pemesanan terlampir, buat permintaan POST berikut. Perlu diperhatikan bahwa nilai penyimpanan SSD Lokal harus ditentukan dalam GB.
Untuk memori, Anda harus menentukan nilainya 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"
}
]
}