Aracılığıyla paylaş

Blobları Listeleme

  • Makale

List Blobs işlemi, 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

Öykünmüş depolama hizmeti URI'si

Öykünmüş depolama hizmetine yönelik bir istekte bulunurken öykünücü konak adını ve Azure Blob Depolama bağlantı noktasını 127.0.0.1:10000olarak 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

Daha fazla bilgi için bkz. Yerel Azure Depolama geliştirmeiçin Azurite öykünücüsü 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, folder1/folder2/readme/readmefile.txtön ek yolunu kullanarak readmefile.txt adlı blobları bulmaya çalışabilirsiniz. Herhangi bir alt klasör readmeadlı bir 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 öğesi 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 öğeleri dahil olmak üzere döndürülecek en fazla blob sayısı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 NextMarker yanıt öğesinde bir devam belirteci döndürür. Bazı durumlarda hizmet, maxresultstarafından belirtilenden 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 eklenmesi 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üldüğünü belirtir.
- uncommittedblobs: Blokları karşıya yüklenen ancak Blok Listesikullanılarak işlenmeyen blobların yanıta eklendiğini belirtir.
- copy: Sürüm 2012-02-12 ve üzeri. Geçerli veya önceki Copy Blob işlemleriyle ilgili meta verilerin yanıta eklenmesi gerektiğini belirtir.
- deleted: Sürüm 2017-07-29 ve üzeri. Geçici olarak silinen blobların yanıta eklenmesi gerektiğini belirtir.
- tags: Sürüm 2019-12-12 ve üzeri. Kullanıcı tanımlı blob dizin etiketlerinin yanıta eklenmesi gerektiğini belirtir.
- versions: Sürüm 2019-12-12 ve üzeri. Blob sürümlerinin numaralandırmaya eklenmesi gerektiğini belirtir.
- deletedwithversions: Sürüm 2020-10-02 ve üzeri. 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 üzeri. 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 üzeri. Numaralandırmanın blobların yasal tutmasını içermesi gerektiğini belirtir.
- permissions: Sürüm 2020-06-12 ve üzeri. 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ış virgül ("%82") ile ayırmanız gerekir.
showonly={deleted,files,directories} Opsiyonel. Yanıtta döndürülecek şu veri kümelerinden birini belirtir:

- deleted: İsteğe bağlı. 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. include=deleted de belirtilirse, istek Hatalı İstek (400) ile başarısız olur.
- files: İsteğe bağlı. 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: İsteğe bağlı. 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.

İ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 depolamaistekleri 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 depolamaistekleri 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 depolamaizleme .
x-ms-upn Opsiyonel. Yalnızca hesap için hiyerarşik bir ad alanı etkinleştirildiğinde ve istekte include=permissions sağlandığında geçerlidir. trueise, <Sahip>, <Grup>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. falseise, değerler Microsoft Entra nesne kimlikleri olarak döndürülür. Varsayılan değer false. Benzersiz kolay adlara sahip olmadıklarından grup ve uygulama nesnesi kimliklerinin çevrildiğini unutmayın.

İstek gövdesi

Hiç kimse.

Örnek istek

Örnek istek için bkz. 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 bilgilerHTTP/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, Marker, MaxResultsve Delimiter öğelerinin yalnızca istek URI'sinde belirtilmişse mevcut olduğunu unutmayın. NextMarker öğesi yalnızca liste sonuçları tamamlanmazsa bir değere sahiptir.

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

Sürüm 2009-09-19 ve sonraki sürümlerde blob'un özellikleri bir Properties öğesi 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)

Content-MD5 öğesi, sürüm 2009-09-19 ve üzeri ile oluşturulan bloblar için görünür. 2012-02-12 ve sonraki sürümlerde Blob Depolama, Put Blobkullanarak bir blob yüklediğinizde Content-MD5 değerini hesaplar. Blok Listesini Koykullanarak blob oluşturduğunuzda Blob Depolama bunu hesaplamaz. Blobu oluştururken değerini açıkça ayarlayabilir veya Blok Listesini Koy çağırabilir veya Blob Özelliklerini Ayarlama işlemlerini .

