Dokumen ini menjelaskan cara membeli komitmen berbasis resource dengan pemesanan terlampir menggunakan konsol Google Cloud , gcloud CLI, atau REST.
Untuk mempelajari lebih lanjut cara kerja reservasi terlampir, lihat Melampirkan reservasi ke komitmen berbasis resource.
Untuk membeli komitmen untuk vCPU dan memori tanpa reservasi terlampir, lihat Membeli komitmen berbasis resource tanpa reservasi terlampir.
Sebelum memulai
-
Siapkan autentikasi jika Anda belum melakukannya.
Autentikasi memverifikasi identitas Anda untuk mengakses layanan Google Cloud dan API. Untuk menjalankan
kode atau sampel dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke
Compute Engine dengan memilih salah satu opsi berikut:
Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:
Konsol
Saat menggunakan konsol Google Cloud untuk mengakses layanan Google Cloud dan API, Anda tidak perlu menyiapkan autentikasi.
gcloud
-
Instal Google Cloud CLI. Setelah penginstalan, 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 reservasi,
minta administrator untuk memberi Anda peran IAM
Compute Admin (roles/compute.admin) di project Anda.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Peran bawaan ini berisi izin yang diperlukan untuk membeli komitmen dan membuat reservasi. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk membeli komitmen dan membuat reservasi:
-
compute.commitments.create -
compute.reservations.create
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Secara default, pemilik project memiliki izin untuk membeli komitmen berbasis resource. Namun, pemilik dapat membuat peran khusus yang mencakup atau mengecualikan pengguna tertentu. Baca kontrol akses untuk memastikan bahwa Anda memiliki izin untuk membeli komitmen berbasis resource.
Membeli komitmen berbasis resource hardware dengan reservasi terlampir
Saat membeli komitmen baru, Anda dapat melampirkan pemesanan ke komitmen dengan salah satu cara berikut:- Menggunakan pemesanan yang ada yang cocok dengan properti komitmen
- Membuat reservasi pencocokan baru saat membeli komitmen
Setelah Anda membeli komitmen, komitmen tersebut akan aktif pada hari berikutnya pukul 00.00 Waktu Pasifik AS dan Kanada (UTC-8, atau UTC-7 selama waktu musim panas). Compute Engine mempertahankan hak gadai pada project Anda untuk setiap region di project Anda tempat Anda membeli komitmen. Saat Anda membeli komitmen baru untuk region mana pun di project Anda, Compute Engine akan mengaitkan hak gadai untuk region tersebut dengan komitmen yang baru dibuat.
Antara waktu pembelian komitmen dan waktu aktivasinya, status komitmen Anda tetap NOT_YET_ACTIVE (atau PENDING di konsolGoogle Cloud ). Setelah aktivasi, status komitmen Anda akan berubah menjadi
ACTIVE.
Misalnya, Anda membeli komitmen pada 20 Januari 2024, pukul 22.00 Waktu Pasifik AS dan Kanada (UTC-8 atau UTC-7). Compute Engine akan langsung membuat komitmen Anda dengan statusnya sebagai NOT_YET_ACTIVE. Komitmen Anda akan ACTIVE pada 21 Januari 2024, pukul 00.00 Waktu Pasifik AS dan Kanada (UTC-8 atau UTC-7).
Persyaratan
Sebelum membeli komitmen dengan pemesanan terlampir, tinjau persyaratan ini dan pastikan komitmen dan pemesanan Anda memenuhi kriteria berikut:
- Anda harus membeli komitmen dan membuat pemesanan terlampir di project dan region yang sama.
- Anda harus membeli komitmen dan membuat pemesanan terlampir untuk resource dari seri kelompok mesin yang sama.
- Jika komitmen Anda menentukan jenis resource yang memerlukan pemesanan terlampir, Anda harus menonaktifkan opsi hapus otomatis pada pemesanan terlampir. Pelajari lebih lanjut jenis resource yang memerlukan reservasi terlampir.
- Jika komitmen Anda memiliki GPU, jenis GPU yang ditentukan dalam reservasi dan komitmen harus cocok.
Untuk GPU dan sebagian besar disk SSD Lokal, jumlah resource yang dipesan untuk setiap jenis resource harus sama persis dengan jumlah resource terpakai untuk jenis resource tersebut. Namun, persyaratan ini tidak berlaku jika Anda menentukan disk SSD Titanium lokal dalam komitmen untuk digunakan dengan jenis mesin C4, C4A, C4D, C4N, G4, H4D, atau Z3.
Misalnya, jika Anda ingin membeli komitmen untuk 4 GPU V100 dan 2 disk SSD Lokal, pemesanan terlampir komitmen Anda harus menentukan total 4 GPU V100 dan 2 SSD Lokal. Jumlah vCPU dan memori yang Anda pesan dapat lebih banyak atau lebih sedikit daripada jumlah komitmen yang Anda beli. Namun, jika Anda menentukan 4 vCPU C4A dan 2 disk SSD Titanium lokal dalam komitmen, Anda tidak perlu melampirkan reservasi apa pun ke komitmen.
Untuk GPU, beli komitmen untuk jenis GPU tertentu yang ingin digunakan. Misalnya, Anda dapat membeli komitmen untuk NVIDIA P100 atau NVIDIA V100, tetapi Anda tidak dapat menggunakan komitmen yang dibeli untuk GPU NVIDIA P100 untuk mencakup GPU NVIDIA V100.
Jika pemesanan terlampir adalah pemesanan bersama dan Anda ingin menerima CUD yang berlaku saat menggunakan pemesanan tersebut di luar project komitmen, Anda harus melakukan kedua hal berikut:
- Bagikan pemesanan Anda hanya ke project yang termasuk dalam akun Penagihan Cloud yang sama dengan komitmen.
- Pastikan pembagian CUD diaktifkan untuk akun Penagihan Cloud tersebut.
Melampirkan reservasi yang ada
Anda dapat melampirkan pemesanan yang ada saat membeli komitmen menggunakan konsol Google Cloud , Google Cloud CLI, atau REST.
Konsol
Sebelum membeli komitmen menggunakan konsol Google Cloud , pilih project yang ingin Anda gunakan untuk membeli komitmen. Jika berbagi DAS diaktifkan untuk akun Penagihan Cloud, Anda dapat membeli komitmen menggunakan project mana pun dari akun Penagihan Cloud tersebut. Setelah memilih project, lakukan hal berikut:
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 A2 yang dioptimalkan akselerator
- Untuk jenis mesin A3 Edge dan A3 High, pilih A3 yang dioptimalkan akselerator
- Untuk jenis mesin A3 Mega, pilih A3 Mega yang dioptimalkan untuk akselerator
- Untuk jenis mesin G2, pilih G2 yang dioptimalkan untuk grafis
- Untuk jenis mesin G4, pilih G4 yang dioptimalkan untuk grafis
- Untuk jenis mesin C2, pilih C2 yang dioptimalkan untuk komputasi
- Untuk jenis mesin C2D, pilih C2D yang dioptimalkan untuk komputasi
- Untuk jenis mesin C3, pilih General-Purpose C3
- Untuk jenis mesin C3D, pilih General-Purpose C3D
- Untuk jenis mesin C4, pilih General-Purpose C4
- Untuk jenis mesin C4A, pilih General-Purpose C4A
- Untuk jenis mesin C4D, pilih General-Purpose C4D
- Untuk jenis mesin C4N, pilih Network-optimized C4N
- Untuk jenis mesin N1, pilih N1 tujuan umum
- Untuk jenis mesin N2, pilih N2 Tujuan Umum
- Untuk jenis mesin N2D, pilih N2D Tujuan Umum
- Untuk jenis mesin M1, pilih M1/M2 yang dioptimalkan untuk memori
- Untuk jenis mesin M3, pilih M3 yang dioptimalkan untuk memori
- Untuk jenis mesin Z3, pilih Z3 yang dioptimalkan untuk penyimpanan
Untuk melampirkan satu atau beberapa reservasi yang ada ke komitmen, lakukan tindakan berikut:
Pilih kotak centang Lampirkan reservasi baru atau yang sudah ada.
Klik Lampirkan reservasi yang ada. Panel Lampirkan reservasi yang ada akan muncul dan menampilkan reservasi dari project Anda. Daftar ini difilter agar sesuai dengan region dan jenis komitmen yang Anda tentukan.
Di panel Attach existing reservations, centang kotak untuk setiap reservasi yang ingin Anda lampirkan.
Tinjau ringkasan resource untuk reservasi yang Anda pilih, lalu klik Lampirkan.
Setelah Anda melampirkan reservasi, Compute Engine akan otomatis mengisi kolom di bagian Commitment details agar sesuai dengan jumlah dan jenis resource dari reservasi yang Anda lampirkan. Jika Anda memasukkan nilai secara manual untuk resource apa pun di bagian Detail komitmen sebelum melampirkan reservasi, nilai Anda akan digantikan dengan nilai dari reservasi.
Di bagian Commitment details, lakukan hal berikut:
Di kolom Cores, verifikasi nilai yang sudah diisi. 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 dapat menentukan memori hanya dengan kelipatan 0,25 GB. Untuk menentukan nilai memori kustom untuk komitmen, gunakan gcloud CLI atau REST.
Luaskan bagian GPU dan SSD lokal, lalu pastikan jenis dan jumlahnya sama antara komitmen dan reservasi terlampir, sebagai berikut:
Di kolom GPU type, verifikasi jenis GPU yang telah diisi sebelumnya.
Di kolom Number of GPUs, verifikasi jumlah GPU yang telah diisi sebelumnya.
Di kolom Local SSDs, verifikasi jumlah disk yang sudah diisi sebelumnya.
Jika Anda secara manual menentukan nilai yang berbeda dari reservasi terlampir untuk salah satu kolom ini, pembelian komitmen Anda tidak akan berhasil. Untuk semua GPU dan sebagian besar disk SSD Lokal, jumlah dan jenis totalnya harus sama antara komitmen dan pemesanan terlampir Anda.
Di bagian Term, lakukan tindakan berikut:
Untuk menentukan paket untuk komitmen Anda, pilih 1 tahun atau 3 tahun. Paket menentukan tarif CUD dan durasi jangka waktu preset komitmen Anda.
Tinjau kolom Tanggal mulai, yang menampilkan tanggal dan waktu saat komitmen Anda menjadi aktif. Kolom ini otomatis disetel ke pukul 00.00 Waktu Pasifik AS dan Kanada pada hari setelah tanggal saat ini.
Opsional. Untuk memperpanjang masa berlaku komitmen di luar durasi masa berlaku preset yang ditentukan oleh paket komitmen, di kolom Tanggal berakhir, tentukan tanggal berakhir kustom untuk komitmen Anda. Untuk mengetahui informasi selengkapnya, lihat Memperpanjang jangka waktu komitmen.
Opsional. Jika Anda ingin komitmen diperpanjang secara otomatis di akhir jangka waktunya, centang kotak Perpanjang komitmen secara otomatis.
Di panel Ringkasan, tinjau detail komitmen dan potensi batasan kuota.
Untuk menyelesaikan pembelian komitmen, lakukan langkah-langkah berikut:
Buka bagian bawah halaman.
Tinjau bagian Pengungkapan yang berisi informasi tentang biaya, kelayakan diskon, serta persyaratan dan ketentuan.
Untuk mengonfirmasi penerimaan Anda atas harga komitmen dan persyaratan khusus layanan, centang kotak.
Klik Purchase.
gcloud
Untuk membeli komitmen dengan melampirkan reservasi yang ada, jalankan
perintah gcloud compute commitments create.
Dalam perintah, sertakan tanda --existing-reservation untuk menentukan reservasi yang ada yang ingin Anda lampirkan ke komitmen. Sertakan instance baru flag ini untuk setiap reservasi yang ada yang ingin Anda pasang. Anda dapat melampirkan sejumlah pemesanan yang ada ke komitmen Anda.
Misalnya, untuk membeli komitmen dengan melampirkan dua reservasi ke komitmen tersebut, jalankan perintah berikut:
gcloud compute commitments create COMMITMENT_NAME \
--region=REGION \
--project=PROJECT_ID \
--resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \
--resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \
--plan=PLAN \
--type=COMMITMENT_TYPE \
--custom-end-time=CUSTOM_END_DATE \
--existing-reservation=name='RESERVATION_NAME_1',zone='RESERVATION_ZONE_1' \
--existing-reservation=name='RESERVATION_NAME_2',zone='RESERVATION_ZONE_2'
Ganti kode berikut:
COMMITMENT_NAME: nama komitmen.REGION: region tempat komitmen berada.PROJECT_ID: ID project tempat Anda ingin membeli komitmen dengan pemesanan terlampir.PLAN: paket komitmen, yang menentukan tarif CUD dan durasi jangka waktu preset Anda. Tentukan12-monthatau36-month.CUSTOM_END_DATE: Opsional. Tanggal akhir kustom untuk jangka waktu Anda, yang harus diformat sebagaiYYYY-MM-DD. Misalnya, untuk menentukan tanggal berakhir kustom 20 April 2024, formatnya sebagai2024-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 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 ruang SSD Lokal dalam GB yang Anda inginkan dalam komitmen Anda.COMMITTED_ACCELERATOR_COUNT: jumlah GPU yang Anda inginkan dalam komitmen.COMMITTED_ACCELERATOR_TYPE: jenis GPU yang Anda inginkan dalam komitmen Anda.RESERVATION_NAME_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 reservasi yang ada
Misalkan Anda memiliki dua reservasi res-01 dan res-02 di zona us-central1-a dan us-central1-b project myproject.
Misalkan, reservasi ini memiliki kapasitas gabungan untuk 4 GPU NVIDIA P100
dan 4 disk SSD Lokal. Untuk membeli komitmen baru di region us-central1 project ini untuk GPU dan disk SSD Lokal ini, dan menggunakan reservasi yang ada ini sebagai reservasi terlampir, jalankan perintah berikut. Komitmen ini menentukan 96 vCPU, 624 GB
memori, 4 GPU NVIDIA P100, dan 1.500 GB penyimpanan SSD Lokal
(setara dengan 4 disk SSD Lokal). Nilai penyimpanan SSD Lokal harus
ditentukan dalam GB (misalnya, 375GB). Untuk gcloud CLI, Anda
dapat menentukan memori dalam MB atau GB. Jika Anda tidak menentukan unit, Compute Engine akan menggunakan GB sebagai unit default. Namun, perhatikan bahwa saat Anda menggunakan REST, Compute Engine menggunakan MB sebagai unit default.
gcloud compute commitments create commitment-01 \
--region=us-central1 \
--project=myproject \
--resources=vcpu=96,memory=624GB,local-ssd=1500 \
--resources-accelerator=type=nvidia-tesla-p100,count=4 \
--plan 12-month \
--existing-reservation=name=res-01,zone=us-central1-a \
--existing-reservation=name=res-02,zone=us-central1-b
REST
Untuk membeli komitmen dengan melampirkan reservasi yang ada, buat permintaan POST
ke metode regionCommitments.insert.
Dalam permintaan Anda, sertakan kolom existingReservations untuk menentukan
daftar yang dipisahkan koma dari semua reservasi yang ada yang ingin Anda
lampirkan ke komitmen Anda. Anda dapat melampirkan sejumlah pemesanan yang ada ke komitmen Anda.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments
{
"name": "COMMITMENT_NAME",
"plan": "PLAN",
"type": "COMMITMENT_TYPE",
"resources":
[
{
"amount": "COMMITTED_VCPUS",
"type": "VCPU"
},
{
"amount": "COMMITTED_MEMORY",
"type": "MEMORY"
},
{
"acceleratorType": "COMMITTED_ACCELERATOR_TYPE",
"amount": "COMMITTED_ACCELERATOR_COUNT",
"type": "ACCELERATOR"
},
{
"amount": "COMMITTED_LOCAL_SSD",
"type": "LOCAL_SSD"
}
],
"customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
"existingReservations": "RESERVATION_URLs"
}
Ganti kode berikut:
COMMITMENT_NAME: nama komitmen.REGION: region tempat komitmen berada.PROJECT_ID: ID project tempat Anda ingin membeli komitmen dengan pemesanan terlampir.PLAN: paket komitmen, yang menentukan tarif CUD dan durasi jangka waktu preset Anda. 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 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 Anda. Untuk REST, Compute Engine menggunakan MB sebagai unit default. Namun, perhatikan bahwa saat Anda menggunakan gcloud CLI, Compute Engine menggunakan GB sebagai unit default.COMMITTED_LOCAL_SSD: jumlah penyimpanan SSD Lokal dalam GB yang Anda inginkan dalam komitmen.COMMITTED_ACCELERATOR_COUNT: jumlah GPU yang Anda inginkan dalam komitmen.COMMITTED_ACCELERATOR_TYPE: jenis GPU yang Anda inginkan dalam komitmen Anda.CUSTOM_END_DATE: Opsional. Tanggal akhir kustom untuk jangka waktu Anda, yang harus diformat 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. 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 reservasi yang ada yang ingin Anda lampirkan ke komitmen. Misalnya, untuk melampirkan dua reservasi,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 reservasi yang ada
Misalkan Anda memiliki dua reservasi res-01 dan res-02 di zona us-central1-a dan us-central1-b project myproject.
Misalkan, reservasi ini memiliki kapasitas gabungan untuk 4 GPU NVIDIA P100
dan 4 disk SSD Lokal. Untuk membeli komitmen baru di region
us-central1 project ini untuk GPU dan disk SSD Lokal ini, serta
menggunakan reservasi yang ada ini sebagai reservasi terlampir, buat permintaan
POST berikut. Komitmen ini menentukan 96 vCPU, 624 GB
memori, 4 GPU NVIDIA P100, dan 1.500 GB penyimpanan SSD Lokal.
Perhatikan bahwa nilai penyimpanan SSD Lokal harus ditentukan dalam GB. Untuk memori, Anda harus menentukan nilai dalam MB. Namun, perhatikan bahwa saat Anda menggunakan gcloud CLI, Compute Engine menggunakan GB sebagai unit default untuk memori.
POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments
{
"name": "commitment-01",
"plan": "TWELVE_MONTH",
"type": "GENERAL_PURPOSE",
"resources":
[
{
"amount": "96",
"type": "VCPU"
},
{
"amount": "638976",
"type": "MEMORY"
},
{
"acceleratorType": "nvidia-tesla-p100",
"amount": "4",
"type": "ACCELERATOR"
},
{
"amount": "1500",
"type": "LOCAL_SSD"
}
],
"existingReservations":
[
"https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/res-01",
"https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-b/reservations/res-02"
]
}
Membuat reservasi baru untuk dilampirkan
Anda dapat membuat pemesanan terlampir saat membeli komitmen menggunakan konsol Google Cloud , Google Cloud CLI, atau REST.
Konsol
Sebelum membeli komitmen menggunakan konsol Google Cloud , pilih project yang ingin Anda gunakan untuk membeli komitmen. Jika berbagi DAS diaktifkan untuk akun Penagihan Cloud, Anda dapat membeli komitmen menggunakan project mana pun dari akun Penagihan Cloud tersebut. Setelah memilih project, lakukan hal berikut:
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 A2 yang dioptimalkan akselerator
- Untuk jenis mesin A3 Edge dan A3 High, pilih A3 yang dioptimalkan akselerator
- Untuk jenis mesin A3 Mega, pilih A3 Mega yang dioptimalkan untuk akselerator
- Untuk jenis mesin G2, pilih G2 yang dioptimalkan untuk grafis
- Untuk jenis mesin G4, pilih G4 yang dioptimalkan untuk grafis
- Untuk jenis mesin C2, pilih C2 yang dioptimalkan untuk komputasi
- Untuk jenis mesin C2D, pilih C2D yang dioptimalkan untuk komputasi
- Untuk jenis mesin C3, pilih General-Purpose C3
- Untuk jenis mesin C3D, pilih General-Purpose C3D
- Untuk jenis mesin C4, pilih General-Purpose C4
- Untuk jenis mesin C4A, pilih General-Purpose C4A
- Untuk jenis mesin C4D, pilih General-Purpose C4D
- Untuk jenis mesin C4N, pilih Network-optimized C4N
- Untuk jenis mesin N1, pilih N1 tujuan umum
- Untuk jenis mesin N2, pilih N2 Tujuan Umum
- Untuk jenis mesin N2D, pilih N2D Tujuan Umum
- Untuk jenis mesin M1, pilih M1/M2 yang dioptimalkan untuk memori
- Untuk jenis mesin M3, pilih M3 yang dioptimalkan untuk memori
- Untuk jenis mesin Z3, pilih Z3 yang dioptimalkan untuk penyimpanan
Untuk membuat reservasi baru dan melampirkannya ke komitmen, lakukan tindakan berikut:
Pilih kotak centang Lampirkan reservasi baru atau yang sudah ada.
Klik Buat reservasi baru. Panel Buat reservasi baru akan muncul.
Di kolom Nama, masukkan nama untuk reservasi.
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 reservasi ini:
- Untuk membuat reservasi satu project, pilih Lokal.
- Untuk membuat reservasi yang dibagikan dengan beberapa project, pilih Dibagikan. Kemudian, klik Tambahkan project dan pilih project yang Anda inginkan.
Di bagian Google Cloud Services, tentukan apakah akan membagikan reservasi ini dengan layanan lain seperti Google Kubernetes Engine atau Vertex AI.
Di bagian Gunakan dengan instance VM, pilih cara yang Anda inginkan agar VM menggunakan reservasi Anda:
- Untuk mengizinkan VM dengan properti yang cocok otomatis menggunakan reservasi ini, pilih Gunakan reservasi secara otomatis.
- Untuk menggunakan resource dari pemesanan ini hanya saat secara khusus ditargetkan berdasarkan nama, pilih Select specific reservation.
Di bagian Detail resource, lakukan hal berikut:
Di kolom Number of VM instances, masukkan jumlah VM.
Di bagian Konfigurasi mesin, tentukan properti dengan memilih Jenis mesin. Pilih jenis mesin dari daftar, atau pilih Kustom untuk menentukan jumlah Inti dan jumlah Memori.
Opsional: Jika Anda ingin mencadangkan GPU, klik Tambahkan GPU, lalu tentukan Jenis GPU dan Jumlah GPU 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, maka dalam daftar Kebijakan penempatan grup, pilih atau buat kebijakan.
Untuk menyelesaikan penentuan properti pemesanan ini, klik Buat dan lampirkan.
Opsional: Jika Anda ingin membuat dan melampirkan lebih banyak reservasi baru, klik Buat reservasi baru lagi dan ulangi langkah-langkah ini.
Setelah Anda melampirkan reservasi, Compute Engine akan otomatis mengisi kolom di bagian Commitment details agar sesuai dengan jumlah dan jenis resource dari reservasi yang Anda lampirkan. Jika Anda memasukkan nilai secara manual untuk resource apa pun di bagian Detail komitmen sebelum melampirkan reservasi, nilai Anda akan digantikan dengan nilai dari reservasi.
Di bagian Commitment details, lakukan hal berikut:
Di kolom Cores, verifikasi nilai yang sudah diisi. 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 dapat menentukan memori hanya dengan kelipatan 0,25 GB. Untuk menentukan nilai memori kustom untuk komitmen, gunakan gcloud CLI atau REST.
Luaskan bagian GPU dan SSD lokal, lalu pastikan jenis dan jumlahnya sama antara komitmen dan reservasi terlampir, sebagai berikut:
Di kolom GPU type, verifikasi jenis GPU yang telah diisi sebelumnya.
Di kolom Number of GPUs, verifikasi jumlah GPU yang telah diisi sebelumnya.
Di kolom Local SSDs, verifikasi jumlah disk yang sudah diisi sebelumnya.
Jika Anda secara manual menentukan nilai yang berbeda dari reservasi terlampir untuk salah satu kolom ini, pembelian komitmen Anda tidak akan berhasil. Untuk semua GPU dan sebagian besar disk SSD Lokal, jumlah dan jenis totalnya harus sama antara komitmen dan pemesanan terlampir Anda.
Di bagian Term, lakukan tindakan berikut:
Untuk menentukan paket untuk komitmen Anda, pilih 1 tahun atau 3 tahun. Paket menentukan tarif CUD dan durasi jangka waktu preset komitmen Anda.
Tinjau kolom Tanggal mulai, yang menampilkan tanggal dan waktu saat komitmen Anda menjadi aktif. Kolom ini otomatis disetel ke pukul 00.00 Waktu Pasifik AS dan Kanada pada hari setelah tanggal saat ini.
Opsional. Untuk memperpanjang masa berlaku komitmen di luar durasi masa berlaku preset yang ditentukan oleh paket komitmen, di kolom Tanggal berakhir, tentukan tanggal berakhir kustom untuk komitmen Anda. Untuk mengetahui informasi selengkapnya, lihat Memperpanjang jangka waktu komitmen.
Opsional. Jika Anda ingin komitmen diperpanjang secara otomatis di akhir jangka waktunya, centang kotak Perpanjang komitmen secara otomatis.
Di panel Ringkasan, tinjau detail komitmen dan potensi batasan kuota.
Untuk menyelesaikan pembelian komitmen, lakukan langkah-langkah berikut:
Buka bagian bawah halaman.
Tinjau bagian Pengungkapan yang berisi informasi tentang biaya, kelayakan diskon, serta persyaratan dan ketentuan.
Untuk mengonfirmasi penerimaan Anda atas harga komitmen dan persyaratan khusus layanan, centang kotak.
Klik Purchase.
gcloud
Untuk membuat reservasi terlampir saat membeli komitmen, jalankan
perintah gcloud compute commitments create.
Bergantung pada apakah Anda ingin melampirkan satu atau beberapa pemesanan, jalankan perintah dengan salah satu cara berikut:
Untuk membuat dan melampirkan satu reservasi ke komitmen, tentukan properti reservasi terlampir dengan menjalankan perintah berikut:
gcloud compute commitments create COMMITMENT_NAME \ --region=REGION \ --project=PROJECT_ID \ --plan PLAN \ --type COMMITMENT_TYPE --resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \ --resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \ --custom-end-time=CUSTOM_END_DATE \ --reservation=RESERVATION_NAME \ --reservation-zone=RESERVATION_ZONE \ --machine-type=RESERVED_MACHINE_TYPE \ --require-specific-reservation=REQUIRE_SPECIFIC_RESERVATION_VALUE \ --vm-count=NUMBER_OF_RESERVED_VMs \ --accelerator=type=RESERVED_ACCELERATOR_TYPE,count=RESERVED_ACCELERATOR_COUNT \ --local-ssd=interface=INTERFACE_1,size=375 \ --local-ssd=interface=INTERFACE_2,size=375 \ --minimum-cpu-platform=MINIMUM_CPU_PLATFORM \ --share-setting=SHARE_SETTING \ --share-with=CONSUMER_PROJECT_ID_1,CONSUMER_PROJECT_ID_2Untuk membuat dan melampirkan beberapa reservasi ke komitmen, tentukan properti reservasi menggunakan file YAML, lalu tentukan file YAML tersebut dalam perintah yang Anda gunakan untuk membeli komitmen. Jika ingin, Anda juga dapat menggunakan pendekatan file YAML ini untuk membuat dan melampirkan satu reservasi ke komitmen Anda. Untuk membuat pemesanan terlampir menggunakan pendekatan ini, lakukan hal berikut:
Buat file YAML di direktori saat ini dan tentukan konfigurasi yang Anda inginkan untuk setiap pemesanan terlampir. Misalnya, untuk menentukan konfigurasi reservasi bersama yang dibagikan dengan dua project yang menentukan GPU, dua disk SSD Lokal, dan platform CPU minimum, sertakan teks berikut dalam file YAML Anda:
- reservation: RESERVATION_NAME reservation_zone: RESERVATION_ZONE require_specific_reservation: REQUIRE_SPECIFIC_RESERVATION_VALUE vm_count: NUMBER_OF_RESERVED_VMs machine_type: RESERVED_MACHINE_TYPE accelerator: - count: RESERVED_ACCELERATOR_COUNT type: RESERVED_ACCELERATOR_TYPE localssd: - interface: INTERFACE_1 size: 375 - interface: INTERFACE_2 size: 375 project: OWNER_PROJECT_ID minimum-cpu-platform: MINIMUM_CPU_PLATFORM share-setting: SHARE_SETTING share-with: - CONSUMER_PROJECT_ID_1 - CONSUMER_PROJECT_ID_2Untuk menentukan konfigurasi beberapa reservasi, ulangi properti ini untuk setiap reservasi yang ingin Anda buat. Anda dapat melampirkan sejumlah pemesanan yang ada ke komitmen Anda.
Jalankan perintah
gcloud compute commitments createdan sertakan flag--reservation-from-file.gcloud compute commitments create COMMITMENT_NAME \ --region REGION \ --project PROJECT_ID \ --plan PLAN \ --type COMMITMENT_TYPE \ --resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \ --resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \ --reservations-from-file=YAML_FILE
Ganti kode berikut dengan properti komitmen dan pemesanan terlampir yang sesuai:
Komitmen
COMMITMENT_NAME: nama komitmen.REGION: region tempat komitmen berada.PROJECT_ID: ID project tempat Anda ingin membeli komitmen dengan pemesanan terlampir.PLAN: paket komitmen, yang menentukan tarif CUD dan durasi jangka waktu preset Anda. Tentukan12-monthatau36-month.CUSTOM_END_DATE: Opsional. Tanggal akhir kustom untuk jangka waktu Anda, yang harus diformat sebagaiYYYY-MM-DD. Misalnya, untuk menentukan tanggal berakhir kustom 20 April 2024, formatnya sebagai2024-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 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 satuan, Compute Engine akan menggunakan GB sebagai satuan default. Namun, perhatikan bahwa saat Anda menggunakan REST, Compute Engine menggunakan MB sebagai unit default.COMMITTED_LOCAL_SSD: jumlah penyimpanan SSD Lokal, yang harus ditentukan dalam GB; misalnya,375GB.COMMITTED_ACCELERATOR_COUNT: jumlah GPU yang Anda inginkan dalam komitmen.COMMITTED_ACCELERATOR_TYPE: jenis GPU yang Anda inginkan dalam komitmen Anda.YAML_FILE: Jalur ke file YAML yang berisi konfigurasi pemesanan terlampir.
Reservasi yang dilampirkan
RESERVATION_NAME: nama pemesanan terlampir.RESERVATION_ZONE: zona pemesanan terlampir.REQUIRE_SPECIFIC_RESERVATION_VALUE: menentukan apakah pemesanan terlampir adalah pemesanan yang ditargetkan secara khusus;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 dalam pemesanan terlampir Anda.- Untuk jenis mesin yang telah ditentukan, gunakan format
MACHINE_FAMILY-standard-CPUS; misalnya,n2-standard-4. Untuk jenis mesin kustom, gunakan format
MACHINE_FAMILY-custom-CPUS-MEMORY; 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 terlampir.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 untuk 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 tetapkan 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 pemesanan satu project.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 satu project.
Compute Engine akan membuat komitmen dan pemesanan terlampir hanya jika ada cukup resource untuk jenis mesin yang ditentukan di zona target, serta kuota yang memadai pada saat permintaan Anda dibuat. Jika pembelian Anda berhasil, Anda akan melihat pesan sukses yang mirip dengan berikut ini:
Created[https://www.googleapis.com/compute/v1/projects/your-project/regions/your-region/commitments/your-commitment-name]
Contoh
Contoh skenario dan perintah berikut menunjukkan cara membeli komitmen untuk GPU, disk SSD Lokal, atau keduanya dengan membuat reservasi baru untuk dilampirkan ke komitmen tersebut.
Contoh 1: Membeli komitmen untuk GPU dengan melampirkan satu reservasi baru
Misalkan Anda ingin membeli komitmen 1 tahun untuk resource tujuan umum (atau resource GPU) di region us-central1 dengan 96 vCPU, memori 624 GB, dan 4 GPU NVIDIA V100. Anda ingin membuat
reservasi reservation-01 baru di zona us-central1-a yang memesan 2
VM n1-standard-32 (setiap VM dengan 32 vCPU, memori 120 GB, dan
2 GPU NVIDIA V100) untuk menggunakan resource yang di-commit ini. Untuk membeli contoh komitmen ini dengan pemesanan terlampirnya, jalankan perintah berikut. Untuk gcloud CLI, Anda dapat menentukan memori dalam MB atau GB.
Jika Anda tidak menentukan satuan, Compute Engine akan menggunakan GB sebagai satuan default. Namun, perhatikan bahwa saat Anda menggunakan REST,
Compute Engine menggunakan MB sebagai unit default.
gcloud compute commitments create commitment-01 \
--region=us-central1 \
--project=myproject \
--resources=vcpu=96,memory=624GB \
--resources-accelerator=type=nvidia-tesla-v100,count=4 \
--plan 12-month \
--reservation=reservation-01 \
--reservation-zone=us-central1-a \
--machine-type=n1-standard-32 \
--accelerator=type=nvidia-tesla-v100,count=2 \
--vm-count=2
Contoh 2: Membeli komitmen untuk GPU tanpa menentukan vCPU atau memori
Untuk membeli komitmen dan memesan GPU dan disk SSD Lokal tanpa membeli komitmen untuk vCPU atau memori, tentukan 0 sebagai nilai untuk jumlah vCPU dan memori.
Misalnya, Anda ingin membeli komitmen 1 tahun untuk resource GPU di region us-west2 dengan 0 vCPU, memori 0 GB, dan 1 GPU NVIDIA P4. Anda juga ingin membuat reservasi baru reservation-01 di zona us-west2-b yang mencadangkan 1 VM n1-standard-2 (dengan 2 vCPU, memori 7,5 GB, dan 1 GPU NVIDIA P4) untuk dilampirkan ke komitmen. Untuk
membeli contoh komitmen ini dengan pemesanan terlampirnya, jalankan
perintah berikut. Untuk gcloud CLI, Anda dapat menentukan memori dalam
MB atau GB. Jika Anda tidak menentukan unit, Compute Engine akan menggunakan GB
sebagai unit default. Namun, perhatikan bahwa saat Anda menggunakan REST,
Compute Engine menggunakan MB sebagai unit default.
gcloud compute commitments create commitment-02 \
--region=us-west2 \
--project=myproject \
--resources=vcpu=0,memory=0 \
--resources-accelerator=type=nvidia-tesla-p4,count=1 \
--plan 12-month \
--reservation=reservation-01 \
--reservation-zone=us-west2-b \
--machine-type=n1-standard-2 \
--accelerator=type=nvidia-tesla-p4,count=1 \
--vm-count=1
Contoh 3: Membeli komitmen untuk GPU dan disk SSD Lokal dengan melampirkan beberapa reservasi baru
Misalkan Anda ingin membeli komitmen 1 tahun untuk resource serbaguna (atau resource GPU dan SSD Lokal) di region us-central1. Anda menginginkan komitmen untuk 96 vCPU, memori 624 GB, 1 GPU NVIDIA V100, dan penyimpanan SSD Lokal 750 GB (sesuai dengan 2 disk SSD Lokal).
Anda juga ingin membuat dan melampirkan dua pemesanan di zona us-central1-a. Dalam pemesanan pertama, res-01, Anda ingin memesan 1 VM n1-standard-2 (dengan 2 vCPU, memori 7,5 GB, dan 1 GPU NVIDIA V100); ini adalah pemesanan tertarget. Pada pemesanan kedua, res-02, Anda
ingin memesan 1 VM n1-standard-8 (dengan 8 vCPU, memori 30 GB) dan
melampirkan 2 disk SSD Lokal (satu antarmuka SCSI, satu antarmuka NVMe).
Untuk membeli contoh komitmen ini dengan pemesanan terlampir, pertama-tama buat file YAML dengan properti kedua pemesanan sebagai berikut:
- reservation: res-01
reservation_zone: us-central1-a
require_specific_reservation: true
vm_count: 1
machine_type: n1-standard-2
accelerator:
- count: 1
type: nvidia-tesla-v100
- reservation: res-02
reservation_zone: us-central1-a
vm_count: 1
machine_type: n1-standard-8
local_ssd:
- interface: scsi
size: 375
- interface: nvme
size: 375
Setelah membuat file YAML, untuk menyelesaikan pembelian komitmen dengan
reservasi terlampirnya, jalankan perintah berikut. Nilai penyimpanan SSD Lokal harus ditentukan dalam GB (misalnya, 375GB). Untuk gcloud CLI, Anda dapat menentukan memori dalam MB atau GB. Jika Anda tidak
menentukan unit, Compute Engine akan menggunakan GB sebagai unit
default. Namun, perhatikan bahwa saat Anda menggunakan REST, Compute Engine
menggunakan MB sebagai unit default untuk memori.
gcloud compute commitments create commitment-03 \
--region=us-central1 \
--project=myproject \
--resources=vcpu=96,memory=624,local-ssd=750 \
--resources-accelerator=type=nvidia-tesla-v100,count=1 \
--plan 12-month \
--reservations-from-file=YAML_FILE
REST
Untuk membuat pemesanan terlampir saat membeli komitmen,
buat permintaan POST ke
metode regionCommitments.insert.
Dalam permintaan Anda, sertakan kolom reservations untuk menentukan daftar semua reservasi baru yang ingin Anda buat dan lampirkan. Anda dapat melampirkan sejumlah pemesanan yang ada ke komitmen.
Untuk membuat reservasi baru dengan menentukan semua properti VM secara manual, sertakan kolom
instancePropertiesdan kecualikan kolomsourceInstanceTemplate.Misalnya, untuk menentukan konfigurasi pemesanan bersama yang dibagikan dengan dua project yang menentukan GPU, dua disk SSD Lokal, dan platform CPU minimum secara manual, buat permintaan berikut:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments { "name": "COMMITMENT_NAME", "plan": "PLAN", "type": "COMMITMENT_TYPE", "resources": [ { "amount": "COMMITTED_VCPUS", "type": "VCPU" }, { "amount": "COMMITTED_MEMORY", "type": "MEMORY" }, { "acceleratorType": "COMMITTED_ACCELERATOR_TYPE", "amount": "COMMITTED_ACCELERATOR_COUNT", "type": "ACCELERATOR" }, { "amount": "COMMITTED_LOCAL_SSD", "type": "LOCAL_SSD" } ], "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ", "reservations": [ { "name": "RESERVATION_NAME", "specificReservation": { "count": "NUMBER_OF_RESERVED_VMS", "instanceProperties": { "guestAccelerators": [ { "acceleratorCount": "RESERVED_ACCELERATOR_COUNT", "acceleratorType": "RESERVED_ACCELERATOR_TYPE" } ], "localSsds": [ { "diskSizeGb": "375", "interface": "RESERVED_INTERFACE_1" }, { "diskSizeGb": "375", "interface": "RESERVED_INTERFACE_2" } ], "machineType": "RESERVED_MACHINE_TYPE", "minCpuPlatform": "MINIMUM_CPU_PLATFORM" } }, "specificReservationRequired": "REQUIRE_SPECIFIC_RESERVATION_VALUE", "zone": "RESERVED_ZONE", "shareSettings": { "shareType": "SPECIFIC_PROJECTS", "projectMap": { "CONSUMER_PROJECT_ID_1": { "projectId": "CONSUMER_PROJECT_ID_1" }, "CONSUMER_PROJECT_ID_2": { "projectId": "CONSUMER_PROJECT_ID_2" } } } } ] }Untuk membuat reservasi baru dengan menentukan template instance, sertakan kolom
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": "RESERVED_ZONE", "shareSettings": { "shareType": "SPECIFIC_PROJECTS", "projectMap": { "CONSUMER_PROJECT_ID_1": { "projectId": "CONSUMER_PROJECT_ID_1" }, "CONSUMER_PROJECT_ID_2": { "projectId": "CONSUMER_PROJECT_ID_2" } } } } ] }
Ganti kode berikut dengan properti komitmen dan pemesanan terlampir yang sesuai:
Komitmen
COMMITMENT_NAME: nama komitmen.REGION: region tempat komitmen berada.PROJECT_ID: ID project tempat Anda ingin membeli komitmen dengan pemesanan terlampir.PLAN: paket komitmen, yang menentukan tarif CUD dan durasi jangka waktu preset Anda. 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 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 Anda. Untuk REST, Compute Engine menggunakan MB sebagai unit default. Namun, perhatikan bahwa saat Anda menggunakan gcloud CLI, Compute Engine menggunakan GB sebagai unit default.COMMITTED_LOCAL_SSD: jumlah penyimpanan SSD Lokal dalam GB yang Anda inginkan dalam komitmen.COMMITTED_ACCELERATOR_COUNT: jumlah GPU yang Anda inginkan dalam komitmen.COMMITTED_ACCELERATOR_TYPE: jenis GPU yang Anda inginkan dalam komitmen Anda.CUSTOM_END_DATE: Opsional. Tanggal akhir kustom untuk jangka waktu Anda, yang harus diformat sebagaiYYYY-MM-DD. Misalnya, untuk menentukan tanggal berakhir 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. Tentukan salah satu nilai berikut:- Selama waktu musim panas:
07:00:00 - Pada waktu lainnya:
08:00:00
- Selama waktu musim panas:
Reservasi yang dilampirkan
RESERVATION_NAME: nama pemesanan terlampir.RESERVATION_ZONE: zona pemesanan terlampir.REQUIRE_SPECIFIC_RESERVATION_VALUE: menentukan apakah pemesanan terlampir adalah pemesanan yang ditargetkan secara khusus;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 dalam pemesanan terlampir Anda.- Untuk jenis mesin yang telah ditentukan, gunakan format
MACHINE_FAMILY-standard-CPUS; misalnya,n2-standard-4. Untuk jenis mesin kustom, gunakan format
MACHINE_FAMILY-custom-CPUS-MEMORY; 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 terlampir.RESERVED_ACCELERATOR_TYPE: jenis akselerator yang ingin Anda tambahkan dalam pemesanan terlampir.INTERFACE_1danINTERFACE_2: jenis antarmuka yang Anda inginkan untuk disk SSD Lokal untuk digunakan 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 tetapkan untuk pemesanan terlampir.INSTANCE_TEMPLATE_NAME: nama template instance yang ingin Anda gunakan untuk membuat reservasi terlampir.SHARE_SETTING: jenis berbagi untuk pemesanan terlampir. Tentukan kolom ini dengan nilai sebagaiSPECIFIC_PROJECTSjika Anda ingin membagikan pemesanan terlampir ke beberapa project konsumen. Kecualikan kolom ini jika Anda ingin membuat pemesanan satu project.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 pemesanan satu project.
Compute Engine membuat komitmen dan pemesanan terlampir hanya jika ada cukup resource untuk jenis mesin yang ditentukan di zona target, serta kuota yang memadai pada saat permintaan Anda dibuat. Jika pembelian Anda berhasil, Compute Engine akan menampilkan status 200 untuk permintaan REST API Anda.
Contoh
Contoh skenario dan perintah berikut menunjukkan cara membeli komitmen untuk GPU, disk SSD Lokal, atau keduanya dengan membuat reservasi baru untuk dilampirkan ke komitmen tersebut.
Contoh 1: Membeli komitmen untuk GPU dengan melampirkan satu reservasi baru
Misalkan Anda ingin membeli komitmen 1 tahun untuk resource tujuan umum di region us-central1 yang mencakup 96 vCPU, 624 GB memori (setara dengan 638976 MB), dan 4 GPU NVIDIA V100.
Anda ingin membuat reservasi baru reservation-01 di zona us-central1-a yang memesan 2 VM n1-standard-8 (setiap VM dengan 8 vCPU, memori 30 GB, dan 2 GPU NVIDIA V100) untuk dilampirkan ke komitmen tersebut. Untuk membeli contoh komitmen ini dengan pemesanan
yang terlampir, buat permintaan POST berikut. Untuk REST, Anda harus
menentukan memori dalam MB. Namun, perhatikan bahwa saat Anda menggunakan gcloud CLI, Compute Engine menggunakan GB sebagai unit default.
POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments
{
"name": "commitment-01",
"plan": "TWELVE_MONTH",
"type": "GENERAL_PURPOSE",
"resources":
[
{
"amount": "96",
"type": "VCPU"
},
{
"amount": "638976",
"type": "MEMORY"
},
{
"acceleratorType": "nvidia-tesla-v100",
"amount": "4",
"type": "ACCELERATOR"
}
],
"reservations":
[
{
"name": "reservation-01",
"specificReservation":
{
"count": "2",
"instanceProperties":
{
"guestAccelerators":
[
{
"acceleratorCount": 2,
"acceleratorType": "nvidia-tesla-v100"
}
],
"machineType": "n1-standard-8"
}
},
"specificReservationRequired": false,
"zone": "us-central1-a"
}
]
}
Contoh 2: Membeli komitmen untuk GPU tanpa menentukan vCPU atau memori
Untuk membeli komitmen dan memesan GPU dan disk SSD Lokal tanpa membeli komitmen untuk vCPU atau memori, tentukan 0 sebagai nilai untuk jumlah vCPU dan memori.
Misalnya, anggaplah Anda ingin membeli komitmen 1 tahun hanya untuk resource GPU di region us-west2, dengan 0 vCPU, memori 0 MB, dan 4 GPU NVIDIA P4. Anda juga ingin membuat reservasi baru reservation-01
di zona us-west2-b yang memesan 1 VM n1-standard-2 (dengan 2 vCPU,
memori 7,5 GB, dan 4 GPU NVIDIA P4) untuk dilampirkan ke komitmen. Untuk
membeli contoh komitmen ini dengan pemesanan terlampirnya, buat permintaan
POST berikut. Untuk REST, Anda harus menentukan memori dalam MB.
Namun, perhatikan bahwa saat Anda menggunakan gcloud CLI, Compute Engine menggunakan GB sebagai unit default.
POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-west2/commitments
{
"name": "commitment-02",
"plan": "TWELVE_MONTH",
"type": "GENERAL_PURPOSE",
"resources":
[
{
"amount": "0",
"type": "VCPU"
},
{
"amount": "0",
"type": "MEMORY"
},
{
"acceleratorType": "nvidia-tesla-p4",
"amount": "4",
"type": "ACCELERATOR"
}
],
"reservations":
[
{
"name": "reservation-01",
"specificReservation":
{
"count": "1",
"instanceProperties":
{
"guestAccelerators":
[
{
"acceleratorCount": 4,
"acceleratorType": "nvidia-tesla-p4"
}
],
"machineType": "n1-standard-2"
}
},
"specificReservationRequired": false,
"zone": "us-west2-b"
}
]
}
Contoh 3: Membeli komitmen untuk GPU dan disk SSD Lokal dengan melampirkan beberapa reservasi baru
Misalkan Anda ingin membeli komitmen 1 tahun untuk resource tujuan umum di region us-central1, dengan 96 vCPU, memori 624 GB (setara dengan 638976 MB), 1 GPU NVIDIA V100, dan penyimpanan SSD Lokal 750 GB. Anda juga ingin membuat dan melampirkan dua pemesanan di zona us-central1-a. Dalam pemesanan pertama, res-01, Anda ingin memesan 1 VM n1-standard-2 (dengan 2 vCPU, memori 7,5 GB, dan 1 GPU NVIDIA V100); ini adalah pemesanan tertarget. Dalam pemesanan kedua, res-02, Anda ingin memesan 1 VM n1-standard-8
(dengan 8 vCPU, memori 30 GB) dan melampirkan 2 disk SSD Lokal
(satu antarmuka SCSI, satu antarmuka NVMe). Untuk membeli contoh komitmen ini dengan reservasi terlampir, buat permintaan POST berikut. Perhatikan bahwa nilai penyimpanan SSD Lokal harus ditentukan dalam GB.
Untuk memori, Anda harus menentukan nilai dalam MB. Namun, perhatikan bahwa saat Anda
menggunakan gcloud CLI, Compute Engine menggunakan GB sebagai unit
default untuk memori.
POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments
{
"name": "commitment-03",
"plan": "TWELVE_MONTH",
"type": "GENERAL_PURPOSE",
"resources":
[
{
"amount": "96",
"type": "VCPU"
},
{
"amount": "638976",
"type": "MEMORY"
},
{
"acceleratorType": "nvidia-tesla-v100",
"amount": "1",
"type": "ACCELERATOR"
},
{
"amount": "750",
"type": "LOCAL_SSD"
}
],
"reservations":
[
{
"name": "res-01",
"specificReservation":
{
"count": "1",
"instanceProperties":
{
"guestAccelerators":
[
{
"acceleratorCount": 1,
"acceleratorType": "nvidia-tesla-v100"
}
],
"machineType": "n1-standard-2"
}
},
"specificReservationRequired": true,
"zone": "us-central1-a"
},
{
"name": "res-02",
"specificReservation":
{
"count": "1",
"instanceProperties":
{
"localSsds":
[
{
"diskSizeGb": "375",
"interface": "SCSI"
},
{
"diskSizeGb": "375",
"interface": "NVME"
}
],
"machineType": "n1-standard-8"
}
},
"specificReservationRequired": false,
"zone": "us-central1-a"
}
]
}