全部产品
Search

搜索本产品

    Object Storage Service：ListBuckets (GetService)

    文档中心

    Object Storage Service：ListBuckets (GetService)

    更新时间：Jul 06, 2025

    Menampilkan semua bucket dalam akun Alibaba Cloud Anda. Anda dapat menggunakan parameter prefix, marker, atau max-keys untuk mencantumkan bucket yang memenuhi kondisi tertentu.

    Catatan penggunaan

    Untuk mencantumkan bucket Object Storage Service (OSS), Anda harus memiliki izin oss:ListBuckets.

    Untuk informasi lebih lanjut, lihat Lampirkan kebijakan kustom ke pengguna RAM.

    Sintaks permintaan

    GET / HTTP/1.1
Host: oss.example.com
Date: GMT Date
Authorization: SignatureValue

    Header permintaan

    Header

    Tipe

    Diperlukan

    Contoh

    Deskripsi

    x-oss-resource-group-id

    String

    Tidak

    rg-aek27tc********

    ID grup sumber daya.

    • Jika Anda menyertakan header ini dan menentukan ID grup sumber daya dalam permintaan, OSS akan mengembalikan semua bucket yang termasuk dalam grup sumber daya tersebut.

      Jika ID grup sumber daya disetel ke rg-default-id, OSS akan mengembalikan semua bucket yang termasuk dalam grup sumber daya default.

    • Jika Anda menyertakan header ini dalam permintaan tetapi tidak menentukan ID grup sumber daya dalam permintaan, OSS akan mengembalikan semua bucket yang termasuk dalam grup sumber daya default.

    • Jika header ini tidak disertakan dalam permintaan, OSS akan mengembalikan semua bucket yang termasuk dalam akun Alibaba Cloud Anda.

    Anda dapat memperoleh ID grup sumber daya di konsol Resource Management atau dengan memanggil operasi ListResourceGroups. Untuk informasi lebih lanjut, lihat Lihat grup sumber daya dan ListResourceGroups.

    Untuk informasi lebih lanjut tentang header permintaan umum lainnya yang termasuk dalam permintaan ListBuckets (GetService), seperti Host dan Date, lihat Header Permintaan Umum.

    Parameter permintaan

    Header

    Tipe

    Diperlukan

    Contoh

    Deskripsi

    prefix

    String

    Tidak

    my

    Awalan yang harus terkandung dalam nama bucket yang ingin Anda kembalikan. Jika parameter ini tidak ditentukan, awalan tidak digunakan untuk menyaring bucket yang dikembalikan.

    Secara default, parameter ini dibiarkan kosong.

    marker

    String

    Tidak

    mybucket10

    Nama bucket setelah operasi ListBuckets (GetService) dimulai. Bucket yang namanya secara alfabetis lebih besar dari nilai parameter marker dikembalikan. Jika parameter ini tidak ditentukan, semua bucket dikembalikan.

    Secara default, parameter ini dibiarkan kosong.

    max-keys

    Integer

    Tidak

    10

    Jumlah maksimum bucket yang dapat dikembalikan untuk permintaan.

    Nilai valid: 1 hingga 1000.

    Nilai default: 100.

    Header respons

    Semua header dalam respons terhadap permintaan ListBuckets (GetService) adalah header respons umum. Untuk informasi lebih lanjut, lihat Header Respons Umum.

    Elemen respons

    Catatan

    Ketika Anda memanggil operasi ListBuckets (GetService), tubuh XML respons tidak mencakup parameter Prefix, Marker, MaxKeys, IsTruncated, atau NextMarker jika semua bucket dikembalikan.

    Header

    Tipe

    Contoh

    Deskripsi

    ListAllMyBucketsResult

    Container

    N/A

    Wadah yang menyimpan hasil dari permintaan ListBuckets (GetService).

    Node anak: Owner dan Buckets

    Node induk: none

    Prefix

    String

    my

    Awalan yang terkandung dalam nama bucket yang dikembalikan.

    Node induk: ListAllMyBucketsResult

    Marker

    String

    mybucket

    Nama bucket setelah operasi ListBuckets (GetService) dimulai.

    Node induk: ListAllMyBucketsResult

    MaxKeys

    String

    10

    Jumlah maksimum bucket yang dapat dikembalikan untuk permintaan.

    Node induk: ListAllMyBucketsResult

    IsTruncated

    Enumerated string

    true

    Menunjukkan apakah semua hasil dikembalikan. Nilai valid:

    • true: Hanya sebagian hasil yang dikembalikan untuk permintaan.

    • false: Semua hasil dikembalikan untuk permintaan.

    Node induk: ListAllMyBucketsResult

    NextMarker

    String

    mybucket10

    Penanda untuk permintaan ListBuckets (GetService) berikutnya, yang dapat digunakan untuk mengembalikan hasil yang tersisa.

    Node induk: ListAllMyBucketsResult

    Owner

    Container

    N/A

    Wadah yang menyimpan informasi tentang pemilik bucket.

    Node induk: ListAllMyBucketsResult

    ID

    String

    ut_test_put_bucket

    ID pengguna pemilik bucket.

    Node induk: ListAllMyBucketsResult.Owner

    DisplayName

    String

    ut_test_put_bucket

    Nama pemilik bucket. Nama pemilik bucket sama dengan ID pengguna.

    Node induk: ListAllMyBucketsResult.Owner

    Buckets

    Container

    N/A

    Wadah yang menyimpan informasi tentang beberapa bucket.

    Node anak: Bucket

    Node induk: ListAllMyBucketsResult

    Bucket

    Container

    N/A

    Wadah yang menyimpan informasi tentang bucket.

    Node anak: Name, CreationDate, dan Location

    Node induk: ListAllMyBucketsResult.Buckets

    Name

    String

    mybucket01

    Nama bucket.

    Node induk: ListAllMyBucketsResult.Buckets.Bucket

    CreationDate

    Time

    2014-05-15T11:18:32.000Z

    Waktu saat bucket dibuat. Format: yyyy-mm-ddThh:mm:ss.timezone.

    Node induk: ListAllMyBucketsResult.Buckets.Bucket

    Location

    String

    oss-cn-hangzhou

    ID wilayah OSS.

    Node induk: ListAllMyBucketsResult.Buckets.Bucket

    ExtranetEndpoint

    String

    oss-cn-hangzhou.aliyuncs.com

    Endpoint publik bucket.

    Node induk: ListAllMyBucketsResult.Buckets.Bucket

    IntranetEndpoint

    String

    oss-cn-hangzhou-internal.aliyuncs.com

    Endpoint internal bucket.

    Node induk: ListAllMyBucketsResult.Buckets.Bucket

    Region

    String

    cn-hangzhou

    ID wilayah Alibaba Cloud.

    Node induk: ListAllMyBucketsResult.Buckets.Bucket

    StorageClass

    String

    Standard

    Kelas penyimpanan bucket. Nilai valid: Standard, IA, Archive, ColdArchive, dan DeepColdArchive.

    Node induk: ListAllMyBucketsResult.Buckets.Bucket

    ResourceGroupId

    String

    rg-aek27tc********

    ID grup sumber daya tempat bucket berada. Jika bucket termasuk dalam grup sumber daya default, ID grup sumber daya adalah rg-default-id.

    Node induk: ListAllMyBucketsResult.Buckets.Bucket

    Contoh

    • Mengquery semua bucket yang termasuk dalam akun Alibaba Cloud Anda

      Permintaan Contoh

      GET / HTTP/1.1
