Aracılığıyla paylaş

Blobları Listeleme

İşlem List Blobs , belirtilen kapsayıcının altındaki blobların listesini döndürür.

İstek

List Blobs isteğini aşağıdaki gibi oluşturabilirsiniz. HTTPS önerilir. myaccount değerini depolama hesabınızın adıyla değiştirin.

Yöntem İstek URI'si HTTP sürümü
GET https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list HTTP/1.1 (İngilizce)

Öykünmüş depolama hizmeti URI'si

Öykünülmüş depolama hizmetine yönelik bir istekte bulunduğunuzda, öykünücü ana bilgisayar adını ve Azure Blob Depolama bağlantı noktasını şu şekilde 127.0.0.1:10000belirtin ve ardından öykünülmüş depolama hesabı adını belirtin.

Yöntem İstek URI'si HTTP sürümü
GET http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container&comp=list HTTP/1.1 (İngilizce)

Daha fazla bilgi için bkz: Yerel Azure Depolama geliştirmesi için Azurite öykünücüsünü kullanma.

URI parametreleri

URI'de aşağıdaki ek parametreleri belirtebilirsiniz.

Parametre Tarif
prefix Opsiyonel. Sonuçları yalnızca belirtilen ön ek ile başlayan adlara sahip blobları döndürecek şekilde filtreler. Hiyerarşik ad alanına sahip hesaplarda, ön ek yolunun ortasında bir dosyanın adının göründüğü durumlarda hata oluşur. Örneğin, önek yolunu readmefile.txtkullanarak adlandırılmış folder1/folder2/readme/readmefile.txt blobları bulmayı deneyebilirsiniz. Herhangi bir alt klasör adlı readmebir dosya içeriyorsa bir hata görüntülenir.
delimiter Opsiyonel. İstek bu parametreyi içerdiğinde, işlem yanıt gövdesinde bir BlobPrefix öğe döndürür. Bu öğe, sınırlayıcı karakterinin görünümüne kadar aynı alt dizeyle başlayan adlara sahip tüm bloblar için yer tutucu işlevi görür. Sınırlayıcı tek bir karakter veya dize olabilir.
marker Opsiyonel. Bir sonraki liste işlemiyle döndürülecek listenin bölümünü tanımlayan dize değeri. Döndürülen liste tamamlanmadıysa, işlem yanıt gövdesi içinde bir işaretçi değeri döndürür. Daha sonra sonraki bir çağrıda işaretleyici değerini kullanarak bir sonraki liste öğesi kümesini isteyebilirsiniz.

İşaretçi değeri istemciye göre opaktır.
maxresults Opsiyonel. Tüm BlobPrefix öğeler dahil olmak üzere döndürülecek blob sayısı üst sınırını belirtir. İstek maxresultsbelirtmezse veya 5.000'den büyük bir değer belirtirse, sunucu en fazla 5.000 öğe döndürür. Döndürülecek ek sonuçlar varsa, hizmet yanıt öğesinde bir devamlılık NextMarker belirteci döndürür. Bazı durumlarda, hizmet tarafından maxresultsbelirtilenden daha az sonuç döndürebilir ve ayrıca bir devamlılık belirteci döndürebilir.

maxresults sıfırdan küçük veya sıfıra eşit bir değere ayarlanması hata yanıt kodu 400 (Hatalı İstek) ile sonuçlanır.
include={snapshots,metadata,uncommittedblobs,copy,deleted,tags,versions,
deletedwithversions,immutabilitypolicy,legalhold,permissions}		 Opsiyonel. Yanıta eklenecek bir veya daha fazla veri kümesini belirtir:

- snapshots: Anlık görüntülerin numaralandırmaya dahil edilmesi gerektiğini belirtir. Anlık görüntüler, yanıtta en eskiden en yeniye listelenir.
- metadata: Yanıtta blob meta verilerinin döndürüleceğini belirtir.
- uncommittedblobs: Blokları karşıya yüklenen, ancak Blok Listesi Koy kullanılarak işlenmemiş blobların yanıta dahil edileceğini belirtir.
- copy: Sürüm 2012-02-12 ve sonrası. Geçerli veya önceki Copy Blob herhangi bir işlemle ilgili meta verilerin yanıta dahil edilmesi gerektiğini belirtir.
- deleted: Sürüm 2017-07-29 ve sonrası. Geçici olarak silinen blobların yanıta eklenmesi gerektiğini belirtir.
- tags: Sürüm 2019-12-12 ve sonrası. Kullanıcı tanımlı blob dizin etiketlerinin yanıta eklenmesi gerektiğini belirtir.
- versions: Sürüm 2019-12-12 ve sonrası. Blob sürümlerinin numaralandırmaya eklenmesi gerektiğini belirtir.
- deletedwithversions: Sürüm 2020-10-02 ve sonrası. Herhangi bir sürüme sahip silinen blobların (etkin veya silinmiş) yanıta eklenmesi gerektiğini belirtir. Kalıcı olarak sildiğiniz öğeler, çöp toplama tarafından işlenene kadar yanıtta görünür. etiketini \<HasVersionsOnly\>ve değerini truekullanın.
- immutabilitypolicy: Sürüm 2020-06-12 ve sonrası. Numaralandırmanın tarihe kadar değişmezlik ilkesini ve blobların değişmezlik ilkesi modunu içermesi gerektiğini belirtir.
- legalhold: Sürüm 2020-06-12 ve sonrası. Numaralandırmanın blobların yasal tutmasını içermesi gerektiğini belirtir.
- permissions: Sürüm 2020-06-12 ve sonrası. Yalnızca hiyerarşik ad alanı etkinleştirilmiş hesaplar için desteklenir. bir istek bu parametreyi içeriyorsa, listelenen bloblar veya dizinler için sahip, grup, izinler ve erişim denetimi listesi numaralandırmaya eklenir.

