Mengaktifkan dan menggunakan konfigurasi retensi objek (original) (raw)

Langsung ke konten utama

• Area teknologi

  • Ringkasan
  • Panduan
  • Referensi
  • Contoh
  • Referensi

• Alat cross product

• Konsol

• Temukan

• Ringkasan produk

• Ringkasan Storage Intelligence

• Mulai

• Dukungan Terraform untuk Cloud Storage

• Mengonfigurasi dan mengelola Storage Intelligence

• Membuat bucket

• Membuat bucket

• Verifikasi bucket bernama domain

• Mengakses dan mengelola bucket

• Membuat daftar bucket

• Mengubah kelas penyimpanan default bucket

• Memindahkan dan mengganti nama bucket

• Menghapus bucket

• Mengupload dan mendownload objek

• Tentang objek

• Ringkasan upload dan download

• Upload objek

  • Mengupload objek dari file
  • Mengupload objek dari memori
  • Upload multibagian XML API
  • Upload gabungan paralel
  • Upload streaming

• Mengakses dan mengelola objek

• Mencantumkan objek

• Menyalin, mengganti nama, dan memindahkan objek

• Mengubah kelas penyimpanan objek

• Alat untuk mengakses dan mengelola objek menggunakan struktur direktori

• Transcoding objek

• Menghapus objek

• Mendapatkan insight tentang data tersimpan Anda

• Menganalisis data tersimpan dengan Gemini Cloud Assist

• Objek cache

• Tentang penyimpanan dalam cache

• Mengontrol siklus proses data

• Opsi untuk mengontrol siklus proses data

• Membuat permintaan

• Konsistensi dalam operasi Cloud Storage

• Permintaan dalam batch

• Menggunakan operasi yang berjalan lama

• Memberi nomor halaman pada hasil

• Karakter pengganti URI

• Membagikan data secara aman

• Kontrol akses

  • Ringkasan
  • Pemfilteran IP bucket
    * Ringkasan
    * Membuat bucket dengan aturan pemfilteran IP
    * Membuat atau memperbarui aturan pemfilteran IP di bucket yang ada
    * Mendapatkan aturan pemfilteran bucket IP
    * Mencantumkan aturan pemfilteran IP bucket
    * Menghapus aturan pemfilteran IP bucket
    * Menonaktifkan pemfilteran IP bucket
    * Mengabaikan aturan pemfilteran IP bucket
  • Skenario berbagi dan kolaborasi
  • Praktik terbaik kontrol akses

• Memantau data dan penggunaan

• Menggunakan Cloud Audit Logs dengan Cloud Storage

• Log penggunaan dan log penyimpanan

• Menggunakan Cloud Audit Logs dengan operasi batch penyimpanan

• Menggunakan Cloud Logs dengan operasi batch penyimpanan

• Menggunakan Cloud Audit Logs dengan Insight Penyimpanan

• Menggunakan metrik sisi klien gRPC

• Menggunakan rekaman aktivitas sisi klien

• Perlindungan, pencadangan, dan pemulihan

• Ringkasan

• Hapus untuk sementara

  • Ringkasan
  • Menetapkan dan mengelola kebijakan penghapusan sementara
  • Menggunakan objek yang dihapus sementara
  • Menggunakan bucket yang dihapus sementara
  • Menetapkan durasi retensi penghapusan sementara default
  • Menggunakan rekomendasi penghapusan sementara
  • Menonaktifkan hapus sementara

• Memasang bucket dengan Cloud Storage FUSE

• Ringkasan

• Panduan memulai

• Menginstal Cloud Storage FUSE

• Memasang bucket

• Caching

  • Ringkasan
  • Penyimpanan file dalam cache
  • Penyimpanan cache daftar
  • Penyimpanan dalam cache statistik
  • Penyimpanan jenis dalam cache

