Menghapus dan memulihkan project

Anda dapat menonaktifkan Google Cloud project saat tidak lagi membutuhkannya, dan memulihkan project yang dihapus dalam periode pemulihan 30 hari. Sebelum Anda menonaktifkan project, tinjau linimasa penghapusan dan pahami kapan Google Cloud menghapus resource project secara permanen sehingga Anda dapat mencegah kehilangan data yang tidak terduga.

Menghentikan (menghapus) project

Menonaktifkan project akan menghentikan semua penagihan dan penggunaan resource. Tindakan ini akan segera memindahkan project ke periode pemulihan 30 hari, setelah itu project dan semua data terkait akan dihapus secara permanen. Hanya project dengan status siklus proses ACTIVE yang dapat dinonaktifkan.

Proses dan linimasa penghapusan

Saat Anda memulai penonaktifan, peristiwa berikut akan terjadi:

  1. Penonaktifan langsung: Project akan langsung ditandai untuk dihapus dan tidak dapat digunakan.

  2. Notifikasi: Google Cloud mengirimkan email notifikasi kepada pengguna yang memulai penghapusan dan ke kontak mana pun yang tercantum dalam kategori Teknis Kontak Penting.

  3. Pemutusan hubungan penagihan: Akun Penagihan Cloud yang terkait akan diputus. Pengaitan ini tidak otomatis diaktifkan kembali jika project dipulihkan nanti.

  4. Periode pemulihan 30 hari: Project tetap dalam status DELETE_REQUESTED selama 30 hari. Selama periode ini, Project Owner dapat memulihkan project.

  5. Penghapusan permanen: Setelah 30 hari, project dan semua resource-nya akan dihapus secara permanen dan tidak dapat dipulihkan.

Melacak progres penghapusan

Setelah memulai penonaktifan, Anda dapat menggunakan perintah gcloud projects describe untuk melacak progres periode penghapusan 30 hari:

gcloud projects describe PROJECT_ID

Output akan menampilkan lifecycleState dan detail project lainnya, seperti yang ditunjukkan dalam contoh berikut:

createTime: '2025-06-14T10:00:00.000Z'
lifecycleState: DELETE_REQUESTED
name: Test Project
parent:
  id: '123456789012'
  type: folder
projectId: Test Project
projectNumber: '987654321098'

Pertimbangan penting

Sebelum menghentikan project, tinjau risiko berikut:

  • Pemulihan resource: Meskipun sebagian besar resource dapat dipulihkan dalam jangka waktu 30 hari, beberapa layanan—seperti Cloud Storage dan Pub/Sub—mungkin menghapus resource jauh lebih cepat. Resource ini mungkin tidak dapat dipulihkan sepenuhnya meskipun project dipulihkan.

  • Penundaan pemulihan: Jika Anda memulihkan project, beberapa layanan mungkin memerlukan waktu hingga 36 jam untuk melanjutkan operasi sepenuhnya.

  • Project ID: Project ID bersifat unik dan permanen. Setelah project dihapus sepenuhnya, ID-nya tidak dapat digunakan kembali. Jika Anda ingin mempertahankan project ID kustom untuk digunakan di masa mendatang, hapus resource dalam project, bukan menonaktifkan project itu sendiri.

  • Kuota project: Hingga project dihapus secara permanen (setelah periode 30 hari), project tersebut akan terus dihitung terhadap kuota project Anda.

  • Tagihan penagihan: Project dapat terus dikenai biaya hingga siklus penagihan saat ini berakhir. Untuk menghindari tagihan tak terduga, nonaktifkan penagihan secara manual sebelum memulai penonaktifan.

  • Diskon Abonemen (DA) Aktif: Jika Anda memiliki DA aktif dalam sebuah project, menghapus project tersebut dapat menyebabkan masalah penagihan yang tidak terduga atau pembatalan diskon. Untuk mencegah penghapusan project yang tidak disengaja dengan CUD aktif, sebaiknya terapkan lien project.

Pengaman

Untuk mencegah penghapusan project penting bisnis secara tidak sengaja, Anda dapat mengaktifkan rekomendasi risiko perubahan. Rekomendasi ini memberikan peringatan saat Anda mencoba menghapus project yang telah diidentifikasi Google Cloud sebagai penting berdasarkan aktivitas terbaru.

Untuk mempelajari lebih lanjut retensi data dan penghapusan yang aman, lihat Cara Google menyimpan data yang kami kumpulkan.

Anda dapat menonaktifkan project menggunakan konsol Google Cloud , Google Cloud CLI, atau API.

Konsol

  1. Di konsol Google Cloud , buka halaman Settings IAM & Admin.

    Buka IAM & Admin Settings

    Langkah-langkah selanjutnya akan muncul di konsol Google Cloud .

  2. Di halaman IAM & Admin Settings, pilih project yang ingin Anda hapus, lalu klik Shut down.

    Shut down hanya muncul untuk pengguna yang memiliki izin resourcemanager.projects.delete dalam project saat ini.

  3. Klik Shut down.
  4. Masukkan project ID, lalu klik Shut down anyway.

