List objects in a bucket - GetBucket ListObjects API - Object Storage Service

Kullanım notları

GetBucket (ListObjects) işlemi, GetBucketV2 (ListObjectsV2) tarafından kullanımdan kaldırılmıştır. Yeni uygulamalar için GetBucketV2 (ListObjectsV2) kullanın. OSS, GetBucket (ListObjects) işlemini hâlâ desteklemektedir. GetBucketV2 (ListObjectsV2) ile ilgili belgelere ListObjectsV2 (GetBucketV2) bölümünden ulaşabilirsiniz.
GetBucket (ListObjects) isteğine verilen yanıtta özel nesne meta verileri döndürülmez.
GetBucket (ListObjects), paket düzeyinde bir işlemdir. Her çağrı, paket depolama sınıfına göre bir PUT isteği olarak faturalandırılır (PUT API istekleri).
Sürüm oluşturma etkinleştirildiğinde, nesnelerin üzerine yazılması veya silinmesi silme işaretçileri ve önceki sürümler oluşturur. Nesneleri listelerken performans düşüşünü önlemek amacıyla, gereksiz silme işaretçilerini ve önceki sürümleri düzenli aralıklarla kaldırmak için yaşam döngüsü kurallarını yapılandırın.

İstek sözdizimi

GET / HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

İstek üstbilgileri

Bu işlem yalnızca Authorization ve Host gibi ortak istek üstbilgilerini kullanır. Daha fazla bilgi için bkz. Ortak istek üstbilgileri.

İstek parametreleri

Ad	Tür	Zorunlu	Örnek	Açıklama
delimiter	String	Hayır	/	Nesne adlarını gruplar. Ön ekten ilk ayraç oluşumuna kadar aynı dizeye sahip nesneler bir CommonPrefixes öğesinde gruplanır. Varsayılan değer: yok.
marker	String	Hayır	test1.txt	Listeleme işleminin başladığı nesne. Belirtilen işaretleyiciden sonra nesneler alfabetik sıraya göre döndürülür. Sayfalama için kullanılır. 1.024 bayttan küçük olmalıdır. İşaretleyici mevcut olmasa bile listeleme, alfabetik sıradaki sonraki nesneden başlar. Varsayılan değer: yok.
max-keys	String	Hayır	200	Döndürülecek maksimum nesne sayısı. Sonuçlar kesilmişse yanıt, sayfalama için bir NextMarker değeri içerir. Geçerli değerler: 1 ile 1000. Varsayılan değer: 100.
prefix	String	Hayır	fun	Yalnızca adlarında bu ön eki içeren nesneleri listeler. 1.024 bayttan küçük olmalıdır. Döndürülen anahtarlar ön eki içerir. Ön ekin bir dizin adına ayarlanması, tüm nesnelerin ve alt dizinlerin özyinelemeli olarak listelenmesini sağlar. Ayraç değerini de eğik çizgi (/) olarak ayarlarsanız yalnızca dizindeki nesneler listelenir. Alt dizin adları CommonPrefixes içinde döndürülür ve içerikleri listelenmez. Örneğin, bir pakette fun/test.jpg, fun/movie/001.avi ve fun/movie/007.avi olmak üzere üç nesne bulunmaktadır. Ön eki fun/ olarak ayarlarsanız üç nesne de döndürülür. Ön eki fun/ ve ayracı eğik çizgi (/) olarak ayarlarsanız fun/test.jpg ve fun/movie/ döndürülür. Varsayılan değer: yok.
encoding-type	String	Hayır	url	Yanıttaki içeriğin kodlama türü. Varsayılan değer: yok. Geçerli değer: url Önemli delimiter, marker, prefix, NextMarker ve Key değerleri UTF-8 olarak kodlanır. XML 1.0 tarafından desteklenmeyen kontrol karakterleri içeren değerleri kodlamak için encoding-type parametresini belirtin.

Yanıt öğeleri

