Tüm Ürünler
Search

Bu Ürün

    Object Storage Service:ListBuckets (GetService)

    Belge Merkezi

    Object Storage Service:ListBuckets (GetService)

    Son Güncelleme:Oct 01, 2026

    Alibaba Cloud hesabınıza ait tüm paketleri listeler. Sonuçları ön ek, işaretçi veya max-keys parametreleriyle filtreleyebilirsiniz.

    Kullanım notları

    Object Storage Service (OSS) paketlerini listelemek için oss:ListBuckets iznine sahip olmanız gerekir.

    Daha fazla bilgi için bkz. Özel bir ilke atama.

    İstek sözdizimi

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

    İstek üst bilgileri

    Üst Bilgi

    Tür

    Gerekli

    Örnek

    Açıklama

    x-oss-resource-group-id

    String

    Hayır

    rg-aek27tc********

    Kaynak grubunun ID değeri.

    • Bir kaynak grubu ID'si olarak ayarlandığında, bu kaynak grubundaki paketler döndürülür.

      rg-default-id olarak ayarlandığında, varsayılan kaynak grubundaki paketler döndürülür.

    • Değer belirtilmeden eklendiğinde, varsayılan kaynak grubundaki paketler döndürülür.

    • Atlandığında, Alibaba Cloud hesabınızdaki tüm paketler döndürülür.

    Kaynak grubu ID'sini Resource Management konsolundan alabilir veya ListResourceGroups işlemini çağırabilirsiniz. Daha fazla bilgi için bkz. Kaynak grubunu görüntüleme ve ListResourceGroups.

    ListBuckets (GetService) isteğine dahil edilen Host ve Date gibi diğer ortak istek üst bilgileri hakkında daha fazla bilgi için bkz. Ortak istek üst bilgileri.

    İstek parametreleri

    Parametre

    Tür

    Gerekli

    Örnek

    Açıklama

    prefix

    String

    Hayır

    my

    Döndürülen paket adlarının içermesi gereken ön ek. Bu parametre belirtilmezse döndürülen paketleri filtrelemek için ön ek kullanılmaz.

    Varsayılan: boş.

    marker

    String

    Hayır

    mybucket10

    Listelemenin başlayacağı paket adı. Bu değerden sonra alfabetik sıraya göre gelen paketler döndürülür. Bu parametre belirtilmezse tüm paketler döndürülür.

    Varsayılan: boş.

    max-keys

    Integer

    Hayır

    10

    Döndürülecek maksimum paket sayısı.

    Geçerli değerler: 1 ile 1000 arasında.

    Varsayılan değer: 100.

    Yanıt üst bilgileri

    ListBuckets (GetService) isteğine verilen yanıtta yer alan tüm üst bilgiler ortak yanıt üst bilgileridir. Daha fazla bilgi için bkz. Ortak yanıt üst bilgileri.

    Yanıt öğeleri

    Not

    Tüm paketler döndürüldüğünde ListBuckets (GetService) yanıt XML'inde Prefix, Marker, MaxKeys, IsTruncated ve NextMarker öğeleri atlanır.

    Öğe

    Tür

    Örnek

    Açıklama

    ListAllMyBucketsResult

    Container

    Yok

    ListBuckets (GetService) sonuçları için kök kapsayıcı.

    Alt düğümler: Owner ve Buckets

    Üst düğümler: yok

    Prefix

    String

    my

    Döndürülen paketleri filtrelemek için kullanılan ön ek.

    Üst düğümler: ListAllMyBucketsResult

    Marker

    String

    mybucket

    ListBuckets (GetService) listelemesinin başladığı paket adı.

    Üst düğümler: ListAllMyBucketsResult

    MaxKeys

    String

    10

    Döndürülen maksimum paket sayısı.

    Üst düğümler: ListAllMyBucketsResult

    IsTruncated

    Enumerated string

    true

    Tüm sonuçların döndürülüp döndürülmediği. Geçerli değerler:

    • true: Tüm sonuçlar döndürülmedi.

    • false: Tüm sonuçlar döndürüldü.

    Üst düğümler: ListAllMyBucketsResult

    NextMarker

    String

    mybucket10

    Kalan sonuçları almak için sayfalama işaretçisi.

    Üst düğümler: ListAllMyBucketsResult

    Owner

    Container

    Yok

    Paket sahibi ayrıntıları için kapsayıcı.

    Üst düğümler: ListAllMyBucketsResult

    ID

    String

    ut_test_put_bucket

    Paket sahibinin kullanıcı ID'si.

    Üst düğümler: ListAllMyBucketsResult.Owner

    DisplayName

    String

    ut_test_put_bucket

    Paket sahibinin görünen adı; kullanıcı ID'sine eşittir.

    Üst düğümler: ListAllMyBucketsResult.Owner

    Buckets

    Container

    Yok

    Birden çok paket girişi için kapsayıcı.

    Alt düğümler: Bucket

    Üst düğümler: ListAllMyBucketsResult

    Bucket

    Container

    Yok

    Tekil paket ayrıntıları için kapsayıcı.

    Alt düğümler: Name, CreationDate ve Location

    Üst düğümler: ListAllMyBucketsResult.Buckets

    Name

    String

    mybucket01

    Paketin adı.

    Üst düğümler: ListAllMyBucketsResult.Buckets.Bucket

    CreationDate

    Time

    2014-05-15T11:18:32.000Z

    Paket oluşturma zamanı. Biçim: yyyy-mm-ddThh:mm:ss.timezone.

    Üst düğümler: ListAllMyBucketsResult.Buckets.Bucket

    Location

    String

    oss-cn-hangzhou

    OSS bölge ID'si.

    Üst düğümler: ListAllMyBucketsResult.Buckets.Bucket

    ExtranetEndpoint

    String

    oss-cn-hangzhou.aliyuncs.com

    Paketin genel uç noktası.

    Üst düğümler: ListAllMyBucketsResult.Buckets.Bucket

    IntranetEndpoint

    String

    oss-cn-hangzhou-internal.aliyuncs.com

    Paketin dahili uç noktası.

    Üst düğümler: ListAllMyBucketsResult.Buckets.Bucket

    Region

    String

    cn-hangzhou

    Alibaba Cloud bölge ID'si.

    Üst düğümler: ListAllMyBucketsResult.Buckets.Bucket

    StorageClass

    String

    Standard

    Paketin depolama sınıfı. Geçerli değerler: Standard, IA, Archive, ColdArchive ve DeepColdArchive.

    Üst düğümler: ListAllMyBucketsResult.Buckets.Bucket

    ResourceGroupId

    String

    rg-aek27tc********

    Paketin kaynak grubu ID'si. Varsayılan kaynak grubundaki paketler rg-default-id değerini döndürür.

    Üst düğümler: ListAllMyBucketsResult.Buckets.Bucket

    Örnekler

    • Hesabınızdaki tüm paketleri listeleme

      Örnek istekler

      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

      Örnek başarılı yanıtlar

      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>

    • Paketleri ön ek ve max-keys parametrelerine göre listeleme

      Örnek istekler

      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

      Örnek başarılı yanıtlar

      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>

    • Belirli bir kaynak grubundaki paketleri listeleme

      Örnek istekler

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

      Örnek başarılı yanıtlar

      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>

    • Varsayılan kaynak grubundaki paketleri listeleme

      Örnek istekler

      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

      Örnek başarılı yanıtlar

      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

    ListBuckets (GetService) işlemini çağırmak için aşağıdaki programlama dillerine ait OSS SDK'larını kullanabilirsiniz:

    ossutil

    ListBuckets işlemine karşılık gelen ossutil komutu hakkında bilgi için bkz. list-buckets (get-service).

    Hata kodları

    Hata Kodu

    HTTP Durum Kodu

    Açıklama

    AccessDenied

    403

    İstek anonim bir kullanıcıdan gelir ve kullanıcı kimlik doğrulama bilgilerini içermez.