2009-09-19 ve sonraki sürümler için, ancak sürüm 2015-02-21'den önce ekleme blobları içeren bir kapsayıcıda List Blobs çağıramazsınız. 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, CopyProgress, CopyCompletionTimeve CopyStatusDescription yalnızca include={copy} parametresini içerdiğinde 2012-02-12 ve sonraki sürümlerde görünür. Bu blob Copy Blob bir işlemde hiç hedef olmadıysa bu öğeler görünmez. Bu blob sonlandırılan bir Copy Blob işleminden sonra Set Blob Properties, Put Blobveya Put Block Listkullanılarak değiştirildiğinde öğeler görünmez. Bu öğeler, Copy Blobtarafından 2012-02-12 sürümünden önce oluşturulan bir blobla da görünmez.

2013-08-15 ve sonraki sürümlerde, EnumerationResults öğesi blob uç noktasını belirten bir ServiceEndpoint özniteliği içerir. Bu öğe ayrıca kapsayıcının adını belirten bir ContainerName alanı içerir. Önceki sürümlerde, bu iki öznitelik ContainerName alanında birleştirildi. Ayrıca 2013-08-15 ve sonraki sürümlerde, Blob altındaki Url öğesi kaldırıldı.

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

2015-12-11 ve sonraki sürümler için List BlobsServerEncrypted öğesini döndürür. Blob ve uygulama meta verileri tamamen şifrelenirse ve false değilse bu öğe true olarak ayarlanır.

2016-05-31 ve sonraki sürümler için List Blobs artımlı kopya blobları ve anlık görüntüleri için IncrementalCopy öğesini döndürür ve değer trueolarak ayarlanır.

2017-04-17 ve sonraki sürümler için, erişim katmanı açıkça ayarlandıysa List BlobsAccessTier öğesini döndürür. İ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 , Coolve ArchiveHot. Blob yeniden doldurma bekleme durumundaysa, geçerli değerlerden biriyle (rehydrate-pending-to-hot, rehydrate-pending-to-coolveya rehydrate-pending-to-cold) ArchiveStatus öğesi döndürülür. Blok blobu katmanlama hakkında ayrıntılı bilgi için bkz.Sık erişimli, seyrek erişimli ve arşiv depolama katmanları .

Sürüm 2017-04-17 ve üzeri için List Blobs, Blob Depolama veya genel amaçlı v2 hesaplarında AccessTierInferred öğesini döndürür. Blok blobunda erişim katmanı ayarlı değilse, katman bilgileri depolama hesabı özelliklerinden çıkarılır ve bu değer trueolarak ayarlanır. Bu üst bilgi yalnızca katmanın hesap özelliğinden çıkarılması durumunda bulunur.

Sürüm 2017-04-17 ve üzeri için List Blobs, Blob Depolama veya genel amaçlı v2 hesaplarında AccessTierChangeTime öğesini döndürür. 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 .

Sürüm 2017-07-29 ve üzeri için, bu işlem include={deleted} parametresini içerdiğinde Deleted, DeletedTimeve RemainingRetentionDays görüntülenir. Bu blob silinmediyse bu öğeler görünmez. Bu öğeler, geçici silme özelliği etkinleştirildiğinde DELETE işlemiyle silinen bloblar veya anlık görüntüler için görünür. Deleted öğesi, geçici olarak silinen bloblar ve anlık görüntüler için true olarak ayarlanır. Deleted-Time, blob'un silindiği zamana karşılık gelir. RemainingRetentionDays geçici olarak silinen blobun kalıcı olarak silindiği gün sayısını gösterir.

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

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

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

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

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

sürüm 2019-12-12 ve üzeri için List Blobs blobun geçerli sürümü için IsCurrentVersion öğesini döndürür. değeri trueolarak ayarlanır. Bu öğe, geçerli sürümü salt okunur, otomatik olarak oluşturulan sürümlerden ayırt etmenizi sağlar.

