Dokumen ini menjelaskan cara menghentikan atau memulai ulang instance Compute Engine. Untuk mempelajari lebih lanjut cara menangguhkan, menghentikan, atau mereset instance, lihat Menangguhkan, menghentikan, atau mereset instance Compute Engine.
Menghentikan instance berguna jika Anda tidak lagi menggunakannya, atau untuk mengubah propertinya—misalnya, untuk mengubah jenis mesinnya, atau menghapus disk yang terpasang dan di-mount. Setelah menghentikan instance, Anda dapat melakukan hal berikut:
Mulai ulang untuk melanjutkan beban kerja Anda.
Hapus jika Anda tidak lagi memerlukannya.
Untuk mengotomatiskan penghentian atau mulai ulang instance, lihat hal berikut:
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.
- 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 menghentikan instance:
compute.instances.stop
pada instance -
Untuk menghentikan instance dari OS tamu:
compute.instances.setMetadata
pada instance jika menggunakan kunci SSH publik level instance. -
Untuk memulai ulang instance:
compute.instances.start
pada instance -
Untuk memulai ulang instance yang menggunakan kunci enkripsi:
compute.instances.startWithEncryptionKey
di instance Menghentikan instance tanpa disk SSD Lokal
Anda dapat menghentikan satu atau beberapa instance secara bersamaan yang tidak memiliki disk SSD Lokal. Setiap skrip shutdown dalam instance harus selesai berjalan dalam periode shutdown default.
Menghentikan instance dengan disk SSD Lokal
Saat menghentikan satu atau beberapa instance secara bersamaan yang memiliki disk SSD Lokal terpasang, Anda dapat memilih untuk menghapus atau mempertahankan (Pratinjau) data di disk tersebut. Setiap skrip shutdown dalam instance harus selesai berjalan dalam periode shutdown default.
Menghentikan instance dari OS tamu
Pendekatan ini memungkinkan Anda menghentikan satu instance hanya setelah skrip shutdown selesai berjalan, atau, jika Anda mengaktifkan penghentian halus, hentikan instance tanpa menghentikannya dengan halus, atau akhiri penghentian halus yang sedang berlangsung. Kecuali jika Anda mencadangkan data secara manual dari disk SSD Lokal yang terpasang ke volume penyimpanan yang andal, menghentikan instance dari dalam OS tamu akan menghapus data apa pun di disk tersebut.
Jika telah mengaktifkan penghentian halus di instance, Anda dapat menghentikan instance tanpa menghentikannya secara halus atau mengakhiri penghentian halus yang sedang berlangsung menggunakan konsol Google Cloud, gcloud CLI, atau REST API.
Untuk menghentikan beberapa instance secara bersamaan, gunakan konsol Google Cloud atau, untuk instance yang berada di zona yang sama, gcloud CLI.
Di konsol Google Cloud, buka halaman Instance VM.
Pilih instance yang sedang berjalan untuk dihentikan.
Klik
Hentikan.Dalam dialog, lakukan hal berikut:
Opsional: Untuk menghentikan instance tanpa menonaktifkannya dengan baik, atau mengakhiri penonaktifan yang sedang berlangsung, centang kotak Lewati penonaktifan yang baik (jika berlaku).
Untuk mengonfirmasi, klik Berhenti.
INSTANCE_NAMES
: daftar nama instance yang dipisahkan oleh spasi—misalnya,instance-01 instance-02 instance-03
.ZONE
: zona tempat instance berada.INSTANCE_NAME
: nama instance.PROJECT_ID
: ID project tempat instance berada.ZONE
: zona tempat instance berada.Jika telah mengaktifkan penghentian halus di instance, Anda dapat menghentikan instance tanpa menghentikannya secara halus atau mengakhiri penghentian halus yang sedang berlangsung menggunakan konsol Google Cloud, gcloud CLI, atau REST API.
Untuk mempertahankan data disk SSD Lokal yang dilampirkan ke instance (tidak termasuk instance Z3), hentikan instance menggunakan gcloud CLI atau REST API.
Untuk menghentikan beberapa instance secara bersamaan, gunakan konsol Google Cloud atau, untuk instance yang berada di zona yang sama, gcloud CLI.
Di konsol Google Cloud, buka halaman Instance VM.
Pilih instance yang sedang berjalan untuk dihentikan.
Klik
Hentikan.Dalam dialog, lakukan hal berikut:
Opsional: Untuk menghentikan instance tanpa menonaktifkannya dengan baik, atau mengakhiri penonaktifan yang sedang berlangsung, centang kotak Lewati penonaktifan yang baik (jika berlaku).
Untuk mengonfirmasi, klik Berhenti.
Untuk menghapus data SSD Lokal, gunakan perintah
gcloud compute instances stop
dengan flag--discard-local-ssd=true
:gcloud compute instances stop INSTANCE_NAMES \ --discard-local-ssd=true \ --zone=ZONE
Untuk mempertahankan data SSD Lokal, gunakan perintah
gcloud beta compute instances stop
dengan flag--discard-local-ssd=false
:gcloud beta compute instances stop INSTANCE_NAMES \ --discard-local-ssd=false \ --zone=ZONE
INSTANCE_NAMES
: daftar nama instance yang dipisahkan oleh spasi—misalnya,instance-01 instance-02 instance-03
.ZONE
: zona tempat instance berada.Untuk menghapus data SSD Lokal, buat permintaan
POST
ke metodeinstances.stop
. Di URL permintaan, sertakan parameter kueridiscardLocalSsd
yang ditetapkan ketrue
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/stop?discardLocalSsd=true
Untuk mempertahankan data SSD Lokal, buat permintaan
POST
ke metodebeta.instances.stop
. Di URL permintaan, sertakan parameter kueridiscardLocalSsd
yang ditetapkan kefalse
:POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/stop?discardLocalSsd=false
PROJECT_ID
: ID project tempat instance berada.ZONE
: zona tempat instance berada.INSTANCE_NAME
: nama instance.Jika Anda belum melakukannya, hubungkan ke instance.
Untuk menghentikan instance, pilih salah satu metode berikut:
Untuk penonaktifan bersih yang memungkinkan instance menjalankan skrip penonaktifan sebelum mematikan OS tamu, jalankan perintah berikut:
sudo shutdown -h now
Jika tidak, untuk memaksa penonaktifan, jalankan perintah berikut:
sudo poweroff
Jika Anda belum melakukannya, hubungkan ke instance menggunakan salah satu metode berikut:
Untuk menghentikan instance, pilih salah satu metode berikut:
Untuk menghentikan instance dengan bersih dan mengizinkan instance menjalankan skrip shutdown sebelum mematikan OS tamu, jalankan perintah berikut:
shutdown /s
Untuk memaksa penonaktifan, jalankan perintah berikut:
shutdown /f
Jika instance Anda tidak memiliki disk terenkripsi yang terpasang, lihat Memulai ulang instance tanpa disk terenkripsi.
Jika tidak, lihat Memulai ulang instance dengan disk terenkripsi.
Di konsol Google Cloud, buka halaman Instance VM.
Pilih satu atau beberapa instance.
Klik
Start / Resume.INSTANCE_NAMES
: daftar nama instance yang dipisahkan oleh spasi—misalnya,instance-01 instance-02 instance-03
.ZONE
: zona tempat instance berada.INSTANCE_NAME
: nama instance yang akan dimulai ulang.PROJECT_ID
: ID project tempat instance berada.ZONE
: zona tempat instance berada.Di konsol Google Cloud, buka halaman Instance VM.
Pilih instance yang akan dimulai ulang.
Klik
Start / Resume.Tentukan kunci enkripsi untuk setiap disk terenkripsi yang terpasang ke instance, lalu klik Mulai.
INSTANCE_NAMES
: daftar nama instance yang dipisahkan oleh spasi—misalnya,instance-01 instance-02 instance-03
.ENCRYPTION_KEY_FILE
: jalur relatif ke file JSON yang berisi kunci enkripsi yang disediakan pelanggan. Anda hanya dapat memulai ulang beberapa instance secara bersamaan jika instance menggunakan kunci enkripsi yang sama yang disediakan pelanggan.ZONE
: zona tempat instance berada.PROJECT_ID
: ID project tempat instance berada.ZONE
: zona tempat instance berada.INSTANCE_NAME
: nama instance.DISK_URL
: URL resource yang sesuai dengan nama lengkap resource dari disk yang terpasang yang dienkripsi dengan kunci enkripsi yang disediakan pelanggan.ENCRYPTION_TYPE
: jenis enkripsi disk yang Anda gunakan, yang dapat berupa salah satu dari berikut:rawKey
,kmsKeyName
, ataursaEncryptedKey
. Jika Anda menggunakan jenisrsaEncryptedKey
, buat permintaanPOST
ke metodebeta.instances.startWithEncryptionKey
.ENCRYPTION_KEY
: kunci enkripsi yang digunakan untuk mengenkripsi persistent disk yang terpasang ke instance. KuncirawKey
ataursaEncryptedKey
harus berenkode base64. Selain itu, untuk menyiapkan kuncirsaEncryptedKey
, lihat Penggabungan kunci RSA.
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.
PHP
Untuk menggunakan contoh PHP 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 diperlukan guna menghentikan atau memulai ulang instance komputasi, 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 menghentikan atau memulai ulang instance komputasi. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk menghentikan atau memulai ulang instance komputasi:
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Menghentikan instance
Saat Anda menghentikan instance komputasi, atau Compute Engine melakukannya untuk tindakan terjadwal, instance akan mempertahankan resource yang terpasang, setelan konfigurasi, alamat IP internal, alamat MAC, dan metadata. Namun, instance kehilangan data dalam memori dan status aplikasinya. Jika Anda perlu mempertahankan status ini, maka tangguhkan instance.
Anda dapat menghentikan instance menggunakan metode berikut, bergantung pada apakah instance memiliki disk SSD Lokal yang terpasang dan cara Anda ingin menangani skrip shutdown:
Menghentikan instance tanpa disk SSD Lokal
Bergantung pada tindakan yang ingin Anda lakukan saat menghentikan instance, gunakan opsi berikut:
Untuk menghentikan satu atau beberapa instance, pilih salah satu opsi berikut:
Konsol
gcloud
Untuk menghentikan satu atau beberapa instance di zona yang sama, gunakan perintah
gcloud compute instances stop
:gcloud compute instances stop INSTANCE_NAMES \ --zone=ZONE
Ganti kode berikut:
Atau, jika Anda telah mengaktifkan penghentian halus di satu atau beberapa instance, Anda dapat menghentikan instance tanpa menghentikannya secara halus, atau mengakhiri penghentian halus yang sedang berlangsung secara manual. Untuk melakukannya, gunakan perintah
gcloud beta compute instances stop
dengan flag--no-graceful-shutdown
:gcloud beta compute instances stop INSTANCE_NAMES \ --no-graceful-shutdown \ --zone=ZONE
Go
Java
Node.js
PHP
Python
REST
Untuk menghentikan instance, buat permintaan
POST
ke metodeinstances.stop
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/stop
Ganti kode berikut:
Secara opsional, jika telah mengaktifkan penghentian halus di instance, Anda dapat menghentikan instance tanpa melakukan penghentian halus, atau mengakhiri penghentian halus yang sedang berlangsung secara manual. Untuk melakukannya, buat permintaan
POST
ke metodeinstances.stop
. Di URL permintaan, sertakan parameter kuerinoGracefulShutdown=true
:POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/stop?noGracefulShutdown=true
Menghentikan instance dengan disk SSD Lokal
Bergantung pada hal yang ingin Anda lakukan saat menghentikan instance komputasi, gunakan opsi berikut:
Untuk menghentikan satu atau beberapa instance yang memiliki disk SSD Lokal terpasang, pilih salah satu opsi berikut:
Konsol
gcloud
Saat menghentikan satu atau beberapa instance di zona yang sama yang memiliki disk SSD Lokal yang terpasang, tentukan apakah akan menghapus atau mempertahankan data SSD Lokal sebagai berikut:
Ganti kode berikut:
Secara opsional, jika telah mengaktifkan penghentian halus di satu atau beberapa instance, Anda dapat menghentikan instance tanpa menonaktifkannya dengan halus, atau mengakhiri penghentian halus yang sedang berlangsung. Untuk melakukannya, gunakan perintah
gcloud beta compute instances stop
dengan flag--no-graceful-shutdown
:gcloud beta compute instances stop INSTANCE_NAMES \ --discard-local-ssd=DISCARD_LOCAL_SSD \ --no-graceful-shutdown \ --zone=ZONE
Ganti
DISCARD_LOCAL_SSD
dengantrue
untuk menghapus data di disk SSD Lokal, ataufalse
untuk mempertahankan data.REST
Saat menghentikan instance yang memiliki disk SSD Lokal yang terpasang, tentukan apakah data SSD Lokal akan dihapus atau dipertahankan sebagai berikut:
Ganti kode berikut:
Atau, jika telah mengaktifkan penghentian tuntas di instance, Anda dapat menghentikan instance tanpa menghentikannya dengan tuntas, atau mengakhiri penghentian tuntas yang sedang berlangsung secara manual. Untuk melakukannya, buat permintaan
POST
ke metodeinstances.stop
. Di URL permintaan, sertakan parameter kuerinoGracefulShutdown=true
:POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/stop?discardLocalSsd=DISCARD_LOCAL_SSD&noGracefulShutdown=true
Ganti
DISCARD_LOCAL_SSD
dengantrue
untuk menghapus data di disk SSD Lokal, ataufalse
untuk mempertahankan data.Menghentikan instance dari OS tamu
Jika instance komputasi memiliki disk SSD Lokal yang terpasang, menonaktifkan OS tamu akan otomatis menghapus data SSD Lokal. Untuk mempertahankan data ini, salin data secara manual ke opsi penyimpanan persisten sebelum menghentikan instance.
Untuk menghentikan instance dari OS tamu, pilih salah satu opsi berikut:
Linux
Windows
Memulai ulang instance
Anda dapat memulai ulang instance komputasi yang telah dihentikan sepenuhnya, yaitu saat status instance adalah
TERMINATED
.Jika Anda memilih untuk mempertahankan data disk SSD Lokal saat menghentikan instance, Anda mungkin perlu memasang ulang disk SSD Lokal setelah memulai ulang instance. Untuk mengetahui informasi selengkapnya tentang cara memasang disk SSD Lokal, lihat Memformat dan memasang perangkat SSD Lokal.
Untuk memulai ulang instance, gunakan salah satu metode berikut berdasarkan apakah instance memiliki disk terenkripsi yang terpasang:
Memulai ulang instance tanpa disk terenkripsi
Anda dapat memulai ulang beberapa instance komputasi secara bersamaan atau instance individual. Untuk beberapa instance, gunakan konsol Google Cloud atau, untuk instance yang berada di zona yang sama, gcloud CLI. Untuk setiap instance, pilih salah satu opsi berikut:
Konsol
gcloud
Untuk memulai ulang satu atau beberapa instance di zona yang sama, gunakan perintah
gcloud compute instances start
:gcloud compute instances start INSTANCE_NAMES \ --zone=ZONE
Ganti kode berikut:
Go
Java
Node.js
PHP
Python
REST
Untuk memulai ulang instance, buat permintaan
POST
ke metodeinstances.start
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/start
Ganti kode berikut:
Memulai ulang instance dengan disk terenkripsi
Saat memulai ulang instance komputasi yang dihentikan yang memiliki disk terpasang yang dienkripsi menggunakan kunci enkripsi yang disediakan pelanggan, Anda harus memberikan informasi kunci enkripsi.
Anda dapat memulai ulang beberapa instance secara bersamaan atau satu per satu. Untuk beberapa instance, gunakan konsol Google Cloud atau, untuk instance yang berada di zona yang sama, gunakan gcloud CLI. Untuk setiap instance, pilih salah satu opsi berikut:
Konsol
gcloud
Untuk memulai ulang satu atau beberapa instance yang menggunakan disk terenkripsi di zona yang sama, gunakan perintah
gcloud compute instances start
dengan flag--csek-key-file
. Jika Anda menggunakan kunci yang digabungkan RSA, gunakan perintahgcloud beta compute instances start
dengan flag--csek-key-file
:gcloud compute instances start INSTANCE_NAMES \ --csek-key-file=ENCRYPTION_KEY_FILE \ --zone=ZONE
Ganti kode berikut:
Go
Java
Node.js
PHP
Python
REST
Untuk memulai ulang instance yang menggunakan disk terenkripsi, buat permintaan
POST
ke metodeinstances.startWithEncryptionKey
:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/startWithEncryptionKey { "disks": [ { "source": "DISK_URL", "diskEncryptionKey": { "ENCRYPTION_TYPE": "ENCRYPTION_KEY" } } ] }
Ganti kode berikut:
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-02-14 UTC.
-