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 Anda 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 Google Cloud konsol, 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
:
gcloud storage ls gs://BUCKET_NAME
Dengan:
BUCKET_NAME
adalah nama bucket yang berisi objek yang ingin Anda cantumkan. Contoh,my-bucket
.
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, 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 mengetahui 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 mengetahui 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 mengetahui 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 mengetahui 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 mengetahui 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 mengetahui 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 mengetahui 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 disetel 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 permintaanGET
Bucket: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
Saat mencantumkan objek, Anda dapat menggunakan awalan atau akhiran dalam permintaan daftar untuk memfilter objek menurut nama.
Konsol
Untuk memfilter objek menurut awalan namanya menggunakan konsol Google Cloud , gunakan kolom Filter objek dan folder di halaman Detail bucket.
Lihat memfilter dan mengurutkan untuk opsi pemfilteran tambahan yang tersedia menggunakan konsol Google Cloud .
Command line
Anda dapat menggunakan karakter pengganti dalam perintah gcloud storage ls
untuk
memfilter objek menurut awalan atau akhiran. Misalnya, perintah berikut
hanya mencantumkan objek di bucket my-bucket
yang namanya diawali dengan
image
dan diakhiri dengan .png
:
gcloud storage ls gs://my-bucket/image*.png
Jika permintaan berhasil, responsnya akan terlihat mirip dengan berikut ini:
gs://my-bucket/image.png gs://my-bucket/image-dog.png gs://my-bucket/image-cat.png ...
Anda dapat menggunakan karakter pengganti bintang ganda untuk mencocokkan nol atau beberapa tingkat direktori dalam jalur. Misalnya, perintah berikut hanya mencantumkan objek yang namanya
berakhir dengan .jpeg
di direktori mana pun dalam bucket my-bucket
:
gcloud storage ls gs://my-bucket/**/*.jpeg
Jika permintaan berhasil, responsnya akan terlihat mirip dengan berikut ini:
gs://my-bucket/puppy.jpeg gs://my-bucket/pug.jpeg gs://my-bucket/pets/dog.jpeg ...
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 berdasarkan awalan
Anda dapat menggunakan parameter string kueri prefix=PREFIX
atau
untuk membatasi hasil pada objek atau folder terkelola yang memiliki
awalan yang ditentukan. Misalnya, untuk mencantumkan 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/"
.
Penggunaan prefix
untuk mencantumkan konten folder terkelola berguna jika Anda hanya memiliki izin untuk mencantumkan objek dalam folder terkelola, tetapi bukan 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 menampilkan hanya
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 mencakup 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 berdasarkan 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 memengaruhi performa operasi pencantuman objek, jika dibandingkan dengan bucket namespace datar. Untuk mengetahui informasi selengkapnya, lihat Mengoptimalkan performa di bucket dengan namespace hierarkis yang diaktifkan.
Langkah berikutnya
- Mendownload objek dari bucket.
- Melihat dan mengedit metadata objek.
- Menghapus objek dari bucket Anda.
- Pelajari cara memberi nomor halaman pada hasil.