ListBuckets (GetService) - Daftar semua bucket | API OSS - Object Storage Service

Menampilkan daftar semua bucket yang dimiliki oleh Akun Alibaba Cloud Anda. Anda dapat memfilter hasil berdasarkan prefix, marker, atau max-keys.

Catatan penggunaan

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

Untuk informasi lebih lanjut, lihat Memberikan kebijakan kustom.

Sintaksis permintaan

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

Header permintaan

Header

Type

Required

Example

Description

x-oss-resource-group-id

String

rg-aek27tc********

ID kelompok sumber daya.

Jika diatur ke ID kelompok sumber daya tertentu, mengembalikan bucket dalam kelompok sumber daya tersebut.

Jika diatur ke rg-default-id, mengembalikan bucket dalam kelompok sumber daya default.
Jika disertakan tanpa nilai, mengembalikan bucket dalam kelompok sumber daya default.
Jika tidak disertakan, mengembalikan semua bucket dalam Akun Alibaba Cloud Anda.

Dapatkan ID kelompok sumber daya dari Konsol Resource Management atau dengan memanggil ListResourceGroups. Untuk informasi lebih lanjut, lihat Melihat kelompok sumber daya dan ListResourceGroups.

Untuk informasi lebih lanjut mengenai header permintaan umum lainnya yang disertakan dalam permintaan ListBuckets (GetService), seperti Host dan Date, lihat Header permintaan umum.

Parameter permintaan

Header	Type	Required	Example	Description
prefix	String	No	my	Awalan yang harus dimiliki oleh nama bucket yang dikembalikan. Jika parameter ini tidak ditentukan, awalan tidak digunakan untuk memfilter bucket yang dikembalikan. Default: kosong.
marker	String	No	mybucket10	Nama bucket tempat daftar dimulai. Bucket yang secara alfabetis berada setelah nilai ini akan dikembalikan. Jika parameter ini tidak ditentukan, semua bucket dikembalikan. Default: kosong.
max-keys	Integer	No	10	Jumlah maksimum bucket yang dikembalikan. Nilai valid: 1 hingga 1000. Nilai default: 100.

Header respons

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

Elemen respons

Catatan

Respons XML ListBuckets (GetService) tidak menyertakan Prefix, Marker, MaxKeys, IsTruncated, dan NextMarker jika semua bucket telah dikembalikan.

Header	Type	Example	Description
ListAllMyBucketsResult	Container	N/A	Kontainer akar untuk hasil ListBuckets (GetService). Node anak: Owner dan Buckets Node induk: tidak ada
Prefix	String	my	Awalan yang digunakan untuk memfilter bucket yang dikembalikan. Node induk: ListAllMyBucketsResult
Marker	String	mybucket	Nama bucket tempat daftar ListBuckets (GetService) dimulai. Node induk: ListAllMyBucketsResult
MaxKeys	String	10	Jumlah maksimum bucket yang dikembalikan. Node induk: ListAllMyBucketsResult
IsTruncated	Enumerated string	true	Apakah semua hasil telah dikembalikan. Nilai valid: true: Tidak semua hasil dikembalikan. false: Semua hasil dikembalikan. Node induk: ListAllMyBucketsResult
NextMarker	String	mybucket10	Penanda paginasi untuk mengambil sisa hasil. Node induk: ListAllMyBucketsResult
Owner	Container	N/A	Kontainer untuk detail 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 tampilan pemilik bucket, yang sama dengan ID pengguna. Node induk: ListAllMyBucketsResult.Owner
Buckets	Container	N/A	Kontainer untuk beberapa entri bucket. Node anak: Bucket Node induk: ListAllMyBucketsResult
Bucket	Container	N/A	Kontainer untuk detail bucket individual. 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 pembuatan bucket. 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	Titik akhir publik bucket. Node induk: ListAllMyBucketsResult.Buckets.Bucket
IntranetEndpoint	String	oss-cn-hangzhou-internal.aliyuncs.com	Titik akhir 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 kelompok sumber daya bucket. Bucket dalam kelompok sumber daya default mengembalikan rg-default-id. Node induk: ListAllMyBucketsResult.Buckets.Bucket

Contoh

Daftar semua bucket dalam akun 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

Respons 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>

Daftar bucket berdasarkan prefix dan max-keys

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

Respons 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>

Daftar bucket dalam kelompok 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********

Respons 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>

Daftar bucket dalam kelompok 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

Respons 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 mengenai perintah ossutil yang sesuai dengan operasi ListBuckets, lihat list-buckets (get-service).

Kode error

Kode error	Kode status HTTP	Deskripsi
AccessDenied	403	Permintaan berasal dari pengguna anonim dan tidak menyertakan informasi autentikasi pengguna.