Dokumen ini menjelaskan cara mencegah instance Compute Engine menggunakan pemesanan. Untuk mempelajari pemesanan lebih lanjut, lihat Pemesanan resource zona Compute Engine.
Pemesanan yang digunakan secara otomatis memungkinkan instance dengan properti yang cocok dengan reservasi untuk menggunakannya secara otomatis. Untuk mencegah instance menggunakan reservasi, lakukan salah satu hal berikut:
Konfigurasikan instance agar tidak menggunakan 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, proses debug, atau deployment terisolasi.
Batasan
Anda hanya dapat mengupdate instance yang ada agar tidak menggunakan reservasi jika instance tersebut dikonfigurasi untuk otomatis menggunakan reservasi yang cocok.
Sebelum memulai
-
Jika Anda belum melakukannya, siapkan autentikasi.
Autentikasi adalah
proses yang digunakan untuk memverifikasi identitas Anda agar dapat mengakses Google Cloud layanan dan API.
Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat mengautentikasi 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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
- Install the Google Cloud CLI.
-
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.
- Install the Google Cloud CLI.
-
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.
- Install the Google Cloud CLI.
-
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.
- Install the Google Cloud CLI.
-
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.
-
Untuk membuat pemesanan:
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 guna 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
pada 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
di project atau di 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
pada project - Untuk menetapkan tag untuk VM:
compute.instances.setTags
di VM - Untuk menetapkan label untuk VM:
compute.instances.setLabels
di VM - Untuk menetapkan akun layanan yang akan digunakan VM:
compute.instances.setServiceAccount
di VM - Untuk membuat disk baru bagi VM:
compute.disks.create
pada 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 di 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 memulai 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 di 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 dibuat.PROJECT_ID
: ID project tempat Anda ingin membuat instance.ZONE
: zona tempat instance 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 informasi selengkapnya tentang project image yang didukung, lihat Image publik.IMAGE
: tentukan salah satu dari hal berikut:Versi image OS tertentu; misalnya,
debian-12-bookworm-v20240617
.Kelompok image, yang harus diformat sebagai
family/IMAGE_FAMILY
. Tindakan ini menentukan image OS terbaru yang masih digunakan. 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 membuat instance 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 diawali 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 informasi selengkapnya tentang project image yang didukung, lihat Image publik.IMAGE
: tentukan salah satu dari hal berikut:Versi image OS tertentu; misalnya,
debian-12-bookworm-v20240617
.Kelompok image, yang harus diformat sebagai
family/IMAGE_FAMILY
. Tindakan ini menentukan image OS terbaru yang masih digunakan. 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.
Cegah instance komputasi di grup instance terkelola (MIG) agar tidak 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 Location, tentukan apakah Anda ingin membuat template instance regional (default) atau global.
Di bagian Machine configuration, 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 membuat template instance.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 informasi selengkapnya tentang project image yang didukung, lihat Image publik.IMAGE
: tentukan salah satu dari hal berikut:Versi image OS tertentu; misalnya,
debian-12-bookworm-v20240617
.Kelompok image, yang harus diformat sebagai
family/IMAGE_FAMILY
. Tindakan ini menentukan image OS terbaru yang masih digunakan. 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.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Untuk informasi selengkapnya, lihat Mengautentikasi untuk menggunakan REST dalam Google Cloud dokumentasi autentikasi.
Peran yang diperlukan
Untuk mendapatkan izin yang Anda perlukan guna mencegah instance komputasi 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 tersebut efektif, 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 reservasi, 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 instance secara massal
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 reservasi, gunakan perintah
gcloud compute instances bulk create
dengan flag--reservation-affinity
yang ditetapkan kenone
.Misalnya, untuk membuat instance secara massal di 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 di 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 pemesanan, pilih salah satu opsi berikut:
Konsol
gcloud
Untuk membuat template instance yang mengonfigurasi instance agar tidak menggunakan pemesanan, 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 pemesanan, jalankan perintah berikut. Jika Anda 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 untuk tidak menggunakan pemesanan, 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, baca 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-03-04 UTC.
-