• Performa

  • Praktik terbaik penyesuaian performa
  • Konfigurasi berbasis profil untuk workload AI/ML
  • Nilai konfigurasi otomatis untuk jenis mesin berperforma tinggi
  • Menggunakan file YAML GKE yang telah dikonfigurasi sebelumnya untuk mengoptimalkan performa Cloud Storage FUSE

• Bekerja di seluruh produk, Cloud, dan platform

• Praktik terbaik untuk workload media

• Interoperabilitas

• Menggunakan Cloud Storage dengan Big Data

• Integrasi dengan layanan dan fitur Google Cloud Platform

• Memecahkan masalah

• Memecahkan masalah umum

• Memecahkan masalah Storage Insights

• Memecahkan masalah Cloud Storage FUSE

Mengaktifkan dan menggunakan konfigurasi retensi objek

Ringkasan

Halaman ini menjelaskan cara menggunakan fitur Kunci Retensi Objek, termasuk mengaktifkannya untuk bucket dan menyetel konfigurasi retensi untuk objek dalam bucket.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mengaktifkan fitur Kunci Retensi Objek bagi bucket dan menetapkan konfigurasi retensi pada objek, minta administrator Anda untuk memberi Anda peran IAM Storage Admin (roles/storage.admin) di bucket atau project yang berisi bucket tersebut. Peran bawaan ini berisi izin yang diperlukan untuk menetapkan dan mengelola konfigurasi retensi. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

• storage.buckets.create
• storage.buckets.enableObjectRetention
• storage.buckets.get
• storage.buckets.list
  • Izin ini hanya diperlukan jika Anda berencana menggunakan konsolGoogle Cloud untuk menjalankan petunjuk di halaman ini.
• storage.objects.get
• storage.objects.list
  • Izin ini hanya diperlukan jika Anda berencana menggunakan konsolGoogle Cloud untuk menjalankan petunjuk di halaman ini.
• storage.objects.overrideUnlockedRetention
  • Izin ini hanya diperlukan jika Anda berencana mengunci atau memperpendek konfigurasi retensi yang ada.
• storage.objects.setRetention
• storage.objects.update

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus.

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

Mengaktifkan retensi objek untuk bucket

Gunakan petunjuk berikut untuk mengizinkan konfigurasi retensi untuk objek dalam bucket. Jika ingin mengaktifkan konfigurasi retensi objek untuk bucket yang ada, Anda harus mengikuti petunjuk konsol Google Cloud .

Konsol

Untuk mengaktifkan konfigurasi retensi objek untuk bucket baru:

1. Buat bucket seperti biasa, dan pada langkah Pilih cara melindungi data objek, pilih Retensi (Untuk kepatuhan), lalu Aktifkan retensi objek.

Untuk mengaktifkan konfigurasi retensi objek untuk bucket yang ada:

1. Di konsol Google Cloud , buka halaman Bucket Cloud Storage.
   Buka Buckets
2. Dalam daftar bucket, klik nama bucket yang ingin Anda aktifkan retensi objeknya.
3. Pilih tab Protection di dekat bagian atas halaman.
   Status retensi objek bucket ditampilkan di bagian Retensi objek.
4. Di bagian Penyimpanan objek, klikPenyimpanan Objek Tidak Diaktifkan.
5. Pada dialog yang muncul, klik Konfirmasi.

Command line

Buat bucket seperti biasa, dan sertakan tanda--enable-per-object-retention dalam perintah.

Library klien

C++

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

C#

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C# API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

Java

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

Node.js

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Node.js API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

PHP

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage PHP API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

Python

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Python API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

REST API

JSON API

Buat bucket seperti biasa, dan sertakan parameter kueri enableObjectRetention=true sebagai bagian dari permintaan.

XML API

Buat bucket seperti biasa, dan sertakan headerx-goog-bucket-object-lock-enabled: True sebagai bagian dari permintaan.

Melihat status retensi objek bucket

Untuk melihat apakah konfigurasi retensi dapat ditetapkan untuk objek dalam bucket:

Konsol