Ad	Tür	Örnek	Açıklama
ListBucketResult	Container	Yok	GetBucket isteğinin sonuçları için kapsayıcı. Alt düğümler: Name, Prefix, Marker, MaxKeys, Delimiter, IsTruncated, Nextmarker ve Contents Üst düğüm: Yok
Name	String	oss-example	Paket adı. Üst düğüm: ListBucketResult
Prefix	String	fun/	Sorgu sonuçlarının ön eki. Üst düğümler: ListBucketResult veya CommonPrefixes
Marker	String	test1.txt	Bu GetBucket (ListObjects) işleminin başlangıç konumu. Üst düğüm: ListBucketResult
MaxKeys	String	100	Yanıtta döndürülen maksimum sonuç sayısı. Üst düğüm: ListBucketResult
Delimiter	String	/	Nesne adlarını gruplamak için kullanılan karakter. Ön ekten ilk Delimiter oluşumuna kadar aynı dizeye sahip nesneler bir CommonPrefixes öğesinde gruplanır. Üst düğüm: ListBucketResult
EncodingType	String	url	Döndürülen sonuçlar için kullanılan kodlama türü. İstekte encoding-type parametresini belirtirseniz yanıttaki Delimiter, Marker, Prefix, NextMarker ve Key öğeleri kodlanır. Üst düğüm: ListBucketResult
IsTruncated	Enumerated string	false	Döndürülen sonuçların kesilip kesilmediğini gösterir. Geçerli değerler: true ve false true: Tüm sonuçlar döndürülmez. false: Tüm sonuçlar döndürülür. Üst düğüm: ListBucketResult
NextMarker	String	test100.txt	Sonraki listeleme işleminin başlangıç konumu. Üst düğüm: ListBucketResult
Contents	Container	Yok	Döndürülen her nesnenin meta verileri için kapsayıcı. Üst düğüm: ListBucketResult
Key	String	fun/test.jpg	Nesnenin anahtarı. Üst düğüm: ListBucketResult.Contents
TransitionTime	Time	2024-04-23T07:21:42.000Z	Nesnenin bir yaşam döngüsü kuralına göre Cold Archive veya Deep Cold Archive depolama sınıfına geçirildiği zaman. Not Cold Archive veya Deep Cold Archive nesnesini dönüştürüldükten 180 gün sonra silerseniz erken silme ücreti alınmaz. Nesneyi dönüştürüldükten sonraki 180 gün içinde silerseniz erken silme ücreti alınır. Bu alan, bir nesnenin yaşam döngüsü kuralıyla IA veya Archive depolama sınıfına dönüştürüldüğü zamanı belirlemek için kullanılamaz. Bir IA veya Archive nesnesinin minimum depolama süresi gereksinimini karşılayıp karşılamadığı `Last-Modified` zamanına bağlıdır. Üst düğüm: ListBucketResult.Contents
SealedTime	Time	2020-05-21T12:07:15.000Z	Nesne üzerinde mühürleme işleminin gerçekleştirildiği zaman. Not Bu alan yalnızca AppendObject tarafından oluşturulan ve mühürlenmiş eklenebilir nesneler için döndürülür. Üst düğüm: ListBucketResult.Contents
LastModified	Time	2012-02-24T08:42:32.000Z	Nesnenin son değiştirildiği zaman. Not Infrequent Access depolama sınıfındaki nesneler için minimum depolama süresi 30 gündür. Süre, nesnenin Last-Modified zamanından itibaren hesaplanır. Nesneyi Last-Modified zamanından 30 gün sonra silerseniz erken silme ücreti alınmaz. Archive Storage depolama sınıfındaki nesneler için minimum depolama süresi 60 gündür. Süre, nesnenin Last-Modified zamanından itibaren hesaplanır. Nesneyi Last-Modified zamanından 60 gün sonra silerseniz erken silme ücreti alınmaz. Üst düğüm: ListBucketResult.Contents
ETag	String	5B3C1A2E053D763E1B002CC607C5A0FE1****	Nesne içeriğini tanımlamak amacıyla nesne oluşturma sırasında oluşturulan varlık etiketi (ETag). PutObject isteğiyle oluşturulan bir nesne için ETag değeri, nesne içeriğinin MD5 karmasıdır. Diğer yöntemlerle oluşturulan bir nesne için ETag, nesne içeriğinin MD5 karması değil, belirli bir kurala göre hesaplanan benzersiz bir değerdir. ETag'leri veri bütünlüğünü doğrulamak için değil, içerik değişikliklerini algılamak için kullanın. Üst düğüm: ListBucketResult.Contents
Type	String	Normal	Nesne türü. Geçerli değerler: Normal: Nesne basit bir yüklemeyle oluşturulmuştur. Multipart: Nesne çok parçalı bir yüklemeyle oluşturulmuştur. Appendable: Nesne ekleme yüklemesiyle oluşturulmuştur. Symlink: Sembolik bağlantı PutSymlink işlemiyle oluşturulmuştur.
Size	String	344606	Döndürülen nesnenin bayt cinsinden boyutu. Üst düğüm: ListBucketResult.Contents
StorageClass	String	Standard	Nesnenin depolama sınıfı. Üst düğüm: ListBucketResult.Contents
RestoreInfo	String	ongoing-request="true”	Nesnenin geri yüklenen durumu. RestoreObject isteği gönderilmediyse veya gönderilen RestoreObject isteğinin süresi dolduysa döndürülmez. Bir RestoreObject isteği gönderildiyse ancak geri yükleme işlemi tamamlanmadıysa RestoreInfo değeri `ongoing-request="true"` olur. Bir RestoreObject isteği gönderildiyse ve geri yükleme işlemi tamamlandıysa RestoreInfo değeri `ongoing-request="false", expiry-date="Thu, 24 Sep 2020 12:40:33 GMT"` olur. `expiry-date` alanı, geri yüklenen nesnenin sona erme zamanını gösterir.
Owner	Container	Yok	Paket sahibi bilgileri için kapsayıcı. Alt düğümler: DisplayName ve ID Üst düğüm: ListBucketResult.Contents
ID	String	0022012****	Paket sahibinin kullanıcı kimliği. Üst düğüm: ListBucketResult.Contents.Owner
DisplayName	String	user_example	Nesne sahibinin adı. Üst düğüm: ListBucketResult.Contents.Owner
CommonPrefixes	Container	Yok	Delimiter belirtildiğinde döndürülür. Ortak bir ön eki paylaşan ve ayraçla biten nesne adı ön eklerinden oluşan bir küme içerir. Üst düğüm: ListBucketResult

