Blobları Listeleme

  • Makale
  • Okumak için 17 dakika

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

İstek

İstek List Blobs aşağıdaki gibi oluşturulabilir. 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ünülen depolama hizmetine yönelik istekte bulunulduğunda öykünücü konak adını ve Blob hizmeti bağlantı noktasını olarak 127.0.0.1:10000belirtin ve 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. Geliştirme ve Test için Azure Depolama Emulator kullanma.

URI Parametreleri

URI'de aşağıdaki ek parametreler belirtilebilir.

Parametre Açıklama
prefix İsteğe bağlı. Sonuçları yalnızca adları belirtilen ön ek ile başlayan blobları döndürecek şekilde filtreler.
delimiter İsteğe bağlı. İstek bu parametreyi içerdiğinde, işlem yanıt gövdesinde adları sınırlayıcı karakterin görünümüne kadar aynı alt dizeyle başlayan tüm bloblar için yer tutucu işlevi gören bir öğe döndürür BlobPrefix . 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 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 işaretçi değeri sonraki liste öğeleri kümesini istemek için sonraki bir çağrıda kullanılabilir.

İş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 5.000'den büyük bir değer belirtmezse maxresults veya belirtmezse, 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 maxresults belirtilenden 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şlenmeyen blobların yanıta eklendiğini belirtir.
- copy: Sürüm 2012-02-12 ve daha yeni. Geçerli veya önceki Copy Blob herhangi bir işlemle ilgili meta verilerin yanıta eklenmesi gerektiğini belirtir.
-deleted: Sürüm 2017-07-29 ve daha yeni. Geçici olarak silinen blobların yanıta eklenmesi gerektiğini belirtir.
-tags: Sürüm 2019-12-12 ve daha yeni. Yanıta kullanıcı tanımlı Blob Dizini etiketlerinin eklenmesi gerektiğini belirtir.
-versions: Sürüm 2019-12-12 ve daha yeni. Blob sürümlerinin numaralandırmaya eklenmesi gerektiğini belirtir.
-deletedwithversions: Sürüm 2020-10-02 ve daha yeni. Herhangi bir sürüme sahip silinen blobların (etkin veya silinmiş) yanıta bir etiket <HasVersionsOnly> ve true değeriyle eklenmesi gerektiğini belirtir.
-immutabilitypolicy: Sürüm 2020-06-12 ve daha yeni. Blobların tarihe kadar değişmezlik ilkesinin ve değişmezlik ilkesi modunun numaralandırmaya dahil edilmesi gerektiğini belirtir.
-legalhold: Sürüm 2020-06-12 ve daha yeni. Blobların yasal ayrı tutmasının numaralandırmaya dahil edilmesi gerektiğini belirtir.
-permissions: Sürüm 2020-06-12 ve daha yeni. 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, İzinler ve Access Control 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: İsteğe bağlı. Sürüm 2020-08-04 ve daha yeni. Yalnızca Hiyerarşik Ad Alanı etkinleştirilmiş hesaplar için. bir istek bu parametreyi içerdiğinde, liste yalnızca geçici olarak silinen blobları içerir. 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 daha yeni. Yalnızca Hiyerarşik Ad Alanı 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 daha yeni. Yalnızca Hiyerarşik Ad Alanı etkinleştirilmiş 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 Hizmeti İş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 Başlığı Description
Authorization Gereklidir. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. Azure Depolama 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 istekleri yetkilendirme.
x-ms-version Anonim istekler için isteğe bağlı olarak tüm yetkili istekler için gereklidir. 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ı. Depolama analizi günlüğü etkinleştirildiğinde analiz günlüklerine kaydedilen 1 KiB karakter sınırına sahip istemci tarafından oluşturulan, opak bir değer sağlar. İstemci tarafı etkinlikleriyle sunucu tarafından alınan istekler arasında bağıntı sağlamak için bu üst bilginin kullanılması kesinlikle önerilir. Daha fazla bilgi için bkz. Depolama Analizi Günlüğü ve Azure Günlüğü Hakkında: Depolama İsteklerini İzlemek için Günlükleri Kullanma.
x-ms-upn İsteğe bağlı. Yalnızca hesap için hiyerarşik ad alanı etkinleştirildiğinde ve istekte include=permissions sağlandığında geçerlidir. True ise, , <Group>ve <Acl> alanlarında döndürülen <Owner>kullanıcı kimliği değerleri Azure Active Directory nesne kimliklerinden kullanıcı asıl adlarına dönüştürülür. False ise, değerler Azure Active Directory nesne kimlikleri olarak döndürülür. Varsayılan değer false şeklindedir. Grup ve uygulama nesne kimliklerinin benzersiz kolay adları olmadığından çevrilmediğini unutmayın.

