Blobları Listeleme

  • Makale

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

İstek

İsteği aşağıdaki gibi oluşturabilirsiniz List Blobs . 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ünülmüş depolama hizmeti URI'si

Öykünülmüş depolama hizmetine yönelik bir istekte bulunurken öykünücü konak adını ve Azure Blob Depolama bağlantı noktasını olarak 127.0.0.1:10000ve ardından öykünülen 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ştirmesi için Azurite öykünücüsü kullanma.

URI parametreleri

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

Parametre Açıklama
prefix İsteğe bağlı. 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 dosya adının göründüğü durumlarda hata oluşur. Örneğin, ön ek yolunu folder1/folder2/readme/readmefile.txtkullanarak adlı readmefile.txt blobları bulmaya çalışabilirsiniz. Herhangi bir alt klasörde adlı readmebir dosya varsa bir hata görüntülenir.
delimiter İsteğe bağlı. İ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ı karakterin 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 İsteğe bağlı. Listenin bir sonraki liste işlemiyle döndürülecek bölümünü tanımlayan bir 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. Bundan sonra sonraki bir çağrıda işaretleyici değerini kullanarak bir sonraki liste öğesi kümesini isteyebilirsiniz.

İşaretçi değeri istemci için opaktır.
maxresults İsteğe bağlı. Tüm BlobPrefix öğeler dahil olmak üzere döndürülecek en fazla blob sayısını belirtir. İstek belirtmezse maxresultsveya 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 NextMarker bir devamlılık 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.

Sıfırdan küçük veya sıfıra eşit bir değere ayarlanması maxresults hata yanıtı kodu 400(Hatalı İstek) ile sonuçlanır.
include={snapshots,metadata,uncommittedblobs,copy,deleted,tags,versions,
deletedwithversions,immutabilitypolicy,legalhold,permissions}		 İsteğe bağlı. 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 kadar listelenir.
- metadata: Yanıtta blob meta verilerinin döndürüldüğünü belirtir.
- uncommittedblobs: Blokların karşıya yüklendiği ancak Blok Listesini Koy kullanılarak işlenmemiş blobların yanıta dahil edildiğini belirtir.
- copy: Sürüm 2012-02-12 ve üzeri. Herhangi bir geçerli veya önceki Copy Blob işlemle 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 (etkin veya silinmiş) sahip silinmiş blobların 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 saklaması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ülle ("%82") ayırmanız gerekir.
showonly={deleted,files,directories} İsteğe bağlı. Yanıtta döndürülecek şu veri kümelerinden birini belirtir:

-deleted:Isteğe bağlı. Sürüm 2020-08-04 ve üzeri. Yalnızca hiyerarşik ad alanıyla etkinleştirilen hesaplar için. bir istek bu parametreyi içerdiğinde, listede yalnızca geçici olarak silinen bloblar bulunur. POSIX ACL yetkilendirme geri dönüşünü 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:Isteğe bağlı. Sürüm 2020-12-06 ve üzeri. Yalnızca hiyerarşik ad alanıyla etkinleştirilen hesaplar için. bir istek bu parametreyi içerdiğinde, liste yalnızca dosyaları içerir.
-directories:Isteğe bağlı. Sürüm 2020-12-06 ve üzeri. Yalnızca hiyerarşik ad alanıyla etkinleştirilen hesaplar için. bir istek bu parametreyi içerdiğinde, liste yalnızca dizinleri içerir.
timeout İsteğe bağlı. 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 Açıklama
Authorization Gereklidir. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. Azure Depolama'ya istekleri yetkilendirme.
Date veya x-ms-date Gereklidir. İstek için Eşgüdümlü Evrensel Saat (UTC) biçimini belirtir. Daha fazla bilgi için bkz. Azure Depolama'ya 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 İsteğe bağlı. Günlüğe kaydetme yapılandırıldığında günlüklere kaydedilen 1 kibibaytlık (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. İzleme Azure Blob Depolama.
x-ms-upn İsteğe bağlı. Yalnızca hesap için hiyerarşik ad alanı etkinleştirildiğinde ve include=permissions istekte sağlandığında geçerlidir. isetrue, 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. isefalse, değerler Microsoft Entra nesne kimlikleri olarak döndürülür. false varsayılan değerdir. Grup ve uygulama nesne kimliklerinin benzersiz kolay adları olmadığından çevrildiğini unutmayın.