URI'de bu seçeneklerden birden fazlasını belirtmek için, her seçeneği URL ile kodlanmış bir virgülle ("%82") ayırmanız gerekir.
showonly={deleted,files,directories} Opsiyonel. Yanıtta döndürülecek şu veri kümelerinden birini belirtir:

- deleted:Opsiyonel. Sürüm 2020-08-04 ve üzeri. Yalnızca hiyerarşik ad alanına sahip etkinleştirilmiş hesaplar için. bir istek bu parametreyi içerdiğinde, liste yalnızca geçici olarak silinen blobları içerir. POSIX ACL yetkilendirme geri dönüşlerinin geçici olarak silinen blobları listelemek için desteklenmediğini unutmayın. Ayrıca belirtilirse include=deleted , istek Hatalı İstek (400) ile başarısız olur.
- files:Opsiyonel. Sürüm 2020-12-06 ve üzeri. Yalnızca hiyerarşik ad alanına sahip etkinleştirilmiş hesaplar için. bir istek bu parametreyi içerdiğinde, liste yalnızca dosyaları içerir.
- directories:Opsiyonel. Sürüm 2020-12-06 ve üzeri. Yalnızca hiyerarşik ad alanına sahip etkinleştirilmiş hesaplar için. bir istek bu parametreyi içerdiğinde, liste yalnızca dizinleri içerir.
timeout Opsiyonel. timeout parametresi saniye cinsinden ifade edilir. Daha fazla bilgi için bkz: Blob Depolama işlemleri için zaman aşımlarını ayarlama.
startFrom Opsiyonel. [Önizleme] Sürüm 2023-05-03 ve daha yeni. Parametre, startFrom prefik parametresinin belirlenen aralık içinde tanımlanmış bir konumdan başlayan blobları listelemek için kullanıldığı gibi, konteyner içinde tam nitelikli bir yol belirtir. Örneğin, startFrom olarak klasör1/klasör2 öneki altında klasör1/klasör2/klasör3/readmefile.txt listelendiğinde, klasör1/klasör2/klasör3/readmefile.txtolarak listelenmeye başlar.

İstek üst bilgileri

Aşağıdaki tabloda gerekli ve isteğe bağlı istek üst bilgileri açıklanmaktadır.

İstek üst bilgisi Tarif
Authorization Gerekli. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. azure depolama istekleri yetkilendirme.
Date veya x-ms-date Gerekli. İstek için Eşgüdümlü Evrensel Saati (UTC) belirtir. Daha fazla bilgi için bkz. azure depolama istekleri yetkilendirme.
x-ms-version Tüm yetkili istekler için gereklidir ve anonim istekler için isteğe bağlıdır. Bu istek için kullanılacak işlemin sürümünü belirtir. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma.
x-ms-client-request-id Opsiyonel. Günlüğe kaydetme yapılandırıldığında günlüklere kaydedilen 1 kibibayt (KiB) karakter sınırıyla istemci tarafından oluşturulan, opak bir değer sağlar. İstemci tarafı etkinlikleriyle sunucunun aldığı istekler arasında bağıntı sağlamak için bu üst bilgiyi kullanmanızı kesinlikle öneririz. Daha fazla bilgi için bkz. azure blob depolama izleme.
x-ms-upn Opsiyonel. Yalnızca hesap için hiyerarşik bir ad alanı etkinleştirildiğinde ve include=permissions istekte sağlandığında geçerlidir. Eğertrue, Owner<, >Group< ve >Acl< alanlarında döndürülen >kullanıcı kimliği değerleri, Microsoft Entra nesne kimliklerinden kullanıcı asıl adlarına dönüştürülür. Ise false, değerler Microsoft Entra nesne kimlikleri olarak döndürülür. Varsayılan değer şudur: false. Benzersiz kolay adlara sahip olmadıklarından grup ve uygulama nesnesi kimliklerinin çevrildiğini unutmayın.

İstek gövdesi

Hiç kimse.

Örnek istek

Bkz. Örnek istek için blob kaynaklarını numaralandırma .

Yanıt

Yanıt bir HTTP durum kodu, yanıt üst bilgileri kümesi ve XML biçiminde bir yanıt gövdesi içerir.

Durum kodu

Başarılı bir işlem 200 durum kodunu döndürür (Tamam). Durum kodları hakkında bilgi için bkz. Durum ve hata kodları.

Yanıt üst bilgileri

Bu işlemin yanıtı aşağıdaki üst bilgileri içerir. Yanıt ek, standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.

Yanıt üst bilgisi Tarif
Content-Type Sonuçların döndürüldiği biçimi belirtir. Şu anda bu değer application/xml.
x-ms-request-id Bu üst bilgi, yapılan isteği benzersiz olarak tanımlar ve isteğin sorunlarını gidermek için kullanılabilir. Daha fazla bilgi için bkz. API işlemleriyle ilgili sorunları giderme.
x-ms-version İsteği çalıştırmak için kullanılan Blob Depolama sürümünü gösterir. Bu üst bilgi, sürüm 2009-09-19 ve üzeri kullanılarak yapılan istekler için döndürülür.