Date: Thu, 15 May 2014 11:18:32 GMT
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=host,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

      Respon Sukses Contoh

      HTTP/1.1 200 OK
Date: Thu, 15 May 2014 11:18:32 GMT
Content-Type: application/xml
Content-Length: 556
Connection: keep-alive
Server: AliyunOSS
x-oss-request-id: 5374A2880232A65C2300****
<?xml version="1.0" encoding="UTF-8"?>
<ListAllMyBucketsResult>
  <Owner>
    <ID>512**</ID>
    <DisplayName>51264</DisplayName>
  </Owner>
  <Buckets>
    <Bucket>
      <CreationDate>2014-02-17T18:12:43.000Z</CreationDate>
      <ExtranetEndpoint>oss-cn-shanghai.aliyuncs.com</ExtranetEndpoint>
      <IntranetEndpoint>oss-cn-shanghai-internal.aliyuncs.com</IntranetEndpoint>
      <Location>oss-cn-shanghai</Location>
      <Name>app-base-oss</Name>
      <Region>cn-shanghai</Region>
      <StorageClass>Standard</StorageClass>
    </Bucket>
    <Bucket>
      <CreationDate>2014-02-25T11:21:04.000Z</CreationDate>
      <ExtranetEndpoint>oss-cn-hangzhou.aliyuncs.com</ExtranetEndpoint>
      <IntranetEndpoint>oss-cn-hangzhou-internal.aliyuncs.com</IntranetEndpoint>
      <Location>oss-cn-hangzhou</Location>
      <Name>mybucket</Name>
      <Region>cn-hangzhou</Region>
      <StorageClass>IA</StorageClass>
    </Bucket>
  </Buckets>