sürüm 2019-12-12 ve üzeri için List Blobs, herhangi bir etikete sahip bloblar için TagCount öğesini döndürür. Tags öğesi yalnızca bu işlem include={tags} parametresini 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 Sealed öğesini döndürür. Sealed öğesi yalnızca ekleme blobu mühürlendiğinde görünür. Ekleme blobu korumalı değilse bu öğeler görünmez.

sürüm 2020-02-10 ve üzeri için List BlobsLastAccessTime öğesini döndürür. öğ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 bilgi için bkz. Blob Hizmeti API'sini. LastAccessTime öğesi, blob meta verilerine en son ne zaman erişildiğinde izlemez.

Sürüm 2020-06-12 ve üzeri için, bu işlem include={immutabilitypolicy} parametresini içerdiğinde List BlobsImmutabilityPolicyUntilDate ve ImmutabilityPolicyMode öğelerini döndürür.

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

2020-06-12 ve üzeri sürümlerde, hiyerarşik ad alanı etkinleştirilmiş hesaplar için List BlobsOwner, Group, Permissionsve Acl öğelerini döndürür. İstek include={permissions} parametresini içermelidir. Acl öğesinin, dosya veya dizinde ayarlanmış birleştirilmiş erişim ve varsayılan erişim denetimi listeleri listesi olduğunu unutmayın.

Sürüm 2020-06-12 ve üzeri için, hiyerarşik ad alanı etkinleştirilmiş hesaplar için sınırlayıcı içeren List BlobsBlobPrefix öğesindeki Properties öğesini döndürür. Bu, dizindeki özelliklere karşılık gelir.

2020-08-04 ve üzeri sürümler için hiyerarşik ad alanı etkinleştirilmiş hesaplar için List Blobs silinen bloblar için DeletionId öğesini döndürür. DeletionId imzalanmamış, 64 bit 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 üzeri sürümler için, hiyerarşik ad alanı etkinleştirilmiş hesaplar için List Blobs yol için ResourceType özellik öğesini döndürür. Bu, file veya directoryolabilir.

Sürüm 2021-02-12 ve üzeri için, List Blobs tüm BlobName veya BlobPrefixName öğe değerlerini yüzde olarak kodlar (RFC 2396 başına). Ö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 yalnızca XML'de geçersiz karakterleri içeren Name öğesi değerleri için oluştuğuna dikkat edin, yanıttaki kalan Name öğeleri için değil.

2021-06-08 ve üzeri sürümlerde, hiyerarşik ad alanı etkinleştirilmiş hesaplar için List BlobsPlaceholder özellikleri öğesini döndürür. Sınırlayıcı ile silinen blobları listelerken yer tutucu dizinleri için BlobPrefix öğesinde 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 üzeri sürümler için hiyerarşik ad alanı etkinleştirilmiş hesaplar için List BlobsEncryptionContext öğesini döndürür. Şifreleme bağlamı özellik değeri ayarlanırsa, ayarlanan değeri döndürür.

2020-02-10 ve üzeri sürümlerde, hiyerarşik ad alanı etkinleştirilmiş hesaplar için List Blobs silinen bloblar için Expiry-Time öğesini döndürür. Expiry-Time, dosyanın süresinin dolacağı zamandır ve süre sonu aynı olduğunda 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 bkz. Blob kaynaklarını numaralandırma.

İ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:

include=tagsbelirtiyorsa:

  • Azure RBAC eylemini : Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/read
  • En az ayrıcalıklı yerleşik rol:Depolama Blob Veri Sahibi

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.

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

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

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

Content-MD5 öğesi, 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 Blob Özelliklerini Ayarlaçağırarak Content-MD5 özelliğini ayarlayabilirsiniz. 2012-02-12 ve sonraki sürümlerde Put Blob, Put Blob isteği bir MD5 üst bilgisi içermese bile blok blobunun MD5 değerini ayarlar.

Yanıttaki meta veriler

Metadata öğesi yalnızca URI'de include=metadata parametresi belirtilmişse bulunur. Metadata öğesinde, her 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ıC# tanımlayıcıları için adlandırma kurallarına uymalıdır.