Bu üst bilgi, kapsayıcı Blob Depolama'nın 2009-09-19 sürümü kullanılarak genel erişim için işaretlenmişse, belirtilen bir sürüm olmadan anonim istekler için de döndürülür.
Date Yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri. Hizmet bu değeri oluşturur.
x-ms-client-request-id İstekler ve karşılık gelen yanıtlarla ilgili sorunları gidermek için bu üst bilgiyi kullanabilirsiniz. bu üst bilginin değeri, istekte varsa x-ms-client-request-id üst bilgisinin değerine eşittir. Değer en fazla 1024 görünür ASCII karakterdir. İstekte x-ms-client-request-id üst bilgisi yoksa, yanıtta bu üst bilgi bulunmaz.

Yanıt gövdesi

XML yanıtının biçimi aşağıdaki gibidir.

, Prefix, , Markerve MaxResults öğelerinin Delimiteryalnızca istek URI'sinde belirtilmişse mevcut olduğunu unutmayın. Boşsa NextMarker , liste sonuçları tamamlanmıştır. Boş NextMarkerdeğilse , liste sonuçları tam olabilir veya olmayabilir. Tüm blobları listelemek istiyorsanız, boş olana kadar List Blobs sonraki işaretçi değerleriyle çağırmaya NextMarker devam edin.

Anlık görüntüler, blob meta verileri ve kaydedilmemiş bloblar, yalnızca istek URI'sinde parametresiyle include belirtilmişse yanıta dahil edilir.

Sürüm 2009-09-19 ve sonraki sürümlerde, blobun özellikleri bir Properties öğe içinde kapsüllenir.

2009-09-19 sürümünden başlayarak, List Blobs yanıt gövdesinde aşağıdaki yeniden adlandırılmış öğeleri döndürür:

  • Last-Modified (daha önce LastModified)

  • Content-Length (daha önce Size)

  • Content-Type (daha önce ContentType)

  • Content-Encoding (daha önce ContentEncoding)

  • Content-Language (daha önce ContentLanguage)

Öğe Content-MD5 , 2009-09-19 ve sonraki sürümlerle oluşturulan bloblar için görünür. Sürüm 2012-02-12 ve sonraki sürümlerde Blob Depolama, Content-MD5 kullanarak bir blob yüklediğinizde değeri hesaplar. Blob Depolama, Blok Listesi Koy'u kullanarak bir blob oluşturduğunuzda bunu hesaplamaz. Blob'u oluştururken veya Content-MD5 ya da Blob Özelliklerini Ayarla işlemlerini çağırarak değeri açıkça ayarlayabilirsiniz.

2009-09-19 ve sonraki sürümler için, ancak 2015-02-21 sürümünden önceki sürümler için, ekleme blobları içeren bir kapsayıcıyı çağıramazsınız List Blobs . Listelemenin sonucu bir ekleme blobu içeriyorsa hizmet 409 (Çakışma) durum kodunu döndürür.

LeaseState ve LeaseDuration yalnızca 2012-02-12 ve sonraki sürümlerde görünür.

CopyId, CopyStatus, CopySource, CopyProgressCopyCompletionTime, ve CopyStatusDescription yalnızca 2012-02-12 ve sonraki sürümlerde, bu işlem parametresini include={copy} içerdiğinde görünür. Bu blob hiçbir zaman bir Copy Blob işlemde hedef olmadıysa bu öğeler görünmez. Bu blob sonuçlandırılan Copy Blob bir işlemden sonra , Set Blob Propertiesveya Put Blobkullanılarak Put Block Listdeğiştirilmişse öğeler görünmez. Bu öğeler, 2012-02-12 sürümünden önce Blob Kopyala tarafından oluşturulan bir blob ile de görünmez.

Sürüm 2013-08-15 ve sonraki sürümlerde, EnumerationResults öğe blob uç noktasını belirten bir ServiceEndpoint öznitelik içerir. Bu öğe, kapsayıcının adını belirten bir ContainerName alan da içerir. Önceki sürümlerde, bu iki özellik sahada bir araya ContainerName getiriliyordu. Ayrıca 2013-08-15 ve sonraki sürümlerde, Url altındaki Blob öğe kaldırılmıştır.

Sürüm 2015-02-21 ve üzeri List Blobs için tüm türlerdeki blobları (blok, sayfa ve ekleme blobları) döndürür.

2015-12-11 ve sonraki List Blobs sürümler için öğesini döndürür ServerEncrypted . Bu öğe, blob ve uygulama meta verilerinin tamamen şifrelenip şifrelenmediği ve true aksi takdirde false ayarlanır.

2016-05-31 ve sonraki sürümler için, List Blobs artımlı kopyalama blobları ve anlık görüntüler için öğeyi döndürür IncrementalCopy ve değer olarak trueayarlanır.

2017-04-17 ve sonraki sürümler için, List Blobs bir erişim katmanı açıkça ayarlanmışsa öğeyi döndürür AccessTier . İzin verilen premium sayfa blob katmanlarının listesi için bkz: VM'ler için yüksek performanslı premium depolama ve yönetilen diskler. Blob Depolama veya genel amaçlı v2 hesapları için geçerli değerler , Hotve Cool'dirArchive. Blob yeniden sulandırılma bekleniyor durumundaysa, ArchiveStatus öğe geçerli değerlerden biriyle (rehydrate-pending-to-hot, rehydrate-pending-to-coolveya rehydrate-pending-to-coldveya ) döndürülür. Blok blobu katmanlama hakkında ayrıntılı bilgi için Sık erişimli, seyrek erişimli ve arşiv depolama katmanlarına bakın.

