Halaman ini menunjukkan cara menampilkan daftar objek yang tersimpan di bucket Cloud Storage, yang diurutkan dalam listing secara leksikografis menurut nama.
Sebelum memulai
Untuk mendapatkan izin yang diperlukan untuk mencantumkan objek, minta administrator untuk memberi Anda peran IAM Storage Object Viewer (roles/storage.objectViewer
) untuk bucket yang berisi objek yang ingin Anda cantumkan.
Jika Anda berencana menggunakan konsol Google Cloud untuk melakukan tugas di halaman ini, minta administrator untuk memberi Anda peran dasar Viewer (roles/viewer
) selain peran Storage Object Viewer (roles/storage.objectViewer
).
Peran ini berisi izin yang diperlukan untuk mencantumkan objek. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:
Izin yang diperlukan
storage.objects.list
storage.buckets.list
- Izin ini hanya diperlukan jika Anda ingin menggunakan Konsol Google Cloud untuk melakukan tugas di halaman ini.
Anda juga bisa mendapatkan izin ini dengan peran standar atau peran khusus lainnya.
Untuk informasi tentang cara memberikan peran untuk bucket, lihat Menggunakan IAM dengan bucket.
Membuat listing objek dalam bucket
Selesaikan langkah-langkah berikut untuk membuat listing objek di bucket:
Konsol
- Di Konsol Google Cloud, buka halaman Bucket Cloud Storage.
Di daftar bucket, klik nama bucket yang isinya ingin Anda lihat.
Opsional: Gunakan pemfilteran dan pengurutan untuk membatasi dan mengatur hasil dalam daftar Anda.
Command line
Gunakan perintah gcloud storage ls
dengan flag --recursive
:
gcloud storage ls --recursive gs://BUCKET_NAME/**
Dengan keterangan:
BUCKET_NAME
adalah nama bucket yang objeknya ingin Anda cantumkan. Contoh,my-bucket
.
Responsnya akan terlihat seperti contoh berikut:
gs://my-bucket/cats.jpeg gs://my-bucket/dogs.jpeg gs://my-bucket/thesis.txt ...
Library klien
C++
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Contoh berikut mencantumkan semua objek dalam bucket:
Contoh berikut mencantumkan objek dengan awalan tertentu:
C#
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C# API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Contoh berikut mencantumkan semua objek dalam bucket:
Contoh berikut mencantumkan objek dengan awalan tertentu:
Go
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Go API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Contoh berikut mencantumkan semua objek dalam bucket:
Contoh berikut mencantumkan objek dengan awalan tertentu:
Java
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Contoh berikut mencantumkan semua objek dalam bucket:
Contoh berikut mencantumkan objek dengan awalan tertentu:
Node.js
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Node.js API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Contoh berikut mencantumkan semua objek dalam bucket:
Contoh berikut mencantumkan objek dengan awalan tertentu:
PHP
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage PHP API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Contoh berikut mencantumkan semua objek dalam bucket:
Contoh berikut mencantumkan objek dengan awalan tertentu:
Python
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Python API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Contoh berikut mencantumkan semua objek dalam bucket:
Contoh berikut mencantumkan objek dengan awalan tertentu:
Ruby
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Ruby API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
Contoh berikut mencantumkan semua objek dalam bucket:
Contoh berikut mencantumkan objek dengan awalan tertentu:
REST API
JSON API
Menginstal dan melakukan inisialisasi gcloud CLI , yang memungkinkan Anda membuat token akses untuk header
Authorization
.Gunakan
cURL
untuk memanggil JSON API dengan permintaan untuk mencantumkan objek:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o"
Dengan
BUCKET_NAME
adalah nama bucket yang objeknya ingin Anda cantumkan. Contoh,my-bucket
.Anda dapat menggunakan parameter kueri
includeFoldersAsPrefixes=True
untuk menampilkan folder terkelola sebagai bagian dari hasil daftar Anda. Saat menggunakan parameterincludeFoldersAsPrefixes
, parameterdelimiter
harus ditetapkan ke/
.
XML API
Menginstal dan melakukan inisialisasi gcloud CLI , yang memungkinkan Anda membuat token akses untuk header
Authorization
.Gunakan
cURL
untuk memanggil XML API dengan permintaan BucketGET
:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?list-type=2"
Dengan
BUCKET_NAME
adalah nama bucket yang objeknya ingin Anda cantumkan. Contoh,my-bucket
.Anda dapat menggunakan parameter string kueri
prefix=PREFIX
untuk membatasi hasil pada objek yang memiliki awalan yang ditentukan.
Memfilter objek
Konsol
Untuk memfilter objek menurut awalan namanya menggunakan konsol Google Cloud, gunakan kolom Filter objects and folders di halaman Bucket details.
Lihat pemfilteran dan pengurutan untuk mengetahui opsi pemfilteran tambahan yang tersedia menggunakan konsol Google Cloud.
Command line
Saat mencantumkan objek menggunakan Google Cloud CLI, Anda dapat menggunakan
karakter pengganti untuk memfilter objek yang diawali dengan awalan yang ditentukan
atau diakhiri dengan akhiran yang ditentukan. Misalnya, perintah berikut cocok dengan
objek yang diawali dengan image
dan diakhiri dengan .png
:
gcloud storage ls gs://my-bucket/image*.png
Untuk mengetahui informasi selengkapnya tentang pemfilteran menggunakan Google Cloud CLI, lihat
dokumentasi gcloud storage ls
.
REST API
JSON API
Saat membuat daftar objek menggunakan Cloud Storage JSON API, Anda dapat menggunakan parameter string kueri prefix
atau matchGlob
untuk memfilter hasil. Untuk mengetahui detail tentang cara menggunakan parameter string kueri ini, lihat Dokumentasi referensi JSON API daftar objek.
Memfilter menurut awalan
Anda dapat menggunakan parameter string kueri atau prefix=PREFIX
untuk membatasi hasil pada objek atau folder terkelola yang memiliki awalan yang ditentukan. Misalnya, untuk menampilkan daftar semua objek di bucket my-bucket
dengan awalan folder/subfolder/
, buat permintaan listingan objek menggunakan URL "https://storage.googleapis.com/storage/v1/b/my-bucket/o?prefix=folder/subfolder/"
.
Menggunakan prefix
untuk mencantumkan konten folder terkelola berguna saat Anda hanya memiliki izin untuk mencantumkan objek dalam folder terkelola, tetapi tidak untuk seluruh bucket. Misalnya, Anda memiliki peran IAM Storage Object Viewer (roles/storage.objectViewer
) untuk folder terkelola my-bucket/my-managed-folder-a/
, tetapi tidak untuk folder terkelola my-bucket/my-managed-folder-b/
. Untuk hanya menampilkan
objek di my-managed-folder-a
, Anda dapat menentukan
prefix=my-managed-folder-a/
.
Saat membatasi hasil ke folder terkelola dan objek di dalamnya,
Anda harus mengakhiri PREFIX
dengan /
(misalnya,
prefix=my-managed-folder/
). Jika tidak, hasil juga dapat menyertakan
objek yang berdekatan dengan folder terkelola. Dalam contoh ini,
Anda memiliki bucket yang berisi objek berikut:
my-bucket/abc.txt
my-bucket/abc/object.txt
Menentukan prefix=abc/
dapat menampilkan objek
my-bucket/abc/object.txt
, sedangkan menentukan prefix=abc
dapat menampilkan
my-bucket/abc.txt
dan my-bucket/abc/object.txt
.
Memfilter menurut ekspresi glob
Anda dapat menggunakan parameter string kueri matchGlob=GLOB_PATTERN
untuk memfilter hasil hanya ke objek yang cocok dengan ekspresi glob tertentu. Misalnya, matchGlob=**.jpeg
dapat
digunakan untuk mencocokkan semua objek yang diakhiri dengan .jpeg
.
Permintaan yang menggunakan parameter matchGlob
akan gagal jika juga menyertakan
parameter delimiter
yang ditetapkan ke nilai selain /
.
Pertimbangan performa saat mencantumkan objek
Struktur dasar bucket dengan namespace hierarkis yang diaktifkan dapat memengaruhi performa operasi objek listingan, jika dibandingkan dengan bucket namespace datar. Untuk mengetahui informasi selengkapnya tentang cara mengoptimalkan performa saat mencantumkan objek dalam bucket dengan namespace hierarkis yang diaktifkan, lihat Mencantumkan objek.
Langkah selanjutnya
- Mendownload objek dari bucket.
- Melihat dan mengedit metadata objek.
- Menghapus objek dari bucket Anda.
- Pelajari cara memberi nomor halaman pada hasil.