Menetapkan dan mengelola kebijakan penghapusan sementara

Ringkasan Penggunaan

Halaman ini menjelaskan cara menetapkan dan mengelola kebijakan penghapusan sementara. Anda dapat mengaktifkan penghapusan sementara di bucket dengan menetapkan kebijakan penghapusan sementara. Anda juga dapat memperbarui durasi retensi untuk bucket dan memeriksa status kebijakan yang ada.

Untuk mengetahui langkah-langkah menonaktifkan penghapusan sementara, lihat Menonaktifkan penghapusan sementara.

Untuk mempelajari cara mencantumkan dan memulihkan objek yang dihapus sementara, lihat Menggunakan objek yang dihapus sementara. Untuk mempelajari cara mencantumkan dan memulihkan bucket yang dihapus sementara, lihat Menggunakan bucket yang dihapus sementara.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna mengaktifkan dan mengelola kebijakan penghapusan sementara, minta administrator untuk memberi Anda peran IAM Storage Admin (roles/storage.admin) di bucket atau project yang berisi bucket.

Peran bawaan ini berisi izin yang diperlukan untuk mengaktifkan dan mengelola kebijakan penghapusan sementara. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk mengaktifkan dan mengelola kebijakan penghapusan tidak permanen:

  • storage.buckets.get
  • storage.buckets.update
  • storage.buckets.list (izin ini hanya diperlukan jika Anda berencana menggunakan konsol Google Cloud untuk menjalankan petunjuk di halaman ini)

Untuk mengetahui informasi tentang cara memberikan peran, lihat Menetapkan dan mengelola kebijakan IAM di bucket atau Mengelola akses ke project.

Mengedit durasi retensi penghapusan sementara bucket

Saat Anda mengedit durasi retensi data penghapusan tidak permanen bucket, durasi retensi data yang diperbarui hanya berlaku untuk objek atau bucket yang Anda hapus setelah kebijakan penghapusan tidak permanen yang diperbarui berlaku. Objek yang dihapus sementara yang ada tidak terpengaruh oleh pembaruan yang dilakukan pada kebijakan penghapusan sementara dan dipertahankan selama durasi yang berlaku saat objek tersebut dihapus.

Gunakan petunjuk berikut untuk mengedit durasi retensi penghapusan tidak permanen bucket:

Konsol

  1. Di konsol Google Cloud , buka halaman Buckets Cloud Storage.

    Buka Buckets

  2. Dalam daftar bucket, klik nama bucket yang kebijakan penghapusan tidak permanennya ingin Anda edit.

  3. Klik tab Protection.

  4. Di bagian Soft delete policy (for data recovery), lakukan hal berikut:

    1. Klik Edit.

    2. Dalam dialog Set a soft delete policy, tentukan durasi retensi penghapusan sementara dengan memilih satuan waktu dan lama waktu.

    3. Klik Simpan.

Untuk mempelajari cara mendapatkan informasi error mendetail tentang operasi Cloud Storage yang gagal di konsol Google Cloud , lihat Pemecahan masalah.

Command line

Untuk menambahkan atau mengedit durasi retensi penghapusan tidak permanen di bucket, gunakan perintah gcloud storage buckets update dengan flag --soft-delete-duration:

gcloud storage buckets update gs://BUCKET_NAME --soft-delete-duration=SOFT_DELETE_DURATION

Ganti kode berikut:

  • BUCKET_NAME: nama bucket. Contoh, my-bucket.

  • SOFT_DELETE_DURATION: durasi retensi penghapusan tidak permanen.

    • Satuan s mewakili detik.
    • Unit d mewakili hari.
    • Unit m mewakili bulan.

    Contoh:

    • 7d43200s menetapkan durasi retensi data tujuh setengah hari (7 hari dan 43.200 detik).

    • 2w1d menetapkan durasi retensi selama dua minggu dan satu hari.

REST API

JSON API

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

  2. Buat file JSON yang berisi informasi berikut:

    {
  "softDeletePolicy": {
    "retentionDurationSeconds": "TIME_IN_SECONDS"
  }
}

    Ganti TIME_IN_SECONDS dengan jumlah waktu dalam detik yang ingin Anda tetapkan untuk durasi retensi penghapusan sementara. Misalnya, 2678400 selama 2.678.400 detik (31 hari).

  3. Gunakan cURL untuk memanggil JSON API dengan permintaan Bucket PATCH:

    curl -X PATCH --data-binary @JSON_FILE_NAME \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME"

    Dengan keterangan:

    • JSON_FILE_NAME adalah jalur untuk file JSON yang Anda buat di Langkah 2.
    • BUCKET_NAME adalah nama bucket yang relevan. Contoh, my-bucket.

Memeriksa apakah penghapusan sementara diaktifkan di bucket

Konsol

  1. Di konsol Google Cloud , buka halaman Buckets Cloud Storage.

    Buka Buckets

  2. Dalam daftar bucket, klik nama bucket yang kebijakan penghapusan tidak permanennya ingin Anda periksa.

  3. Klik tab Protection.

    Status akan ditampilkan di bagian Kebijakan penghapusan sementara (untuk pemulihan data).

Untuk mempelajari cara mendapatkan informasi error mendetail tentang operasi Cloud Storage yang gagal di konsol Google Cloud , lihat Pemecahan masalah.

Command line

Untuk memeriksa status kebijakan penghapusan tidak permanen bucket, gunakan perintah gcloud storage buckets describe:

gcloud storage buckets describe gs://BUCKET_NAME --format="default(soft_delete_policy)"

Ganti BUCKET_NAME dengan nama bucket. Contoh, my-bucket.

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/BUCKET_NAME?fields=softDeletePolicy"

    Ganti BUCKET_NAME dengan nama bucket yang relevan. Contoh, my-bucket.

Langkah berikutnya