Dokumen ini menjelaskan cara menggunakan pemesanan diCompute Engine. Untuk mempelajari cara menggunakan pemesanan di produk Google Cloud lain yang mendukung pemesanan, lihat dokumentasi berikut:
Setelah Anda membuat pemesanan, atau Compute Engine otomatis membuat pemesanan untuk Anda guna memenuhi pemesanan untuk masa mendatang atau pemesanan untuk masa mendatang dalam mode kalender, Compute Engine akan menyimpan resource yang dipesan untuk project Anda, dan project apa pun yang Anda bagikan pemesanan tersebut. Saat membuat instance Compute Engine yang cocok dengan properti pemesanan, Anda menggunakan pemesanan dengan menggunakan resource yang dipesan untuk membuat instance komputasi, bukan menggunakan resource yang tersedia di zona instance komputasi. Anda dapat menggunakan pemesanan untuk membuat instance komputasi hingga pemesanan digunakan sepenuhnya.
Batasan
Anda tidak dapat menggunakan pemesanan untuk membuat resource Compute Engine berikut:
Flex-start VM
Spot VM atau preemptible instance
Sole-tenant node
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, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:
gcloud init
-
- Tetapkan region dan zona default.
-
Instal Google Cloud CLI.
-
Konfigurasi gcloud CLI agar menggunakan identitas gabungan Anda.
Untuk mengetahui informasi selengkapnya, lihat Login ke gcloud CLI dengan identitas gabungan Anda.
-
Buat kredensial autentikasi lokal untuk akun pengguna Anda:
gcloud auth application-default login
Jika error autentikasi ditampilkan, pastikan Anda telah login ke gcloud CLI dengan identitas gabungan Anda.
-
Instal Google Cloud CLI.
-
Konfigurasi gcloud CLI agar menggunakan identitas gabungan Anda.
Untuk mengetahui informasi selengkapnya, lihat Login ke gcloud CLI dengan identitas gabungan Anda.
-
Buat kredensial autentikasi lokal untuk akun pengguna Anda:
gcloud auth application-default login
Jika error autentikasi ditampilkan, pastikan Anda telah login ke gcloud CLI dengan identitas gabungan Anda.
-
Instal Google Cloud CLI.
-
Konfigurasi gcloud CLI agar menggunakan identitas gabungan Anda.
Untuk mengetahui informasi selengkapnya, lihat Login ke gcloud CLI dengan identitas gabungan Anda.
-
Buat kredensial autentikasi lokal untuk akun pengguna Anda:
gcloud auth application-default login
Jika error autentikasi ditampilkan, pastikan Anda telah login ke gcloud CLI dengan identitas gabungan Anda.
-
Instal Google Cloud CLI.
-
Konfigurasi gcloud CLI agar menggunakan identitas gabungan Anda.
Untuk mengetahui informasi selengkapnya, lihat Login ke gcloud CLI dengan identitas gabungan Anda.
-
Buat kredensial autentikasi lokal untuk akun pengguna Anda:
gcloud auth application-default login
Jika error autentikasi ditampilkan, pastikan Anda telah login ke gcloud CLI dengan identitas gabungan Anda.
Go
Untuk menggunakan contoh Go di halaman ini dalam lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.
Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk menggunakan contoh Java di halaman ini dalam lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.
Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk menggunakan contoh Node.js di halaman ini dalam lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.
Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk menggunakan contoh Python di halaman ini dalam lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.
Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
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, lalu login ke gcloud CLI dengan identitas gabungan Anda.
Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .
Peran yang diperlukan
Untuk mendapatkan izin yang Anda perlukan untuk menggunakan pemesanan, minta administrator untuk memberi Anda peran IAM berikut:
-
Untuk menggunakan pemesanan:
Compute Instance Admin (v1) (
roles/compute.instanceAdmin.v1) pada project -
Untuk menggunakan reservasi bersama dari project konsumen:
Compute Instance Admin (v1) (
roles/compute.instanceAdmin.v1) pada project pemilik dan project konsumen
Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.
Peran yang telah ditetapkan ini berisi izin yang diperlukan untuk menggunakan pemesanan. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk menggunakan pemesanan:
-
Untuk membuat pemesanan:
compute.reservations.createpada project -
Untuk membuat instance komputasi:
compute.instances.createpada project- Untuk menggunakan image kustom guna membuat VM:
compute.images.useReadOnlypada image - Untuk menggunakan snapshot guna membuat VM:
compute.snapshots.useReadOnlypada snapshot - Untuk menggunakan template instance guna membuat VM:
compute.instanceTemplates.useReadOnlypada template instance - Untuk menetapkan jaringan lama ke VM:
compute.networks.usepada project - Untuk menentukan alamat IP statis bagi VM:
compute.addresses.usepada project - Untuk menetapkan alamat IP eksternal ke VM saat menggunakan jaringan lama:
compute.networks.useExternalIppada project - Untuk menentukan subnet bagi VM:
compute.subnetworks.usedi project atau di subnet yang dipilih - Untuk menetapkan alamat IP eksternal ke VM saat menggunakan jaringan VPC:
compute.subnetworks.useExternalIppada project atau pada subnet yang dipilih - Untuk menetapkan metadata instance VM untuk VM:
compute.instances.setMetadatadi project - Untuk menetapkan tag bagi VM:
compute.instances.setTagsdi VM - Untuk menetapkan label bagi VM:
compute.instances.setLabelsdi VM - Untuk menetapkan akun layanan yang akan digunakan VM:
compute.instances.setServiceAccountdi VM - Untuk membuat disk baru untuk VM:
compute.disks.createdi project - Untuk memasang disk yang ada dalam mode hanya baca atau baca-tulis:
compute.disks.usepada disk - Untuk memasang disk yang ada dalam mode hanya baca:
compute.disks.useReadOnlypada disk
-
Untuk membuat template instance:
compute.instanceTemplates.createpada project
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Menggunakan pemesanan
Contoh di bagian berikut menunjukkan cara menggunakan pemesanan dengan membuat satu instance komputasi. Anda juga dapat menggunakan pemesanan dengan membuat instance komputasi yang cocok dengan properti pemesanan menggunakan opsi deployment yang berbeda, atau dengan memperbarui properti instance komputasi yang ada agar cocok dengan pemesanan yang digunakan secara otomatis.
Untuk menggunakan pemesanan, gunakan salah satu metode berikut:
Untuk membuat instance komputasi yang menggunakan pemesanan otomatis yang Anda buat, atau yang dibuat Compute Engine secara otomatis untuk memenuhi pemesanan untuk masa mendatang, lihat Menggunakan pemesanan yang digunakan secara otomatis.
Untuk membuat instance komputasi yang menggunakan pemesanan tertentu yang Anda buat, atau yang dibuat Compute Engine secara otomatis untuk memenuhi pemesanan untuk masa mendatang, lihat Menggunakan pemesanan yang ditargetkan secara khusus.
Untuk membuat instance komputasi guna menggunakan pemesanan tertentu yang otomatis dibuat oleh Compute Engine untuk memenuhi pemesanan untuk masa mendatang dalam mode kalender, lihat Menggunakan pemesanan yang dibuat otomatis untuk permintaan dalam mode kalender.
Menggunakan pemesanan yang digunakan secara otomatis
Pemesanan yang digunakan secara otomatis memungkinkan instance komputasi apa pun yang cocok dengan properti pemesanan untuk menggunakannya secara otomatis. Perilaku konsumsi ini berlaku untuk instance komputasi yang baru dan yang sudah ada, yang sedang berjalan. Saat Anda membuat pemesanan on-demand, atau Compute Engine otomatis membuat pemesanan untuk memenuhi pemesanan untuk masa mendatang, jenis pemesanan ini adalah setelan default.
Jika properti reservasi otomatis project tunggal dan reservasi otomatis bersama cocok, instance komputasi dalam project Anda akan menggunakan reservasi project tunggal terlebih dahulu, lalu menggunakan reservasi bersama. Untuk mengetahui informasi selengkapnya, lihat urutan penggunaan untuk pemesanan.
Untuk membuat dan menggunakan contoh pemesanan otomatis, pilih salah satu opsi berikut:
Konsol
Contoh berikut menunjukkan cara membuat pemesanan otomatis di zona us-central1-a untuk tiga instance N2 dengan 32 vCPU, dan Intel Cascade Lake sebagai platform CPU minimum. Contoh ini juga menunjukkan cara membuat satu instance komputasi untuk menggunakan pemesanan.
Untuk membuat contoh pemesanan otomatis dan menggunakannya, lakukan hal berikut:
Untuk membuat contoh pemesanan, selesaikan langkah-langkah berikut:
Di konsol Google Cloud , buka halaman Reservations.
Langkah-langkah selanjutnya akan otomatis muncul di konsolGoogle Cloud .
Di tab pemesanan on-demand (default), klik Create reservation. Halaman Buat pemesanan akan muncul.
Di kolom Name, masukkan nama untuk pemesanan. Misalnya, masukkan
reservation-01.Pilih Region dan Zone tempat Anda ingin memesan resource. Misalnya, pilih us-central1 dan us-central1-a.
Di bagian Share type, lakukan salah satu tindakan berikut:
Untuk membuat reservasi project tunggal, pilih Local.
Untuk membuat pemesanan bersama, pilih Shared, lalu tentukan project yang ingin Anda gunakan dalam pemesanan bersama.
Di bagian Use with VM instance, pilih Use reservation automatically, jika belum dipilih.
Di kolom Number of VM instances, masukkan
3.Di tab General purpose, pilih N2.
Di bagian Machine type, pada tab Preset (default), pilih n2-standard-32.
Luaskan CPU platform and GPU, lalu di kolom CPU platform, pilih Intel Cascade Lake or later.
Klik Create.
Untuk membuat instance komputasi yang menggunakan contoh pemesanan, selesaikan langkah-langkah berikut:
Di konsol Google Cloud , buka halaman Create an instance.
Halaman Create an instance akan muncul dan menampilkan panel Machine configuration.
Di panel Machine configuration, lakukan hal berikut:
Di kolom Name, masukkan nama untuk instance komputasi. Untuk contoh ini, masukkan
instance-01.Tentukan Region dan Zone tempat Anda ingin memesan resource. Untuk contoh ini, pilih us-central1 dan us-central1-a.
Di tab General purpose, pilih N2.
Di bagian Machine type, pada tab Preset (default), pilih n2-standard-32.
Luaskan bagian Advanced options, lalu, di kolom CPU platform, pilih Intel Cascade Lake or later.
Opsional: Menggunakan pemesanan yang cocok secara otomatis adalah setelan default. Namun, jika Anda ingin menentukan setelan ini, lakukan hal berikut:
Di menu navigasi, klik Advanced. Panel Advanced akan muncul.
Di bagian Reservations, pilih Use automatic selection.
Klik Create.
gcloud
Contoh berikut menunjukkan cara membuat pemesanan otomatis di zona us-central1-a untuk tiga instance N2 dengan 32 vCPU, dan Intel Cascade Lake sebagai platform CPU minimum. Contoh ini juga menunjukkan cara membuat satu instance komputasi untuk menggunakan pemesanan.
Untuk membuat contoh pemesanan otomatis dan menggunakannya, lakukan hal berikut:
Untuk membuat contoh pemesanan, gunakan perintah
gcloud compute reservations create:gcloud compute reservations create reservation-01 \ --machine-type=n2-standard-32 \ --min-cpu-platform="Intel Cascade Lake" \ --vm-count=3 \ --zone=us-central1-aUntuk membuat instance komputasi yang menggunakan contoh pemesanan, gunakan perintah
gcloud compute instances createdengan flag--reservation-affinityyang ditetapkan keany. Karenaanyadalah konfigurasi default, Anda juga dapat menghilangkan flag ini.gcloud compute instances create instance-01 \ --machine-type=n2-standard-32 \ --min-cpu-platform="Intel Cascade Lake" \ --reservation-affinity=any \ --zone=us-central1-a
Go
Untuk membuat contoh pemesanan otomatis menggunakan template instance, dan membuat instance untuk menggunakan pemesanan menggunakan template yang sama, gunakan contoh kode berikut:
Java
Contoh berikut menunjukkan cara membuat instance N1 dengan empat vCPU,
dan Intel Skylake sebagai platform CPU minimum di zona us-central1-a. Instance
akan otomatis menggunakan pemesanan yang cocok.
Untuk membuat instance contoh, gunakan contoh kode berikut:
Node.js
Contoh berikut menunjukkan cara membuat instance N1 dengan empat vCPU,
dan Intel Skylake sebagai platform CPU minimum di zona us-central1-a. Instance
akan otomatis menggunakan pemesanan yang cocok.
Untuk membuat instance contoh, gunakan contoh kode berikut:
Python
Contoh berikut menunjukkan cara membuat pemesanan otomatis di zona
us-central1-a untuk tiga instance N1 dengan satu vCPU, dan Intel Ivy sebagai
platform CPU minimum. Bagian ini juga menunjukkan cara membuat satu instance untuk menggunakan pemesanan.
Untuk membuat contoh pemesanan otomatis dan menggunakannya, lakukan hal berikut:
REST
Contoh berikut menunjukkan cara membuat pemesanan otomatis di zona us-central1-a untuk tiga instance N2 dengan 32 vCPU, dan Intel Cascade Lake sebagai platform CPU minimum. Contoh ini juga menunjukkan cara membuat satu instance untuk menggunakan pemesanan.
Untuk membuat contoh pemesanan otomatis dan menggunakannya, lakukan hal berikut:
Untuk membuat contoh pemesanan, buat permintaan
POSTke metodereservations.insert:POST https://compute./compute/v1/projects/example-project/zones/us-central1-a/reservations { "name": "reservation-01", "specificReservation": { "count": "3", "instanceProperties": { "machineType": "n2-standard-32", "minCpuPlatform": "Intel Cascade Lake" } } }Untuk membuat instance yang menggunakan contoh pemesanan, buat permintaan
POSTke metodeinstances.insert. Dalam isi permintaan, sertakan kolomconsumeReservationTypeyang ditetapkan keANY_RESERVATION. Namun, karenaANY_RESERVATIONadalah konfigurasi default, Anda juga dapat menghilangkan kolom tersebut.POST https://compute./compute/v1/projects/example-project/zones/us-central1-a/instances { "name": "instance-01", "machineType": "zones/us-central1-a/machineTypes/n2-standard-32", "minCpuPlatform": "Intel Cascade Lake", "disks": [ { "boot": true, "initializeParams": { "sourceImage": "projects/debian-cloud/global/images/family/debian-12" } } ], "networkInterfaces": [ { "network": "global/networks/default" } ], "reservationAffinity": { "consumeReservationType": "ANY_RESERVATION" } }
Menggunakan pemesanan yang ditargetkan secara khusus
Pemesanan yang ditargetkan secara khusus memungkinkan instance komputasi baru yang cocok dengan properti pemesanan dan menargetkan pemesanan untuk menggunakannya. Anda hanya dapat berhasil membuat instance komputasi jika propertinya cocok dengan properti pemesanan. Jika tidak, permintaan pembuatan Anda akan gagal.
Berdasarkan metode pembuatan yang ingin Anda gunakan, buat pemesanan dan instance komputasi tertentu yang menargetkannya sebagai berikut:
| Metode pembuatan | Saat Anda membuat pemesanan | Saat Anda membuat instance komputasi untuk menggunakan pemesanan |
|---|---|---|
| KonsolGoogle Cloud | Di bagian Use with VM instance, pilih Select specific reservation. | Di panel Advanced, di bagian Reservations, pilih Choose a reservation. Kemudian, ikuti petunjuk untuk memilih reservasi. |
| Google Cloud CLI | Sertakan flag --require-specific-reservation. |
Sertakan flag berikut:
|
| Go | Sertakan kolom SpecificReservationRequired yang ditetapkan ke
true. |
Di kolom ReservationAffinity, sertakan kolom
berikut:
|
| Java | Sertakan kolom setSpecificReservationRequired yang ditetapkan ke
true. |
Di kolom ReservationAffinity, sertakan kolom
berikut:
|
| Node.js dan REST API | Sertakan kolom specificReservationRequired yang ditetapkan ke
true. |
Di kolom reservationAffinity, sertakan kolom
berikut:
|
| Python | Sertakan kolom specific_reservation_required yang ditetapkan ke
true. |
Di kolom reservation_affinity, sertakan kolom
berikut:
|
| Terraform | Sertakan kolom specific_reservation_required yang ditetapkan ke
true. |
Di kolom reservation_affinity, sertakan kolom
berikut:
|
Untuk membuat contoh pemesanan khusus dan instance komputasi untuk menggunakannya, pilih salah satu opsi berikut:
Konsol
Contoh berikut menunjukkan cara membuat pemesanan spesifik di zona
us-central1-a untuk tiga instance N2 dengan 32 vCPU, dan Intel Cascade Lake
sebagai platform CPU minimum. Contoh ini juga menunjukkan cara membuat satu instance komputasi untuk menggunakan pemesanan.
Untuk membuat contoh pemesanan khusus dan menggunakannya, lakukan hal berikut:
Untuk membuat contoh pemesanan, selesaikan langkah-langkah berikut:
Di konsol Google Cloud , buka halaman Reservations.
Langkah-langkah selanjutnya akan otomatis muncul di konsolGoogle Cloud .
Di tab pemesanan on-demand (default), klik Create reservation. Halaman Buat pemesanan akan muncul.
Di kolom Name, masukkan nama untuk pemesanan. Misalnya, masukkan
reservation-02.Tentukan Region dan Zone tempat Anda ingin memesan resource. Untuk contoh ini, pilih us-central1 dan us-central1-a.
Di bagian Share type, lakukan salah satu tindakan berikut:
Untuk membuat reservasi project tunggal, pilih Local.
Untuk membuat pemesanan bersama, pilih Shared, lalu tentukan project yang ingin Anda gunakan dalam pemesanan bersama.
Di bagian Use with VM instance, pilih Select specific reservation.
Di kolom Number of VM instances, masukkan
3.Di tab General purpose, pilih N2.
Di bagian Machine type, pada tab Preset (default), pilih n2-standard-32.
Luaskan CPU platform and GPU, lalu di kolom CPU platform, pilih Intel Cascade Lake or later.
Klik Create.
Untuk membuat instance komputasi yang menggunakan contoh pemesanan, selesaikan langkah-langkah berikut:
Di konsol Google Cloud , buka halaman Create an instance.
Halaman Create an instance akan muncul dan menampilkan panel Machine configuration.
Di panel Machine configuration, lakukan hal berikut:
Di kolom Name, masukkan nama untuk instance komputasi. Untuk contoh ini, masukkan
instance-02.Tentukan Region dan Zone tempat Anda ingin memesan resource. Untuk contoh ini, pilih us-central1 dan us-central1-a.
Di tab General purpose, pilih N2.
Di bagian Machine type, pada tab Preset (default), pilih n2-standard-32.
Luaskan bagian Advanced options, lalu, di kolom CPU platform, pilih Intel Cascade Lake or later.
Di menu navigasi, klik Advanced. Panel Advanced akan muncul.
Di bagian Reservations, pilih Choose a reservation, lalu klik Choose reservation.
Di panel Choose a reservation yang muncul, lakukan hal berikut:
Pilih pemesanan spesifik yang Anda buat di langkah sebelumnya. Jika Anda ingin menggunakan pemesanan bersama yang ada di project lain, pilih project tempat pemesanan berada dalam daftar Project.
Klik Choose.
Klik Create.
gcloud
Contoh berikut menunjukkan cara membuat pemesanan spesifik di zona
us-central1-a untuk tiga instance N2 dengan 32 vCPU, dan Intel Cascade Lake
sebagai platform CPU minimum. Contoh ini juga menunjukkan cara membuat satu instance komputasi untuk menggunakan pemesanan.
Untuk membuat contoh pemesanan khusus dan menggunakannya, lakukan hal berikut:
Untuk membuat contoh pemesanan, gunakan perintah
gcloud compute reservations createdengan flag--require-specific-reservation:gcloud compute reservations create reservation-02 \ --machine-type=n2-standard-32 \ --min-cpu-platform="Intel Cascade Lake" \ --require-specific-reservation \ --vm-count=3 \ --zone=us-central1-aUntuk membuat instance komputasi yang menggunakan contoh pemesanan, gunakan perintah
gcloud compute instances createdengan flag--reservationdan--reservation-affinity=specific:gcloud compute instances create instance-02 \ --machine-type=n2-standard-32 \ --min-cpu-platform="Intel Cascade Lake" \ --reservation-affinity=specific \ --reservation=RESERVATION_URL \ --zone=us-central1-aGanti
RESERVATION_URLdengan URL pemesanan. Tentukan salah satu nilai berikut:Jika Anda membuat pemesanan di project yang sama:
reservation-02Jika pemesanan berada di project yang berbeda:
projects/PROJECT_ID/reservations/reservation-02
Go
Contoh berikut menunjukkan cara membuat instance N2 dengan 32 vCPU, dan Intel Cascade Lake sebagai platform CPU minimum, di zona us-central1-a untuk menggunakan pemesanan tertentu yang cocok:
Untuk membuat contoh instance komputasi yang menggunakan reservasi khusus satu project, gunakan contoh kode berikut:
Untuk membuat contoh instance komputasi yang menggunakan pemesanan bersama dan spesifik, gunakan contoh kode berikut:
Java
Contoh berikut menunjukkan cara membuat instance N1 dengan empat vCPU, dan Intel Skylake sebagai platform CPU minimum, di zona us-central1-a untuk menggunakan pemesanan tertentu yang cocok:
Untuk membuat contoh reservasi sebagai reservasi project tunggal, dan membuat instance komputasi untuk menggunakannya, gunakan contoh kode berikut:
Untuk membuat contoh pemesanan sebagai pemesanan bersama, dan membuat instance komputasi untuk menggunakannya, gunakan contoh kode berikut:
Node.js
Contoh berikut menunjukkan cara membuat instance N1 dengan 4 vCPU, dan Intel Skylake sebagai platform CPU minimum, di zona us-central1-a untuk menggunakan pemesanan tertentu yang cocok:
Python
Contoh berikut menunjukkan cara membuat instance N2 dengan 32 vCPU, dan Intel Cascade Lake sebagai platform CPU minimum, di zona us-central1-a untuk menggunakan pemesanan tertentu yang cocok:
Untuk membuat contoh pemesanan khusus dan menggunakannya, lakukan hal berikut:
Untuk membuat dan menggunakan contoh pemesanan sebagai pemesanan project tunggal, gunakan contoh kode berikut:
Untuk membuat dan menggunakan contoh pemesanan sebagai pemesanan bersama, gunakan contoh kode berikut:
REST
Contoh berikut menunjukkan cara membuat pemesanan spesifik di zona
us-central1-a untuk tiga instance N2 dengan 32 vCPU, dan Intel Cascade Lake
sebagai platform CPU minimum. Contoh ini juga menunjukkan cara membuat satu instance untuk menggunakan pemesanan.
Untuk membuat contoh pemesanan khusus dan menggunakannya, lakukan hal berikut:
Untuk membuat contoh pemesanan, buat permintaan
POSTke metodereservations.insert. Dalam isi permintaan, sertakan kolomspecificReservationRequiredyang ditetapkan ketrue:POST https://compute./compute/v1/projects/example-project/zones/us-central1-a/reservations { "name": "reservation-02", "specificReservation": { "count": "3", "instanceProperties": { "machineType": "n2-standard-32", "minCpuPlatform": "Intel Cascade Lake" } }, "specificReservationRequired": true }Untuk membuat instance komputasi yang menggunakan contoh pemesanan, buat permintaan
POSTke metodeinstances.insert. Dalam isi permintaan, di kolomreservationAffinity, sertakan hal berikut:Kolom
consumeReservationTypeditetapkan keSPECIFIC_RESERVATION.Kolom
keyditetapkan kecompute.googleapis.com/reservation-name.Kolom
valuesditetapkan ke URL pemesanan.
Permintaannya mirip dengan yang berikut ini:
POST https://compute./compute/v1/projects/example-project/zones/us-central1-a/instances { "name": "instance-02", "machineType": "zones/us-central1-a/machineTypes/n2-standard-32", "minCpuPlatform": "Intel Cascade Lake", "disks": [ { "boot": true, "initializeParams": { "sourceImage": "projects/debian-cloud/global/images/family/debian-12" } } ], "networkInterfaces": [ { "network": "global/networks/default" } ], "reservationAffinity": { "consumeReservationType": "SPECIFIC_RESERVATION", "key": "compute./reservation-name", "values": [ "RESERVATION_URL" ] } }Ganti
RESERVATION_URLdengan URL pemesanan. Tentukan salah satu nilai berikut:Jika Anda membuat pemesanan di project yang sama:
reservation-02Jika pemesanan berada di project yang berbeda:
projects/PROJECT_ID/reservations/reservation-02
Menggunakan pemesanan yang dibuat otomatis untuk permintaan dalam mode kalender
Jenis pemesanan ini memungkinkan instance komputasi baru menggunakan pemesanan yang dibuat secara otomatis oleh Compute Engine untuk memenuhi pemesanan untuk masa mendatang dalam mode kalender.
Untuk menggunakan jenis pemesanan ini, Anda harus membuat instance komputasi sebagai berikut:
Instance komputasi harus secara khusus menargetkan pemesanan.
Instance komputasi harus dihentikan atau dihapus pada waktu akhir pemesanan.
Instance komputasi harus menggunakan model penyediaan terikat pemesanan. Saat membuat instance komputasi, Anda dapat menentukan model ini sebagai berikut:
Di konsol Google Cloud , jika Anda menentukan jenis mesin yang didukung untuk pemesanan untuk masa mendatang dalam mode kalender, model yang terikat pemesanan akan otomatis dipilih.
Di gcloud CLI, sertakan flag
--provisioning-modelyang ditetapkan keRESERVATION_BOUND.Di REST API, sertakan kolom
provisioningModelyang ditetapkan keRESERVATION_BOUND.
Contoh berikut membuat permintaan pemesanan untuk masa mendatang dalam mode kalender untuk instance A3 Ultra. Contoh ini juga menunjukkan kolom yang harus ditentukan saat Anda membuat instance A3 Ultra mandiri untuk menggunakan pemesanan yang dibuat otomatis untuk permintaan tersebut.
Untuk menggunakan contoh pemesanan yang dibuat otomatis, pilih salah satu opsi berikut:
Konsol
Buat contoh permintaan untuk lima instance A3 Ultra dan kirimkan untuk ditinjau:
Di konsol Google Cloud , buka halaman Reservations.
Klik tab Pemesanan untuk masa mendatang.
Klik Buat pemesanan untuk masa mendatang. Halaman Create a future reservation akan muncul.
Klik tab GPU, lalu di daftar GPU type, pilih NVIDIA H200 141GB. Tindakan ini menentukan instance A3 Ultra.
Di kolom Total capacity needed, masukkan
5.Di bagian Reservation period, tentukan waktu mulai dan durasi untuk periode pemesanan Anda.
Klik Search for capacity, lalu di bagian Available capacity, pilih salah satu mesin yang tersedia.
Klik Create.
Pada waktu mulai permintaan, untuk membuat instance A3 Ultra guna menggunakan contoh pemesanan yang dibuat otomatis, lakukan hal berikut:
Di konsol Google Cloud , buka halaman Create an instance.
Di kolom Name, masukkan nama untuk instance komputasi. Untuk contoh ini, masukkan
example-instance.Tentukan Region dan Zone tempat pemesanan yang dibuat otomatis berada. Untuk contoh ini, pilih us-central1 dan us-central1-b.
Klik tab GPU, lalu di daftar GPU type, pilih NVIDIA H200 141GB. Tindakan ini menentukan instance A3 Ultra dan menetapkan model penyediaan ke Reservation-bound.
Di menu navigasi, klik Advanced.
Di bagian Reservations, pilih Choose a reservation, lalu klik Choose a reservation.
Di panel Choose a reservation, lakukan hal berikut:
Pilih contoh pemesanan yang dibuat otomatis.
Klik Choose.
Di bagian Provisioning model, luaskan bagian VM provisioning model advanced settings.
Dalam daftar On VM termination, pilih Stop (default) atau Delete.
Klik Create.
gcloud
Untuk membuat contoh permintaan untuk lima VM A3 Ultra dan mengirimkannya untuk ditinjau, gunakan perintah
gcloud compute future-reservations create:gcloud compute future-reservations create example-fr \ --auto-delete-auto-created-reservations \ --deployment-type=DENSE \ --planning-status=SUBMITTED \ --require-specific-reservation \ --reservation-mode=CALENDAR \ --reservation-name=example-reservation \ --share-setting=local \ --start-time=2026-03-05T00:00:00Z \ --end-time=2026-03-19T00:00:00Z \ --machine-type=a3-ultragpu-8g \ --total-count=5 \ --zone=us-central1-bAsumsikan bahwa Google Cloud menyetujui permintaan dan Compute Engine otomatis membuat pemesanan kosong. Pada waktu mulai permintaan, yaitu 5 Maret 2026, Compute Engine akan meningkatkan jumlah VM GPU yang dipesan dalam pemesanan. Kemudian, Anda dapat menggunakan pemesanan.
Pada waktu mulai permintaan, untuk membuat instance A3 Ultra yang menggunakan contoh pemesanan kreasi otomatis, gunakan perintah
gcloud compute instances createdengan flag berikut:Flag
--instance-termination-action.Flag
--provisioning-modelditetapkan keRESERVATION_BOUND.Flag
--reservation.Flag
--reservation-affinityditetapkan kespecific.
Perintahnya mirip dengan yang berikut ini. Untuk mengetahui persyaratan lengkap dalam membuat instance A3 Ultra, lihat Membuat instance A3 Ultra atau A4.
gcloud compute instances create example-a3ultra-instance \ --machine-type=a3-ultragpu-8g \ --instance-termination-action=TERMINATION_ACTION \ --provisioning-model=RESERVATION_BOUND \ --reservation-affinity=specific \ --reservation=RESERVATION_URL \ --zone=us-central1-b \ ...Perintah tersebut menyertakan nilai berikut:
TERMINATION_ACTION: apakah Compute Engine menghentikan (STOP) atau menghapus (DELETE) VM di akhir periode pemesanan.RESERVATION_URL: URL pemesanan, yang diformat sebagai berikut:Jika pemesanan yang dibuat secara otomatis ada di project Anda:
example-reservation.Jika pemesanan yang dibuat otomatis ada di project lain:
projects/PROJECT_ID/reservations/example-reservation.
REST
Untuk membuat contoh permintaan untuk lima instance A3 Ultra dan mengirimkannya untuk ditinjau, buat permintaan
POSTke metodefutureReservations.insert:POST https://compute./compute/v1/projects/example-project/zones/us-central1-b/futureReservations { "name": "example-request-calendar-mode", "autoDeleteAutoCreatedReservations": true, "deploymentType": "DENSE", "planningStatus": "SUBMITTED", "reservationMode": "CALENDAR", "reservationName": "example-reservation", "shareSettings": { "shareType": "LOCAL" }, "specificReservationRequired": true, "specificSkuProperties": { "instanceProperties": { "machineType": "a3-ultragpu-8g" }, "totalCount": "5" }, "timeWindow": { "startTime": "2026-03-05T00:00:00Z", "endTime": "2026-03-19T00:00:00Z" } }Asumsikan bahwa Google Cloud menyetujui permintaan dan Compute Engine otomatis membuat pemesanan kosong. Pada waktu mulai permintaan, yaitu 5 Maret 2026, Compute Engine akan meningkatkan jumlah VM GPU yang dipesan dalam pemesanan. Kemudian, Anda dapat menggunakan pemesanan.
Pada waktu mulai permintaan, untuk membuat instance A3 Ultra guna menggunakan contoh pemesanan yang dibuat otomatis, buat permintaan
POSTke metodeinstances.insert. Dalam isi permintaan, sertakan kolom berikut:Kolom
reservationAffinity.consumeReservationTypeditetapkan keSPECIFIC_RESERVATION.Kolom
reservationAffinity.keyditetapkan kecompute.googleapis.com/reservation-name.Kolom
reservationAffinity.valuesditetapkan ke URL pemesanan.Kolom
scheduling.instanceTerminationAction.Kolom
scheduling.provisioningModelditetapkan keRESERVATION_BOUND.
Permintaannya mirip dengan yang berikut ini. Untuk mengetahui persyaratan lengkap dalam membuat instance A3 Ultra, lihat Membuat instance A3 Ultra atau A4.
POST https://compute./compute/v1/projects/example-project/zones/us-central1-b/instances { "machineType": "projects/example-project/zones/us-central1-b/machineTypes/a3-ultragpu-8g", "name": "example-a3ultra-instance", "reservationAffinity": { "consumeReservationType": "SPECIFIC_RESERVATION", "key": "compute.googleapis.com/reservation-name", "values": [ "RESERVATION_URL" ] }, "scheduling": { "instanceTerminationAction": "TERMINATION_ACTION", "provisioningModel": "RESERVATION_BOUND" }, ... }Isi permintaan menyertakan nilai-nilai berikut:
RESERVATION_URL: URL pemesanan, yang diformat sebagai berikut:Jika pemesanan yang dibuat secara otomatis ada di project Anda:
example-reservation.Jika pemesanan yang dibuat otomatis ada di project lain:
projects/PROJECT_ID/reservations/example-reservation.
TERMINATION_ACTION: apakah Compute Engine menghentikan (STOP) atau menghapus (DELETE) VM di akhir periode pemesanan.
Menguji apakah properti instance komputasi cocok dengan reservasi yang digunakan secara otomatis
Tidak seperti pemesanan yang ditargetkan secara khusus, pemesanan yang digunakan secara otomatis tidak menampilkan error jika properti instance komputasi tidak cocok. Sebagai gantinya, Compute Engine akan mencoba membuat instance komputasi menggunakan kapasitas on-demand. Untuk memverifikasi bahwa properti instance komputasi Anda cocok dengan pemesanan yang digunakan secara otomatis sebelum Anda meluncurkan workload, uji properti tersebut terhadap pemesanan yang ditargetkan secara khusus untuk pengujian yang memiliki properti yang sama.
Untuk menguji apakah properti instance komputasi cocok dengan pemesanan yang digunakan secara otomatis, selesaikan langkah-langkah berikut:
Buat pemesanan pengujian: buat pemesanan yang ditargetkan secara khusus dengan properti instance komputasi yang sama dengan pemesanan yang digunakan secara otomatis yang ingin Anda uji. Tetapkan jumlah instance komputasi yang dicadangkan ke
1.Membuat instance komputasi pengujian: mencoba membuat instance komputasi dengan menargetkan pemesanan pengujian Anda. Hasil dari langkah ini adalah salah satu dari berikut:
Jika Anda berhasil membuat instance komputasi, berarti properti instance komputasi dan pemesanan pengujian cocok.
Jika Anda tidak dapat membuat instance komputasi dan menerima error, propertinya mungkin tidak cocok. Untuk memecahkan masalah error, lihat Memecahkan masalah pemakaian pemesanan.
Hapus resource: jika Anda berhasil membuat instance komputasi dengan menargetkan pemesanan pengujian, hapus resource pengujian untuk menghindari biaya yang tidak perlu:
Memverifikasi pemakaian reservasi
Untuk memverifikasi pemakaian pemesanan, gunakan salah satu metode berikut:
Untuk memeriksa pemesanan yang digunakan oleh instance komputasi, lihat pemesanan yang digunakan oleh instance komputasi.
Untuk memeriksa instance komputasi mana yang menggunakan pemesanan tertentu, lihat daftar instance komputasi yang menggunakan pemesanan.
Untuk memeriksa penggunaan pemesanan saat ini dan melihat jumlah instance komputasi yang menggunakan pemesanan, serta jumlah instance komputasi lainnya yang dapat menggunakannya, lihat pemesanan.
Untuk memantau data pemakaian pemesanan, yang diperbarui setiap 30 menit, dan menerima pemberitahuan saat pemesanan digunakan, pantau pemakaian pemesanan.
Untuk menganalisis pemakaian pemesanan menggunakan data Penagihan Cloud yang diekspor ke BigQuery, lihat contoh berikut:
Untuk melihat data pemakaian pemesanan, yang diperbarui setiap 24 jam, lakukan salah satu hal berikut:
- Untuk menerima laporan konsumsi di bucket Cloud Storage guna menganalisis tren konsumsi dan mengidentifikasi pemesanan yang tidak digunakan, lihat laporan penggunaan pemesanan.