1. Di konsol Google Cloud , buka halaman Bucket Cloud Storage.
   Buka Buckets
2. Klik nama bucket yang statusnya ingin Anda periksa.
3. Klik tab Perlindungan.
4. Status retensi objek bucket ditampilkan di bagian Retensi objek.

Command line

Gunakan perintah gcloud storage buckets describe dengan flag --format:

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

Dengan BUCKET_NAME adalah nama bucket yang kebijakan retensinya ingin Anda lihat. Contoh, my-bucket.

Jika berhasil dan kebijakan retensi untuk bucket sudah ada, responsnya akan mirip dengan berikut ini:

per_object_retention: mode: Enabled

Jika berhasil dan kebijakan retensi untuk bucket tidak ada, responsnya akan mirip dengan berikut ini:

null

Library klien

C++

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

Untuk melihat konfigurasi retensi objek bucket, ikuti petunjuk untuk menampilkan metadata bucket dan cari kolom retensi objek dalam respons.

C#

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C# API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

Untuk melihat konfigurasi retensi objek bucket, ikuti petunjuk untuk menampilkan metadata bucket dan cari kolom retensi objek dalam respons.

Java

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

Untuk melihat konfigurasi retensi objek bucket, ikuti petunjuk untuk menampilkan metadata bucket dan cari kolom retensi objek dalam respons.

Node.js

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Node.js API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

Untuk melihat konfigurasi retensi objek bucket, ikuti petunjuk untuk menampilkan metadata bucket dan cari kolom retensi objek dalam respons.

PHP

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage PHP API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

Untuk melihat konfigurasi retensi objek bucket, ikuti petunjuk untuk menampilkan metadata bucket dan cari kolom retensi objek dalam respons.

Python

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Python API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

Untuk melihat konfigurasi retensi objek bucket, ikuti petunjuk untuk menampilkan metadata bucket dan cari kolom retensi objek dalam respons.

REST API

JSON API

1. Instal dan lakukan inisialisasigcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.
2. Gunakan cURL untuk memanggil JSON API dengan permintaan Bucket GET yang menyertakan kolom objectRetention:
   curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=objectRetention"
   Dengan BUCKET_NAME adalah nama bucket yang relevan. Contoh, my-bucket.

XML API

1. Instal dan lakukan inisialisasigcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.
2. Gunakan cURL untuk memanggil XML API dengan permintaan GET Bucket yang dicakup ke ?object-lock:
   curl -X GET \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   "https://storage.googleapis.com/BUCKET_NAME?object-lock"
   Dengan BUCKET_NAME adalah nama bucket yang relevan. Contoh, my-bucket.

Menetapkan konfigurasi retensi objek

Untuk menetapkan konfigurasi retensi untuk objek, objek harus disimpan dalam bucket yang mengaktifkan retensi objek. Untuk menetapkan konfigurasi retensi untuk objek:

Konsol

1. Di konsol Google Cloud , buka halaman Bucket Cloud Storage.
   Buka Buckets
2. Dalam daftar bucket, klik nama bucket yang berisi objek yang konfigurasi retensinya ingin Anda tetapkan atau ubah.
   Halaman Detail bucket akan terbuka, dan tab Objek akan dipilih.
3. Buka objek, yang mungkin terletak dalam folder.
4. Klik nama objek.
   Halaman Detail objek akan terbuka, yang menampilkan metadata objek.
5. Di bagian Perlindungan, klik ikon Edit() yang terkait dengan Dari konfigurasi retensi objek.
   Panel Edit retensi akan terbuka.
6. Di bagian Konfigurasi retensi objek, klik Diaktifkanatau Dinonaktifkan.
   1. Jika konfigurasi retensi diaktifkan, pilih tanggal dan waktu untuk konfigurasi di bagian Pertahankan hingga waktu, lalu klik Tidak terkunci atau Terkunci di bagian Mode retensi.
7. Klik Konfirmasi.

Command line