</ListAllMyBucketsResult>

    • Mengquery bucket dengan menentukan awalan dan jumlah maksimum bucket yang dikembalikan

      Permintaan Contoh

      GET /?prefix=my&max-keys=10 HTTP/1.1
Date: Thu, 15 May 2014 11:18:32 GMT
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=host,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

      Respon Sukses Contoh

      HTTP/1.1 200 OK
Date: Thu, 15 May 2014 11:18:32 GMT
Content-Type: application/xml
Content-Length: 545
Connection: keep-alive
Server: AliyunOSS
x-oss-request-id: 5374A2880232A65C2300****
<?xml version="1.0" encoding="UTF-8"?>
<ListAllMyBucketsResult>
  <Prefix>my</Prefix>
  <Marker>mybucket</Marker>
  <MaxKeys>10</MaxKeys>
  <IsTruncated>true</IsTruncated>
  <NextMarker>mybucket10</NextMarker>
  <Owner>
    <ID>ut_test_put_bucket</ID>
    <DisplayName>ut_test_put_bucket</DisplayName>
  </Owner>
  <Buckets>
    <Bucket>
      <CreationDate>2014-05-14T11:18:32.000Z</CreationDate>
      <ExtranetEndpoint>oss-cn-hangzhou.aliyuncs.com</ExtranetEndpoint>
     <IntranetEndpoint>oss-cn-hangzhou-internal.aliyuncs.com</IntranetEndpoint>
      <Location>oss-cn-hangzhou</Location>
      <Name>mybucket01</Name>
      <Region>cn-hangzhou</Region>
      <StorageClass>Standard</StorageClass>
    </Bucket>
  </Buckets>
</ListAllMyBucketsResult>

    • Mengquery semua bucket yang termasuk dalam grup sumber daya tertentu

      Permintaan Contoh

      GET / HTTP/1.1
Date: Thu, 15 May 2014 11:18:32 GMT
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=host,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
x-oss-resource-group-id: rg-aek27tc********

      Respon Sukses Contoh

      HTTP/1.1 200 OK