İstek Gövdesi

Yok.

Örnek İstek

Ö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 İşlemleri Sorunlarını Giderme.
x-ms-version İsteği yürütmek için kullanılan Blob hizmetinin sürümünü gösterir. Bu üst bilgi, 2009-09-19 ve daha yeni bir sürüm kullanılarak yapılan istekler için döndürülür.

Bu üst bilgi, kapsayıcı Blob hizmetinin 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 Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren utc tarih/saat değeri.
x-ms-client-request-id Bu üst bilgi, istekler ve karşılık gelen yanıtlarla ilgili sorunları gidermek için kullanılabilir. Bu üst bilginin değeri, istekte varsa ve değer en fazla 1024 görünür ASCII karakteriyse üst bilginin değerine x-ms-client-request-id eşittir. İstekte x-ms-client-request-id üst bilgi yoksa, bu üst bilgi yanıtta mevcut olmaz.

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.

Sürüm 2009-09-19 ve daha yeni 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, 2009-09-19 ve daha yeni sürümlerle oluşturulan bloblar için görünür. 2012-02-12 ve daha yeni sürümlerde Content-MD5 Blob hizmeti, Blob Koy'u kullanarak bir blob yüklediğinizde değeri hesaplar, ancak Blok Listesi Koy'u kullanarak blob oluşturduğunuzda 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 daha yeni sürümler için ancak sürüm 2015-02-21'den önce, listeleme sonucunda ekleme blobu varsa ekleme blobu içeren bir kapsayıcıda çağrı List Blobs 409 (FeatureVersionMismatch) durum koduyla başarısız olur.

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 bir işlemde Copy Blob hiç hedef olmadıysa veya bu blob , Put Blobveya Put Block Listkullanılarak Set Blob Propertiessonlandırılan Copy Blob bir işlemden sonra değiştirildiyse bu öğeler görünmez. Bu öğeler, Blobu Kopyala tarafından 2012-02-12 sürümünden önce oluşturulmuş bir blobla da görünmez.

Sürüm 2013-08-15 ve daha yeni sürümlerde, EnumerationResults öğesi blob uç noktasını belirten bir ServiceEndpoint öznitelik ve kapsayıcının adını belirten bir ContainerName alan içerir. Önceki sürümlerde bu iki öznitelik alanda birlikte ContainerName birleştirildi. Ayrıca sürüm 2013-08-15 ve daha yeni sürümlerde Url altındaki Blob öğ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.

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 değerinin olarak ayarlandığı trueöğesini döndürürIncrementalCopy.

2017-04-17 ve üzeri 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 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 şunlardır: Hot``Archive/Cool/. Blob yeniden doldurma bekleme durumundaysa ArchiveStatus öğesi geçerli değerlerden rehydrate-pending-to-hot/rehydrate-pending-to-coolbiriyle 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ürAccessTierInferred. Blok blobunda erişim katmanı ayarlanmadıysa depolama hesabı özelliklerinden katman çıkarıyoruz ve bu değer olarak trueayarlanır. Bu üst bilgi yalnızca katmanın hesap özelliğinden çıkarılmış olması durumunda bulunur. 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ürAccessTierChangeTime. Bu yalnızca blok blobu katmanı ayarlanmışsa döndürülür. Tarih biçimi RFC 1123'e göredir. Daha fazla bilgi için bkz. Üst Bilgilerde Date-Time Değerlerinin Gösterimi. Blok blobu katmanlama hakkında ayrıntılı bilgi için bkz . Sık erişimli, seyrek erişimli ve arşiv depolama katmanları.

2017-07-29 ve üzeri Deleted``DeletedTime sürümler için ve 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 silinen DELETE blob veya anlık görüntü 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 silinen blobun blob hizmeti tarafından kalıcı olarak silineceği gün sayısını gösterir.

Sürüm 2017-11-09 ve üzeri için bu Creation-Time blob'un oluşturulduğu zamanı döndürür.

2019-02-02 ve üzeri 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 blobun işlemin bir parçası List Blobs olarak şifresi çözülemeyen meta verileri olduğunu belirten bir Encrypted="true" özniteliği olur. 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 üzeri sürümler için blob List Blobs bir şifreleme kapsamıyla şifrelenmişse öğ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 blob Depolama veya nesne yeniden doldurma bekleme durumundaysa v2 hesapları Genel Amaçlı öğesini döndürürRehydratePriority. Geçerli değerler şunlardır: High/Standard. 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 2019-12-12 ve üzeri için, List Blobs hesapta VersionId Sürüm Oluşturma etkinleştirildiğinde bloblar ve oluşturulan blob sürümleri için öğesini döndürür.