x-oss-request-id ve Content-Type gibi diğer ortak yanıt üstbilgileri için bkz. Ortak yanıt üstbilgileri.

Örnekler

Basit istek

GET / HTTP/1.1
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 24 Feb 2012 08:43:27 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Örnek yanıt

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 24 Feb 2012 08:43:27 GMT
Content-Type: application/xml
Content-Length: 1866
Connection: keep-alive
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<ListBucketResult xmlns=”http://doc.oss-cn-hangzhou.aliyuncs.com”>
<Name>examplebucket</Name>
<Prefix></Prefix>
<Marker></Marker>
<MaxKeys>100</MaxKeys>
<Delimiter></Delimiter>
<IsTruncated>false</IsTruncated>
<Contents>
      <Key>fun/movie/001.avi</Key>
      <TransitionTime>2024-04-23T07:21:42.000Z</TransitionTime>
      <LastModified>2012-02-24T08:43:07.000Z</LastModified>
      <ETag>"5B3C1A2E053D763E1B002CC607C5A0FE1****"</ETag>
      <Type>Normal</Type>
      <Size>344606</Size>
      <StorageClass>Standard</StorageClass>
      <Owner>
          <ID>0022012****</ID>
          <DisplayName>user-example</DisplayName>
      </Owner>
</Contents>
<Contents>
      <Key>fun/movie/007.avi</Key>
      <LastModified>2012-02-24T08:43:27.000Z</LastModified>
      <ETag>"5B3C1A2E053D763E1B002CC607C5A0FE1****"</ETag>
      <Type>Normal</Type>
      <Size>344606</Size>
      <StorageClass>Standard</StorageClass>
      <Owner>
          <ID>0022012****</ID>
          <DisplayName>user-example</DisplayName>
      </Owner>
</Contents>
<Contents>
      <Key>fun/test.jpg</Key>
      <LastModified>2012-02-24T08:42:32.000Z</LastModified>
      <ETag>"5B3C1A2E053D763E1B002CC607C5A0FE1****"</ETag>
      <Type>Normal</Type>
      <Size>344606</Size>
      <StorageClass>Standard</StorageClass>
      <Owner>
          <ID>0022012****</ID>
          <DisplayName>user-example</DisplayName>
      </Owner>
</Contents>
<Contents>
      <Key>oss.jpg</Key>
      <LastModified>2012-02-24T06:07:48.000Z</LastModified>
      <ETag>"5B3C1A2E053D763E1B002CC607C5A0FE1****"</ETag>
      <Type>Normal</Type>
      <Size>344606</Size>
      <StorageClass>Standard</StorageClass>
      <Owner>
          <ID>0022012****</ID>
          <DisplayName>user-example</DisplayName>
      </Owner>
</Contents>
</ListBucketResult>

Ön ek parametresi içeren istek

