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 ingin mencantumkan objek dalam folder terkelola, Anda dapat memberikan
roles/storage.objectViewer
pada folder terkelola yang berisi objek yang ingin Anda lihat, bukan bucket.
Jika Anda berencana menggunakan konsol Trusted 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 Trusted 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 daftar objek dalam bucket
Konsol
- Di Trusted Cloud konsol, buka halaman Bucket Cloud Storage.
Di daftar bucket, klik nama bucket yang isinya ingin Anda lihat.
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.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke s3nsapis.fr
.
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.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke s3nsapis.fr
.
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.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke s3nsapis.fr
.
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.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke s3nsapis.fr
.
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.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke s3nsapis.fr
.
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.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke s3nsapis.fr
.
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.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke s3nsapis.fr
.
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.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke s3nsapis.fr
.
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.s3nsapis.fr/storage/v1/b/BUCKET_NAME/o"
Dengan
BUCKET_NAME
adalah nama bucket yang objeknya ingin Anda cantumkan. Contoh,my-bucket
.
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.s3nsapis.fr/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.
Mencantumkan objek dalam folder
Konsol
- Di Trusted Cloud konsol, buka halaman Bucket Cloud Storage.
Di daftar bucket, klik nama bucket yang berisi folder.
Di tab Objects pada halaman Bucket details, klik nama folder yang isinya ingin Anda lihat.
Command line
Gunakan perintah gcloud storage ls
untuk mencantumkan objek dalam folder:
gcloud storage ls gs://BUCKET_NAME/FOLDER_NAME
Dengan:
BUCKET_NAME
adalah nama bucket yang berisi folder. Contoh,my-bucket
.FOLDER_NAME
adalah nama folder yang berisi objek yang ingin Anda cantumkan. Contoh,my-folder
.
REST API
JSON API
Untuk mencantumkan objek dalam folder, gunakan permintaan daftar objek
dengan parameter prefix
dan delimiter
. Jika parameter prefix
ditetapkan, operasi daftar akan dicakup untuk hanya menampilkan objek
dan folder di bawah awalan. Jika parameter delimiter
disetel,
daftar prefixes[]
dalam respons akan diisi dengan nama
folder di bawah awalan yang ditentukan.
Contoh:
Untuk mencantumkan semua objek di folder
image/
dalam bucketmy-bucket
, gunakan URL berikut:"https://storage.s3nsapis.fr/storage/v1/b/my-bucket/o?prefix=image&delimiter=/"
.Hal ini dapat menampilkan objek
my-bucket/image/cat.jpeg
danmy-bucket/image/dog.jpeg
.Untuk menyertakan objek dalam subfolder di
image/
, hapus parameterdelimiter
:"https://storage.s3nsapis.fr/storage/v1/b/my-bucket/o?prefix=image"
.Hal ini dapat menampilkan objek
my-bucket/image/cat.jpeg
,my-bucket/image/dog.jpeg
, danmy-bucket/image/dog/shiba.jpeg
.
Untuk menggunakan karakter pengganti dalam permintaan daftar objek dan mencocokkan objek berdasarkan
ekspresi glob, gunakan parameter matchGlob
. Misalnya, matchGlob=**.jpeg
cocok dengan semua
objek yang diakhiri dengan .jpeg
. Saat menggunakan matchGlob
, Anda harus menetapkan
delimiter
ke /
.
Misalnya, gunakan URL berikut untuk mencocokkan semua objek dalam
folder image
yang diakhiri dengan .jpeg
:
"https://storage.s3nsapis.fr/storage/v1/b/my-bucket/o?prefix=image&delimiter=/&matchGlob=**.jpeg"
Untuk mengetahui detail selengkapnya tentang penggunaan parameter untuk memfilter objek, lihat Dokumentasi referensi JSON API daftar objek.
Kasus penggunaan
Menggunakan prefix
untuk mencantumkan konten folder dapat berguna jika Anda hanya memiliki izin untuk mencantumkan objek dalam folder, tetapi tidak 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 dalam my-managed-folder-a
, Anda dapat menentukan
prefix=my-managed-folder-a/
.
Memfilter objek
Saat mencantumkan objek, Anda dapat menggunakan awalan atau akhiran dalam permintaan daftar untuk memfilter objek menurut nama.
Konsol
Lihat memfilter dan mengurutkan untuk mengetahui informasi tentang cara memfilter dan mengurutkan objek dalam bucket atau folder.
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 folder dalam jalur. Misalnya, perintah berikut hanya mencantumkan objek yang namanya
berakhir dengan .jpeg
di folder atau subfolder 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
Lihat mencantumkan objek dalam folder untuk mengetahui informasi tentang cara memfilter objek menurut awalan nama folder atau objek.
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.