Meta veri ad-değer çifti bu adlandırma kısıtlamalarını ihlal ederse, yanıt gövdesi x-ms-invalid-name öğesi 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

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

blob'da etiket yoksa Tags ve TagCount öğeleri döndürülemez.

Depolama hizmeti blob ile etiketleri arasında güçlü tutarlılık sağlar, ancak ikincil dizin sonunda tutarlı olur. Etiketler, Find Blobs by Tags işlemlerine görünmeden önce List Blobs yanıt olarak görülebilir.

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

Anlık görüntüler yanıtta yalnızca URI'de include=snapshots parametresi belirtilmişse listelenir. Anlık görüntülerin etkin kiraları olmadığından yanıtta listelenen anlık görüntüler LeaseStatus öğesini içermez.

Hizmet sürümü 2021-06-08 ve üzerini kullanarak, sınırlayıcıyla List Blobs çağırabilir 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

Kaydedilmemiş bloblar yanıtta yalnızca URI'de include=uncommittedblobs parametresi belirtilmişse 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 yanıtta yalnızca URI'de include=deleted parametresi belirtilmişse listelenir. Yanıtta listelenen silinmiş bloblar Kira öğelerini içermez, çünkü silinen blobların etkin kiraları olamaz.

URI'de include=deleted,snapshot belirtildiyse, silinen anlık görüntüler liste yanıtına eklenir.

Yanıttaki nesne çoğaltma meta verileri

OrMetadata öğesi, bir nesne çoğaltma ilkesi blob üzerinde değerlendirildiğinde ve List Blobs çağrısı sürüm 2019-12-12 veya üzeri kullanılarak yapıldığında bulunur. OrMetadata öğesinde, her 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ı üzerindeki 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

ImmutabilityPolicyUntilDate ve ImmutabilityPolicyMode öğeleri yalnızca URI'de include=immutabilitypolicy parametresi belirtilmişse bulunur.

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

LegalHold öğesi yalnızca URI'de include=legalhold parametresi belirtilmişse bulunur.

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

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

maxresults parametresi için bir değer belirtirseniz ve döndürülecek blob sayısı bu değeri aşıyorsa veya maxresultsiçin varsayılan değeri aşıyorsa, yanıt gövdesi bir NextMarker öğesi içerir. Bu öğe, sonraki bir istekte döndürülecek sonraki blobu gösterir. Bazı durumlarda, döndürülen sonuç sayısı maxresultsdeğerinden küçük olsa bile hizmet NextMarker öğesini döndürebilir.

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

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

delimiter parametresi, çağıranın kullanıcı tarafından yapılandırılmış bir sınırlayıcı kullanarak blob ad alanında dolaşması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 öğesi döndürür. BlobPrefix öğesi, sınırlayıcı karakterinin görünümüne kadar aynı alt dizeyle başlayan adlara sahip tüm blobların yerine döndürülür. BlobPrefix öğesinin değeri alt dize+sınırlayıcı' dir; burada alt dize bir veya daha fazla blob adı başlayan ortak alt dizedir ve sınırlayıcıdelimiter parametresinin değeridir.

Bu ön ek ile başlayan blobları listelemek üzere sonraki bir çağrı yapmak için BlobPrefix değerini kullanabilirsiniz. Bunu, istek URI'sinde prefix parametresi için BlobPrefix değerini 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.

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

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

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

  • CopyStatus failedolarak ayarlandığında, CopyStatusDescription metni kopyalama işleminin başarısız olmasına neden olan hatayı açıklar.

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. Azure tarafından <ErrorCode> öğesinde sağlanır. <ErrorCode> öğesi görüntülenmezse, hizmet HTTP belirtimindeki üç basamaklı HTTP durum koduyla ilişkili standart hata metni içeren bir anahtar sözcük döndürür. Daha fazla bilgi için bkz. Common 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. Hata 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. Hata 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, <ErrorCode> öğesinde ResourceNotFound döndürür. Yanıtta <ErrorCode> öğesi görüntülenmediyse, HTTP durumunun standart dize gösterimi (NotFoundgibi) 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.

Durumu ve hata kodları
blob depolama hata kodları