全部产品
Search

搜索本产品

    Object Storage Service：list-buckets(get-service)

    文档中心

    Object Storage Service：list-buckets(get-service)

    更新时间：Jul 02, 2025

    Menampilkan semua bucket yang dimiliki oleh peminta.

    Catatan penggunaan

    • Untuk menampilkan semua bucket yang dimiliki oleh peminta, Anda memerlukan izin oss:ListBuckets(GetService). Untuk informasi lebih lanjut, lihat Melampirkan kebijakan kustom ke pengguna RAM.

    • Anda dapat menggunakan parameter prefix, marker, atau max-keys untuk memfilter bucket berdasarkan kondisi tertentu.

    • Jika semua bucket dikembalikan saat menjalankan perintah, respons dalam format XML tidak akan mencakup elemen Prefix, Marker, MaxKeys, IsTruncated, atau NextMarker.

    Sintaksis perintah

    ossutil api list-buckets [flags]

    Parameter

    Tipe

    Deskripsi

    --marker

    string

    Nama bucket.

    --max-keys

    int

    Jumlah maksimum bucket yang dapat dikembalikan untuk permintaan ini.

    --prefix

    string

    Awalan yang harus terkandung dalam nama bucket yang ingin Anda tampilkan.

    --resource-group-id

    string

    ID grup sumber daya tempat bucket tersebut berada.

    Catatan

    • Perintah list-buckets sesuai dengan operasi ListBuckets (GetService). Untuk informasi lebih lanjut tentang parameter dalam operasi ListBuckets (GetService), lihat ListBuckets(GetService).

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

    Contoh

    • Jalankan perintah berikut untuk menampilkan semua bucket yang dimiliki oleh peminta:

      ossutil api list-buckets

    • Jalankan perintah berikut untuk menampilkan semua bucket yang dimiliki oleh peminta dalam format JSON:

      ossutil api list-buckets --output-format json

    • Jalankan perintah berikut untuk menampilkan semua bucket yang dimiliki oleh peminta dalam format YAML:

      ossutil api list-buckets --output-format yaml

    • Jalankan perintah berikut untuk menampilkan bucket yang namanya mengandung awalan example dan dimiliki oleh peminta:

      ossutil api list-buckets --prefix example

    • Jalankan perintah berikut untuk menampilkan 100 bucket pertama yang dimiliki oleh peminta:

      ossutil api list-buckets --max-keys 100

    • Jalankan perintah berikut untuk menampilkan bucket yang namanya secara alfabetis setelah examplebucket dan dimiliki oleh peminta:

      ossutil api list-buckets --marker examplebucket

    • Jalankan perintah berikut untuk menampilkan bucket yang termasuk dalam grup sumber daya dengan ID rg-123:

      ossutil api list-buckets --resource-group-id rg-123