Menggunakan penghapusan sementara

Ringkasan Penggunaan

Halaman ini menjelaskan cara mengaktifkan, memperbarui, dan memeriksa status kebijakan penghapusan sementara di bucket. Untuk mempelajari cara mencantumkan dan memulihkan objek yang dihapus sementara, lihat Menggunakan objek yang dihapus sementara. Untuk membuat daftar dan memulihkan bucket yang dihapus secara sementara, lihat Menggunakan bucket yang dihapus secara sementara. Untuk informasi selengkapnya tentang penghapusan sementara, lihat Ringkasan. Untuk menonaktifkan fitur ini, lihat Menonaktifkan penghapusan 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, luaskan 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 Konsol Google Cloud untuk menjalankan petunjuk di halaman ini)

Untuk informasi tentang cara memberikan peran, lihat Menggunakan IAM dengan bucket atau Mengelola akses ke project.

Mengedit kebijakan penghapusan sementara bucket

Durasi retensi 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 disimpan selama durasi yang berlaku saat dihapus.

Gunakan petunjuk berikut untuk mengedit kebijakan penghapusan sementara bucket:

Konsol

  1. Di Konsol Google Cloud, buka halaman Bucket Cloud Storage.

    Buka Buckets

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

  3. Klik tab Protection.

  4. Di bagian Kebijakan penghapusan sementara, lakukan salah satu tindakan berikut:

    • Jika bucket tidak memiliki kebijakan penghapusan sementara, klik Edit, pilih satuan waktu dan lama waktu untuk durasi retensi, lalu klik Save.

    • Jika bucket memiliki kebijakan penghapusan sementara, klik Edit untuk mengubah satuan waktu dan durasi waktu untuk durasi retensi Anda.

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

  • BUCKET_NAME adalah nama bucket. Contoh, my-bucket.
  • SOFT_DELETE_DURATION menentukan durasi untuk menyimpan objek yang dihapus sementara. Misalnya, 2w1d adalah dua minggu dan satu hari. Untuk informasi selengkapnya, lihat durasi retensi penghapusan sementara.

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"
  }
}

    Dengan TIME_IN_SECONDS adalah jumlah waktu dalam detik yang ingin Anda gunakan untuk mempertahankan objek yang dihapus secara sementara. Contohnya, 2678400. Untuk informasi selengkapnya, lihat durasi retensi penghapusan sementara.

  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 kebijakan penghapusan data sementara diaktifkan di bucket

Konsol

  1. Di Konsol Google Cloud, buka halaman Bucket Cloud Storage.

    Buka Buckets

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

  3. Klik tab Protection.

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

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

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 sementara bucket, gunakan perintah gcloud storage buckets describe:

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

Dengan keterangan:

  • BUCKET_NAME adalah 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"

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

Langkah selanjutnya