2017-04-17 ve sonraki List Blobs sürümler için Blob Depolama veya genel amaçlı v2 hesaplarındaki öğeyi döndürür AccessTierInferred . Blok blobu erişim katmanı ayarlanmamışsa, katman bilgileri depolama hesabı özelliklerinden çıkarılır ve bu değer olarak trueayarlanır. Bu üst bilgi yalnızca katmanın hesap özelliğinden çıkarılması durumunda bulunur.

2017-04-17 ve sonraki List Blobs sürümler için Blob Depolama veya genel amaçlı v2 hesaplarındaki öğeyi döndürür AccessTierChangeTime . Bu yalnızca blok blobundaki katman ayarlanmışsa döndürülür. Daha fazla bilgi için bkz. üst bilgilerde tarih-saat değerlerinin gösterimi.

2017-07-29 ve sonraki sürümler için, Deleted, DeletedTimeve RemainingRetentionDays bu işlem parametresini include={deleted} içerdiğinde görünür. Bu blob silinmediyse bu öğeler görünmez. Bu öğeler, geçici silme özelliği etkinleştirildiğinde işlemle silinen DELETE bloblar veya anlık görüntüler için görünür. Öğe Deleted , geçici olarak silinen bloblar ve anlık görüntüler için olarak true ayarlanır. Deleted-Time blobun silindiği zamana karşılık gelir. RemainingRetentionDays Geçici olarak silinen bir blobun kaç gün sonra kalıcı olarak silineceğini gösterir.

2017-11-09 ve sonraki Creation-Time sürümler için bu blobun oluşturulduğu saati döndürür.

2019-02-02 ve sonraki sürümler için, List Blobs blob müşteri tarafından sağlanan bir anahtarla şifrelenmişse öğeyi döndürür CustomerProvidedKeySha256 . Değer, blobu şifrelemek için kullanılan anahtarın SHA-256 karması olarak ayarlanır. Ayrıca, işlem parametresini include={metadata} içeriyorsa ve müşteri tarafından sağlanan bir anahtarla şifrelenmiş bir blob üzerinde uygulama meta verileri varsa, Metadata öğenin bir Encrypted="true" özniteliği olur. Bu öznitelik, blobun işlemin bir parçası List Blobs olarak şifresi çözülemeyen meta verilere sahip olduğunu gösterir. Bu blobların meta verilerine erişmek için müşteri tarafından sağlanan anahtarla Blob Özelliklerini Al'ı veya Blob Meta Verilerini Al'ı çağırın.

Sürüm 2019-02-02 ve üzeri için, List Blobs blob bir şifreleme kapsamıyla şifrelenmişse öğeyi döndürür EncryptionScope . Değer, blobu şifrelemek için kullanılan şifreleme kapsamının adına ayarlanır. İşlem parametresini include={metadata} içeriyorsa, blob üzerindeki uygulama meta verilerinin şifresi saydam bir şekilde çözülür ve öğede Metadata kullanılabilir.

2019-12-12 ve sonraki sürümler için, List Blobs nesne durumdaysa Blob Depolama veya genel amaçlı v2 hesaplarındaki RehydratePriority öğeyi döndürürrehydrate pending. Geçerli değerler: High ve Standard.

Sürüm 2019-12-12 ve üzeri için, List Blobs hesapta sürüm oluşturma etkinleştirildiğinde bloblar ve oluşturulan blob sürümleri için öğeyi döndürür VersionId .

2019-12-12 ve sonraki List Blobs sürümler için blobun geçerli sürümünün öğesini döndürür IsCurrentVersion . Değer olarak trueayarlanır. Bu öğe, geçerli sürümü salt okunur, otomatik olarak oluşturulan sürümlerden ayırt etmenizi sağlar.

2019-12-12 ve sonraki sürümler için, List Blobs herhangi bir etikete sahip bloblar için öğeyi döndürür TagCount . Öğe Tags yalnızca bu işlem parametreyi include={tags} içerdiğinde görünür. Blobda etiket yoksa bu öğeler görünmez.

Sürüm 2019-12-12 ve üzeri için, List Blobs ekleme blobları için öğeyi döndürür Sealed . Öğe Sealed yalnızca ekleme blobu mühürlendiğinde görünür. Ekleme blobu korumalı değilse bu öğeler görünmez.

2020-02-10 ve sonraki List Blobs sürümler için öğesini döndürür LastAccessTime . öğesi, depolama hesabının son erişim zamanı izleme ilkesine göre blob verilerine en son ne zaman erişildiğini gösterir. Depolama hesabında bu ilke yoksa veya ilke devre dışı bırakıldıysa öğesi döndürülemez. Hesabın son erişim zamanı izleme ilkesini ayarlama hakkında daha fazla bilgi için Blob Hizmeti API'sine bakın. Öğe LastAccessTime , blobun meta verilerine en son ne zaman erişildiğini izlemez.

2020-06-12 ve sonraki sürümler için, List Blobs bu işlem parametresini ImmutabilityPolicyUntilDateImmutabilityPolicyMode içerdiğinde ve include={immutabilitypolicy} öğelerini döndürür.

Sürüm 2020-06-12 ve üzeri için, List Blobs bu işlem parametresini LegalHoldinclude={legalhold} içerdiğinde öğesini döndürür.