Date: Thu, 15 May 2014 11:18:32 GMT
Content-Type: application/xml
Content-Length: 556
Connection: keep-alive
Server: AliyunOSS
x-oss-request-id: 5374A2880232A65C2300****
<?xml version="1.0" encoding="UTF-8"?>
<ListAllMyBucketsResult>
  <Owner>
    <ID>512**</ID>
    <DisplayName>51264</DisplayName>
  </Owner>
  <Buckets>
    <Bucket>
      <CreationDate>2014-02-07T18:12:43.000Z</CreationDate>
      <ExtranetEndpoint>oss-cn-shanghai.aliyuncs.com</ExtranetEndpoint>
      <IntranetEndpoint>oss-cn-shanghai-internal.aliyuncs.com</IntranetEndpoint>
      <Location>oss-cn-shanghai</Location>
      <Name>test-bucket-1</Name>
      <Region>cn-shanghai</Region>
      <StorageClass>Standard</StorageClass>
      <ResourceGroupId>rg-aek27tc********</ResourceGroupId>
    </Bucket>
    <Bucket>
      <CreationDate>2014-02-05T11:21:04.000Z</CreationDate>
      <ExtranetEndpoint>oss-cn-hangzhou.aliyuncs.com</ExtranetEndpoint>
      <IntranetEndpoint>oss-cn-hangzhou-internal.aliyuncs.com</IntranetEndpoint>
      <Location>oss-cn-hangzhou</Location>
      <Name>test-bucket-2</Name>
      <Region>cn-hangzhou</Region>
      <StorageClass>IA</StorageClass>
      <ResourceGroupId>rg-aek27tc********</ResourceGroupId>
    </Bucket>
  </Buckets>
</ListAllMyBucketsResult>

    • Mengquery semua bucket dalam grup sumber daya default

      Permintaan Contoh

      GET / HTTP/1.1
Date: Thu, 15 May 2014 11:18:32 GMT
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=host,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
x-oss-resource-group-id: rg-default-id

      Respon Sukses Contoh

      HTTP/1.1 200 OK
Date: Thu, 15 May 2014 11:18:32 GMT
Content-Type: application/xml
Content-Length: 556
Connection: keep-alive
Server: AliyunOSS
x-oss-request-id: 5374A2880232A65C2300****
<?xml version="1.0" encoding="UTF-8"?>
<ListAllMyBucketsResult>
  <Owner>
    <ID>512**</ID>
    <DisplayName>51264</DisplayName>
  </Owner>
  <Buckets>
    <Bucket>
      <CreationDate>2014-02-07T18:12:43.000Z</CreationDate>
      <ExtranetEndpoint>oss-cn-shanghai.aliyuncs.com</ExtranetEndpoint>
      <IntranetEndpoint>oss-cn-shanghai-internal.aliyuncs.com</IntranetEndpoint>
      <Location>oss-cn-shanghai</Location>
      <Name>test-bucket-3</Name>
      <Region>cn-shanghai</Region>
      <StorageClass>Standard</StorageClass>
      <ResourceGroupId>rg-default-id</ResourceGroupId>
    </Bucket>
    <Bucket>
      <CreationDate>2014-02-05T11:21:04.000Z</CreationDate>
      <ExtranetEndpoint>oss-cn-hangzhou.aliyuncs.com</ExtranetEndpoint>
      <IntranetEndpoint>oss-cn-hangzhou-internal.aliyuncs.com</IntranetEndpoint>
      <Location>oss-cn-hangzhou</Location>
      <Name>test-bucket-4</Name>
      <Region>cn-hangzhou</Region>
      <StorageClass>IA</StorageClass>
      <ResourceGroupId>rg-default-id</ResourceGroupId>
    </Bucket>
  </Buckets>
</ListAllMyBucketsResult>

    SDK

    Anda dapat menggunakan SDK OSS untuk bahasa pemrograman berikut untuk memanggil ListBuckets (GetService):

    ossutil

    Untuk informasi tentang perintah ossutil yang sesuai dengan operasi ListBuckets, lihat list-buckets (get-service).

    Kode kesalahan

    Kode kesalahan

    Status HTTP

    Deskripsi

    AccessDenied

    403

    Permintaan berasal dari pengguna anonim dan tidak mencakup informasi autentikasi pengguna.