Sürüm 2019-12-12 ve üzeri için blobun List Blobs geçerli sürümü için değerinin olarak ayarlandığı trueöğesini döndürerek IsCurrentVersion otomatik olarak oluşturulan salt okunur sürümlerden ayırt eder.

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ı öğesini döndürür Sealed . Sealed Öğe yalnızca Ekleme blobu mühürlendiğinde görünür. Ekleme Blobu mühürlenmediyse bu öğeler görünmez.

Sürüm 2020-02-10 ve üzeri List Blobs için LastAccessTime öğesini döndürür. Öğeler, 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ının son erişim zamanı izleme ilkesi yoksa veya ilke devre dışı bırakılırsa öğesi döndürülmeyecektir. Hesabın son erişim zamanı izleme ilkesini ayarlama hakkında bilgi için bkz. Blob Hizmeti API'si. LastAccessTime öğesi blob'un meta verilerine en son ne zaman erişildiğini izlemez.

2020-06-12 ve üzeri 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 içerdiğinde include={legalhold} öğesini döndürürLegalHold.

2020-06-12 ve üzeri sürümler için hiyerarşik ad alanı etkinleştirilmiş hesaplar için, List Blobs istek parametre içerdiğinde include={permissions} , Group``Permissions ve Acl öğesini döndürürOwner. öğesinin Acl , dosyada/dizinde ayarlanan Access ve Varsayılan Acl'lerin birleştirilmiş listesi olacağını 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, öğesinde dizindeki BlobPrefix Özellikler'e karşılık gelen öğesini döndürürProperties.

2020-08-04 ve üzeri sürümler için Hiyerarşik Ad Alanı özellikli hesaplar için silinen List Blobs bloblar için öğesini döndürür DeletionId . DeletionId , aynı yola sahip diğer silinmiş bloblardan ayırmak için geçici olarak silinmiş bir yolu benzersiz olarak tanımlayan imzasız bir 64 bit tanımlayıcıdır.

2020-10-02 ve üzeri sürümler için Hiyerarşik Ad Alanı özellikli hesaplar için yol List Blobs için özellik öğesini döndürür ResourceType ve bu öğelerden biri file/directoryolabilir.

Sürüm 2021-02-12 ve üzeri için, List Blobs XML'de geçersiz karakterler içeren tüm Name Blob veya öğe değerlerini (özellikle U+FFFE veya BlobPrefix Name U+FFFF) yüzde kodlar (RFC 2396 başına). Kodlandıysa, Name öğesi bir Encoded=true öznitelik içerir. Bunun yanıttaki Name kalan Name öğeler için değil yalnızca XML'de geçersiz karakterleri içeren öğe değerleri için gerçekleşeceğini unutmayın.

2021-06-08 ve üzeri sürümler için Hiyerarşik Ad Alanı özellikli hesaplar için, List Blobs sınırlayıcı ile silinen blobları listelerken yer tutucu dizinleri öğesindeki BlobPrefix properties öğesini döndürürPlaceholder. Bu yer tutucu dizinler yalnızca geçici olarak silinen bloblara gitmenize yardımcı olmak için bulunur.

2020-02-10 ve üzeri sürümlerde Hiyerarşik Ad Alanı özellikli hesaplar için silinen List Blobs bloblar için öğesini döndürür Expiry-Time . Expiry-Time , dosyanın süresinin dolacağı ve süre sonu aynı olduğunda dosya için döndürüleceği zamandı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>
        <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

Kapsayıcının erişim denetim listesi (ACL) kapsayıcıya anonim erişime izin verecek şekilde ayarlandıysa, herhangi bir istemci bu işlemi çağırabilir. Aksi takdirde, bu işlem hesap sahibi ve kapsayıcıdaki blobları listeleme izni olan Paylaşılan Erişim İmzası olan herkes tarafından çağrılabilir.

Açıklamalar

Yanıttaki Blob Özellikleri

Kaydedilmemiş blobların numaralandırmaya eklenmesini istediyseniz, blob işlenene kadar bazı özelliklerin ayarlanmadığını, bu nedenle yanıtta bazı özelliklerin döndürülmeyebileceğini unutmayın.

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 yalnızca 2009-09-19 veya sonraki bir sürüm kullanılarak blobda ayarlanmışsa görünür. Blob oluşturulduğunda veya Blob Özelliklerini Ayarla'yı çağırarak özelliğini ayarlayabilirsinizContent-MD5. Sürüm 2012-02-12 ve daha yeni sürümlerde, Put Blob istekte MD5 üst bilgisi olmasa bile blok blobunun Put Blob MD5 değerini ayarlar.

Yanıttaki Meta Veriler

Metadata öğesi yalnızca parametresi 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 hizmetinin 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 2009-09-19 sürümü tarafından uygulanan adlandırma kısıtlamalarını ihlal ederse, yanıt gövdesi aşağıdaki XML parçasında gösterildiği gibi bir x-ms-invalid-name öğe içindeki sorunlu adı 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 parametresi 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ülmüyor.