2020-06-12 ve sonraki sürümler için, List Blobs hiyerarşik ad alanı etkinleştirilmiş hesaplar için , Owner, Groupve Permissions öğelerini döndürürAcl. İsteğin parametreyi içermesi include={permissions} gerekir. Öğenin Acl , dosya veya dizinde ayarlanan erişim ve varsayılan erişim denetim listelerinin birleşik bir listesi olduğunu unutmayın.

2020-06-12 ve sonraki sürümler için, hiyerarşik ad alanı etkinleştirilmiş hesaplar için, List Blobs bir sınırlayıcı ile öğedeki PropertiesBlobPrefix öğeyi döndürür. Bu, dizindeki özelliklere karşılık gelir.

2020-08-04 ve sonraki sürümler için, hiyerarşik ad alanı etkinleştirilmiş List Blobs hesaplar için silinen bloblar için öğeyi döndürür DeletionId . DeletionId imzasız, 64 bitlik bir tanımlayıcıdır. öğesi, aynı yola sahip diğer silinmiş bloblardan ayırt etmek için geçici olarak silinmiş bir yolu benzersiz olarak tanımlar.

2020-10-02 ve sonraki sürümler için, hiyerarşik ad alanı etkinleştirilmiş List Blobs hesaplar için yolun özellik öğesini döndürür ResourceType . Bu ya da filedirectoryolabilir.