Gunakan perintah gcloud storage objects update dengan flag yang sesuai. Untuk menambahkan atau mengubah konfigurasi retensi, gunakan perintah berikut. Perhatikan bahwa Anda juga harus menyertakan flag --override-unlocked-retention jika Anda mengubah konfigurasi yang ada sedemikian rupa sehingga menguncinya atau mempersingkat waktu retensi hingga waktunya:

gcloud storage objects update gs://BUCKET_NAME/OBJECT_NAME --retain-until=DATETIME --retention-mode=STATE

Dengan:

• BUCKET_NAME adalah nama bucket yang relevan. Contoh, my-bucket.
• OBJECT_NAME adalah nama objek yang relevan. Contoh, kitten.png.
• DATETIME adalah tanggal dan waktu paling awal saat objek dapat dihapus. Contoh, 2028-02-15T05:30:00Z.
• STATE adalah Locked atau Unlocked.

Jika berhasil, responsnya akan terlihat mirip dengan contoh berikut ini:

Updating gs://my-bucket/kitten.png... Completed 1

Untuk menghapus konfigurasi retensi dari objek, gunakan perintah berikut:

gcloud storage objects update gs://BUCKET_NAME/OBJECT_NAME --clear-retention --override-unlocked-retention

Dengan:

• BUCKET_NAME adalah nama bucket yang relevan. Contoh, my-bucket.
• OBJECT_NAME adalah nama objek yang relevan. Contoh, kitten.png.

Library klien

C++

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

C#

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C# API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

Java

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

Node.js

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Node.js API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

PHP

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage PHP API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

Python

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Python API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

REST API

JSON API

1. Instal dan lakukan inisialisasigcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.
2. Buat file JSON yang berisi informasi berikut:
   {
   "retention": {
   "mode": STATE,
   "retainUntilTime": "DATETIME"
   }
   }
   Dengan:
   • STATE adalah Locked atau Unlocked.
   • DATETIME adalah tanggal dan waktu paling awal objek dapat dihapus. Contoh,2028-02-15T05:30:00Z.
3. Gunakan cURL untuk memanggil JSON API dengan permintaan PATCH Object:
   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/o/OBJECT_NAME?overrideUnlockedRetention=BOOLEAN"
   Dengan keterangan:
   • JSON_FILE_NAME adalah jalur untuk file yang Anda buat di Langkah 2.
   • BUCKET_NAME adalah nama bucket yang relevan. Contoh, my-bucket.
   • OBJECT_NAME adalah nama objek yang relevan yang dienkode ke URL. Misalnya, pets/kitten.png, dienkode URL sebagai pets%2Fkitten.png.
   • BOOLEAN harus berupa true jika permintaan memperpendek, menghapus, atau mengunci konfigurasi retensi yang ada. Jika tidak, parameter overrideUnlockedRetention dapat dikecualikan sepenuhnya dari permintaan.

XML API

1. Instal dan lakukan inisialisasigcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.
2. Buat file XML yang berisi informasi berikut: STATE DATETIME Dengan: * `STATE` adalah `GOVERNANCE` atau`COMPLIANCE`. * `DATETIME` adalah tanggal dan waktu paling awal objek dapat dihapus. Contoh,`2028-02-15T05:30:00Z`.
3. Gunakan cURL untuk memanggil XML API dengan permintaanObjek PUT yang dicakup ke ?retention:
   curl -X PUT --data-binary @XML_FILE_NAME \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "x-goog-bypass-governance-retention: BOOLEAN" \
   "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME?retention"
   Dengan:
   • XML_FILE_NAME adalah jalur untuk file XML yang Anda buat pada Langkah 2.
   • BOOLEAN harus berupa true jika permintaan memperpendek, menghapus, atau mengunci konfigurasi retensi yang ada. Jika tidak, header x-goog-bypass-governance-retention dapat dikecualikan sepenuhnya dari permintaan.
   • BUCKET_NAME adalah nama bucket yang relevan. Contoh, my-bucket.
   • OBJECT_NAME adalah nama objek yang relevan yang dienkode ke URL. Misalnya, pets/kitten.png, dienkode URL sebagai pets%2Fkitten.png.

