Dokumen ini menjelaskan cara membatasi runtime instance virtual machine (VM) baru atau yang sudah ada dan cara memantau runtime VM tersebut. Untuk grup instance terkelola (MIG), lihat Membatasi waktu berjalan MIG.
Saat membatasi waktu berjalan VM, Anda dapat menjadwalkan VM untuk dihentikan (dihentikan atau dihapus) secara otomatis saat mencapai batas waktu tertentu (durasi atau waktu). Gunakan batas waktu untuk membantu mengoptimalkan workload sementara—dengan membatasi runtime VM secara otomatis, Anda dapat membantu meminimalkan biaya dan mengosongkan kuota.
Untuk mempelajari cara menghentikan VM secara langsung, lihat artikel Menghentikan atau memulai ulang VM. Untuk mempelajari cara menghapus VM secara langsung, lihat artikel Menghapus VM.
Sebelum memulai
-
Untuk mendapatkan izin yang Anda perlukan untuk membatasi waktu berjalan VM, 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.Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.
-
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.
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. Setelah login, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:
gcloud init
Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Trusted Cloud .
Pembatasan
Membatasi waktu berjalan VM memiliki batasan berikut:
Tindakan penghentian otomatis harus berupa penghentian atau penghapusan. Anda tidak dapat mengonfigurasi VM agar ditangguhkan secara otomatis saat batas waktu tercapai.
Batas waktu minimum adalah 30 detik dan batas waktu maksimum adalah 120 hari.
Penghentian otomatis mungkin memerlukan waktu hingga 30 detik lebih lama dari durasi atau waktu yang Anda tentukan untuk mulai menghentikan atau menghapus VM.
Anda tidak dapat menggunakan batas waktu dengan preemptible VM lama. Sebagai gantinya, gunakan batas waktu dengan Spot VM.
Data SSD lokal VM tidak dapat dipertahankan saat VM dihentikan secara otomatis karena batas waktu. Untuk mengetahui informasi selengkapnya, lihat artikel Menghentikan VM dengan SSD Lokal.
Membatasi waktu berjalan VM baru
Bagian berikut menjelaskan cara mengonfigurasi batas waktu saat membuat VM baru. Anda dapat menentukan batas waktu, yaitu kapan Anda ingin VM dihentikan secara otomatis, baik sebagai durasi (
maxRunDuration
) maupun waktu (terminationTime
).Saat memutuskan jenis batas waktu untuk VM, pertimbangkan bahwa VM mungkin terganggu—misalnya, oleh permintaan pengguna atau oleh peristiwa host. Perilaku batas waktu bervariasi berdasarkan jenis gangguan dan jenis batas waktu:
Stempel waktu penghentian VM (
terminationTimestamp
) adalah kolom hanya baca yang menunjukkan waktu yang direncanakan untuk penghentian otomatis dan ditentukan secara otomatis oleh Compute Engine setiap kali VM memiliki batas waktu dan memasuki statusRUNNING
.Stempel waktu penghentian akan otomatis dihapus setiap kali VM dihentikan atau ditangguhkan. Namun, stempel waktu penghentian tidak berubah saat Anda mereset atau memulai ulang VM.
Stempel waktu penghentian akan otomatis didefinisikan ulang setiap kali VM dimulai ulang atau dilanjutkan berdasarkan jenis batas waktu yang Anda tetapkan:
- Jika Anda menetapkan durasi untuk VM, stempel waktu penghentian akan dihitung ulang dengan menambahkan durasi tersebut ke waktu mulai terbaru VM.
- Jika Anda menetapkan waktu untuk VM, stempel waktu penghentian akan ditetapkan ke waktu tersebut. Namun, waktu harus di masa mendatang; jika tidak, permintaan untuk membuat atau menjalankan ulang VM akan gagal hingga Anda memperbarui atau menghapus waktu tersebut.
Menyetel durasi
Durasi menunjukkan total waktu berjalan yang Anda inginkan untuk VM. Untuk membuat VM yang otomatis dihentikan setelah VM berjalan selama durasi tertentu, gunakan Trusted Cloud konsol, Google Cloud CLI, Terraform, atau Compute Engine API.
Konsol
Di konsol Trusted Cloud , buka halaman Create an instance.
Di bagian Kebijakan ketersediaan, luaskan Setelan lanjutan model penyediaan VM.
Centang kotak Set a time limit for the VM. Kolom Jenis batas waktu akan muncul.
Di kolom Time limit type, pilih By hours (default) untuk menentukan batas waktu sebagai durasi. Pada kolom berikut, masukkan durasi dalam jam.
Dalam daftar On VM termination, pilih apa yang terjadi saat waktu proses VM mencapai batas waktu yang ditentukan:
- Untuk menghentikan VM secara otomatis, pilih Stop (default).
- Untuk menghapus VM, pilih Delete.
Opsional: Tentukan opsi VM lainnya. Untuk mengetahui informasi selengkapnya, baca Membuat dan memulai instance VM.
Untuk membuat dan meluncurkan VM, klik Create.
gcloud
Untuk membuat VM dari gcloud CLI, gunakan perintah
gcloud compute instances create
.- Untuk membuat VM yang otomatis dihentikan setelah durasi tertentu, Anda harus menyertakan flag
--max-run-duration
. - Untuk menentukan tindakan penghentian, sertakan
flag
--instance-termination-action
. - Konfigurasi
flag
--discard-local-ssds-at-termination-timestamp
:- Jika VM memiliki SSD lokal dan tindakan penghentian
(
TERMINATION_ACTION
) adalah stop (STOP
), Anda harus menyertakan flag--discard-local-ssds-at-termination-timestamp=true
. - Jika tidak, hilangkan tanda
--discard-local-ssds-at-termination-timestamp
.
- Jika VM memiliki SSD lokal dan tindakan penghentian
(
gcloud compute instances create VM_NAME \ --max-run-duration=DURATION \ --instance-termination-action=TERMINATION_ACTION
Ganti kode berikut:
VM_NAME
: Nama VM baru.DURATION
: Durasi yang Anda inginkan agar VM ini berjalan sebelum dihentikan secara otomatis. Format durasi sebagai jumlah hari, jam, menit, dan detik diikuti dengand
,h
,m
, dans
. Misalnya, tentukan30m
untuk durasi 30 menit, atau tentukan1d2h3m4s
untuk durasi 1 hari, 2 jam, 3 menit, dan 4 detik. Durasi minimum adalah 30 detik (30s
) dan durasi maksimum adalah 120 hari (120d
).TERMINATION_ACTION
: Tindakan penghentian untuk VM ini, yang dapat berupa hentikan (STOP
) atau hapus (DELETE
). Berdasarkan model penyediaan VM, kolom ini mungkin wajib diisi atau memiliki nilai default:- Jika ini adalah Spot VM (jika VM menggunakan flag
--provisioning-model=SPOT
), flag--instance-termination-action=TERMINATION_ACTION
akan bersifat opsional. Jika flag ini dihilangkan, tindakan penghentian default adalah berhenti. - Jika tidak (default), flag
--instance-termination-action=TERMINATION_ACTION
diperlukan.
- Jika ini adalah Spot VM (jika VM menggunakan flag
Untuk mengetahui informasi selengkapnya tentang opsi lain yang dapat Anda tentukan saat membuat VM, lihat Membuat dan memulai instance VM.
Terraform
Untuk membuat VM menggunakan Terraform, gunakan resource
google_compute_instance
.- Untuk membuat VM yang otomatis dihentikan setelah durasi tertentu, Anda harus menyertakan
argumen
max_run_duration
. - Untuk menentukan tindakan penghentian, sertakan
argumen
instance_termination_action
. Anda harus menyertakan argumeninstance_termination_action
kecuali jika Anda membuat Spot VM (tetapkan argumenprovisioning_model
keSPOT
), yang secara default akan berhenti (STOP
). - Konfigurasi argumen
on_instance_stop_action
:- Jika VM memiliki SSD lokal dan tindakan penghentian
(argumen
instance_termination_action
) adalah stop (STOP
), Anda harus menetapkan argumenon_instance_stop_action
ke benar (true
). - Jika tidak, hapus argumen
on_instance_stop_action
.
- Jika VM memiliki SSD lokal dan tindakan penghentian
(argumen
Untuk mengetahui informasi selengkapnya, lihat dokumentasi Terraform untuk resource
google_compute_instance
.REST
Untuk membuat VM dari Compute Engine API, gunakan metode
instances.insert
. Anda harus menentukan nama, jenis mesin, dan boot disk untuk VM.Untuk membuat VM yang otomatis dihentikan setelah durasi tertentu, Anda harus menyertakan kolom
maxRunDuration
. Untuk menentukan tindakan penghentian, sertakan kolominstanceTerminationAction
, yang bersifat opsional untuk Spot VM.POST https://compute.googleapis.com/compute/v1/projects/
PROJECT_ID
/zones/ZONE
/instances { "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE", "name": "VM_NAME
", "disks": [ { "initializeParams": { "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE" }, "boot": true } ] "scheduling": { "maxRunDuration": { "seconds": DURATION }, "instanceTerminationAction": "TERMINATION_ACTION" }, }Ganti properti berikut:
PROJECT_ID
: Project ID dari project tempat VM dibuat.ZONE
: Zona untuk membuat VM. Zona tersebut juga harus mendukung jenis mesin yang akan digunakan untuk VM baru.MACHINE_TYPE
: Jenis mesin yang telah ditentukan atau kustom untuk VM baru.VM_NAME
: Nama VM baru.IMAGE_PROJECT
: Project yang berisi gambar. Misalnya, jika Anda menetapkanfamily/debian-10
sebagai image, tetapkandebian-cloud
sebagai project image.IMAGE
: Image untuk VM baru. Anda dapat menentukan versi tertentu dari image publik atau kelompok image. Misalnya, jika Anda menentukanfamily/debian-10
sebagai image dandebian-cloud
sebagai project image, Compute Engine akan membuat VM dari versi terbaru OS image dalam kelompok image Debian 10.DURATION
: Durasi dalam detik yang Anda inginkan agar VM ini berjalan sebelum dihentikan secara otomatis. Durasi minimum adalah 30 detik (30s
) dan durasi maksimum adalah 120 hari (120d
).TERMINATION_ACTION
: Tindakan penghentian untuk VM ini, yang dapat berupa hentikan (STOP
) atau hapus (DELETE
). Berdasarkan model penyediaan VM, kolom ini mungkin wajib diisi atau memiliki nilai default:- Jika ini adalah Spot VM (jika VM menggunakan kolom
"provisioningModel": "SPOT"
), kolom"instanceTerminationAction": "TERMINATION_ACTION"
akan bersifat opsional. Jika kolom ini dihilangkan, tindakan penghentian default adalah berhenti. - Jika tidak (default), kolom
"instanceTerminationAction": "TERMINATION_ACTION"
akan diperlukan.
- Jika ini adalah Spot VM (jika VM menggunakan kolom
Untuk informasi selengkapnya tentang opsi yang dapat Anda tentukan saat membuat VM, lihat Membuat dan memulai instance VM.
Menyetel waktu
Waktu mewakili tanggal, waktu, dan zona waktu kapan Anda ingin VM dihentikan. Untuk membuat VM yang otomatis dihentikan pada waktu tertentu, gunakan Trusted Cloud konsol, Google Cloud CLI, atau Compute Engine API.
Konsol
Di konsol Trusted Cloud , buka halaman Create an instance.
Di bagian Kebijakan ketersediaan, luaskan Setelan lanjutan model penyediaan VM.
Centang kotak Set a time limit for the VM. Kolom Jenis batas waktu akan muncul.
Di kolom Time limit type, pilih By date untuk menentukan batas waktu sebagai waktu dan tanggal. Di kolom berikut, klik
Select date and time, lalu pilih tanggal, waktu, dan zona waktu untuk batas waktu.Dalam daftar On VM termination, pilih apa yang terjadi saat waktu proses VM mencapai batas waktu yang ditentukan:
- Untuk menghentikan VM secara otomatis, pilih Stop (default).
- Untuk menghapus VM, pilih Delete.
Opsional: Tentukan opsi VM lainnya. Untuk mengetahui informasi selengkapnya, baca Membuat dan memulai instance VM.
Untuk membuat dan meluncurkan VM, klik Create.
gcloud
Untuk membuat VM dari gcloud CLI, gunakan perintah
gcloud compute instances create
.- Untuk membuat VM yang otomatis dihentikan pada waktu tertentu, Anda harus menyertakan flag
--termination-time
. - Untuk menentukan tindakan penghentian, sertakan
flag
--instance-termination-action
, yang bersifat opsional untuk Spot VM. - Konfigurasi
flag
--discard-local-ssds-at-termination-timestamp
:- Jika VM memiliki SSD lokal dan menetapkan tindakan penghentian
(
TERMINATION_ACTION
) ke berhenti (STOP
), Anda harus menyertakan tanda--discard-local-ssds-at-termination-timestamp=true
flag. - Jika tidak, hilangkan tanda
--discard-local-ssds-at-termination-timestamp
.
- Jika VM memiliki SSD lokal dan menetapkan tindakan penghentian
(
gcloud compute instances create VM_NAME \ --termination-time=TIME \ --instance-termination-action=TERMINATION_ACTION
Ganti kode berikut:
VM_NAME
: Nama VM baru.TIME
: Waktu Anda ingin VM ini dihentikan secara otomatis. Waktu yang Anda tentukan harus minimal 30 detik ke depan dan maksimal 120 hari ke depan. Format waktu sebagai stempel waktu RFC 3339:YYYY-MM-DDTHH:MM:SSOFFSET
Ganti properti berikut:
YYYY-MM-DD
: Tanggal dengan format 4 digit tahun, 2 digit bulan, dan 2 digit hari dalam sebulan yang dipisahkan dengan tanda hubung.HH:MM:SS
: Waktu yang diformat sebagai 2 digit jam menggunakan waktu 24 jam, 2 digit menit, dan 2 digit detik yang dipisahkan oleh titik dua.OFFSET
: Zona waktu yang diformat sebagai penyeimbang Waktu Universal Terkoordinasi (Coordinated Universal Time/UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), yang 8 jam lebih awal dari UTC, tentukan-08:00
. Atau, untuk tidak menggunakan penyeimbang (UTC+0), tentukanZ
.
TERMINATION_ACTION
: Tindakan penghentian untuk VM ini, yang dapat berupa hentikan (STOP
) atau hapus (DELETE
). Berdasarkan model penyediaan VM, kolom ini mungkin wajib diisi atau memiliki nilai default:- Jika ini adalah Spot VM (jika VM menggunakan flag
--provisioning-model=SPOT
), flag--instance-termination-action=TERMINATION_ACTION
akan bersifat opsional. Jika flag ini dihilangkan, tindakan penghentian default adalah berhenti. - Jika tidak (default), flag
--instance-termination-action=TERMINATION_ACTION
akan diperlukan.
- Jika ini adalah Spot VM (jika VM menggunakan flag
Untuk mengetahui informasi selengkapnya tentang opsi lain yang dapat Anda tentukan saat membuat VM, lihat Membuat dan memulai instance VM.
REST
Untuk membuat VM dari Compute Engine API, gunakan metode
instances.insert
. Anda harus menentukan nama, jenis mesin, dan boot disk untuk VM.Untuk membuat VM yang otomatis dihentikan pada waktu tertentu, Anda harus menyertakan kolom
terminationTime
. Untuk menentukan tindakan penghentian, sertakan kolominstanceTerminationAction
, yang bersifat opsional untuk Spot VM.POST https://compute.googleapis.com/compute/v1/projects/
PROJECT_ID
/zones/ZONE
/instances { "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE", "name": "VM_NAME
", "disks": [ { "initializeParams": { "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE" }, "boot": true } ] "scheduling": { "terminationTime": "TIME", "instanceTerminationAction": "TERMINATION_ACTION" }, }Ganti properti berikut:
PROJECT_ID
: Project ID dari project tempat VM dibuat.ZONE
: Zona untuk membuat VM. Zona tersebut juga harus mendukung jenis mesin yang akan digunakan untuk VM baru.MACHINE_TYPE
: Jenis mesin yang telah ditentukan atau kustom untuk VM baru.VM_NAME
: Nama VM baru.IMAGE_PROJECT
: Project yang berisi gambar. Misalnya, jika Anda menetapkanfamily/debian-10
sebagai image, tetapkandebian-cloud
sebagai project image.IMAGE
: Image untuk VM baru. Anda dapat menentukan versi tertentu dari image publik atau kelompok image. Misalnya, jika Anda menentukanfamily/debian-10
sebagai image dandebian-cloud
sebagai project image, Compute Engine akan membuat VM dari versi terbaru OS image dalam kelompok image Debian 10.TIME
: Waktu Anda ingin VM ini dihentikan secara otomatis. Waktu yang Anda tentukan harus minimal 30 detik ke depan dan maksimal 120 hari ke depan. Format waktu sebagai stempel waktu RFC 3339:YYYY-MM-DDTHH:MM:SSOFFSET
Ganti properti berikut:
YYYY-MM-DD
: Tanggal dengan format 4 digit tahun, 2 digit bulan, dan 2 digit hari dalam sebulan yang dipisahkan dengan tanda hubung.HH:MM:SS
: Waktu yang diformat sebagai 2 digit jam menggunakan waktu 24 jam, 2 digit menit, dan 2 digit detik yang dipisahkan oleh titik dua.OFFSET
: Zona waktu yang diformat sebagai penyeimbang Waktu Universal Terkoordinasi (Coordinated Universal Time/UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), yang 8 jam lebih awal dari UTC, tentukan-08:00
. Atau, untuk tidak menggunakan penyeimbang (UTC+0), tentukanZ
.
TERMINATION_ACTION
: Tindakan penghentian untuk VM ini, yang dapat berupa hentikan (STOP
) atau hapus (DELETE
). Berdasarkan model penyediaan VM, kolom ini mungkin wajib diisi atau memiliki nilai default:- Jika ini adalah Spot VM (jika VM menggunakan kolom
"provisioningModel": "SPOT"
), kolom"instanceTerminationAction": "TERMINATION_ACTION"
akan bersifat opsional. Jika kolom ini dihilangkan, tindakan penghentian default adalah berhenti. - Jika tidak (default), kolom
"instanceTerminationAction": "TERMINATION_ACTION"
akan diperlukan.
- Jika ini adalah Spot VM (jika VM menggunakan kolom
Untuk informasi selengkapnya tentang opsi yang dapat Anda tentukan saat membuat VM, lihat Membuat dan memulai instance VM.
Membatasi waktu berjalan VM yang ada
Anda dapat membatasi waktu berjalan VM yang ada dengan memperbarui jadwal VM. Jika Anda belum memahami cara mengonfigurasi setelan untuk batas waktu, sebaiknya pelajari bagian sebelumnya tentang cara membatasi waktu berjalan VM baru terlebih dahulu.
Anda dapat menggunakan Trusted Cloud konsol, Google Cloud CLI, atau Compute Engine API untuk memperbarui properti terkait penjadwalan VM, seperti yang dijelaskan di bagian ini. Metode ini mengharuskan Anda menghentikan VM terlebih dahulu, lalu memperbarui propertinya, kemudian memulai ulang VM. Atau, jika Anda ingin memperbarui properti VM tambahan secara bersamaan dan otomatis menghentikan serta memulai ulang VM, lihat artikel Memperbarui properti instance.
Konsol
Di konsol Trusted Cloud , buka halaman VM instances.
Di kolom Name, klik nama VM yang ingin Anda perbarui.
Dari halaman VM instance details, selesaikan langkah-langkah berikut:
- Jika VM berjalan, klik Stop untuk menghentikan VM.
- Untuk mengedit VM, klik Edit.
Di halaman Edit instance, selesaikan langkah-langkah berikut:
Di bagian Availability policies, ubah kotak centang Set a time limit for the VM dan kolom apa pun di bawahnya sesuai keinginan.
Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi properti untuk batas waktu, lihat membatasi waktu berjalan VM baru.
Untuk menyimpan perubahan, klik Save.
Opsional: Jika Anda ingin mulai menjalankan VM sekarang, klik Start.
gcloud
Untuk memperbarui batas waktu VM menggunakan gcloud CLI, selesaikan langkah-langkah berikut:
Jika VM berjalan, hentikan VM dengan menggunakan perintah
gcloud compute instances stop
:gcloud compute instances stop VM_NAME
Ganti
VM_NAME
dengan nama VM yang ingin Anda perbarui.Perbarui batas waktu VM menggunakan perintah
gcloud compute instances set-scheduling
.gcloud compute instances set-scheduling VM_NAME \ --max-run-duration=DURATION \ --termination-time=TIME \ --instance-termination-action=TERMINATION_ACTION \ --discard-local-ssds-at-termination-timestamp=true
Konfigurasi flag berikut:
- Anda harus menghapus flag
--max-run-duration
atau--termination-time
untuk menetapkan batas waktu sebagai waktu atau durasi. - Sertakan tanda
--instance-termination-action
untuk menetapkan tindakan penghentian. - Jika VM memiliki SSD lokal dan menetapkan tindakan penghentian
(
TERMINATION_ACTION
) ke berhenti (STOP
), Anda harus menyertakan flag--discard-local-ssds-at-termination-timestamp=true
. Jika tidak, hilangkan tanda--discard-local-ssds-at-termination-timestamp=true
.
Kemudian, ganti kode berikut:
VM_NAME
: Nama VM yang ingin Anda perbarui.DURATION
: Durasi yang Anda inginkan agar VM ini berjalan sebelum dihentikan secara otomatis. Format durasi sebagai jumlah hari, jam, menit, dan detik diikuti dengand
,h
,m
, dans
. Misalnya, tentukan30m
untuk durasi 30 menit, atau tentukan1d2h3m4s
untuk durasi 1 hari, 2 jam, 3 menit, dan 4 detik. Durasi minimum adalah 30 detik (30s
) dan durasi maksimum adalah 120 hari (120d
).TIME
: Waktu Anda ingin VM ini dihentikan secara otomatis. Waktu yang Anda tentukan harus minimal 30 detik ke depan dan maksimal 120 hari ke depan. Format waktu sebagai stempel waktu RFC 3339:YYYY-MM-DDTHH:MM:SSOFFSET
Ganti properti berikut:
YYYY-MM-DD
: tanggal dengan format 4 digit tahun, 2 digit bulan, dan 2 digit hari dalam sebulan yang dipisahkan dengan tanda hubung.HH:MM:SS
: waktu yang diformat sebagai 2 digit jam menggunakan waktu 24 jam, 2 digit menit, dan 2 digit detik yang dipisahkan oleh titik dua.OFFSET
: zona waktu yang diformat sebagai penyeimbang Waktu Universal Terkoordinasi (Coordinated Universal Time/UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), yang 8 jam lebih awal dari UTC, tentukan-08:00
. Atau, untuk tidak menggunakan penyeimbang (UTC+0), tentukanZ
.
TERMINATION_ACTION
: Tindakan penghentian untuk VM ini, yang dapat berupa hentikan (STOP
) atau hapus (DELETE
). Berdasarkan model penyediaan VM, kolom ini mungkin wajib diisi atau memiliki nilai default:- Jika ini adalah Spot VM (jika VM menggunakan flag
--provisioning-model=SPOT
), flag--instance-termination-action=TERMINATION_ACTION
akan bersifat opsional. Jika flag ini dihilangkan, tindakan penghentian default adalah berhenti. - Jika tidak (default), flag
--instance-termination-action=TERMINATION_ACTION
akan diperlukan.
- Jika ini adalah Spot VM (jika VM menggunakan flag
- Anda harus menghapus flag
Jika Anda ingin agar VM mulai berjalan, mulai VM dengan menggunakan perintah
gcloud compute instances start
:gcloud compute instances start VM_NAME
Ganti
VM_NAME
dengan nama VM.
REST
Untuk memperbarui batas waktu VM menggunakan Compute Engine API, selesaikan langkah-langkah berikut:
Jika VM berjalan, hentikan VM dengan menggunakan metode
instances.stop
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/stop
Ganti properti berikut:
PROJECT_ID
: Project ID dari project yang berisi VM.ZONE
: Zona yang berisi VM.VM_NAME
: Nama VM yang ingin Anda perbarui.
Perbarui properti
scheduling
VM, termasuk kolom untuk batas waktu VM, menggunakan metodeinstances.setScheduling
. Sertakan kolommaxRunDuration
atau kolomterminationTime
untuk menetapkan batas waktu sebagai durasi atau waktu:Untuk menetapkan durasi, gunakan permintaan berikut:
POST https://compute.googleapis.com/compute/v1/projects/
PROJECT_ID
/zones/ZONE
/instances/VM_NAME/setScheduling { "maxRunDuration": { "seconds": DURATION }, "instanceTerminationAction": "TERMINATION_ACTION" }Untuk menetapkan waktu, gunakan permintaan berikut:
POST https://compute.googleapis.com/compute/v1/projects/
PROJECT_ID
/zones/ZONE
/instances/VM_NAME/setScheduling { "terminationTime": "TIME", "instanceTerminationAction": "TERMINATION_ACTION" }
Ganti properti berikut:
PROJECT_ID
: Project ID dari project tempat VM dibuat.ZONE
: Zona untuk membuat VM. Zona tersebut juga harus mendukung jenis mesin yang akan digunakan untuk VM baru.MACHINE_TYPE
: Jenis mesin yang telah ditentukan atau kustom untuk VM baru.VM_NAME
: Nama VM baru.IMAGE_PROJECT
: Project yang berisi gambar. Misalnya, jika Anda menetapkanfamily/debian-10
sebagai image, tetapkandebian-cloud
sebagai project image.IMAGE
: Image untuk VM baru. Anda dapat menentukan versi tertentu dari image publik atau kelompok image. Misalnya, jika Anda menentukanfamily/debian-10
sebagai image dandebian-cloud
sebagai project image, Compute Engine akan membuat VM dari versi terbaru OS image dalam kelompok image Debian 10.DURATION
: Durasi dalam detik yang Anda inginkan agar VM ini berjalan sebelum dihentikan secara otomatis. Durasi minimum adalah 30 detik (30s
) dan durasi maksimum adalah 120 hari (120d
).TIME
: Waktu Anda ingin VM ini dihentikan secara otomatis. Waktu yang Anda tentukan harus minimal 30 detik ke depan dan maksimal 120 hari ke depan. Format waktu sebagai stempel waktu RFC 3339:YYYY-MM-DDTHH:MM:SSOFFSET
Ganti properti berikut:
YYYY-MM-DD
: Tanggal dengan format 4 digit tahun, 2 digit bulan, dan 2 digit hari dalam sebulan yang dipisahkan dengan tanda hubung.HH:MM:SS
: Waktu yang diformat sebagai 2 digit jam menggunakan waktu 24 jam, 2 digit menit, dan 2 digit detik yang dipisahkan oleh titik dua.OFFSET
: Zona waktu yang diformat sebagai penyeimbang Waktu Universal Terkoordinasi (Coordinated Universal Time/UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), yang 8 jam lebih awal dari UTC, tentukan-08:00
. Atau, untuk tidak menggunakan penyeimbang (UTC+0), tentukanZ
.
TERMINATION_ACTION
: Tindakan penghentian untuk VM ini, yang dapat berupa hentikan (STOP
) atau hapus (DELETE
). Berdasarkan model penyediaan VM, kolom ini mungkin wajib diisi atau memiliki nilai default:- Jika ini adalah Spot VM (jika VM menggunakan kolom
"provisioningModel": "SPOT"
), kolom"instanceTerminationAction": "TERMINATION_ACTION"
akan bersifat opsional. Jika kolom ini dihilangkan, tindakan penghentian default adalah berhenti. - Jika tidak (default), kolom
"instanceTerminationAction": "TERMINATION_ACTION"
akan diperlukan.
- Jika ini adalah Spot VM (jika VM menggunakan kolom
Jika Anda ingin agar VM mulai berjalan, mulai VM dengan menggunakan metode
instances.start
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/start
Ganti properti berikut:
PROJECT_ID
: project ID dari project yang berisi VM.ZONE
: zona yang berisi VM.VM_NAME
: nama VM.
Memantau waktu berjalan VM
Anda dapat memantau waktu berjalan VM yang memiliki batas waktu dengan menggunakan opsi berikut:
Untuk melihat kapan VM yang sedang berjalan dijadwalkan untuk dihentikan secara otomatis, lihat stempel waktu penghentian VM:
- Lihat detail VM.
- Pada output, lihat kolom VM untuk stempel waktu penghentian:
- Jika Anda menggunakan konsol Trusted Cloud , lihat kolom Durasi maks.
- Jika Anda menggunakan Google Cloud CLI atau Compute Engine API, lihat kolom
terminationTimestamp
.
Untuk memverifikasi apakah VM dihentikan secara otomatis, lihat operasi VM:
- Melihat operasi VM.
Dalam output, Anda dapat mengidentifikasi operasi VM yang disebabkan oleh batas waktu dengan mencari jenis operasi berikut:
compute.instances.deferredStop
menunjukkan tindakan penghentian otomatis karena penghentiancompute.instances.deferredDelete
menunjukkan tindakan penghentian otomatis karena penghapusan
Langkah berikutnya
Pelajari cara mengoptimalkan VM lebih lanjut:
- Jika workload Anda fault-tolerant, Anda dapat menggunakan Spot VM untuk mendapatkan diskon yang signifikan dan kuota khusus opsional.
- Jika ingin VM menjalankan perintah secara otomatis sebelum dimatikan, Anda dapat menggunakan skrip penonaktifan.
Pelajari opsi lainnya untuk membatasi waktu berjalan VM secara otomatis:
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-08 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-08 UTC."],[[["This document details how to set time limits for virtual machine (VM) instances, enabling automatic termination (stop or delete) after a specified duration or at a set time."],["Setting time limits on VMs helps manage temporary workloads, minimize costs, and free up quotas by automatically terminating them upon reaching the defined limit."],["You can configure a new or existing VM to be automatically terminated either by specifying a maximum run duration (from 30 seconds to 120 days) or by setting a specific termination time, with the ability to choose whether the VM should be stopped or deleted."],["When setting a duration for a time limit, the termination timestamp is calculated by adding the duration to the VM's start time, whereas setting a specific time defines the exact termination point, but the specified time must always be in the future."],["To monitor VM run time, you can view the VM's `terminationTimestamp` field to see when it's scheduled for termination, or check the VM operations for `compute.instances.deferredStop` or `compute.instances.deferredDelete` to verify if the VM was automatically stopped or deleted due to a time limit."]]],[]] -