2021-02-12 ve sonraki sürümler için, List Blobs tüm BlobName veya BlobPrefixName öğe değerlerini yüzde olarak kodlar (RFC 2396'ya göre). Özel olarak, XML (U+FFFE veya U+FFFF) içinde geçerli olmayan karakterler içeren değerler için bunu yapar. Kodlanırsa, Name öğesi bir Encoded=true özniteliği içerir. Bunun, yanıtın Name geri kalan Name öğeleri için değil, yalnızca XML'de geçersiz karakterleri içeren öğe değerleri için geçerli olduğunu unutmayın.

2021-06-08 ve sonraki sürümler için, List Blobs hiyerarşik ad alanı etkinleştirilmiş hesaplar için properties öğesini döndürür Placeholder . Silinen blobları bir sınırlayıcı ile listelerken, yer tutucu dizinler için öğede BlobPrefix bu öğeyi döndürür. Geçici olarak silinen bloblara gezintiyi kolaylaştırmak için bu yer tutucu dizinler vardır.

2021-06-08 ve sonraki sürümler için, List Blobs hiyerarşik ad alanı etkinleştirilmiş hesaplar için öğesini döndürür EncryptionContext . Şifreleme bağlamı özellik değeri ayarlanırsa, ayarlanan değeri döndürür.

Sürüm 2020-02-10 ve sonraki sürümler için, hiyerarşik ad alanı etkinleştirilmiş List Blobs hesaplar için silinen bloblar için öğeyi döndürür Expiry-Time . Expiry-Time dosyanın süresinin dolacağı zamandır ve süre sonu aynı şekilde ayarlanmışsa dosya için döndürülür.

<?xml version="1.0" encoding="utf-8"?>  
<EnumerationResults ServiceEndpoint="http://myaccount.blob.core.windows.net/"  ContainerName="mycontainer">  
  <Prefix>string-value</Prefix>  
  <Marker>string-value</Marker>  
  <MaxResults>int-value</MaxResults>  
  <Delimiter>string-value</Delimiter>  
  <Blobs>  
    <Blob>  
      <Name>blob-name</Name>  
      <Snapshot>date-time-value</Snapshot>  
      <VersionId>date-time-vlue</VersionId>
      <IsCurrentVersion>true</IsCurrentVersion>
      <Deleted>true</Deleted>
      <Properties> 
        <Creation-Time>date-time-value</Creation-Time>
        <Last-Modified>date-time-value</Last-Modified>  
        <Etag>etag</Etag>
        <Owner>owner user id</Owner>
        <Group>owning group id</Group>
        <Permissions>permission string</Permissions>
        <Acl>access control list</Acl>
        <ResourceType>file | directory</ResourceType>
        <Placeholder>true</Placeholder>
        <Content-Length>size-in-bytes</Content-Length>  
        <Content-Type>blob-content-type</Content-Type>  
        <Content-Encoding />  
        <Content-Language />  
        <Content-MD5 />  
        <Cache-Control />  
        <x-ms-blob-sequence-number>sequence-number</x-ms-blob-sequence-number>  
        <BlobType>BlockBlob|PageBlob|AppendBlob</BlobType>  
        <AccessTier>tier</AccessTier>  
        <LeaseStatus>locked|unlocked</LeaseStatus>  
        <LeaseState>available | leased | expired | breaking | broken</LeaseState>  
        <LeaseDuration>infinite | fixed</LeaseDuration>  
        <CopyId>id</CopyId>  
        <CopyStatus>pending | success | aborted | failed </CopyStatus>  
        <CopySource>source url</CopySource>  
        <CopyProgress>bytes copied/bytes total</CopyProgress>  
        <CopyCompletionTime>datetime</CopyCompletionTime>  
        <CopyStatusDescription>error string</CopyStatusDescription>  
        <ServerEncrypted>true</ServerEncrypted> 
        <CustomerProvidedKeySha256>encryption-key-sha256</CustomerProvidedKeySha256>
        <EncryptionContext>encryption-context</EncryptionContext>
        <EncryptionScope>encryption-scope-name</EncryptionScope>
        <IncrementalCopy>true</IncrementalCopy>
        <AccessTierInferred>true</AccessTierInferred>
        <AccessTierChangeTime>datetime</AccessTierChangeTime>
        <DeletedTime>datetime</DeletedTime>
        <RemainingRetentionDays>no-of-days</RemainingRetentionDays>
        <TagCount>number of tags between 1 to 10</TagCount>
        <RehydratePriority>rehydrate priority</RehydratePriority>
        <Expiry-Time>date-time-value</Expiry-Time>
      </Properties>  
      <Metadata>     
        <Name>value</Name>  
      </Metadata>  
      <Tags>
          <TagSet>
              <Tag>
                  <Key>TagName</Key>
                  <Value>TagValue</Value>
              </Tag>
          </TagSet>
      </Tags>
      <OrMetadata />
    </Blob>  
    <BlobPrefix>  
      <Name>blob-prefix</Name>  
    </BlobPrefix>  
  </Blobs>  
  <NextMarker />  
</EnumerationResults>

Örnek yanıt

Örnek yanıt için blob kaynaklarını numaralandırma bölümüne bakın.

İzin

Azure Depolama'da herhangi bir veri erişim işlemi çağrılırken yetkilendirme gereklidir. aşağıda açıklandığı gibi List Blobs işlemini yetkileyebilirsiniz.

Önemli

Microsoft, Azure Depolama'ya yönelik istekleri yetkilendirmek için Yönetilen kimliklerle Microsoft Entra Id kullanılmasını önerir. Microsoft Entra ID, Paylaşılan Anahtar yetkilendirmesine kıyasla üstün güvenlik ve kullanım kolaylığı sağlar.

Azure Depolama, blob verilerine yönelik istekleri yetkilendirmek için Microsoft Entra Id kullanılmasını destekler. Microsoft Entra Id ile azure rol tabanlı erişim denetimini (Azure RBAC) kullanarak bir güvenlik sorumlusuna izin vekleyebilirsiniz. Güvenlik sorumlusu bir kullanıcı, grup, uygulama hizmet sorumlusu veya Azure yönetilen kimliği olabilir. OAuth 2.0 belirtecini döndürmek için güvenlik sorumlusunun kimliği Microsoft Entra Id tarafından doğrulanır. Daha sonra belirteç, Blob hizmetine karşı bir isteği yetkilendirmek için kullanılabilir.

Microsoft Entra Id kullanarak yetkilendirme hakkında daha fazla bilgi edinmek için bkz.Microsoft Entra Id kullanarak bloblara erişimi yetkilendirme .

İzinler

Aşağıda bir Microsoft Entra kullanıcısı, grubu, yönetilen kimliği veya hizmet sorumlusunun List Blobs işlemini çağırması için gereken RBAC eylemi ve bu eylemi içeren en az ayrıcalıklı yerleşik Azure RBAC rolü verilmiştir:

Belirtiyorsanız include=tags:

Azure RBAC kullanarak rol atama hakkında daha fazla bilgi edinmek için bkz. Blob verilerine erişim için Azure rolü atama.

Açıklamalar

Yanıttaki blob özellikleri

Kaydedilmemiş blobların numaralandırmaya eklenmesini istediyseniz, blob işlenene kadar bazı özelliklerin ayarlanmadığını unutmayın. Yanıtta bazı özellikler döndürülmeyebilir.

Öğe x-ms-blob-sequence-number yalnızca sayfa blobları için döndürülür.

Öğe OrMetadata yalnızca blok blobları için döndürülür.

Sayfa blobları için, öğede Content-Length döndürülen değer blobun x-ms-blob-content-length üst bilgisinin değerine karşılık gelir.

Öğe Content-MD5 , yalnızca blob üzerinde 2009-09-19 veya sonraki bir sürüm kullanılarak ayarlanmışsa yanıt gövdesinde görünür. Blob oluşturulduğunda veya Content-MD5 çağırarak özelliği ayarlayabilirsiniz. Sürüm 2012-02-12 ve sonraki sürümlerde, Put Blob istek bir MD5 üst bilgisi içermese Put Blob bile blok blobunun MD5 değerini ayarlar.

Yanıttaki meta veriler

Öğe Metadata yalnızca parametre URI'de belirtilmişse include=metadata bulunur. Öğe Metadata içinde, her bir ad-değer çiftinin değeri, çiftin adına karşılık gelen bir öğe içinde listelenir.

Bu parametreyle istenen meta verilerin Blob Depolama'nın 2009-09-19 sürümü tarafından uygulanan adlandırma kısıtlamalarına uygun olarak depolanması gerektiğini unutmayın. Bu sürümden başlayarak, tüm meta veri adlarının C# tanımlayıcıları için adlandırma kurallarına uyması gerekir.

Bir meta veri ad-değer çifti bu adlandırma kısıtlamalarını ihlal ediyorsa, yanıt gövdesi bir x-ms-invalid-name öğe içindeki sorunlu adı gösterir. Aşağıdaki XML parçası bunu gösterir:

  
…  
<Metadata>  
  <MyMetadata1>first value</MyMetadata1>  
  <MyMetadata2>second value</MyMetadata2>  
  <x-ms-invalid-name>invalid-metadata-name</x-ms-invalid-name>  
</Metadata>  
…

Yanıttaki etiketler

Öğe Tags yalnızca parametre URI'de belirtilmişse include=tags ve blob üzerinde etiketler varsa bulunur. Öğe TagSet içinde, her biri kullanıcı tanımlı blob dizin etiketlerini içeren Tag en key fazla 10 value öğe döndürülür. Yanıtta etiketlerin sıralanması garanti değildir.

Blob Tags üzerinde etiket yoksa ve TagCount öğeleri döndürülmez.

Depolama hizmeti blob ile etiketleri arasında güçlü tutarlılık sağlar, ancak ikincil dizin sonunda tutarlı olur. Etiketler, işlemler tarafından List Blobs görülmeden önce bir yanıt Find Blobs by Tags olarak görünür olabilir.

Yanıttaki anlık görüntüler

Anlık görüntüler, yalnızca parametre URI'de belirtilmişse include=snapshots yanıtta listelenir. Yanıtta listelenen anlık görüntüler öğeyi içermez LeaseStatus , çünkü anlık görüntülerin etkin kiralamaları olamaz.

Hizmet sürümü 2021-06-08 ve üzerini kullanarak, bir sınırlayıcı ile çağırabilir List Blobs ve numaralandırmaya anlık görüntüler ekleyebilirsiniz. 2021-06-08 öncesi hizmet sürümleri için, her ikisini de içeren bir istek InvalidQueryParameter hatası döndürür (HTTP durum kodu 400 – Hatalı İstek).

Yanıtta kaydedilmemiş bloblar

İşlenmemiş bloblar, yalnızca parametre URI'de belirtilmişse include=uncommittedblobs yanıtta listelenir. Yanıtta listelenen kaydedilmemiş bloblar aşağıdaki öğelerden hiçbirini içermez:

  • Last-Modified

  • Etag

  • Content-Type

  • Content-Encoding

  • Content-Language

  • Content-MD5

  • Cache-Control

  • Metadata

Yanıttaki silinen bloblar

Silinen bloblar yalnızca parametre URI'de belirtilmişse include=deleted yanıtta listelenir. Yanıtta listelenen silinmiş bloblar Lease öğelerini içermez, çünkü silinen bloblar etkin kiralamalara sahip olamaz.

Silinen anlık görüntüler, URI'de belirtilmişse include=deleted,snapshot liste yanıtına dahil edilir.

Yanıttaki nesne çoğaltma meta verileri

Öğe OrMetadata , bir blob üzerinde bir nesne çoğaltma ilkesi değerlendirildiğinde ve List Blobs çağrı 2019-12-12 veya sonraki bir sürüm kullanılarak yapıldığında mevcuttur. Öğe OrMetadata içinde, her bir ad-değer çiftinin değeri, çiftin adına karşılık gelen bir öğe içinde listelenir. Adın biçimi , or-{policy-id}_{rule-id}burada {policy-id} depolama hesabındaki nesne çoğaltma ilkesi tanımlayıcısını temsil eden bir GUID'dir. {rule-id} , depolama kapsayıcısındaki kural tanımlayıcısını temsil eden bir GUID'dir. Geçerli değerler complete veya failed.

  
…  
<OrMetadata>  
  <or-e524bba7-4323-4b93-91f8-d09d5d0b7057_d86c51de-ef02-4264-bdcf-dcd389a6c7ac>complete</or-e524bba7-4323-4b93-91f8-d09d5d0b7057_d86c51de-ef02-4264-bdcf-dcd389a6c7ac>  
  <or-2b302b5d-fcd5-44d6-a5ed-455bf27e17ea_4a398ff5-2a89-4090-879b-10248f23428e>failed</or-2b302b5d-fcd5-44d6-a5ed-455bf27e17ea_4a398ff5-2a89-4090-879b-10248f23428e>  
</OrMetadata>  
…

Yanıtta değişmezlik ilkesi

ve ImmutabilityPolicyUntilDateImmutabilityPolicyMode öğeleri yalnızca parametre URI'de belirtilmişse include=immutabilitypolicy bulunur.

<Properties> 
   <ImmutabilityPolicyUntilDate>date-time-value</ImmutabilityPolicyUntilDate>   
   <ImmutabilityPolicyMode>unlocked | locked </ImmutabilityPolicyMode>  
</Properties>

Öğe LegalHold yalnızca parametre URI'de belirtilmişse include=legalhold bulunur.

<Properties> 
  <LegalHold>true | false </LegalHold>  
</Properties>

İşaretçi değeri kullanarak sonuç kümelerini döndürme

Parametre için maxresults bir değer belirtirseniz ve döndürülecek blob sayısı bu değeri aşarsa veya için varsayılan değeri maxresultsaşarsa, yanıt gövdesi bir NextMarker öğe içerir. Bu öğe, sonraki bir istekte döndürülecek sonraki blobu gösterir. Bazı durumlarda, döndürülen sonuç sayısı değerinden NextMarkerküçük olsa bile hizmet öğeyi döndürebilirmaxresults.

Sonraki öğe kümesini döndürmek için, sonraki isteğin URI'sinde işaretçi parametresi olarak değerini NextMarker belirtin. Değerinin NextMarker opak olarak değerlendirilmesi gerektiğini unutmayın.

Blob ad alanında geçiş yapmak için sınırlayıcı kullanma

Parametre delimiter , çağıranın kullanıcı tarafından yapılandırılmış bir sınırlayıcı kullanarak blob ad alanında geçiş yapmasını sağlar. Bu şekilde, sanal bir blob hiyerarşisini dosya sistemiymiş gibi geçirebilirsiniz. Sınırlayıcı tek bir karakter veya dize olabilir.

İstek bu parametreyi içerdiğinde, işlem bir BlobPrefix öğe döndürür. Öğe BlobPrefix , sınırlayıcı karakterin görünümüne kadar aynı alt dizeyle başlayan adlara sahip tüm blobların yerine döndürülür. Öğenin değeri BlobPrefixsubstring+sınırlayıcıdır, burada substring bir veya daha fazla blob adıyla başlayan ortak alt dizedir ve sınırlayıcı parametrenin delimiter değeridir.

Bu ön ekle başlayan blobları listelemek için sonraki bir çağrı yapmak için değerini BlobPrefix kullanabilirsiniz. Bunu, istek URI'sinde parametrenin BlobPrefix değerini prefix belirterek yaparsınız.

Döndürülen her BlobPrefix öğesinin, her Blob öğesinde olduğu gibi en yüksek sonuç için sayıldığını unutmayın.

Bloblar yanıt gövdesinde alfabetik sırada listelenir ve önce büyük harfler listelenir. Hiyerarşik ad alanı etkinleştirilmiş hesaplar için, / en düşük sıralama düzeni olarak kabul edilir. Davranıştaki bu farklılık yalnızca yinelemeli listeleme için geçerlidir.

Kopyalama Durumu Açıklaması'ndaki kopyalama hataları

CopyStatusDescription Hata hakkında Copy Blob daha fazla bilgi içerir.

  • Kopyalama girişimi başarısız olduğunda, CopyStatus Blob Depolama işlemi yeniden deniyorsa olarak pending ayarlanır. Metin CopyStatusDescription , son kopyalama denemesi sırasında oluşmuş olabilecek hatayı açıklar.

  • olarak ayarlandığındaCopyStatus, metinde failed kopyalama işleminin başarısız olmasına neden olan hata açıklanır.CopyStatusDescription

Aşağıdaki tabloda her CopyStatusDescription değerin alanları açıklanmaktadır.

Parça Tarif
HTTP durum kodu Hatayı belirten standart üç basamaklı tamsayı.
Hata kodu Hatayı açıklayan anahtar sözcük. Bu, Azure tarafından ErrorCode< öğesinde >sağlanır. Hiçbir <ErrorCode> öğesi görünmezse, hizmet, HTTP belirtimindeki üç basamaklı HTTP durum koduyla ilişkili standart hata metnini içeren bir anahtar sözcük döndürür. Daha fazla bilgi için bkz . Ortak REST API hata kodları.
Bilgi Hatanın ayrıntılı açıklaması, tırnak içinde.

Aşağıdaki tabloda, yaygın hata senaryolarının CopyStatus ve CopyStatusDescription değerleri açıklanmaktadır.

Önemli

Burada gösterilen açıklama metni, sürüm değişikliği olmadan bile uyarı vermeden değişebilir. Bu metni tam olarak eşleştirmeye güvenmeyin.

Senaryo Durum Değerini Kopyala Durum Açıklaması değerini kopyala
Kopyalama işlemi başarıyla tamamlandı. başarı boş
Kullanıcı, tamamlanmadan önce kopyalama işlemini iptal etti. Iptal boş
Kopyalama işlemi sırasında kaynak blobdan okunurken bir hata oluştu. İşlem yeniden denenecek. beklemede 502 BadGateway "Kaynak okunurken yeniden denenebilir bir hatayla karşılaşıldı. Yeniden denenecek. Başarısızlık zamanı: <zaman>"
Kopyalama işleminin hedef blob'unu yazarken bir hata oluştu. İşlem yeniden denenecek. beklemede 500 InternalServerError "Yeniden denenebilir bir hatayla karşılaşıldı. Yeniden denenecek. Başarısızlık zamanı: <zaman>"
Kopyalama işleminin kaynak blobundan okunurken kurtarılamaz bir hata oluştu. başarısız 404 ResourceNotFound "Kaynak okunurken kopyalama başarısız oldu." Hizmet bu temel hatayı bildirdiğinde, ErrorCodeResourceNotFound öğesini döndürür.<> Yanıtta herhangi <bir ErrorCode> öğesi görünmezse, HTTP durumunun NotFoundgibi standart bir dize gösterimi görüntülenir.
Tüm kopyalama işlemlerini sınırlayan zaman aşımı süresi doldu. (Şu anda zaman aşımı süresi iki haftadır.) başarısız 500 OperationCancelled "Kopya izin verilen en uzun süreyi aştı."
Kaynaktan okuma yaparken kopyalama işlemi çok sık başarısız oldu ve denemelerin başarı oranı en düşük düzeyde değildi. (Bu zaman aşımı, başarısız olmadan önce çok kötü bir kaynağın iki hafta içinde yeniden denenmesini önler). başarısız 500 OperationCancelled "Kaynak okunurken kopya başarısız oldu."

Fatura

Fiyatlandırma istekleri, Blob Depolama API'lerini kullanan istemcilerden, doğrudan Blob Depolama REST API'si aracılığıyla veya bir Azure Depolama istemci kitaplığından kaynaklanabilir. Bu istekler işlem başına ücret tahakkuk eder. İşlem türü, hesabın ücretlendirilma şeklini etkiler. Örneğin, okuma işlemleri yazma işlemlerinden farklı bir faturalama kategorisine tahakkuk eder. Aşağıdaki tabloda, depolama hesabı türüne göre List Blobs istekleri için faturalama kategorisi gösterilmektedir:

İşlem Depolama hesabı türü Faturalama kategorisi
Blobları Listeleme Premium blok blobu
Standart genel amaçlı v2
Standart genel amaçlı v1		 Kapsayıcı işlemlerini listeleme ve oluşturma

Belirtilen faturalama kategorisinin fiyatlandırması hakkında bilgi edinmek için bkz. azure blob depolama fiyatlandırması.

Ayrıca bkz.

Durum ve hata kodları
blob depolama hata kodları

  • Last updated on