Menggunakan bucket yang dihapus secara sementara

Ringkasan fitur hapus sementara

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

Ringkasan

Setelah dihapus sementara, bucket akan disimpan oleh Cloud Storage selama durasi retensi penghapusan sementara, dan tidak dapat diubah saat dalam status dihapus sementara. Setelah durasi retensi penghapusan sementara berakhir, Cloud Storage akan menghapus bucket dan objeknya secara permanen. Bucket dengan fitur penghapusan sementara yang diaktifkan pada saat penghapusan dapat dipulihkan dalam durasi retensi penghapusan sementaranya. 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 memulihkan bucket yang dihapus secara sementara, Anda harus memiliki nomor pembuatan bucket. Untuk mengambil nomor pembuatan bucket yang dihapus secara sementara, lihat Mencantumkan bucket yang dihapus secara sementara.

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

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

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

  • Bucket yang dihapus secara permanen 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 secara sementara, Anda tidak dapat memulihkan bucket yang dihapus secara sementara hingga bucket baru dihapus.

  • Anda tidak dapat memulihkan bucket yang dihapus secara sementara dengan namespace hierarkis yang diaktifkan.

  • Binding tag mungkin tidak dapat dipulihkan saat Anda memulihkan bucket yang dihapus secara sementara dengan tag. Untuk menghindari kehilangan data, saat Anda memulihkan bucket yang dihapus secara sementara dengan binding tag, sebaiknya periksa untuk memastikan binding tag bucket telah 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 guna memulihkan bucket yang dihapus secara sementara, minta administrator 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 permanen. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk memulihkan bucket yang dihapus permanen:

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

Membuat daftar bucket yang dihapus permanen

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

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

Command line

Untuk mencantumkan semua bucket yang dihapus secara permanen, 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 Bucket GET:

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 secara sementara

Gunakan petunjuk berikut untuk memulihkan bucket yang dihapus permanen:

Command line

Untuk memulihkan bucket yang dihapus secara 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 dari bucket yang dihapus secara soft yang ingin Anda pulihkan. Untuk mendapatkan nomor generasi bucket, lihat Mencantumkan bucket yang dihapus secara permanen.

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 Bucket POST:

    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 keterangan:

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

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

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

Langkah selanjutnya