全部产品
Search

搜索本产品

    Object Storage Service：list-objects (get-bucket)

    文档中心

    Object Storage Service：list-objects (get-bucket)

    更新时间：Jul 02, 2025

    Menampilkan semua objek dalam bucket Object Storage Service (OSS) yang ditentukan.

    Catatan penggunaan

    • Secara default, akun Alibaba Cloud memiliki izin untuk menampilkan semua objek dalam sebuah bucket. Untuk menampilkan semua objek dalam bucket menggunakan pengguna RAM atau Security Token Service (STS), Anda harus memiliki izin oss:ListObjects. Untuk informasi lebih lanjut, lihat Melampirkan kebijakan kustom ke pengguna RAM.

    • Perintah list-objects (get-bucket) telah diperbarui ke versi yang lebih baru: list-objects-v2 (get-bucket-v2). Kami merekomendasikan Anda menggunakan list-objects-v2 (get-bucket-v2) dalam pengembangan aplikasi. Untuk menjaga kompatibilitas mundur, OSS terus mendukung perintah list-objects (get-bucket).

    • Perintah list-objects (get-bucket) tidak mengembalikan metadata pengguna dari objek.

    Sintaks perintah

    ossutil api list-objects --bucket value [flags]

    Parameter

    Tipe

    Deskripsi

    --bucket

    string

    Nama bucket.

    --delimiter

    string

    Karakter yang ingin Anda gunakan untuk mengelompokkan objek berdasarkan nama.

    --encoding-type

    string

    Tipe penyandian nama objek dalam respons.

    --marker

    string

    Nama objek setelah operasi list-objects dimulai. Jika parameter ini ditentukan, objek yang namanya secara alfabetis setelah nilai marker akan dikembalikan.

    --max-keys

    int

    Jumlah maksimum objek yang akan dikembalikan.

    --prefix

    string

    Awalan yang harus dimiliki oleh nama objek yang dikembalikan.

    Catatan

    • Perintah list-objects setara dengan operasi GetBucket (ListObjects). Untuk informasi lebih lanjut tentang operasi API, lihat GetBucket (ListObjects).

    • Untuk informasi lebih lanjut tentang opsi baris perintah global yang didukung, lihat Opsi Baris Perintah.

    Contoh

    Daftarkan semua objek dalam bucket bernama examplebucket.

    ossutil api list-objects --bucket examplebucket

    Daftarkan semua objek dalam bucket bernama examplebucket dan format keluaran dalam JSON.

    ossutil api list-objects --bucket examplebucket --output-format json

    Daftarkan semua objek dalam bucket bernama examplebucket dan format keluaran dalam YAML.

    ossutil api list-objects --bucket examplebucket --output-format yaml

    Daftarkan semua objek dengan awalan dir dalam namanya di bucket bernama examplebucket.

    ossutil api list-objects --bucket examplebucket --prefix dir

    Daftarkan 100 objek pertama dengan awalan dir dalam namanya di bucket bernama examplebucket.

    ossutil api list-objects --bucket examplebucket --prefix dir --max-keys 100

    Daftarkan semua objek dalam direktori saat ini di bucket bernama examplebucket.

    ossutil api list-objects --bucket examplebucket --delimiter /

    Daftarkan objek yang namanya secara alfabetis setelah test.txt di bucket bernama examplebucket.

    ossutil api list-objects --bucket examplebucket --marker test.txt

    Daftarkan semua objek dalam bucket bernama examplebucket dan URL-encode nama objek dalam respons.

    ossutil api list-objects --bucket examplebucket --encoding-type url