Menetapkan dan mengelola kebijakan penghapusan sementara

Ringkasan Penggunaan

Halaman ini menjelaskan cara menetapkan dan mengelola kebijakan penghapusan sementara. Anda dapat menetapkan kebijakan baru di bucket untuk mengaktifkan penghapusan sementara, serta memperbarui dan memeriksa status kebijakan yang ada. Untuk mempelajari cara 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

Guna mendapatkan izin yang Anda perlukan untuk mengaktifkan dan mengelola kebijakan penghapusan sementara, minta administrator untuk memberi Anda peran IAM Admin Penyimpanan (roles/storage.admin) di bucket atau project yang berisi bucket tersebut.

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

  • storage.buckets.get
  • storage.buckets.update
  • storage.buckets.list (izin ini hanya diperlukan jika Anda berencana menggunakan Google Cloud konsol 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 kebijakan penghapusan sementara bucket

Durasi retensi data penghapusan sementara yang baru hanya berlaku untuk objek atau bucket yang Anda hapus setelah kebijakan penghapusan sementara 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 kebijakan penghapusan sementara bucket:

Konsol

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

    Buka Buckets

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

  3. Klik tab Protection.

  4. Di bagian Soft delete policy (for data recovery), tambahkan kebijakan penghapusan sementara baru atau edit durasi retensi data kebijakan yang ada dengan menggunakan langkah-langkah berikut:

    1. Klik Edit.

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

    3. Klik Save.

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

Command line

Untuk menambahkan atau mengedit kebijakan penghapusan sementara 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

Dengan:

  • BUCKET_NAME adalah nama bucket. Misalnya, my-bucket.

  • SOFT_DELETE_DURATION menentukan durasi retensi data penghapusan sementara.

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

    Contoh:

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

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

REST API

JSON API

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

  2. Buat file JSON yang berisi informasi berikut:

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

    Dengan TIME_IN_SECONDS adalah jumlah waktu dalam detik yang ingin Anda tetapkan sebagai durasi retensi data penghapusan sementara. Misalnya, 2678400 untuk 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. Misalnya, my-bucket.

Memeriksa apakah kebijakan penghapusan sementara diaktifkan di bucket

Konsol

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

    Buka Buckets

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

  3. Klik tab Protection.

    Statusnya akan ditampilkan di bagian Soft delete policy (for data recovery).

Anda juga dapat menggunakan Protection tab untuk memeriksa apakah ada kebijakan penghapusan sementara di bucket Anda.

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

Command line

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

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

Dengan:

  • BUCKET_NAME adalah nama bucket. Misalnya, my-bucket.

REST API

JSON API

  1. Pastikan gcloud CLI telah diinstal dan diinisialisasi, sehingga Anda dapat 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"

    Dengan BUCKET_NAME adalah nama bucket yang relevan. Misalnya, my-bucket.

Langkah berikutnya