Dokumen ini menjelaskan cara mencegah instance Compute Engine menggunakan reservasi. Untuk mempelajari pemesanan lebih lanjut, lihat Pemesanan resource zona Compute Engine.
Reservasi yang digunakan secara otomatis memungkinkan instance dengan properti yang cocok dengan reservasi untuk otomatis menggunakannya. Untuk mencegah instance menggunakan reservasi, lakukan salah satu tindakan berikut:
Konfigurasi instance agar tidak memakai reservasi, seperti yang dijelaskan dalam dokumen ini.
Membuat atau memperbarui instance dengan properti yang tidak cocok dengan reservasi.
Anda dapat menghindari penggunaan reservasi saat ingin menggunakan instance untuk tugas seperti pengujian, pen-debug-an, atau deployment terisolasi.
Batasan
Anda hanya dapat memperbarui instance yang ada agar tidak menggunakan pemesanan jika instance dikonfigurasi untuk otomatis menggunakan pemesanan yang cocok.
Sebelum memulai
-
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.
-
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.
-
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.
-
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.
-
Untuk membuat reservasi:
compute.reservations.create
pada project -
Untuk membuat instance:
compute.instances.create
pada project- Untuk menggunakan image kustom guna membuat VM:
compute.images.useReadOnly
pada image - Untuk menggunakan snapshot untuk membuat VM:
compute.snapshots.useReadOnly
pada snapshot - Untuk menggunakan template instance guna membuat VM:
compute.instanceTemplates.useReadOnly
di template instance - Untuk menetapkan jaringan lama ke VM:
compute.networks.use
di project - Untuk menentukan alamat IP statis untuk VM:
compute.addresses.use
di project - Untuk menetapkan alamat IP eksternal ke VM saat menggunakan jaringan lama:
compute.networks.useExternalIp
di project - Untuk menentukan subnet bagi VM:
compute.subnetworks.use
pada project atau pada subnet yang dipilih - Untuk menetapkan alamat IP eksternal ke VM saat menggunakan jaringan VPC:
compute.subnetworks.useExternalIp
di project atau di subnet yang dipilih - Untuk menetapkan metadata instance VM untuk VM:
compute.instances.setMetadata
di project - Untuk menyetel tag untuk VM:
compute.instances.setTags
di VM - Untuk menyetel label VM:
compute.instances.setLabels
di VM - Untuk menyetel akun layanan yang akan digunakan VM:
compute.instances.setServiceAccount
di VM - Untuk membuat disk baru untuk VM:
compute.disks.create
di project - Untuk memasang disk yang ada dalam mode hanya baca atau baca-tulis:
compute.disks.use
pada disk - Untuk memasang disk yang ada dalam mode hanya baca:
compute.disks.useReadOnly
pada disk
-
Untuk membuat template instance:
compute.instanceTemplates.create
pada project Buat file YAML kosong.
Untuk mengekspor properti instance ke file YAML yang baru saja Anda buat, gunakan perintah
gcloud compute instances export
:gcloud compute instances export INSTANCE_NAME \ --destination=YAML_FILE \ --zone=ZONE
Ganti kode berikut:
INSTANCE_NAME
: nama instance.YAML_FILE
: jalur ke file YAML kosong yang Anda buat pada langkah sebelumnya.ZONE
: zona tempat instance berada.
Dalam file konfigurasi YAML, tetapkan
consumeReservationType
keNO_RESERVATION
:reservationAffinity: consumeReservationType: NO_RESERVATION
Untuk memperbarui instance dan memulai ulang, gunakan perintah
gcloud compute instances update-from-file
dengan flag--most-disruptive-allowed-action
yang ditetapkan keRESTART
:gcloud compute instances update-from-file INSTANCE_NAME \ --most-disruptive-allowed-action=RESTART \ --source=YAML_FILE \ --zone=ZONE
Ganti kode berikut:
INSTANCE_NAME
: nama instance.YAML_FILE
: jalur ke file YAML dengan data konfigurasi yang Anda ubah di langkah sebelumnya.ZONE
: zona tempat instance berada.
Untuk melihat properti instance yang ada, buat permintaan
GET
ke metodeinstances.get
:GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME
Ganti kode berikut:
PROJECT_ID
: ID project tempat Anda membuat instance.ZONE
: zona tempat instance berada.INSTANCE_NAME
: nama instance.
Simpan output dari permintaan
GET
dalam file atau editor teks. Ubah output yang disalin untuk mengubah kolomconsumeReservationType
menjadiNO_RESERVATION
:{ ... "reservationAffinity": { "consumeReservationType": "NO_RESERVATION" }, ... }
Untuk mengupdate instance dan memulainya ulang, buat permintaan
PUT
ke metodeinstances.update
. Dalam permintaan, lakukan hal berikut:Di URL permintaan, sertakan parameter kueri
mostDisruptiveAllowedAction
yang ditetapkan keRESTART
.Untuk isi permintaan, gunakan output dari permintaan
GET
yang Anda edit pada langkah sebelumnya.
Permintaannya mirip dengan contoh berikut:
PUT https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central-1/instances/instance-01?mostDisruptiveAllowedAction=RESTART { ... "reservationAffinity": { "consumeReservationType": "NO_RESERVATION" }, ... }
Di konsol Google Cloud , buka halaman Create an instance.
Di kolom Name, masukkan nama untuk instance.
Di daftar Region dan Zone, pilih region dan zona tempat instance akan dibuat.
Tentukan jenis mesin yang akan digunakan untuk instance.
Di menu navigasi, klik Lanjutan.
Di bagian Reservations, pilih Don't use a reservation.
Klik Buat.
INSTANCE_NAME
: nama instance.MACHINE_TYPE
: jenis mesin yang akan digunakan untuk instance.ZONE
: zona tempat instance akan dibuat.PROJECT_ID
: ID project tempat Anda ingin membuat instance.ZONE
: zona tempat instance akan dibuat.INSTANCE_NAME
: nama instance.MACHINE_TYPE
: jenis mesin yang akan digunakan untuk instance.IMAGE_PROJECT
: project image yang berisi image OS; misalnya,debian-cloud
. Untuk mengetahui informasi selengkapnya tentang project gambar yang didukung, lihat Gambar publik.IMAGE
: tentukan salah satu dari berikut ini:Versi tertentu dari image OS; misalnya,
debian-12-bookworm-v20240617
.Kelompok image, yang harus diformat sebagai
family/IMAGE_FAMILY
. Tindakan ini menentukan image OS terbaru yang tidak digunakan lagi. Misalnya, jika Anda menentukanfamily/debian-12
, versi terbaru dalam kelompok image Debian 12 akan digunakan. Untuk mengetahui informasi selengkapnya tentang penggunaan kelompok image, lihat Praktik terbaik kelompok image.
COUNT
: jumlah instance yang akan dibuat.MACHINE_TYPE
: jenis mesin yang akan digunakan untuk instance.NAME_PATTERN
: pola nama untuk instance. Untuk mengganti urutan angka dalam nama instance, gunakan urutan karakter hash (#
). Misalnya, menggunakaninstance-#
untuk pola nama akan menghasilkan instance dengan nama yang dimulai denganinstance-1
,instance-2
, dan berlanjut hingga jumlah instance yang ditentukan olehCOUNT
.ZONE
: zona tempat membuat instance secara massal.PROJECT_ID
: ID project tempat instance akan dibuat secara massal.ZONE
: zona tempat membuat instance secara massal.COUNT
: jumlah instance yang akan dibuat.NAME_PATTERN
: pola nama untuk instance. Untuk mengganti urutan angka dalam nama instance, gunakan urutan karakter hash (#
). Misalnya, menggunakaninstance-#
untuk pola nama akan menghasilkan instance dengan nama yang dimulai denganinstance-1
,instance-2
, dan berlanjut hingga jumlah instance yang ditentukan olehCOUNT
.MACHINE_TYPE
: jenis mesin yang akan digunakan untuk instance.IMAGE_PROJECT
: project image yang berisi image OS; misalnya,debian-cloud
. Untuk mengetahui informasi selengkapnya tentang project gambar yang didukung, lihat Gambar publik.IMAGE
: tentukan salah satu dari berikut ini:Versi tertentu dari image OS; misalnya,
debian-12-bookworm-v20240617
.Kelompok image, yang harus diformat sebagai
family/IMAGE_FAMILY
. Tindakan ini menentukan image OS terbaru yang tidak digunakan lagi. Misalnya, jika Anda menentukanfamily/debian-12
, versi terbaru dalam kelompok image Debian 12 akan digunakan. Untuk mengetahui informasi selengkapnya tentang penggunaan kelompok image, lihat Praktik terbaik kelompok image.
Mencegah instance komputasi dalam grup instance terkelola (MIG) menggunakan reservasi saat Anda melakukan hal berikut:
Di konsol Google Cloud , buka halaman Create an instance template.
Di kolom Name, masukkan nama untuk template instance.
Di bagian Lokasi, tentukan apakah Anda ingin membuat template instance regional (default) atau global.
Di bagian Konfigurasi mesin, tentukan jenis mesin yang akan digunakan untuk instance yang dibuat menggunakan template.
Luaskan bagian Opsi lanjutan, lalu lakukan hal berikut:
Luaskan bagian Management.
Di bagian Reservations, pilih Don't use a reservation.
Klik Buat.
INSTANCE_TEMPLATE_NAME
: nama template instance.REGION
: region tempat membuat template instance.MACHINE_TYPE
: jenis mesin yang akan digunakan untuk instance yang dibuat menggunakan template instance.Untuk membuat template instance global: Metode
instanceTemplates.insert
.Untuk membuat template instance regional: metode
regionInstanceTemplates.insert
.PROJECT_ID
: ID project tempat template instance akan dibuat.INSTANCE_TEMPLATE_NAME
: nama template instance.MACHINE_TYPE
: jenis mesin yang akan digunakan untuk instance yang dibuat menggunakan template instance.IMAGE_PROJECT
: project image yang berisi image OS; misalnya,debian-cloud
. Untuk mengetahui informasi selengkapnya tentang project gambar yang didukung, lihat Gambar publik.IMAGE
: tentukan salah satu dari berikut ini:Versi tertentu dari image OS; misalnya,
debian-12-bookworm-v20240617
.Kelompok image, yang harus diformat sebagai
family/IMAGE_FAMILY
. Tindakan ini menentukan image OS terbaru yang tidak digunakan lagi. Misalnya, jika Anda menentukanfamily/debian-12
, versi terbaru dalam kelompok image Debian 12 akan digunakan. Untuk mengetahui informasi selengkapnya tentang penggunaan kelompok image, lihat Praktik terbaik kelompok image.
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 informasi selengkapnya, lihat Set up authentication for a local development environment.
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 informasi selengkapnya, lihat Set up authentication for a local development environment.
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 informasi selengkapnya, lihat Set up authentication for a local development environment.
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 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 Anda perlukan agar instance komputasi tidak menggunakan reservasi, minta administrator untuk memberi Anda peran IAM Compute Instance Admin (v1) (
roles/compute.instanceAdmin.v1
) 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 mencegah instance komputasi menggunakan reservasi. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk mencegah instance komputasi menggunakan reservasi:
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Mencegah pemakaian reservasi
Untuk mencegah instance komputasi menggunakan reservasi, tetapkan properti afinitas reservasi (
reservationAffinity
) agar tidak menggunakan reservasi. Properti ini mengontrol apakah instance dapat menggunakan reservasi yang cocok, reservasi tertentu, atau tidak ada reservasi.Untuk mencegah satu atau beberapa instance menggunakan reservasi, gunakan salah satu metode berikut:
Mencegah penggunaan di instance yang ada
Anda dapat mengupdate instance yang sedang berjalan sehingga tidak lagi otomatis menggunakan reservasi. Anda harus memulai ulang instance agar perubahan diterapkan, seperti yang dijelaskan di bagian ini.
Untuk mencegah instance yang ada menggunakan reservasi, pilih salah satu opsi berikut:
gcloud
REST
Untuk mengetahui informasi selengkapnya tentang cara mengupdate instance, lihat Memperbarui properti instance.
Mencegah penggunaan saat membuat instance
Untuk membuat instance komputasi yang tidak dapat menggunakan reservasi, pilih salah satu opsi berikut:
Konsol
gcloud
Untuk membuat instance yang tidak dapat menggunakan pemesanan, gunakan perintah
gcloud compute instances create
dengan flag--reservation-affinity
yang ditetapkan kenone
:gcloud compute instances create INSTANCE_NAME \ --machine-type=MACHINE_TYPE \ --reservation-affinity=none \ --zone=ZONE
Ganti kode berikut:
Go
Untuk membuat instance yang tidak dapat menggunakan reservasi, gunakan contoh kode berikut:
Java
Untuk membuat instance yang tidak dapat menggunakan reservasi, gunakan contoh kode berikut:
Node.js
Untuk membuat instance yang tidak dapat menggunakan reservasi, gunakan contoh kode berikut:
Python
Untuk membuat instance yang tidak dapat menggunakan reservasi, gunakan contoh kode berikut:
REST
Untuk membuat instance yang tidak dapat menggunakan reservasi, buat permintaan
POST
ke metodeinstances.insert
. Dalam isi permintaan, sertakan kolomconsumeReservationType
yang ditetapkan keNO_RESERVATION
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances { "name": "INSTANCE_NAME", "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE", "disks": [ { "boot": true, "initializeParams": { "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE" } } ], "networkInterfaces": [ { "network": "global/networks/default" } ], "reservationAffinity": { "consumeReservationType": "NO_RESERVATION" } }
Ganti kode berikut:
Untuk mengetahui informasi selengkapnya tentang cara membuat instance, lihat Membuat dan memulai instance Compute Engine.
Mencegah penggunaan saat membuat beberapa instance sekaligus
Untuk membuat instance komputasi secara massal yang tidak dapat menggunakan reservasi, pilih salah satu opsi berikut:
gcloud
Untuk membuat instance secara massal yang tidak dapat menggunakan pemesanan, gunakan perintah
gcloud compute instances bulk create
dengan flag--reservation-affinity
yang ditetapkan kenone
.Misalnya, untuk membuat instance secara massal dalam satu zona dan menentukan pola nama, jalankan perintah berikut:
gcloud compute instances bulk create \ --count=COUNT \ --machine-type=MACHINE_TYPE \ --name-pattern="NAME_PATTERN" \ --reservation-affinity=none \ --zone=ZONE
Ganti kode berikut:
REST
Untuk membuat instance secara massal yang tidak dapat menggunakan reservasi, buat permintaan
POST
ke metodeinstances.bulkInsert
. Dalam isi permintaan, sertakan kolomconsumeReservationType
yang ditetapkan keNO_RESERVATION
.Misalnya, untuk membuat instance secara massal dalam satu zona dan menentukan pola nama, buat permintaan sebagai berikut:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert { "count": COUNT, "namePattern": "NAME_PATTERN", "instanceProperties": { "machineType": "MACHINE_TYPE", "disks": [ { "boot": true, "initializeParams": { "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE" } } ], "networkInterfaces": [ { "network": "global/networks/default" } ], "reservationAffinity": { "consumeReservationType": "NO_RESERVATION" } } }
Ganti kode berikut:
Untuk mengetahui informasi selengkapnya tentang cara membuat instance secara massal, lihat Membuat VM secara massal.
Mencegah penggunaan saat membuat template instance
Setelah membuat template instance yang mengonfigurasi instance agar tidak menggunakan reservasi, Anda dapat menggunakan template tersebut untuk melakukan hal berikut:
Untuk membuat template instance yang mengonfigurasi instance agar tidak menggunakan reservasi, pilih salah satu opsi berikut:
Konsol
gcloud
Untuk membuat template instance yang mengonfigurasi instance agar tidak menggunakan reservasi, gunakan perintah
gcloud compute instances-templates create
dengan flag--reservation-affinity
yang ditetapkan kenone
.Untuk membuat template instance regional yang mengonfigurasi instance agar tidak menggunakan reservasi, jalankan perintah berikut. Jika ingin membuat template instance global, gunakan perintah yang sama tanpa flag
--instance-template-region
.gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \ --instance-template-region=REGION \ --machine-type=MACHINE_TYPE \ --reservation-affinity=none
Ganti kode berikut:
Go
Untuk membuat template instance yang mengonfigurasi instance agar tidak menggunakan reservasi, gunakan contoh kode berikut:
Java
Untuk membuat template instance yang mengonfigurasi instance agar tidak menggunakan reservasi, gunakan contoh kode berikut:
Node.js
Untuk membuat template instance yang mengonfigurasi instance agar tidak menggunakan reservasi, gunakan contoh kode berikut:
Python
Untuk membuat template instance yang mengonfigurasi instance agar tidak menggunakan reservasi, gunakan contoh kode berikut:
REST
Untuk membuat template instance yang mengonfigurasi instance agar tidak menggunakan pemesanan, buat permintaan
POST
ke salah satu metode berikut:Dalam isi permintaan, sertakan kolom
consumeReservationType
dan tetapkan keNO_RESERVATION
.Misalnya, untuk membuat template instance regional dan menentukan agar tidak menggunakan reservasi, buat permintaan sebagai berikut:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/InstanceTemplates { "name": "INSTANCE_TEMPLATE_NAME", "properties": { "machineType": "MACHINE_TYPE", "disks": [ { "boot": true, "initializeParams": { "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE" } } ], "networkInterfaces": [ { "network": "global/networks/default" } ], "reservationAffinity": { "consumeReservationType": "NO_RESERVATION" } } }
Ganti kode berikut:
Untuk mengetahui informasi selengkapnya tentang cara membuat template instance, lihat Membuat template instance.
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.
-