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 Trusted Cloud by S3NS 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 Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.
gcloud
-
Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:
gcloud init
- Set a default region and zone.
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.
Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda.
Create local authentication credentials for your user account:
gcloud auth application-default login
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 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.
Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda.
Create local authentication credentials for your user account:
gcloud auth application-default login
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 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.
Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda.
Create local authentication credentials for your user account:
gcloud auth application-default login
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 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.
Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda.
Create local authentication credentials for your user account:
gcloud auth application-default login
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 informasi selengkapnya, lihat Set up authentication for a local development environment.
REST
Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, Anda menggunakan 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 Trusted 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:
-
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
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
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.
REST
Untuk melihat properti instance yang ada, buat permintaan
GET
ke metodeinstances.get
:GET https://compute.s3nsapis.fr/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.s3nsapis.fr/compute/v1/projects/example-project/zones/us-central-1/instances/instance-01?mostDisruptiveAllowedAction=RESTART { ... "reservationAffinity": { "consumeReservationType": "NO_RESERVATION" }, ... }
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
Di konsol Trusted 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.
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:
INSTANCE_NAME
: nama instance.MACHINE_TYPE
: jenis mesin yang akan digunakan untuk instance.ZONE
: zona tempat instance akan dibuat.
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.s3nsapis.fr/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:
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.
Untuk mengetahui informasi selengkapnya tentang cara membuat instance, lihat Membuat dan memulai instance Compute Engine.
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:
Mencegah instance komputasi dalam grup instance terkelola (MIG) menggunakan reservasi saat Anda melakukan hal berikut:
Untuk membuat template instance yang mengonfigurasi instance agar tidak menggunakan reservasi, pilih salah satu opsi berikut:
Konsol
Di konsol Trusted 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.
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:
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.
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:Untuk membuat template instance global: Metode
instanceTemplates.insert
.Untuk membuat template instance regional: metode
regionInstanceTemplates.insert
.
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.s3nsapis.fr/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:
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.
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-08-19 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-08-19 UTC."],[[["This document outlines methods to prevent Compute Engine instances from consuming reservations, which is useful for tasks like testing or isolated deployments."],["You can configure existing or new instances to not consume reservations by setting the `reservationAffinity` property to `NO_RESERVATION`."],["Methods to prevent reservation consumption include updating an existing instance, creating a new instance, creating instances in bulk, and creating instance templates."],["To update an existing instance, you can export the properties to a YAML file, modify it to set `consumeReservationType` to `NO_RESERVATION`, then update the instance using the updated file and restart."],["When creating new instances, instance templates, or bulk instances, setting the `--reservation-affinity` flag to `none` or the `consumeReservationType` to `NO_RESERVATION` in the request body will prevent them from consuming reservations."]]],[]] -