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
- Di Konsol Google Cloud, buka halaman Bucket Cloud Storage.
Dalam daftar bucket, klik nama bucket yang kebijakan hapus untuk sementara ingin Anda kelola.
Klik tab Perlindungan.
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
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
.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
untukRETENTION_DURATION
.Gunakan
cURL
untuk memanggil JSON API dengan permintaan BucketPATCH
: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
- Di Konsol Google Cloud, buka halaman Bucket Cloud Storage.
Dalam daftar bucket, klik nama bucket yang kebijakan penghapusan sementaranya ingin Anda periksa.
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
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
.Gunakan
cURL
untuk memanggil JSON API dengan permintaan BucketGET
: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
- Pelajari penghapusan untuk sementara lebih lanjut.
- Pelajari cara menggunakan objek yang dihapus untuk sementara.