İstek gövdesi

Yok.

Örnek istek

Örnek istek için bkz. Blob kaynaklarını listeleme .

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 (Tamam) durum kodunu döndürür. 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 Description
Content-Type Sonuçların döndürüldiği biçimi belirtir. Şu anda bu değer şeklindedir 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 üst bilginin değerine x-ms-client-request-id eşittir. Değer en fazla 1024 görünür ASCII karakterdir. x-ms-client-request-id Üst bilgi istekte yoksa, yanıtta bu üst bilgi bulunmaz.

Yanıt gövdesi

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

, Marker, MaxResultsve Delimiter öğelerinin Prefixyalnızca istek URI'sinde belirtilmiş olmaları durumunda mevcut olduğunu unutmayın. öğesinin NextMarker yalnızca liste sonuçları tamamlanmazsa bir değeri vardır.

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

2009-09-19 ve sonraki sürümlerde blob'un ö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 (önceki LastModified)

  • Content-Length (önceki Size)

  • Content-Type (önceki ContentType)

  • Content-Encoding (önceki ContentEncoding)

  • Content-Language (önceki 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 Content-MD5 Blob Depolama, Blobu Koy'ı kullanarak bir blobu karşıya yüklediğinizde değeri hesaplar. Blok Listesini Koy'u kullanarak blob oluşturduğunuzda Blob Depolama bunu hesaplamaz. Blobu oluştururken veya Blok Listesini Koy veya Blob Özelliklerini Ayarla işlemlerini çağırarak değeri açıkça ayarlayabilirsinizContent-MD5.

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 çağrı List Blobs yapamazsı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 2012-02-12 ve sonraki sürümlerde, bu işlem parametresini içerdiğinde include={copy} görünür. Bu blob hiçbir zaman bir Copy Blob işlemde hedef olmadıysa bu öğeler görünmez. Bu blob sonlandırılan bir Copy Blob işlemden sonra , veya Put Block Listkullanılarak Set Blob PropertiesPut Blobdeğiştirildiğinde öğeler görünmez. Bu öğeler, 2012-02-12 sürümünden önce Blobu Kopyala tarafından oluşturulan bir blobla da görünmez.

2013-08-15 ve sonraki sürümlerde öğesi blob EnumerationResults uç noktasını belirten bir ServiceEndpoint öznitelik 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 alanda ContainerName birlikte birleştirildi. Ayrıca 2013-08-15 ve sonraki sürümlerde Url altındaki Blob öğesi kaldırılmıştır.

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.

Sürüm 2015-12-11 ve üzeri List Blobs için ServerEncrypted öğesini döndürür. Bu öğe, blob ve uygulama meta verilerinin tamamen şifrelenip şifrelenmediği ve false aksi takdirde olarak ayarlanırtrue.

Sürüm 2016-05-31 ve üzeri için, List Blobs artımlı kopyalama blobları ve anlık görüntüleri için öğesini döndürür IncrementalCopy ve değer olarak ayarlanır true.

2017-04-17 ve sonraki sürümler için, List Blobs bir erişim katmanı açıkça ayarlandıysa öğesini döndürür AccessTier . İzin verilen premium sayfa blobu 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 ArchivedeğerleridirHot. Blob yeniden doldurma bekleme durumundaysa, ArchiveStatus öğe geçerli değerlerden biriyle (rehydrate-pending-to-hot, rehydrate-pending-to-coolveya rehydrate-pending-to-cold) 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 Blob List Blobs Depolama veya genel amaçlı v2 hesaplarında öğesini döndürür AccessTierInferred . Blok blobunda erişim katmanı ayarlı değilse, 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.

Sürüm 2017-04-17 ve üzeri için Blob List Blobs Depolama veya genel amaçlı v2 hesaplarında öğesini 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 üzeri Deletedsürümler için , DeletedTimeve RemainingRetentionDays bu işlem parametresini içerdiğinde include={deleted} görüntülenir. Bu blob silinmediyse bu öğeler görünmez. Bu öğeler, geçici silme özelliği etkinleştirildiğinde işlemle birlikte DELETE 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 olarak ayarlanırtrue. 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.

Sürüm 2017-11-09 ve üzeri 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 List Blobs müşteri tarafından sağlanan bir anahtarla şifrelenirse öğesini 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 blobda 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ülemez meta veriler 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.

2019-02-02 ve sonraki sürümler için blob List Blobs bir şifreleme kapsamıyla şifrelenirse öğesini 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 öğesinde Metadata kullanılabilir.

Sürüm 2019-12-12 ve üzeri için, List Blobs nesne durumundaysa Blob Depolama veya genel amaçlı v2 hesaplarındaki rehydrate pending öğesini döndürürRehydratePriority. Geçerli değerler ve StandarddeğerleridirHigh.

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 öğesini döndürür VersionId .

Sürüm 2019-12-12 ve üzeri için blobun List BlobsIsCurrentVersion geçerli sürümü için öğesini döndürür. 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.

Sürüm 2019-12-12 ve üzeri için, List Blobs herhangi bir etikete sahip bloblar için öğesini döndürür TagCount . Tags öğesi yalnızca bu işlem parametresini içerdiğinde include={tags} görünür. Blobda etiket yoksa bu öğeler görünmez.

Sürüm 2019-12-12 ve üzeri için ekleme List Blobs blobları için öğesini döndürür Sealed . Sealed öğe 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 List Blobs için LastAccessTime öğ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ılırsa öğesi döndürülemez. Hesabın son erişim zamanı izleme ilkesini ayarlama hakkında bilgi için bkz. Blob Hizmeti API'si. LastAccessTime öğesi blob meta verilerine en son ne zaman erişildiğinde izlemez.

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

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

2020-06-12 ve sonraki sürümlerde hiyerarşik ad alanı etkinleştirilmiş List Blobs hesaplar için , Group, Permissionsve Acl öğelerini döndürürOwner. İstek parametresini include={permissions} içermelidir. öğesinin Acl , dosya veya dizinde ayarlanmış birleştirilmiş erişim ve varsayılan erişim denetim 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ı List Blobs öğedeki BlobPrefix öğesini döndürürProperties. Bu, dizindeki özelliklere karşılık gelir.

2020-08-04 ve sonraki sürümlerde hiyerarşik ad alanı etkinleştirilmiş hesaplar için silinen List Blobs bloblar için öğesini döndürür DeletionId . 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ümlerde hiyerarşik ad alanı etkinleştirilmiş List Blobs hesaplar için yol için özellik öğesini döndürür ResourceType . Bu veya filedirectoryolabilir.

Sürüm 2021-02-12 ve üzeri için, List Blobs tüm BlobName veya BlobPrefixName öğe değerlerini yüzde-kodlar (RFC 2396 başına). Özellikle, XML (U+FFFE veya U+FFFF) içinde geçerli olmayan karakterler içeren değerler için bunu yapar. Kodlandıysa, Name öğesi bir Encoded=true öznitelik içerir. Bunun yalnızca XML'de Name geçersiz karakterleri içeren öğe değerleri için oluştuğuna dikkat edin, yanıttaki kalan Name öğeler için değil.

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

2021-06-08 ve üzeri sürümlerde hiyerarşik ad alanı etkinleştirilmiş List Blobs hesaplar için öğesini döndürür EncryptionContext . Ş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 silinen List Blobs bloblar için öğesini döndürür Expiry-Time . 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ı listeleme .

Yetkilendirme

Azure Depolama'da herhangi bir veri erişimi işlemi çağrılırken yetkilendirme gereklidir. İşlemi aşağıda açıklandığı gibi yetki List Blobs verebilirsiniz.

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 güvenlik sorumlusuna izinler verilmektedir. Güvenlik sorumlusu bir kullanıcı, grup, uygulama hizmet sorumlusu veya Azure yönetilen kimliği olabilir. Güvenlik sorumlusunun kimliği, OAuth 2.0 belirtecini döndürmek için Microsoft Entra ID tarafından doğrulanır. Belirteç daha sonra 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, Microsoft Entra kullanıcı, grup veya hizmet sorumlusunun işlemi çağırması List Blobs için gereken RBAC eylemi ve bu eylemi içeren en az ayrıcalıklı yerleşik Azure RBAC rolü verilmiştir:

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, öğesinde Content-Length döndürülen değer blobun x-ms-blob-content-length üst bilgisinin değerine karşılık gelir.

Content-MD5 Öğe yanıt gövdesinde görünür, ancak blobda 2009-09-19 veya sonraki bir sürüm kullanılarak ayarlanmışsa. Blob oluşturulduğunda veya Blob Özelliklerini Ayarla'yı çağırarak özelliğini ayarlayabilirsinizContent-MD5. 2012-02-12 ve sonraki sürümlerde, Put Blob istek bir MD5 üst bilgisi içermese bile blok blobunun Put Blob MD5 değerini ayarlar.

Yanıttaki meta veriler

Metadata öğesi yalnızca parametre URI'de belirtilmişse include=metadata bulunur. öğesinde Metadata , 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 öğenin x-ms-invalid-name 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 include=tags parametre URI'de belirtilmişse ve blobda etiketler varsa bulunur. öğesi içindeTagSet, her biri kullanıcı tanımlı blob dizini etiketlerini ve value içeren key en fazla 10 Tag öğe döndürülür. Yanıtta etiketlerin sıralanması garanti değildir.

Blobda Tags etiket yoksa 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, işlemlere List Blobs görünmeden önce yanıt olarak görülebilir Find Blobs by Tags .

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

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

Hizmet sürümü 2021-06-08 ve üzerini kullanarak bir sınırlayıcı ile çağrı List Blobs yapabilir 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 parametre URI'de belirtilmişse include=uncommittedblobs 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 silinen bloblar Kira öğelerini içermez, çünkü silinen blobların etkin kiraları olamaz.

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

Yanıttaki nesne çoğaltma meta verileri

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

  
…  
<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 parametre URI'de belirtilmişse include=immutabilitypolicy bulunur.

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

LegalHold öğesi 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

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

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

Blob ad alanında gezinmek için sınırlayıcı kullanma

parametresi, delimiter ç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, bir dosya sistemiymiş gibi sanal bir blob hiyerarşisinde geçiş yapabilirsiniz. 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 Öğe, 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. öğesinin BlobPrefix değeri substring+sınırlayıcıdır; burada alt dize bir veya daha fazla blob adıyla başlayan ortak alt dizedir ve sınırlayıcı parametrenin delimiter değeridir.

bu ön ek ile başlayan blobları listelemek üzere sonraki bir çağrı yapmak için değerini BlobPrefix kullanabilirsiniz. Bunu, istek URI'sinde parametresi için prefix değerini BlobPrefix belirterek yaparsınız.

Döndürülen her BlobPrefix öğenin, her Blob öğenin yaptığı gibi en yüksek sonuda doğru saydığını unutmayın.

Bloblar yanıt gövdesinde alfabetik sırada listelenir ve ilk olarak büyük harfler listelenir.

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 denemeye devam ediyorsa olarak ayarlanır pending . Metinde CopyStatusDescription , son kopyalama girişimi sırasında oluşmuş olabilecek hata açıklanır.

  • CopyStatus olarak ayarlandığındafailedCopyStatusDescription, metin 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.

Bileşen Açıklama
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. Hiçbir <ErrorCode> öğesi görüntülenmezse, 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 tırnak içinde ayrıntılı açıklaması.

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

Önemli

Burada gösterilen açıklama metni, sürüm değişikliği olmasa 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ılı empty
Kullanıcı kopyalama işlemini tamamlanmadan önce iptal etti. Iptal empty
Kopyalama işlemi sırasında kaynak blobdan okunurken bir hata oluştu. İşlem yeniden denenecek. bekleniyor 502 BadGateway "Kaynak okunurken yeniden denenebilir bir hatayla karşılaşıldı. Yeniden denenecek. Hata zamanı: <saat>"
Kopyalama işleminin hedef blob'unu yazarken hata oluştu. İşlem yeniden denenecek. bekleniyor 500 InternalServerError "Yeniden denenebilir bir hatayla karşılaşıldı. Yeniden denenecek. Hata zamanı: <saat>"
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 <döndürürResourceNotFound. Yanıtta hiçbir <ErrorCode> öğesi görünmediyse, HTTP durumunun standart dize gösterimi ( gibi NotFound) 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 okurken kopyalama işlemi çok sık başarısız oldu ve başarıya yönelik girişimlerin en düşük oranını karşılamadı. (Bu zaman aşımı, başarısız olmadan önce iki hafta içinde çok kötü bir kaynağın yeniden denenmesini önler). başarısız 500 OperationCancelled "Kaynak okunurken kopya başarısız oldu."

Faturalama

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 nasıl ücretlendirildiğinden etkilenir. Ö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 istekler için List Blobs 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. fiyatlandırma Azure Blob Depolama.

Ayrıca bkz.

Durum ve hata kodları
Blob Depolama hata kodları