Menggunakan bucket yang dihapus secara sementara

Ringkasan fitur hapus sementara

Halaman ini menjelaskan cara mencantumkan dan memulihkan bucket yang dihapus sementara.

Ringkasan

Setelah dihapus sementara, bucket akan dipertahankan oleh Cloud Storage hingga waktu penghapusan permanennya, dan tidak dapat diubah saat dalam status dihapus sementara. Waktu penghapusan permanen setidaknya sama dengan waktu penghapusan permanen terbaru objek bucket. Setelah waktu penghapusan permanen berlalu, Cloud Storage akan menghapus bucket secara permanen. Saat Anda memulihkan bucket yang dihapus sementara, bucket tersebut akan dikembalikan ke status aktif, dan objek yang ada di bucket pada saat penghapusan juga dapat dipulihkan.

Pertimbangan

  • Untuk melindungi dari penghapusan berbahaya, bucket yang dihapus sementara tidak dapat dihapus secara permanen hingga bucket tersebut dipertahankan selama durasi retensi data penghapusan sementara penuh.

  • Setelah bucket dihapus sementara, Anda harus memulihkan bucket tersebut sebelum dapat mencantumkan atau memulihkan objek yang dihapus sementara di dalamnya.

  • Untuk memulihkan bucket yang dihapus sementara, Anda harus memiliki nomor generasi bucket. Untuk mengambil nomor generasi bucket yang dihapus sementara, lihat Mencantumkan bucket yang dihapus sementara.

  • Bucket yang dihapus sementara hanya dapat dipulihkan jika tidak ada bucket aktif dengan nama yang sama. Jika Anda atau orang lain membuat bucket dengan nama yang sama dengan bucket yang dihapus sementara, Anda tidak dapat memulihkan bucket yang dihapus sementara hingga bucket baru dihapus.

  • Operasi pemulihan bucket tidak memulihkan objek yang dihapus sementara yang ada di bucket pada saat penghapusan. Untuk memulihkan objek yang dihapus sementara setelah bucket yang dihapus sementara dipulihkan, Anda harus melakukan operasi pemulihan objek.

  • Pengikatan tag mungkin tidak dipulihkan saat Anda memulihkan bucket yang dihapus sementara dengan tag. Untuk menghindari kehilangan data, saat Anda memulihkan bucket yang dihapus sementara dengan binding tag, sebaiknya periksa untuk memastikan binding tag bucket dipulihkan. Jika binding tag bucket tidak dipulihkan, Anda harus mengikat tag yang tidak dipulihkan ke bucket secara manual.

Izin yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk memulihkan bucket yang dihapus sementara, minta administrator Anda untuk memberi Anda peran IAM Storage Admin (roles/storage.admin) di project Cloud Storage.

Peran bawaan ini berisi izin yang diperlukan untuk memulihkan bucket yang dihapus sementara. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk memulihkan bucket yang dihapus sementara:

  • storage.buckets.list
  • storage.buckets.restore

Mencantumkan bucket yang dihapus sementara

Anda dapat melakukan operasi daftar untuk mengambil metadata bucket yang dihapus sementara.

Gunakan petunjuk berikut untuk mencantumkan semua bucket yang dihapus sementara di project Anda:

Command line

Untuk mencantumkan semua bucket yang dihapus sementara, gunakan perintah gcloud storage ls:

gcloud storage ls --buckets --soft-deleted --full

REST API

JSON API

  1. Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.

  2. Gunakan cURL untuk memanggil JSON API dengan permintaan GET Bucket:

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://storage.googleapis.com/storage/v1/b?softDeleted=true"

Memulihkan bucket yang dihapus sementara

Gunakan petunjuk berikut untuk memulihkan bucket yang dihapus sementara:

Command line

Untuk memulihkan bucket yang dihapus sementara, gunakan perintah gcloud storage restore:

  gcloud storage restore gs://BUCKET_NAME#GENERATION_NUMBER

Ganti kode berikut:

  • BUCKET_NAME: nama bucket yang dihapus sementara yang ingin Anda pulihkan.

  • GENERATION_NUMBER: nomor pembuatan unik dan permanen bucket yang dihapus sementara yang ingin Anda pulihkan. Untuk mendapatkan nomor generasi bucket Anda, lihat Mencantumkan bucket yang dihapus sementara.

REST API

JSON API

  1. Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.

  2. Gunakan cURL untuk memanggil JSON API dengan permintaan POST Bucket:

    curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/restore?generation=GENERATION_NUMBER

    Dengan:

    • BUCKET_NAME adalah nama bucket yang ingin Anda pulihkan. Contoh, my-bucket.

    • GENERATION_NUMBER adalah nomor pembuatan unik permanen bucket yang dihapus sementara yang ingin Anda pulihkan. Untuk mendapatkan nomor generasi bucket Anda, lihat Mencantumkan bucket yang dihapus sementara.

Cloud Storage memulihkan bucket yang dihapus sementara ke status aktif. Perhatikan bahwa memulihkan bucket tidak akan memulihkan objek yang ada di bucket pada saat penghapusan sementara. Untuk memulihkan objek yang dihapus sementara yang ada di bucket pada saat penghapusan, lihat Memulihkan objek yang dihapus sementara.

Langkah berikutnya