GET /?prefix=fun HTTP/1.1
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 24 Feb 2012 08:43:27 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Örnek yanıt

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 24 Feb 2012 08:43:27 GMT
Content-Type: application/xml
Content-Length: 1464
Connection: keep-alive
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<ListBucketResult xmlns=”http://doc.oss-cn-hangzhou.aliyuncs.com”>
<Name>examplebucket</Name>
<Prefix>fun</Prefix>
<Marker></Marker>
<MaxKeys>100</MaxKeys>
<Delimiter></Delimiter>
<IsTruncated>false</IsTruncated>
<Contents>
      <Key>fun/movie/001.avi</Key>
      <LastModified>2012-02-24T08:43:07.000Z</LastModified>
      <ETag>"5B3C1A2E053D763E1B002CC607C5A0FE1****"</ETag>
      <Type>Normal</Type>
      <Size>344606</Size>
      <StorageClass>Standard</StorageClass>
      <Owner>
          <ID>0022012****</ID>
          <DisplayName>user_example</DisplayName>
      </Owner>
</Contents>
<Contents>
      <Key>fun/movie/007.avi</Key>
      <LastModified>2012-02-24T08:43:27.000Z</LastModified>
      <ETag>"5B3C1A2E053D763E1B002CC607C5A0FE1****"</ETag>
      <Type>Normal</Type>
      <Size>344606</Size>
      <StorageClass>Standard</StorageClass>
      <Owner>
          <ID>0022012****</ID>
          <DisplayName>user_example</DisplayName>
      </Owner>
</Contents>
<Contents>
      <Key>fun/test.jpg</Key>
      <LastModified>2012-02-24T08:42:32.000Z</LastModified>
      <ETag>"5B3C1A2E053D763E1B002CC607C5A0FE1****"</ETag>
      <Type>Normal</Type>
      <Size>344606</Size>
      <StorageClass>Standard</StorageClass>
      <Owner>
          <ID>0022012****</ID>
          <DisplayName>user_example</DisplayName>
      </Owner>
</Contents>
</ListBucketResult>

Ön ek ve ayraç parametrelerini içeren istek

GET /?prefix=fun/&delimiter=/ HTTP/1.1
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 24 Feb 2012 08:43:27 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Örnek yanıt

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 24 Feb 2012 08:43:27 GMT
Content-Type: application/xml
Content-Length: 712
Connection: keep-alive
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<ListBucketResult xmlns=”http://doc.oss-cn-hangzhou.aliyuncs.com”>
<Name>examplebucket</Name>
<Prefix>fun/</Prefix>
<Marker></Marker>
<MaxKeys>100</MaxKeys>
<Delimiter>/</Delimiter>
<IsTruncated>false</IsTruncated>
<Contents>
      <Key>fun/test.jpg</Key>
      <LastModified>2012-02-24T08:42:32.000Z</LastModified>
      <ETag>"5B3C1A2E053D763E1B002CC607C5A0FE1****"</ETag>
      <Type>Normal</Type>
      <Size>344606</Size>
      <StorageClass>Standard</StorageClass>
      <Owner>
          <ID>0022012****</ID>
          <DisplayName>user_example</DisplayName>
      </Owner>
</Contents>
<CommonPrefixes>
      <Prefix>fun/movie/</Prefix>
</CommonPrefixes>
</ListBucketResult>

İşaretleyici parametresini belirten sayfalanmış istek

Bu örnekte en fazla iki nesne döndürmek için max-keys değeri 2 olarak ayarlanmıştır.

