Halaman ini menjelaskan cara memulai peristiwa pemeliharaan host secara manual di instance Compute Engine yang didukung. Fitur ini memungkinkan Anda memulai peristiwa pemeliharaan untuk mengontrol waktu pemeliharaan instance. Hal ini berguna untuk workload yang mungkin terpengaruh oleh penurunan performa atau periode nonaktif, yang memerlukan waktu mulai masa pemeliharaan pada waktu tertentu.
Saat Anda memulai peristiwa pemeliharaan secara manual, pemeliharaan host akan dimulai segera. Anda tidak dapat menentukan tanggal atau waktu mulai acara pemeliharaan. Jika Anda tidak menggunakan fitur ini, peristiwa pemeliharaan akan terjadi pada waktu yang ditunjukkan dalam notifikasi pemeliharaan mendatang.
Jika ingin menguji terlebih dahulu cara aplikasi Anda menangani peristiwa pemeliharaan, Anda dapat menyimulasikan peristiwa pemeliharaan.
Batasan
Anda dapat memulai peristiwa pemeliharaan host secara manual untuk instance yang menggunakan jenis mesin berikut:
Kelompok mesin yang dioptimalkan akselerator:
Kelompok mesin yang dioptimalkan untuk komputasi:
Kelompok mesin tujuan umum:
Jenis mesin C4 dengan 192 atau 288 vCPU atau dengan disk SSD Lokal yang terpasang
Jenis mesin C4D dengan 384 vCPU atau dengan disk SSD Lokal yang terpasang
Jenis mesin C3 dengan 176 vCPU atau dengan disk SSD Lokal yang terpasang
Jenis mesin C3D dengan 360 vCPU atau dengan disk SSD Lokal yang terpasang
Kelompok mesin yang dioptimalkan untuk memori:
Kelompok mesin yang dioptimalkan untuk penyimpanan:
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:
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 .
Peran yang diperlukan
Untuk mendapatkan izin yang Anda perlukan untuk mengelola pemeliharaan 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.Peran bawaan ini berisi izin yang diperlukan untuk mengelola pemeliharaan VM. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk mengelola pemeliharaan VM:
-
Untuk mendapatkan informasi tentang instance komputasi:
compute.instances.get
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Memulai peristiwa pemeliharaan host secara manual
Compute Engine mengirimkan notifikasi untuk peristiwa pemeliharaan mendatang dengan beberapa metode. Dengan menggunakan informasi dalam notifikasi, Anda dapat menentukan jangka waktu kapan Anda dapat memulai peristiwa pemeliharaan secara manual.
Periksa informasi notifikasi
Anda dapat menemukan notifikasi peristiwa pemeliharaan dengan salah satu cara berikut:
Jika notifikasi tentang peristiwa pemeliharaan host berisi
canReschedule=True
danmaintenanceStatus=Pending
, Anda memiliki opsi untuk memulai pemeliharaan pada waktu yang Anda pilih, atau menunggu peristiwa pemeliharaan berlangsung pada waktu yang ditentukan olehwindowStartTime
.Jika tidak ada notifikasi, dan Anda mencoba memulai peristiwa pemeliharaan secara manual, pesan berikut akan ditampilkan:
There is no reschedulable upcoming maintenance.
Pesan ini menunjukkan bahwa tidak ada peristiwa pemeliharaan yang dijadwalkan dan tidak ada tindakan yang perlu dilakukan.
Mulai peristiwa pemeliharaan
Anda dapat memulai pemeliharaan host pada waktu yang Anda pilih, bukan menunggu waktu yang dijadwalkan. Gunakan Google Cloud CLI atau REST untuk memicu peristiwa pemeliharaan, yang kemudian akan segera dimulai.
gcloud
Untuk memulai acara pemeliharaan, gunakan perintah
compute instances perform-maintenance
. Pemeliharaan host dimulai segera setelah memasukkan perintah.gcloud compute instances perform-maintenance INSTANCE_NAME \ --zone=ZONE
Ganti kode berikut:
INSTANCE_NAME
: Nama instance compute.ZONE
: Zona tempat instance berada.
Responsnya mirip dengan hal berikut ini:
resourceStatus: upcomingMaintenance: canReschedule: false latestWindowStartTime: '2025-01-15T19:57:17Z' maintenanceStatus: ONGOING type: SCHEDULED windowEndTime: '2025-01-15T23:57:11Z' windowStartTime: '2025-01-15T19:57:16Z'
Dalam respons,
canReschedule
disetel kefalse
danmaintenanceStatus
disetel keONGOING
, yang menunjukkan bahwa operasi pemeliharaan host sedang berlangsung.REST
Untuk memulai peristiwa pemeliharaan, buat permintaan
POST
menggunakan metodeinstances.performMaintenance
.POST: https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/INSTANCE_NAME/performMaintenance
Ganti kode berikut:
PROJECT_NAME
: Nama projectZONE
: Zona tempat instance komputasi beradaINSTANCE_NAME
: nama instance
Responsnya akan terlihat seperti ini:
upcomingMaintenance:{ "canReschedule":false "latestWindowStartTime": "2023-12-01T19:00:01Z" "maintenanceStatus":"ONGOING" "type":"SCHEDULED" "windowEndTime": "2023-12-01T22:00:00Z" "windowStartTime": "2023-12-01T19:00:00Z" }
Dalam respons,
canReschedule
disetel kefalse
danmaintenanceStatus
disetel keONGOING
, yang menunjukkan bahwa operasi pemeliharaan host sedang berlangsung.Langkah berikutnya
- Pelajari cara Menyimulasikan peristiwa pemeliharaan host.
- Pelajari cara Mendapatkan pemberitahuan migrasi langsung.
- Pelajari cara Mengonfigurasi pemberitahuan untuk notifikasi pemeliharaan host.
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 the process for manually initiating a host maintenance event on supported Compute Engine instances, allowing users to control the timing of maintenance."],["Manually starting a maintenance event triggers the process immediately, without the option to schedule it for a specific future date or time."],["Only certain machine types across accelerator-optimized, compute-optimized, general purpose, memory-optimized, and storage-optimized families are eligible for manually triggered host maintenance events."],["Users must have the `Compute Instance Admin (v1)` IAM role or equivalent permissions to manage VM maintenance, which involves getting information about a compute instance."],["Before initiating, users should check for maintenance notifications, which contain information on whether a maintenance event is reschedulable, and if the notification is not present, it means there is no scheduled maintenance event."]]],[]] -