Depolama hizmeti blob ile etiketleri arasında güçlü tutarlılık sağlar, ancak ikincil dizin sonunda tutarlı olur. Etiketler, Blobları Etiketlere Göre Bul işlemlerine görünmeden önce Liste Bloblarına yanıt olarak görünebilir.

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ı olamayacağından LeaseStatus yanıtta listelenen anlık görüntüler öğesini içermez.

Sınırlayıcı ile çağırırsanız List Blobs , numaralandırmaya anlık görüntüler de ekleyemezsiniz. Her ikisini de içeren bir istek InvalidQueryParameter hatası döndürür (HTTP durum kodu 400 – Hatalı İstek).

Yanıttaki Kaydedilmemiş Bloblar

Kaydedilmemiş bloblar yanıtta yalnızca parametresi 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 yanıtta yalnızca parametresi URI'de belirtilmişse include=deleted listelenir. Yanıtta listelenen silinen bloblar Kira öğelerini içermez, silinen bloblar etkin kiralara sahip 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 Nesne Çoğaltma ilkesi bir blob üzerinde değerlendirildiğinde ve Blobları Listele çağrısı 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 biçimi, or-{policy-id}_{rule-id}``{policy-id} burada depolama hesabındaki nesne çoğaltma ilkesi tanımlayıcısını temsil eden bir guid ve {rule-id} depolama kapsayıcısı üzerindeki kural tanımlayıcısını temsil eden bir guid'dir. Geçerli değerler şunlardır: complete/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 İlkesi

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

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

Yanıtta Yasal Tutma

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

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

İşaretçi Değeri Kullanarak Sonuç Kümeleri Döndürme

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

Sonraki öğe kümesini döndürmek için değerini sonraki istek için URI'de işaretçi parametresi olarak belirtin NextMarker . değerinin NextMarker opak olarak kabul edilmesi 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, sanal bir blob hiyerarşisinde bir dosya sistemiymiş gibi geçiş yapabilirsiniz. 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. BlobPrefix öğesi, adları sınırlayıcı karakterin görünümüne kadar aynı alt dizeyle başlayan 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ını başlayan ortak alt dizedir ve sınırlayıcı sınırlayıcı parametresinin değeridir.

değerini kullanarak BlobPrefix , istek URI'sinde parametresinin değerini BlobPrefix belirterek bu ön ekle başlayan blobları listelemek üzere prefix sonraki bir çağrı yapabilirsiniz.

Döndürülen her öğenin, her BlobPrefix Blob öğenin yaptığı gibi en yüksek sonuç için de sayı olduğunu unutmayın.

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

CopyStatusDescription'daki kopyalama hataları

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

  • Kopyalama girişimi başarısız olduğunda ve Blob hizmeti işlemi yeniden denediğinde, CopyStatus olarak ayarlanır pendingve CopyStatusDescription metinde son kopyalama girişimi sırasında oluşmuş olabilecek hata açıklanır.

  • CopyStatus olarak ayarlandığındafailed``CopyStatusDescription, metin kopyalama işleminin başarısız olmasına neden olan hatayı açıklar.

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

Bileşen Açıklama
HTTP durum kodu Hatayı belirten standart 3 basamaklı tamsayı.
Hata kodu <ErrorCode> öğesinde Azure tarafından sağlanan hatayı açıklayan anahtar sözcük. <ErrorCode> öğesi görüntülenmezse, HTTP belirtimindeki 3 basamaklı HTTP durum koduyla ilişkili standart hata metnini içeren bir anahtar sözcük kullanılır. Bkz. Yaygın 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 ve CopyStatusDescription değerleri açıklanmaktadırCopyStatus.

Önemli

Burada gösterilen açıklama metni, sürüm değişikliği olmasa bile uyarı olmadan değişebilir, bu nedenle bu tam metinle eşleşmeye güvenmeyin.

Senaryo CopyStatus değeri CopyStatusDescription değeri
Kopyalama işlemi başarıyla tamamlandı. başarılı empty
Kullanıcı tamamlanmadan önce kopyalama işlemini iptal etti. Iptal empty
Kopyalama işlemi sırasında kaynak blobdan okunurken bir hata oluştu, ancak iş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 bir hata oluştu, ancak iş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." Not: Bu temel hatayı bildirirken Azure, <ErrorCode> öğesinde döndürürResourceNotFound. Yanıtta <ErrorCode> öğesi görünmediyse, HTTP durumunun gibi NotFound 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 2 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 2 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."

Ayrıca bkz.

Durum ve Hata Kodları
Blob Hizmeti Hata Kodları