GET /?max-keys=2&marker=test1.txt HTTP/1.1
Host: examplebucket.oss-cn-shenzhen.aliyuncs.com
Accept-Encoding: identity
Accept: */*
Connection: keep-alive
User-Agent: aliyun-sdk-python/2.11.0(Darwin/18.2.0/x86_64;3.4.1)
date: Tue, 26 May 2020 08:39:48 GMT
authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Örnek yanıt

Sonraki istek için işaretleyici olarak yanıtta yer alan NextMarker değerini kullanın.

HTTP/1.1 200 OK
Server: AliyunOSS
Date: Tue, 26 May 2020 08:39:48 GMT
Content-Type: application/xml
Content-Length: 1032
Connection: keep-alive
x-oss-request-id: 5ECCD5D4881816373582xxx
x-oss-server-time: 3

<?xml version="1.0" encoding="UTF-8"?>
<ListBucketResult>
  <Name>examplebucket</Name>
  <Prefix></Prefix>
  <Marker>test1.txt</Marker>
  <MaxKeys>2</MaxKeys>
  <Delimiter></Delimiter>
  <EncodingType>url</EncodingType>
  <IsTruncated>true</IsTruncated>
  <NextMarker>test100.txt</NextMarker>
  <Contents>
    <Key>test10.txt</Key>
    <LastModified>2020-05-26T07:50:18.000Z</LastModified>
    <ETag>"C4CA4238A0B923820DCC509A6F75****"</ETag>
    <Type>Normal</Type>
    <Size>1</Size>
    <StorageClass>Standard</StorageClass>
    <Owner>
      <ID>1305433xxx</ID>
      <DisplayName>1305433xxx</DisplayName>
    </Owner>
  </Contents>
  <Contents>
    <Key>test100.txt</Key>
    <LastModified>2020-05-26T07:50:20.000Z</LastModified>
    <ETag>"C4CA4238A0B923820DCC509A6F75****"</ETag>
    <Type>Normal</Type>
    <Size>1</Size>
    <StorageClass>Standard</StorageClass>
    <Owner>
      <ID>1305433xxx</ID>
      <DisplayName>1305433xxx</DisplayName>
    </Owner>
  </Contents>
</ListBucketResult>

Archive veya Cold Archive nesneleri içeren bir paket için istek

examplebucket paketinin exampleobject1.txt, exampleobject2.txt ve exampleobject3.txt nesnelerini içerdiğini varsayalım. Üç nesnenin tamamı Cold Archive depolama sınıfındadır. Üç nesnenin durumları aşağıdaki gibidir:

exampleobject1.txt için RestoreObject isteği gönderilmemiş veya gönderilen RestoreObject isteğinin süresi dolmuştur.
exampleobject2.txt için RestoreObject isteği gönderilmiş ve geri yükleme işlemi devam etmektedir.
exampleobject3.txt için RestoreObject isteği gönderilmiş ve geri yükleme işlemi tamamlanmıştır.

Örnek istek

GET / HTTP/1.1
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 24 Feb 2012 08:43:27 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Örnek yanıt

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Date: Fri, 24 Feb 2012 08:43:27 GMT
Content-Type: application/xml
Content-Length: 1866
Connection: keep-alive
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<ListBucketResult xmlns=”http://doc.oss-cn-hangzhou.aliyuncs.com”>
  <Name>examplebucket</Name>
  <Prefix></Prefix>
  <Marker></Marker>
  <MaxKeys></MaxKeys>
  <Delimiter></Delimiter>
  <IsTruncated>false</IsTruncated>
  <Contents>
        <Key>exampleobject1.txt</Key>
        <LastModified>2020-06-22T11:42:32.000Z</LastModified>
        <ETag>"5B3C1A2E053D763E1B002CC607C5A0FE1****"</ETag>
        <Type>Normal</Type>
        <Size>344606</Size>
        <StorageClass>ColdArchive</StorageClass>
        <Owner>
            <ID>0022012****</ID>
            <DisplayName>user-example</DisplayName>
        </Owner>
  </Contents>
  <Contents>
        <Key>exampleobject2.txt</Key>
        <LastModified>2020-06-22T11:42:32.000Z</LastModified>
        <ETag>"5B3C1A2E053D763E1B002CC607C5A0FE1****"</ETag>
        <Type>Normal</Type>
        <Size>344606</Size>
        <StorageClass>Standard</StorageClass>
        <RestoreInfo>ongoing-request="true"</RestoreInfo>
        <Owner>
            <ID>0022012****</ID>
            <DisplayName>user-example</DisplayName>
        </Owner>
  </Contents>
  <Contents>
        <Key>exampleobject3.txt</Key>
        <LastModified>2020-06-22T11:42:32.000Z</LastModified>
        <ETag>"5B3C1A2E053D763E1B002CC607C5A0FE1****"</ETag>
        <Type>Normal</Type>
        <Size>344606</Size>
        <StorageClass>Standard</StorageClass>
        <RestoreInfo>ongoing-request="false", expiry-date="Thu, 24 Sep 2020 12:40:33 GMT"</RestoreInfo>
        <Owner>
            <ID>0022012****</ID>
            <DisplayName>user-example</DisplayName>
        </Owner>
  </Contents>
</ListBucketResult>

SDK

Bu işlemi çağırmaya yönelik SDK'lar:

ossutil komut satırı aracı

İlgili ossutil komutu list-objects (get-bucket) şeklindedir.

Hata kodları

Hata kodu	HTTP durum kodu	Açıklama
NoSuchBucket	404	Belirtilen paket mevcut değil. Paket adının geçerli olup olmadığını kontrol edin.
AccessDenied	403	Gerekli izinlere sahip değilsiniz. Bu işlemi yalnızca paket sahibi veya `oss:ListObjects` izni verilmiş kullanıcılar gerçekleştirebilir.
InvalidArgument	400	max-keys değeri 0'dan küçük veya 1.000'den büyük. prefix, marker veya delimiter parametresinin uzunluğu geçersiz.