Gunakan hapus untuk sementara

Ringkasan Penggunaan

Halaman ini menjelaskan cara mengaktifkan, menonaktifkan, memperbarui, dan memeriksa status kebijakan penghapusan sementara di bucket. Untuk mempelajari cara menampilkan daftar dan memulihkan objek yang dihapus sementara, lihat Menggunakan objek yang dihapus sementara.

Sebelum memulai

Untuk membuat dan mengelola kebijakan penghapusan sementara pada bucket, pastikan Anda memiliki peran IAM Storage Admin (roles/storage.admin) di bucket atau project yang berisi bucket. Peran yang telah ditetapkan ini mencakup izin yang diperlukan untuk membuat dan mengelola penghapusan untuk sementara di bucket.

Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

  • storage.buckets.get
  • storage.buckets.update
  • storage.buckets.list
    • Izin ini diperlukan jika Anda berencana menggunakan Konsol Google Cloud untuk menjalankan petunjuk di halaman ini.

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

Mengelola kebijakan penghapusan sementara pada bucket

Untuk menambahkan, menghapus, atau mengubah kebijakan penghapusan sementara untuk bucket:

Konsol

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

    Buka Buckets

  2. Dalam daftar bucket, klik nama bucket yang kebijakan hapus untuk sementara ingin Anda kelola.

  3. Klik tab Perlindungan.

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

    • Jika bucket tidak memiliki kebijakan penghapusan untuk sementara, klik Tetapkan kebijakan penghapusan untuk sementara, pilih satuan waktu dan durasi waktu untuk durasi retensi, lalu klik Simpan.

    • Jika bucket memiliki kebijakan hapus sementara, klik Edit untuk mengubah durasi durasi retensi, atau klik Delete untuk menghapus kebijakan penghapusan sementara pada bucket.

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 pada 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. Misalnya, my-bucket.
  • SOFT_DELETE_DURATION menentukan durasi untuk mempertahankan objek yang dihapus sementara. Misalnya, 2w1d adalah dua minggu dan satu hari. Untuk mengetahui informasi selengkapnya, lihat durasi retensi penghapusan untuk sementara.

Untuk menghapus kebijakan penghapusan sementara dari bucket, gunakan perintah gcloud storage buckets update dengan flag --clear-soft-delete:

  gcloud storage buckets update gs://BUCKET_NAME --clear-soft-delete

Dengan keterangan:

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

REST API

JSON API

  1. Telah menginstal dan melakukan inisialisasigcloud CLI, agar dapat membuat token akses untuk header Authorization.

    Atau, Anda dapat membuat token akses menggunakan OAuth 2.0 Playground dan menyertakannya di header Authorization.

  2. Buat file JSON yang berisi informasi berikut:

    {
  "softDeletePolicy": {
    "retentionDurationSeconds": "RETENTION_DURATION"
  }
}

    Dengan RETENTION_DURATION adalah jumlah waktu yang Anda inginkan untuk mempertahankan objek yang dihapus sementara. Misalnya, 2w1d menyimpan objek yang dihapus sementara selama dua minggu dan satu hari. Untuk mengetahui informasi selengkapnya, lihat durasi retensi penghapusan untuk sementara.

    Guna menonaktifkan kebijakan penghapusan sementara untuk bucket, gunakan nilai 0 untuk RETENTION_DURATION.

  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 pada Langkah 2.
    • BUCKET_NAME adalah nama bucket yang relevan. Contoh, my-bucket.

Memeriksa apakah kebijakan penghapusan untuk 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 Perlindungan.

    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 sementara pada 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. Misalnya, my-bucket.

REST API

JSON API

  1. Telah menginstal dan melakukan inisialisasigcloud CLI, agar dapat membuat token akses untuk header Authorization.

    Atau, Anda dapat membuat token akses menggunakan OAuth 2.0 Playground dan menyertakannya di 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