Untuk melihat konfigurasi retensi yang ditetapkan pada objek, jika ada:

Konsol

1. Di konsol Google Cloud , buka halaman Bucket Cloud Storage.
   Buka Buckets
2. Dalam daftar bucket, klik nama bucket yang berisi objek yang konfigurasi retensinya ingin Anda lihat.
   Halaman Detail bucket akan terbuka, dan tab Objek akan dipilih.
3. Buka objek, yang mungkin terletak dalam folder.
4. Klik nama objek.
   Halaman Detail objek akan terbuka, yang menampilkan metadata objek. Informasi tentang konfigurasi retensi yang dimiliki objek ditampilkan di bagian Perlindungan.

Command line

Gunakan perintah gcloud storage objects describe dengan flag --format:

gcloud storage objects describe gs://BUCKET_NAME/OBJECT_NAME --format="default(retention_settings)"

Dengan keterangan:

• BUCKET_NAME adalah nama bucket yang relevan. Contoh, my-bucket.
• OBJECT_NAME adalah nama objek yang relevan. Contoh, kitten.png.

Jika berhasil dan konfigurasi retensi untuk objek sudah ada, responsnya akan mirip dengan berikut ini:

retention_settings: mode: Unlocked retainUntilTime: '2028-11-30T14:11:14+00:00'

Jika berhasil dan konfigurasi retensi untuk objek tidak ada, responsnya akan mirip dengan berikut ini:

null

Library klien

C++

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

Untuk melihat konfigurasi retensi objek, ikuti petunjuk untuk menampilkan metadata objek dan cari kolom retensi dalam respons.

C#

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C# API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

Untuk melihat konfigurasi retensi objek, ikuti petunjuk untuk menampilkan metadata objek dan cari kolom retensi dalam respons.

Java

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

Untuk melihat konfigurasi retensi objek, ikuti petunjuk untuk menampilkan metadata objek dan cari kolom retensi dalam respons.

Node.js

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Node.js API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

Untuk melihat konfigurasi retensi objek, ikuti petunjuk untuk menampilkan metadata objek dan cari kolom retensi dalam respons.

PHP

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage PHP API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

Untuk melihat konfigurasi retensi objek, ikuti petunjuk untuk menampilkan metadata objek dan cari kolom retensi dalam respons.

Python

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Python API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihatMenyiapkan autentikasi untuk library klien.

Untuk melihat konfigurasi retensi objek, ikuti petunjuk untuk menampilkan metadata objek dan cari kolom retensi dalam respons.

REST API

JSON API

1. Instal dan lakukan inisialisasigcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.
2. Gunakan cURL untuk memanggil JSON API dengan permintaan GET Object yang menyertakan kolom retention:
   curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/OBJECT_NAME?fields=retention"
   Dengan:
   • BUCKET_NAME adalah nama bucket yang relevan. Contoh, my-bucket.
   • OBJECT_NAME adalah nama objek yang relevan. Contoh, kitten.png.

XML API

1. Instal dan lakukan inisialisasigcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.
2. Gunakan cURL untuk memanggil XML API dengan permintaanObjek GET yang dicakup ke ?retention:
   curl -X GET \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME?retention"
   Dengan:
   • BUCKET_NAME adalah nama bucket yang relevan. Contoh, my-bucket.
   • OBJECT_NAME adalah nama objek yang relevan. Contoh, kitten.png.

Langkah berikutnya

• Pelajari lebih lanjut konfigurasi retensi.
• Pelajari fitur lain yang melindungi data Cloud Storage Anda.
• Pelajari Object Lifecycle Management, yang dapat secara otomatis menghapus file setelah mencapai periode retensi datanya.

Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.

Terakhir diperbarui pada 2025-12-15 UTC.