Dokumen ini menjelaskan cara membuat pemesanan satu project, yang hanya dapat digunakan oleh instance virtual machine (VM) dalam project yang sama. Untuk mempelajari pemesanan lebih lanjut, lihat Pemesanan resource zona Compute Engine.
Untuk metode pembuatan pemesanan yang lain, lihat halaman berikut:
Untuk membuat pemesanan yang dapat digunakan oleh beberapa project, lihat Membuat pemesanan bersama.
Untuk membuat reservasi saat membeli komitmen berbasis resource, lihat Membeli komitmen dengan reservasi terlampir. Komitmen memberikan diskon, yang dikenal sebagai diskon abonemen (DA), untuk biaya resource sesuai permintaan Anda sebagai imbalan atas pembelian tingkat minimum resource atau pembelanjaan jumlah minimum.
Sebelum memulai
- Tinjau persyaratan dan pembatasan untuk pemesanan.
-
Jika Anda belum melakukannya, siapkan autentikasi.
Autentikasi adalah
proses yang digunakan untuk memverifikasi identitas Anda untuk mengakses Google Cloud layanan dan API.
Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke
Compute Engine dengan memilih salah satu opsi berikut:
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
- Set a default region and zone.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
-
compute.reservations.create
di project -
Untuk menentukan template instance:
compute.instanceTemplates.useReadOnly
pada template instance Direkomendasikan: Menentukan template instance
Bagian ini menjelaskan cara menggunakan template instance untuk menentukan properti pemesanan. Dengan menggunakan template instance, Anda dapat menentukan properti pemesanan dan VM yang dapat menggunakan pemesanan di tempat yang sama.
-
Bagian ini menjelaskan cara menggunakan VM yang ada untuk menentukan properti pemesanan. Dengan menggunakan properti VM yang ada, Anda dapat menggunakan reservasi dengan membuat VM dengan properti yang cocok dengan VM referensi.
Menentukan properti secara langsung
Bagian ini menjelaskan cara menentukan properti pemesanan secara langsung. Metode ini mengharuskan Anda secara manual memastikan bahwa properti VM dan pemesanan Anda sama persis—setiap properti yang tidak cocok akan mencegah pemakaian.
Buat pemesanan yang hanya dapat dipakai oleh VM yang secara khusus menargetkannya, seperti yang dijelaskan di bagian berikut dalam dokumen ini. Kemudian, konfigurasi VM untuk memakai pemesanan tersebut.
Buat pemesanan di region dan zona yang sama dengan resource dalam template instance. Setiap resource regional atau resource zona yang ditentukan dalam template instance—seperti jenis mesin atau volume Disk Persisten—membatasi penggunaan template ke lokasi tempat resource tersebut berada. Misalnya, jika template instance Anda menentukan volume Persistent Disk yang ada di zona
us-central1-a
, Anda hanya dapat membuat reservasi di zona yang sama. Untuk memeriksa apakah template yang ada menentukan resource yang mengikat template ke region atau zona tertentu, lihat detail template instance dan cari referensi ke resource regional atau resource zona di dalamnya.Jika template instance menentukan kebijakan penempatan yang ringkas, pastikan template tersebut menentukan jenis mesin yang didukung untuk kebijakan penempatan yang ringkas. Jika tidak, pembuatan pemesanan akan gagal.
Di konsol Google Cloud , buka halaman Reservations.
Di tab Reservasi sesuai permintaan (default), klik
Buat reservasi.Halaman Create a reservation akan terbuka.
Untuk Name, masukkan nama untuk reservasi Anda.
Untuk Region dan Zone, pilih tempat Anda ingin memesan resource.
Di bagian Jenis berbagi, pilih Lokal jika belum dipilih.
Opsional: Untuk mengizinkan penggunaan reservasi VM GPU oleh tugas pelatihan kustom atau tugas prediksi di Vertex AI, di bagian Layanan Google Cloud, pilih Bagikan reservasi.
Di bagian Gunakan dengan instance VM, pilih salah satu opsi berikut:
Untuk mengizinkan VM yang cocok menggunakan pemesanan ini secara otomatis, pilih Gunakan pemesanan secara otomatis jika belum dipilih.
Untuk menggunakan resource pemesanan ini hanya saat membuat VM yang sama persis yang secara khusus menargetkan pemesanan ini berdasarkan nama, pilih Pilih pemesanan tertentu.
Untuk Number of VM instances, masukkan jumlah VM yang ingin Anda pesan.
Di bagian Machine configuration, lakukan hal berikut:
Untuk menentukan properti VM Anda dari template instance yang ada, pilih Gunakan template instance.
Di kolom Template instance, pilih template instance pilihan Anda. Jika memilih template instance regional, Anda hanya dapat memesan resource dalam region template instance.
Di bagian Hapus otomatis, Anda dapat mengaktifkan opsi hapus otomatis agar Compute Engine menghapus pemesanan secara otomatis pada tanggal dan waktu tertentu. Menghapus reservasi secara otomatis dapat berguna untuk menghindari biaya yang tidak perlu saat Anda berhenti menggunakan reservasi.
Untuk membuat pemesanan, klik Buat.
Halaman Reservations akan terbuka. Pembuatan pemesanan satu project dapat memakan waktu hingga satu menit.
RESERVATION_NAME
: nama pemesanan yang akan dibuat.PROJECT_ID
: ID project tempat Anda ingin mencadangkan resource dan tempat template instance berada.LOCATION
: lokasi template instance. Tentukan salah satu nilai berikut:Untuk template instance global:
global
.Untuk template instance regional:
regions/REGION
. GantiREGION
dengan region tempat template instance berada. Jika Anda menentukan template instance regional, Anda hanya dapat memesan VM dalam region yang sama dengan region template.
INSTANCE_TEMPLATE_NAME
: nama template instance yang ada. Jika template instance menentukan jenis mesin A3 Mega, A3 High, atau A3 Edge, atau kebijakan penempatan yang ringkas, Anda harus menyertakan flag--require-specific-reservation
. Hal ini menunjukkan bahwa hanya VM yang secara khusus menargetkan reservasi yang dapat menggunakannya. Untuk mengetahui informasi selengkapnya, lihat Menggunakan VM dari reservasi tertentu.NUMBER_OF_VMS
: jumlah VM yang akan dipesan.ZONE
: zona tempat memesan resource.Untuk menentukan bahwa hanya VM yang secara khusus menargetkan reservasi ini yang dapat menggunakannya, sertakan flag
--require-specific-reservation
.gcloud compute reservations create RESERVATION_NAME \ --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \ --require-specific-reservation \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Untuk mengizinkan pemesanan VM GPU digunakan oleh tugas pelatihan kustom atau tugas prediksi di Vertex AI, sertakan flag
--reservation-sharing-policy
yang ditetapkan keALLOW_ALL
.gcloud compute reservations create RESERVATION_NAME \ --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \ --reservation-sharing-policy=ALLOW_ALL \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Agar Compute Engine dapat menghapus pemesanan secara otomatis, pilih salah satu metode berikut:
Untuk menghapus reservasi pada tanggal dan waktu tertentu, gunakan perintah
gcloud beta compute reservations create
dengan flag--delete-at-time
.gcloud beta compute reservations create RESERVATION_NAME \ --delete-at-time=DELETE_AT_TIME \ --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Ganti
DELETE_AT_TIME
dengan tanggal dan waktu yang diformat sebagai stempel waktu RFC 3339, yang harus seperti berikut:none YYYY-MM-DDTHH:MM:SSOFFSET
Ganti kode berikut:
YYYY-MM-DD
: tanggal yang diformat sebagai tahun 4 digit, bulan 2 digit, dan hari 2 digit dalam bulan, yang dipisahkan oleh tanda hubung (-
).HH:MM:SS
: waktu yang diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit, yang dipisahkan oleh titik dua (:
).OFFSET
: zona waktu yang diformat sebagai offset dari Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan-08:00
. Atau, untuk tidak menggunakan penyeimbang, tentukanZ
.
Untuk menghapus pemesanan setelah durasi tertentu, gunakan perintah
gcloud beta compute reservations create
dengan flag--delete-after-duration
.gcloud beta compute reservations create RESERVATION_NAME \ --delete-after-duration=DELETE_AFTER_DURATION \ --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Ganti
DELETE_AFTER_DURATION
dengan durasi dalam hari, jam, menit, atau detik. Misalnya, tentukan30m
selama 30 menit, atau1d2h3m4s
untuk 1 hari, 2 jam, 3 menit, dan 4 detik.
PROJECT_ID
: ID project tempat Anda ingin mencadangkan resource dan tempat template instance berada.ZONE
: zona tempat memesan resource.RESERVATION_NAME
: nama pemesanan yang akan dibuat.NUMBER_OF_VMS
: jumlah VM yang akan dipesan.LOCATION
: lokasi template instance. Tentukan salah satu nilai berikut:Untuk template instance global:
global
.Untuk template instance regional:
regions/REGION
. GantiREGION
dengan region tempat template instance berada. Jika Anda menentukan template instance regional, Anda hanya dapat memesan VM dalam region yang sama dengan region template.
INSTANCE_TEMPLATE_NAME
: nama template instance yang ada. Jika template instance menentukan jenis mesin A3 Mega, A3 High, atau A3 Edge atau kebijakan penempatan ringkas, Anda harus menyertakan kolomspecificReservationRequired
di isi permintaan, dan menetapkan kolom ketrue
. Hal ini menunjukkan bahwa hanya VM yang secara khusus menargetkan reservasi ini yang dapat menggunakannya. Untuk mengetahui informasi selengkapnya, lihat Menggunakan VM dari reservasi tertentu.Untuk menentukan bahwa hanya VM yang secara khusus menargetkan pemesanan ini yang dapat menggunakannya, sertakan kolom
specificReservationRequired
dalam isi permintaan, dan tetapkan kolom ketrue
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations { "name": "RESERVATION_NAME", "specificReservation": { "count": "NUMBER_OF_VMS", "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME" }, "specificReservationRequired": true }
Untuk mengizinkan reservasi VM GPU digunakan oleh tugas pelatihan kustom atau tugas prediksi di Vertex AI, sertakan kolom
serviceShareType
dan tetapkan keALLOW_ALL
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations { "name": "RESERVATION_NAME", "reservationSharingPolicy": { "serviceShareType": "ALLOW_ALL" }, "specificReservation": { "count": "NUMBER_OF_VMS", "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME" } }
Agar Compute Engine dapat menghapus pemesanan secara otomatis, pilih salah satu metode berikut:
Untuk menghapus pemesanan pada tanggal dan waktu tertentu, buat permintaan
POST
ke metodebeta.reservations.insert
. Dalam isi permintaan, sertakan kolomdeleteAtTime
.POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations { "deleteAtTime": "DELETE_AT_TIME", "name": "RESERVATION_NAME", "specificReservation": { "count": "NUMBER_OF_VMS", "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME" } }
Ganti
DELETE_AT_TIME
dengan tanggal dan waktu yang diformat sebagai stempel waktu RFC 3339, yang harus seperti berikut:YYYY-MM-DDTHH:MM:SSOFFSET
Ganti kode berikut:
YYYY-MM-DD
: tanggal yang diformat sebagai tahun 4 digit, bulan 2 digit, dan hari 2 digit dalam bulan, yang dipisahkan oleh tanda hubung (-
).HH:MM:SS
: waktu yang diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit, yang dipisahkan oleh titik dua (:
).OFFSET
: zona waktu yang diformat sebagai offset dari Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan-08:00
. Atau, untuk tidak menggunakan penyeimbang, tentukanZ
.
Untuk menghapus pemesanan setelah durasi tertentu, buat permintaan
POST
ke metodebeta.reservations.insert
. Dalam isi permintaan, sertakan kolomdeleteAfterDuration
.POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations { "deleteAfterDuration": { "seconds": "DELETE_AFTER_DURATION" }, "name": "RESERVATION_NAME", "specificReservation": { "count": "NUMBER_OF_VMS", "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME" } }
Ganti
DELETE_AFTER_DURATION
dengan durasi dalam detik. Misalnya, tentukan86400
untuk 86.400 detik (1 hari).
Buat dan gunakan template instance sebagai berikut:
Buat template instance berdasarkan VM referensi tanpa mengganti properti VM referensi.
Buat VM menggunakan template yang baru dibuat dengan melakukan salah satu atau kedua hal berikut:
Buat VM berdasarkan VM referensi sambil memastikan bahwa properti VM baru dan VM referensi sama persis.
Di konsol Google Cloud , buka halaman Reservations.
Klik
Create reservation.Halaman Create a reservation akan terbuka.
Untuk Name, masukkan nama untuk reservasi Anda.
Untuk Region dan Zone, pilih tempat Anda ingin memesan resource.
Di bagian Jenis berbagi, klik Lokal jika belum dipilih.
Di bagian Gunakan dengan instance VM, pilih salah satu opsi berikut:
Untuk mengizinkan VM yang cocok menggunakan pemesanan ini secara otomatis, pilih Gunakan pemesanan secara otomatis jika belum dipilih.
Untuk menggunakan resource pemesanan ini hanya saat membuat VM yang sama persis yang secara khusus menargetkan pemesanan ini berdasarkan nama, pilih Pilih pemesanan tertentu.
Untuk Number of VM instances, masukkan jumlah VM yang ingin Anda pesan.
Di bagian Machine configuration, lakukan hal berikut:
Pilih Gunakan VM yang ada.
Untuk VM yang Ada, pilih VM yang propertinya ingin Anda gunakan untuk membuat reservasi.
Opsional: Untuk menentukan kebijakan penempatan ringkas untuk reservasi yang memenuhi persyaratan, di bagian Kebijakan penempatan grup, klik daftar Pilih atau buat kebijakan penempatan grup, lalu lakukan salah satu tindakan berikut:
Untuk membuat kebijakan penempatan rapat yang akan ditentukan dalam pemesanan ini, lakukan hal berikut:
Klik Create group placement policy.
Panel Buat kebijakan penempatan grup akan muncul.
Untuk Nama kebijakan, masukkan nama kebijakan Anda.
Klik Buat.
Mungkin perlu waktu beberapa detik untuk menyelesaikan pembuatan kebijakan penempatan rapat.
Jika tidak, pilih kebijakan penempatan yang ringkas yang ada.
Di bagian Hapus otomatis, Anda dapat mengaktifkan opsi hapus otomatis agar Compute Engine menghapus pemesanan secara otomatis pada tanggal dan waktu tertentu. Menghapus reservasi secara otomatis dapat berguna untuk menghindari biaya yang tidak perlu saat Anda berhenti menggunakan reservasi.
Untuk membuat pemesanan, klik Buat.
Halaman Reservations akan terbuka. Mungkin perlu waktu hingga satu menit untuk menyelesaikan pembuatan reservasi.
Di konsol Google Cloud , buka halaman Reservations.
Di tab Reservasi sesuai permintaan (default), klik
Buat reservasi.Halaman Create a reservation akan terbuka.
Untuk Name, masukkan nama untuk reservasi Anda.
Untuk Region dan Zone, pilih tempat Anda ingin memesan resource.
Di bagian Jenis berbagi, klik Lokal jika belum dipilih.
Opsional: Untuk mengizinkan penggunaan reservasi VM GPU oleh tugas pelatihan kustom atau tugas prediksi di Vertex AI, di bagian Layanan Google Cloud, pilih Bagikan reservasi.
Di bagian Gunakan dengan instance VM, pilih salah satu opsi berikut:
Untuk mengizinkan VM yang cocok menggunakan pemesanan ini secara otomatis, pilih Gunakan pemesanan secara otomatis jika belum dipilih.
Untuk menggunakan resource pemesanan ini hanya saat membuat VM yang sama persis yang secara khusus menargetkan pemesanan ini berdasarkan nama, pilih Pilih pemesanan tertentu.
Untuk Number of VM instances, masukkan jumlah VM yang ingin Anda pesan.
Di bagian Konfigurasi mesin, pilih Tentukan jenis mesin, lalu tentukan hal berikut:
Untuk Machine family, Series, dan Machine type, pilih kelompok mesin, seri, dan jenis mesin.
Opsional: Untuk menentukan platform CPU minimum atau melampirkan GPU ke VM N1, lakukan hal berikut:
Untuk meluaskan bagian CPU Platform and GPU, klik peluas
.Opsional: Untuk menentukan platform CPU minimum, pilih salah satu opsi untuk CPU Platform.
Opsional: Untuk memasang GPU ke VM N1, klik
Tambahkan GPU. Kemudian, untuk GPU type dan Number of GPUs, pilih jenis dan jumlah GPU yang akan dilampirkan ke setiap VM N1.
Opsional: Untuk memasang disk SSD Lokal ke jenis mesin yang tidak menyertakan disk SSD Lokal secara default, lakukan langkah berikut:
Untuk Number of disks, pilih jumlah disk SSD Lokal yang akan dilampirkan.
Untuk Jenis antarmuka, pilih antarmuka disk untuk disk SSD Lokal.
Opsional: Untuk menentukan kebijakan penempatan ringkas untuk reservasi yang memenuhi persyaratan, di bagian Kebijakan penempatan grup, klik daftar Pilih atau buat kebijakan penempatan grup, lalu lakukan salah satu tindakan berikut:
Untuk membuat kebijakan penempatan rapat yang akan ditentukan dalam pemesanan ini, lakukan hal berikut:
Klik Create group placement policy.
Panel Buat kebijakan penempatan grup akan muncul.
Untuk Nama kebijakan, masukkan nama kebijakan Anda.
Klik Buat.
Mungkin perlu waktu beberapa detik untuk membuat kebijakan penempatan rapat.
Jika tidak, pilih kebijakan penempatan yang ringkas yang ada.
Di bagian Hapus otomatis, Anda dapat mengaktifkan opsi hapus otomatis agar Compute Engine otomatis menghapus pemesanan pada tanggal dan waktu tertentu. Menghapus reservasi secara otomatis dapat berguna untuk menghindari biaya yang tidak perlu saat Anda berhenti menggunakan reservasi.
Untuk membuat pemesanan, klik Buat.
Halaman Reservations akan terbuka. Pembuatan pemesanan satu project dapat memakan waktu hingga satu menit.
RESERVATION_NAME
: nama pemesanan yang akan dibuat.MACHINE_TYPE
: jenis mesin yang akan digunakan untuk setiap VM. Jika Anda menentukan jenis mesin A3 Mega, A3 High, atau A3 Edge, Anda harus menyertakan flag--require-specific-reservation
. Hal ini menunjukkan bahwa hanya VM yang secara khusus menargetkan reservasi yang dapat menggunakannya. Untuk mengetahui informasi selengkapnya, lihat Menggunakan VM dari reservasi tertentu.NUMBER_OF_VMS
: jumlah VM yang akan dipesan.ZONE
: zona tempat memesan resource.Untuk memasang GPU ke VM N1 yang dipesan, sertakan tanda
--accelerator
.gcloud compute reservations create RESERVATION_NAME \ --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \ --machine-type=MACHINE_TYPE \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Ganti kode berikut:
NUMBER_OF_ACCELERATORS
: jumlah GPU yang akan ditambahkan per VM yang dipesan.ACCELERATOR_TYPE
: model GPU yang didukung untuk VM N1. Pastikan model GPU yang Anda pilih tersedia di zona tempat Anda ingin memesan resource. Jika tidak, pembuatan pemesanan akan gagal.
Untuk memasang disk SSD Lokal ke jenis mesin yang tidak menyertakan disk SSD Lokal secara default, sertakan tanda
--local-ssd
. Anda hanya dapat melampirkan disk SSD Lokal berukuran 375 GB.gcloud compute reservations create RESERVATION_NAME \ --local-ssd=count=NUMBER_OF_LOCAL_SSD_DISKS,size=375,interface=INTERFACE_TYPE \ --machine-type=MACHINE_TYPE \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Ganti kode berikut:
NUMBER_OF_LOCAL_SSD_DISKS
: jumlah disk SSD Lokal yang akan dipasang.INTERFACE_TYPE
: jenis antarmuka disk yang Anda inginkan untuk digunakan setiap disk SSD Lokal dan yang didukung oleh jenis mesin yang Anda tentukan. Tentukan salah satu nilai berikut:Untuk antarmuka disk NVME:
nvme
Untuk antarmuka disk SCSI:
scsi
Agar VM yang dipesan menggunakan platform CPU minimum tertentu, bukan platform CPU default zona, sertakan flag
--min-cpu-platform
.gcloud compute reservations create RESERVATION_NAME \ --machine-type=MACHINE_TYPE \ --min-cpu-platform="MIN_CPU_PLATFORM" \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Ganti
MIN_CPU_PLATFORM
dengan platform CPU minimum. Untuk memastikan bahwa platform CPU tersedia di zona tempat Anda memesan resource, lihat platform CPU yang tersedia menurut zona.Untuk menentukan bahwa hanya VM yang secara khusus menargetkan reservasi ini yang dapat menggunakannya, sertakan flag
--require-specific-reservation
.gcloud compute reservations create RESERVATION_NAME \ --machine-type=MACHINE_TYPE \ --require-specific-reservation \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Untuk menentukan kebijakan penempatan rapat guna menurunkan latensi jaringan di antara VM, sertakan flag
--resource-policies=policy
.gcloud compute reservations create RESERVATION_NAME \ --machine-type=MACHINE_TYPE \ --resource-policies=policy=COMPACT_PLACEMENT_POLICY_NAME \ --require-specific-reservation \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Ganti COMPACT_PLACEMENT_POLICY_NAME dengan nama kebijakan penempatan ringkas yang ada. Selain itu, untuk menghindari error saat membuat pemesanan satu project yang menentukan kebijakan penempatan rapat, pastikan untuk menentukan hal berikut:
Jenis mesin yang didukung dan jumlah maksimum VM untuk kebijakan penempatan rapat.
Zona dalam region tempat kebijakan penempatan rapat berada.
Flag
--require-specific-reservation
. Hal ini menunjukkan bahwa hanya VM yang secara khusus menargetkan reservasi yang dapat menggunakannya.
Untuk mengizinkan pemesanan VM GPU digunakan oleh tugas pelatihan kustom atau tugas prediksi di Vertex AI, sertakan flag
--reservation-sharing-policy
yang ditetapkan keALLOW_ALL
.gcloud compute reservations create RESERVATION_NAME \ --machine-type=MACHINE_TYPE \ --reservation-sharing-policy=ALLOW_ALL \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Agar Compute Engine dapat menghapus pemesanan secara otomatis, pilih salah satu metode berikut:
Untuk menghapus reservasi pada tanggal dan waktu tertentu, gunakan perintah
gcloud beta compute reservations create
dengan flag--delete-at-time
.gcloud beta compute reservations create RESERVATION_NAME \ --delete-at-time=DELETE_AT_TIME \ --machine-type=MACHINE_TYPE \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Ganti
DELETE_AT_TIME
dengan tanggal dan waktu yang diformat sebagai stempel waktu RFC 3339, yang harus seperti berikut:YYYY-MM-DDTHH:MM:SSOFFSET
Ganti kode berikut:
YYYY-MM-DD
: tanggal yang diformat sebagai tahun 4 digit, bulan 2 digit, dan hari 2 digit dalam bulan, yang dipisahkan oleh tanda hubung (-
).HH:MM:SS
: waktu yang diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit, yang dipisahkan oleh titik dua (:
).OFFSET
: zona waktu yang diformat sebagai offset dari Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan-08:00
. Atau, untuk tidak menggunakan penyeimbang, tentukanZ
.
Untuk menghapus pemesanan setelah durasi tertentu, gunakan perintah
gcloud beta compute reservations create
dengan flag--delete-after-duration
.gcloud beta compute reservations create RESERVATION_NAME \ --delete-after-duration=DELETE_AFTER_DURATION \ --machine-type=MACHINE_TYPE \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Ganti
DELETE_AFTER_DURATION
dengan durasi dalam hari, jam, menit, atau detik. Misalnya, tentukan30m
selama 30 menit, atau1d2h3m4s
untuk 1 hari, 2 jam, 3 menit, dan 4 detik.
PROJECT_ID
: ID project tempat Anda ingin memesan resource.ZONE
: zona tempat memesan resource.RESERVATION_NAME
: nama pemesanan yang akan dibuat.NUMBER_OF_VMS
: jumlah VM yang akan dipesan.MACHINE_TYPE
: jenis mesin yang akan digunakan untuk setiap VM. Jika Anda menentukan jenis mesin A3 Mega, A3 High, atau A3 Edge, Anda harus menyertakan kolomspecificReservationRequired
di isi permintaan, dan menetapkan kolom ketrue
. Hal ini menunjukkan bahwa hanya VM yang secara khusus menargetkan reservasi yang dapat menggunakannya. Untuk mengetahui informasi selengkapnya, lihat Menggunakan VM dari reservasi tertentu.Untuk memasang GPU ke VM N1 yang dipesan, sertakan kolom
guestAccelerators
di isi permintaan.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations { "name": "RESERVATION_NAME", "specificReservation": { "count": "NUMBER_OF_VMS", "instanceProperties": { "guestAccelerators": [ { "acceleratorCount": NUMBER_OF_ACCELERATORS, "acceleratorType": "ACCELERATOR_TYPE" } ], "machineType": "MACHINE_TYPE" } } }
Ganti kode berikut:
NUMBER_OF_ACCELERATORS
: jumlah GPU yang akan ditambahkan per VM yang dipesan.ACCELERATOR_TYPE
: model GPU yang didukung untuk VM N1. Pastikan model GPU yang Anda pilih tersedia di zona tempat Anda ingin memesan resource. Jika tidak, pembuatan pemesanan akan gagal.
Untuk memasang disk SSD Lokal ke jenis mesin yang tidak menyertakan disk SSD Lokal secara default, sertakan kolom
localSsds
dalam isi permintaan. Anda hanya dapat memasang disk SSD Lokal berukuran 375 GB.Misalnya, untuk memasang dua disk SSD Lokal ke jenis mesin yang ingin Anda pesan, buat permintaan sebagai berikut:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations { "name": "RESERVATION_NAME", "specificReservation": { "count": "NUMBER_OF_VMS", "instanceProperties": { "localSsds": [ { "diskSizeGb": "375", "interface": "INTERFACE_TYPE" }, { "diskSizeGb": "375", "interface": "INTERFACE_TYPE" } ], "machineType": "MACHINE_TYPE" } } }
Ganti
INTERFACE_TYPE
dengan jenis antarmuka disk yang Anda inginkan untuk digunakan setiap disk SSD Lokal dan yang didukung oleh jenis mesin yang Anda tentukan. Tentukan salah satu nilai berikut:Untuk antarmuka disk NVME:
NVME
Untuk antarmuka disk SCSI:
SCSI
Agar VM yang dipesan menggunakan platform CPU minimum tertentu dan bukan platform CPU default zona, sertakan kolom
minCpuPlatform
dalam isi permintaan.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations { "name": "RESERVATION_NAME", "specificReservation": { "count": "NUMBER_OF_VMS", "instanceProperties": { "machineType": "MACHINE_TYPE", "minCpuPlatform": "MIN_CPU_PLATFORM" } } }
Ganti
MIN_CPU_PLATFORM
dengan platform CPU minimum. Untuk memastikan bahwa platform CPU tersedia di zona tempat Anda memesan resource, lihat platform CPU yang tersedia menurut zona.Untuk menentukan kebijakan penempatan rapat guna mengurangi latensi jaringan di antara VM yang dipesan, sertakan kolom
resourcePolicies
dalam isi permintaan.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations { "name": "RESERVATION_NAME", "resourcePolicies": { "policy" : "projects/example-project/regions/REGION/resourcePolicies/COMPACT_PLACEMENT_POLICY_NAME" }, "specificReservation": { "count": "NUMBER_OF_VMS", "instanceProperties": { "machineType": "MACHINE_TYPE" } }, "specificReservationRequired": true }
Ganti kode berikut:
REGION
: region tempat kebijakan penempatan yang ringkas berada. Anda hanya dapat membuat reservasi dalam region kebijakan penempatan.COMPACT_PLACEMENT_POLICY_NAME
: nama kebijakan penempatan ringkas yang ada.
Selain itu, untuk menghindari error saat membuat pemesanan satu project yang menentukan kebijakan penempatan rapat, pastikan untuk menentukan berikut ini:
Jenis mesin yang didukung untuk kebijakan penempatan rapat.
Kolom
specificReservationRequired
ditetapkan ketrue
. Hal ini menunjukkan bahwa hanya VM yang secara khusus menargetkan reservasi ini yang dapat menggunakannya.
Untuk menentukan bahwa hanya VM yang secara khusus menargetkan pemesanan ini yang dapat menggunakannya, sertakan kolom
specificReservationRequired
dalam isi permintaan dan tetapkan kolom ketrue
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations { "name": "RESERVATION_NAME", "specificReservation": { "count": "NUMBER_OF_VMS", "instanceProperties": { "machineType": "MACHINE_TYPE" } }, "specificReservationRequired": true }
Untuk mengizinkan reservasi VM GPU digunakan oleh tugas pelatihan kustom atau tugas prediksi di Vertex AI, sertakan kolom
serviceShareType
dan tetapkan keALLOW_ALL
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations { "name": "RESERVATION_NAME", "reservationSharingPolicy": { "serviceShareType": "ALLOW_ALL" }, "specificReservation": { "count": "NUMBER_OF_VMS", "instanceProperties": { "machineType": "MACHINE_TYPE" } } }
Agar Compute Engine dapat menghapus pemesanan secara otomatis, pilih salah satu metode berikut:
Untuk menghapus pemesanan pada tanggal dan waktu tertentu, buat permintaan
POST
ke metodebeta.reservations.insert
. Dalam isi permintaan, sertakan kolomdeleteAtTime
.POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations { "deleteAtTime": "DELETE_AT_TIME", "name": "RESERVATION_NAME", "specificReservation": { "count": "NUMBER_OF_VMS", "instanceProperties": { "machineType": "MACHINE_TYPE" } } }
Ganti
DELETE_AT_TIME
dengan tanggal dan waktu yang diformat sebagai stempel waktu RFC 3339, yang harus seperti berikut:YYYY-MM-DDTHH:MM:SSOFFSET
Ganti kode berikut:
YYYY-MM-DD
: tanggal yang diformat sebagai tahun 4 digit, bulan 2 digit, dan hari 2 digit dalam bulan, yang dipisahkan oleh tanda hubung (-
).HH:MM:SS
: waktu yang diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit, yang dipisahkan oleh titik dua (:
).OFFSET
: zona waktu yang diformat sebagai offset dari Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan-08:00
. Atau, untuk tidak menggunakan penyeimbang, tentukanZ
.
Untuk menghapus pemesanan setelah durasi tertentu, buat permintaan
POST
ke metodebeta.reservations.insert
. Dalam isi permintaan, sertakan kolomdeleteAfterDuration
.POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations { "deleteAfterDuration": { "seconds": "DELETE_AFTER_DURATION" }, "name": "RESERVATION_NAME", "specificReservation": { "count": "NUMBER_OF_VMS", "instanceProperties": { "machineType": "MACHINE_TYPE" } } }
Ganti
DELETE_AFTER_DURATION
dengan durasi dalam detik. Misalnya, tentukan86400
untuk 86.400 detik (1 hari).
Pelajari cara melihat pemesanan Anda.
Pelajari cara melampirkan pemesanan ke komitmen.
Pelajari cara menggunakan pemesanan.
Pelajari cara memantau pemakaian pemesanan.
Terraform
Untuk menggunakan contoh Terraform di halaman ini dalam lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.
Untuk informasi selengkapnya, lihat Set up authentication for a local development environment.
REST
Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .
Peran yang diperlukan
Untuk mendapatkan izin yang diperlukan untuk membuat pemesanan satu project, minta administrator Anda untuk memberi Anda peran IAM Compute Admin (
roles/compute.admin
) di project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.Peran bawaan ini berisi izin yang diperlukan untuk membuat pemesanan satu project. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk membuat pemesanan satu project:
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Membuat pemesanan satu project
Untuk menggunakan pemesanan, VM harus memiliki properti yang sama persis dengan pemesanan tersebut. Untuk menentukan properti VM yang ingin Anda pesan, pilih salah satu bagian berikut dalam dokumen ini:
Secara default, pemesanan dapat otomatis dipakai oleh semua VM yang memiliki properti yang sama persis dengannya. Jika Anda ingin mengontrol pemakaian pemesanan, lakukan satu atau beberapa hal berikut:
Selain itu, Anda dapat menentukan kebijakan penempatan rapat saat membuat pemesanan khusus satu project. Kebijakan penempatan rapat menentukan bahwa VM harus ditempatkan sedekat mungkin satu sama lain untuk mengurangi latensi jaringan.
Menentukan template instance
Untuk menghindari error saat membuat pemesanan dengan menentukan template instance, pastikan hal berikut:
Untuk membuat pemesanan satu project dengan menentukan template instance, pilih salah satu opsi berikut:
Konsol
gcloud
Untuk membuat reservasi satu project, gunakan perintah
gcloud compute reservations create
.Untuk membuat pemesanan satu project dengan menentukan template instance dan tanpa menyertakan flag opsional, jalankan perintah berikut:
gcloud compute reservations create RESERVATION_NAME \ --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Ganti kode berikut:
Misalnya, untuk membuat reservasi untuk sepuluh VM di zona
us-central1-a
dengan menentukan template instance global, jalankan perintah berikut:gcloud compute reservations create my-reservation \ --source-instance-template=projects/example-project/global/example-instance-template \ --vm-count=10 \ --zone=us-central1-a
Secara opsional, Anda dapat melakukan satu atau beberapa hal berikut:
Go
Java
Node.js
Python
REST
Untuk membuat pemesanan satu project, buat permintaan
POST
ke metodereservations.insert
.Untuk membuat pemesanan satu project dengan menentukan template instance dan tanpa menyertakan flag opsional apa pun, buat permintaan
POST
berikut:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations { "name": "RESERVATION_NAME", "specificReservation": { "count": "NUMBER_OF_VMS", "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME" } }
Ganti kode berikut:
Misalnya, untuk membuat reservasi sepuluh VM di zona
us-central1-a
dengan menentukan template instance global, buat permintaanPOST
berikut:POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations { "name": "my-reservation", "specificReservation": { "count": "10", "sourceInstanceTemplate": "projects/example-project/global/instanceTemplates/example-instance-template" } }
Secara opsional, Anda dapat melakukan satu atau beberapa hal berikut:
Menentukan VM yang ada
Anda hanya dapat membuat reservasi berdasarkan VM yang ada di zona yang sama dengan VM.
Setelah membuat reservasi, Anda dapat menggunakannya dengan membuat VM yang memiliki properti yang cocok dengan VM referensi. Anda dapat melakukannya dengan melakukan salah satu tindakan berikut:
Untuk membuat reservasi satu project yang menggunakan properti VM yang ada, lakukan hal berikut:
Menentukan properti secara langsung
Untuk membuat pemesanan satu project dengan menentukan properti secara langsung, pilih salah satu opsi berikut:
Konsol
gcloud
Untuk membuat reservasi satu project, gunakan perintah
gcloud compute reservations create
.Untuk membuat pemesanan satu project dengan menentukan properti secara langsung dan tanpa menyertakan flag opsional, jalankan perintah berikut:
gcloud compute reservations create RESERVATION_NAME \ --machine-type=MACHINE_TYPE \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Ganti kode berikut:
Misalnya, untuk membuat reservasi di zona
us-central1-a
untuk sepuluh VM yang masing-masing menggunakan jenis mesin N2 yang telah ditetapkan dengan 4 vCPU, jalankan perintah berikut:gcloud compute reservations create my-reservation \ --machine-type=n2-standard-4 \ --vm-count=10 \ --zone=us-central1-a
Secara opsional, Anda dapat melakukan satu atau beberapa hal berikut:
Go
Java
Node.js
Python
Terraform
Untuk membuat pemesanan satu project, gunakan resource Terraform
google_compute_reservation
.Misalnya, untuk membuat pemesanan satu project untuk satu jenis mesin N2 yang telah ditentukan sebelumnya dengan 2 vCPU, gunakan resource berikut:
Untuk mengetahui informasi selengkapnya tentang cara menggunakan Terraform, lihat artikel Menggunakan Terraform dengan Google Cloud.
REST
Untuk membuat pemesanan satu project, buat permintaan
POST
ke metodereservations.insert
.Untuk membuat pemesanan satu project dengan menentukan properti secara langsung dan tanpa menyertakan kolom opsional apa pun, buat permintaan
POST
berikut:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations { "name": "RESERVATION_NAME", "specificReservation": { "count": "NUMBER_OF_VMS", "instanceProperties": { "machineType": "MACHINE_TYPE" } } }
Ganti kode berikut:
Misalnya, untuk membuat reservasi di zona
us-central1-a
untuk sepuluh VM yang masing-masing menggunakan jenis mesin N2 yang telah ditetapkan dengan 4 vCPU, buat permintaanPOST
berikut:POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations { "name": "my-reservation", "specificReservation": { "count": "10", "instanceProperties": { "machineType": "n2-standard-4", } } }
Secara opsional, Anda dapat melakukan satu atau beberapa hal berikut:
Pemecahan masalah
Pelajari cara memecahkan masalah pembuatan reservasi.
Langkah berikutnya
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-14 UTC.
-