Atau, Anda dapat menghapus project dari halaman Manage resources:

  1. Di konsol Google Cloud , buka halaman Manage resources.

    Buka Kelola resource

  2. Pilih project yang ingin Anda hapus.

  3. Klik Hapus.

  4. Masukkan project ID, lalu klik Shut down.

gcloud

  1. Di konsol Google Cloud , aktifkan Cloud Shell.

    Aktifkan Cloud Shell

    Di bagian bawah konsol Google Cloud , sesi Cloud Shell akan terbuka dan menampilkan prompt command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi pada sesi.

  2. Untuk menghapus project, gunakan perintah gcloud projects delete:

    gcloud projects delete PROJECT_ID

    Dengan PROJECT_ID sebagai ID project yang ingin Anda hapus.

REST

Cuplikan kode berikut menghapus project yang ditentukan:

Permintaan:

DELETE https://cloudresourcemanager.googleapis.com/v3/projects/my-project-123

Memecahkan masalah penghapusan project

Jika Anda mengalami masalah saat mencoba menonaktifkan atau memulihkan project, biasanya hal ini disebabkan oleh batasan izin atau "lien" resource tertentu. Untuk mengetahui informasi selengkapnya, lihat Memecahkan masalah penghapusan project.

Memulihkan project

Project Owner dapat memulihkan project yang dihapus dalam periode pemulihan 30 hari yang dimulai saat project ditutup.

Memulihkan project akan mengembalikannya ke keadaan sebelum ditutup, dengan pengecualian berikut:

  • Penagihan dinonaktifkan pada project saat project dinonaktifkan. Fitur ini tidak diaktifkan kembali secara otomatis setelah pemulihan. Anda harus menautkan project ke akun Penagihan Cloud secara manual. Anda mungkin perlu menunggu beberapa jam sebelum dapat berhasil menautkan project yang baru saja dipulihkan ke akun penagihan.

  • Anda dapat memulihkan sebagian besar resource jika Anda memulihkan project dalam periode 30 hari. Beberapa layanan seperti Cloud Storage atau Pub/Sub mungkin menghapus data lebih cepat dari 30 hari. Misalnya, resource Cloud Storage yang dilindungi oleh penghapusan sementara mungkin akan dihapus setelah 7 hari, bergantung pada durasi retensi penghapusan sementara, tetapi bucket yang penghapusan sementaranya dinonaktifkan mungkin akan langsung dihapus dan mungkin tidak dapat dipulihkan. Rasio keberhasilan pemulihan resource terkait dengan dependensi resource tersebut.

  • Diperlukan waktu hingga 36 jam agar semua layanan dalam project yang dipulihkan dapat berfungsi sepenuhnya. Secara khusus, klien OAuth mungkin memerlukan waktu 1 hingga 3 hari untuk beroperasi sepenuhnya setelah project dipulihkan. Jika resource Anda tidak dipulihkan setelah periode ini, hubungi dukungan Google.

  • Beberapa layanan mungkin perlu dimulai ulang secara manual. Untuk mengetahui informasi selengkapnya, lihat Memulai Ulang Layanan Google Cloud .

Untuk memulihkan project, Anda harus memiliki izin resourcemanager.projects.undelete pada project. Untuk melihat project yang menunggu penghapusan di konsol, Anda juga memerlukan izin berikut:

  • resourcemanager.projects.list
  • resourcemanager.folders.list (jika project berada dalam folder)
  • resourcemanager.projects.get

Untuk memulihkan project, gunakan salah satu metode berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Manage resources.

    Buka Kelola resource

  2. Di pemilih project di bagian atas halaman, pilih resource organisasi Anda.

  3. Di bawah daftar resource, folder, dan project organisasi, klik Resources pending deletion.

  4. Centang kotak untuk project yang ingin Anda pulihkan, lalu klik Restore. Pada dialog yang muncul, konfirmasi bahwa Anda ingin memulihkan project.

gcloud

  1. Di konsol Google Cloud , aktifkan Cloud Shell.

    Aktifkan Cloud Shell

    Di bagian bawah konsol Google Cloud , sesi Cloud Shell akan terbuka dan menampilkan prompt command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi pada sesi.

  2. Untuk memulihkan project, gunakan perintah gcloud projects undelete:

    gcloud projects undelete PROJECT_ID

    PROJECT_ID adalah project ID atau nomor project dari project yang ingin Anda pulihkan.

REST

Cuplikan kode berikut memulihkan project yang ditentukan:

Permintaan:

POST https://cloudresourcemanager.googleapis.com/v3/projects/my-project-123:undelete

Langkah berikutnya