Menggunakan bucket yang dihapus sementara

Ringkasan fitur penghapusan sementara

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

Ringkasan

Setelah bucket dihapus sementara, bucket tersebut akan disimpan oleh Cloud Storage hingga waktu penghapusan permanennya, dan tidak dapat diubah saat dalam status dihapus sementara. Waktu penghapusan permanen setidaknya selama 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 disimpan selama durasi retensi data penghapusan sementara penuh.

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

  • Untuk memulihkan bucket yang dihapus sementara, Anda harus memiliki nomor pembuatan bucket. Untuk mengambil nomor pembuatan 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.

  • Saat Anda memulihkan bucket yang dihapus sementara menggunakan gcloud CLI atau JSON API, objek dalam bucket tidak akan dipulihkan. Untuk memulihkan objek yang dihapus sementara, Anda harus melakukan operasi pemulihan objek setelah memulihkan bucket yang dihapus sementara.

  • Binding tag mungkin tidak dapat 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 Anda perlukan 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, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk memulihkan bucket yang dihapus sementara:

  • storage.buckets.list
  • storage.buckets.restore
  • Memulihkan objek saat Anda menggunakan Cloud de Confiance konsol untuk memulihkan bucket yang dihapus sementara:
    • storage.objects.restore
    • storage.objects.create

Mencantumkan bucket yang dihapus sementara

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

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

Konsol

  1. Di Cloud de Confiance konsol, buka halaman Buckets Cloud Storage.

    Buka Buckets

  2. Klik View options.

  3. Pilih Soft deleted buckets only.

  4. Klik Save.

    Daftar bucket yang dihapus sementara akan ditampilkan. Jika bucket yang dihapus sementara memiliki beberapa generasi, setiap generasi bucket akan muncul di baris terpisah.

Command line

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

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

REST API

JSON API

  1. Pastikan gcloud CLI telah diinstal dan diinisialisasi, yang memungkinkan Anda membuat token akses untuk header Authorization.

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

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

Memulihkan bucket yang dihapus sementara

Gunakan petunjuk berikut untuk memulihkan bucket yang dihapus sementara.

Saat Anda memulihkan bucket yang dihapus sementara menggunakan Cloud de Confiance konsol, Anda juga dapat memulihkan objek yang dihapus sementara yang ada di bucket.

Konsol

  1. Di Cloud de Confiance konsol, buka halaman Buckets Cloud Storage.

    Buka Buckets

  2. Tampilkan bucket yang dihapus sementara dalam daftar bucket, jika belum muncul. Untuk mengetahui langkah-langkahnya, lihat Mencantumkan bucket yang dihapus sementara.

  3. Di baris bucket yang ingin Anda pulihkan, klik Restore.

  4. Jika bucket memiliki beberapa generasi, di tab Specify bucket generation, pilih generasi yang akan dipulihkan.

  5. Klik tab Specify objects to restore.

  6. Di bagian Specify objects to restore, pilih apakah Anda ingin memulihkan objek yang dihapus sementara yang ada di bucket. Tersedia opsi-opsi berikut:

    • Don't restore objects.

      Anda dapat memulihkan objek yang dihapus sementara nanti jika diperlukan.

    • Restore all objects.

    • Restore objects that match criteria. Lakukan tindakan berikut:

      1. Pilih rentang waktu yang objeknya ingin Anda pulihkan.

      2. Opsional: Untuk memulihkan hanya objek yang cocok dengan a pola glob, pilih Filter by glob pattern dan masukkan a pola glob.

  7. Opsional: Tentukan perilaku pemulihan tambahan di bagian Additional options.

  8. Klik Restore.

    Cloud Storage memulihkan bucket yang dihapus sementara ke status aktif.

    Jika Anda memulihkan objek dalam bucket, Cloud Storage akan membuat operasi pemulihan massal untuk objek tersebut. Operasi ini terjadi secara asinkron dan mungkin memerlukan waktu satu jam atau lebih untuk dimulai. Anda dapat melacak progres operasi dengan mengklik tombol Notifications () di Cloud de Confiance header konsol. Atau, Anda dapat menggunakan gcloud CLI untuk melacak status dari operasi yang berjalan lama terkait.

Command line

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

  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 permanen dan unik dari bucket yang dihapus sementara yang ingin Anda pulihkan. Untuk mendapatkan nomor pembuatan bucket, 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. Untuk memulihkan objek yang dihapus sementara, lihat Memulihkan objek yang dihapus sementara.

REST API

JSON API

  1. Pastikan gcloud CLI telah diinstal dan diinisialisasi, yang memungkinkan Anda membuat token akses untuk header Authorization.

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

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

    Dengan:

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

    • GENERATION_NUMBER adalah nomor pembuatan permanen dan unik dari bucket yang dihapus sementara yang ingin Anda pulihkan. Untuk mendapatkan nomor pembuatan bucket, 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. Untuk memulihkan objek yang dihapus sementara, lihat Memulihkan objek yang dihapus sementara.

Langkah berikutnya