Blobları Listele

List Blobsişlemi, belirtilen kapsayıcı altındaki blobların listesini döndürür.

İstek

İstek List Blobs aşağıdaki gibi oluşturulmuş olabilir. HTTPS önerilir. myaccount yerine depolama hesabınız adını yazın:

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ülen depolama hizmeti URI'si

Öykünülen depolama hizmetine istekte bulunuyorsanız öykünücü konak adını ve Blob hizmeti bağlantı noktasını olarak belirtin ve ardından 127.0.0.1:10000 öykünücü depolama hesabı adını girin:

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. Azure Depolama Emulator Geliştirme ve Test için 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 ekle başlayan blobları iade etmek için filtreler.
delimiter İsteğe bağlı. İstek bu parametreyi içerirken, işlem yanıt gövdesinde adları sınırlayıcı karakterinin görünümüne kadar aynı alt dizeyle başlayan tüm bloblar için yer tutucu işlevi de içeren BlobPrefix bir öğe döndürür. Sınırlayıcı tek bir karakter veya dize olabilir.
marker İsteğe bağlı. Bir sonraki liste işlemiyle döndürülen listenin bölümünü tanımlayan dize değeri. Döndürülen liste tamamlanmadı ise işlem yanıt gövdesi içinde bir işaretçi değeri döndürür. İşaretçi değeri daha sonra bir sonraki liste öğeleri kümesi isteğinde kullanılacaktır.

İşaretçi değeri istemci için opaktır.
maxresults İsteğe bağlı. Tüm öğeler de dahil olmak üzere, en fazla getirili blob sayısını BlobPrefix belirtir. İstek 5.000'den büyük bir değer belirtmezseniz veya belirtmezseniz sunucu en fazla maxresults 5.000 öğe geri döner.

Sıfırdan maxresults küçük veya sıfıra eşit bir değere ayarlanıyorsa 400 (Hatalı İstek) hata yanıtı koduyla sonuçlanıyor.
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ümesi belirtir:

- snapshots: Anlık görüntülerin numaralandırma dahil edileceklerini belirtir. Anlık görüntüler yanıtta en eskiden en yeniye listelenir.
- metadata: Yanıtta blob meta verileri döndürül olacağını belirtir.
- uncommittedblobs: Hangi blokların karşıya yüklenmiş olduğu, ancak Blok Listesi Koy kullanılarak işlenmiş olan blobların yanıta dahil olacağını belirtir.
- copy: Sürüm 2012-02-12 ve daha yenisi. Herhangi bir geçerli veya önceki işlemle ilgili meta Copy Blob verilerin yanıta dahil olması gerektiğini belirtir.
-deleted: Sürüm 2017-07-29 ve daha yenisi. Yanıta yazılımla silinen blobların dahil olması gerektiğini belirtir.
-tags: Sürüm 2019-12-12 ve daha yenisi. Kullanıcı tanımlı Blob Dizini etiketlerinin yanıta dahil olması gerektiğini belirtir.
-versions: Sürüm 2019-12-12 ve daha yenisi. Blob sürümlerinin numaralandırma dahil edileceklerini belirtir.
-deletedwithversions: Sürüm 2020-10-02 ve daha yenisi. Herhangi bir sürüme (etkin veya silinmiş) sahip silinmiş blobların yanıta bir etiket ve true değeriyle <HasVersionsOnly> dahil olması gerektiğini belirtir.
-immutabilitypolicy: Sürüm 2020-06-12 ve daha yenisi. Blobların tarihe kadar olan değişmezlik ilkesi ve sabit ilke modunun sabit numaralamada dahil edileceklerini belirtir.
-legalhold: Sürüm 2020-06-12 ve daha yenisi. Blobların yasal tutması için numaralamanın dahil olması gerektiğini belirtir.
-permissions: Sürüm 2020-06-12 ve daha yenisi. Yalnızca hiyerarşik ad alanı etkinleştirilmiş hesaplar için destek sağlar. Bir istek bu parametreyi içerirse, listelenen bloblar veya dizinler için Sahip, Grup, İzinler ve Access Control Listesi numaralandırma dahil edilir.

URI'de bu seçeneklerden birden fazlasını belirtmek için her seçeneği URL ile kodlanmış virgül ("%82") ile ayırmalısınız.
showonly={deleted} İsteğe bağlı. Sürüm 2020-08-04 ve daha yenisi. Yalnızca Hiyerarşik Ad Alanı etkinleştirilmiş hesaplar için. bir istek bu parametreyi içerdiğinde, listede yalnızca yazılımdan silinmiş bloblar vardır. include=deleted de belirtilirse, istek Hatalı İstek (400) ile başarısız olur.
timeout İsteğe bağlı. timeoutparametresi saniyeler içinde ifade edildi. Daha fazla bilgi için bkz. Blob Hizmeti İşlemleri için Zaman Aşımı Ayarlama.

İstek Üst Bilgileri

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

İstek Başlığı Açıklama
Authorization Gereklidir. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. Azure Depolama.
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.
x-ms-version Anonim istekler için isteğe bağlı olarak tüm yetkili istekler için gereklidir. Bu istek için kullanmak üzere işlem sürümünü belirtir. Daha fazla bilgi için bkz. Azure Depolama Servicesiçin sürüm.
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ıyla istemci tarafından oluşturulan ve 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 Analiz Günlüğü ve Azure Günlüğü Hakkında: İstekleri Izlemek için Depolama 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ğlanıyor olduğunda geçerlidir. true ise, ve alanlarında döndürülen kullanıcı kimliği değerleri, nesne kimliklerinden Azure Active Directory asıl <Owner> <Group> <Acl> adlarına dönüştürülecek. false ise, değerler nesne kimlikleri Azure Active Directory döndürülür. Varsayılan değer false şeklindedir. Grup ve uygulama nesnesi kimlikleri, benzersiz kolay adlara sahip olmayan için çevrilebilir değildir.

İstek Gövdesi

Yok.

Örnek İstek

Örnek bir istek için bkz. Blob Kaynaklarını Numaralar.

Yanıt

Yanıt bir HTTP durum kodu, bir dizi yanıt üst bilgisi 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şlem için 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 uygun.

Yanıt üst bilgisi Açıklama
Content-Type Sonuçların döndürül olduğu biçimi belirtir. Şu anda bu application/xml değerdir.
x-ms-request-id Bu üst bilgi, yapılan isteği benzersiz bir şekilde 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, sürüm 2009-09-19 ve daha yenisi kullanılarak yapılan istekler için döndürülür.

Kapsayıcı Blob hizmetinin 2009-09-19 sürümü kullanılarak genel erişim için işaretlenmişse, bu üst bilgi, sürüm belirtilmemiş 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, isteklerde ve ilgili yanıtlarda sorun gidermek için kullanılabilir. bu üst bilginin değeri, istekte mevcutsa üst bilginin değerine eşittir ve değer en fazla x-ms-client-request-id 1024 görünür ASCII karakteridir. üst x-ms-client-request-id bilgisi istekte yoksa, yanıtta bu üst bilgi mevcut olmaz.

Yanıt Gövdesi

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

, Prefix , Marker ve MaxResults öğelerinin yalnızca istek Delimiter URI'si üzerinde belirtilmişse mevcut olduğunu unutmayın. öğenin NextMarker yalnızca liste sonuçları tamamlanmadı ise bir değeri vardır.

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

Sürüm 2009-09-19 ve daha yeni sürümlerde blob özellikleri bir öğe içinde Properties kapsüller.

2009-09-19 sürümünden itibaren yanıt List Blobs gövdesinde aşağıdaki yeniden adlandırılan öğ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 )

öğesi, Content-MD5 sürüm 2009-09-19 ve daha yenisi ile oluşturulan bloblar için görünür. Sürüm 2012-02-12 ve daha yeni sürümlerde, Blob hizmeti Blob Koy kullanarak bir blobu karşıya yüklerken değeri hesaplar, ancak Blok Listesini Koy kullanarak bir blob sanız bunu Content-MD5 hesaplamaz. Blobu ekleyebilirsiniz veya Put Block List veya Set Blob Properties işlemlerini çağırarak Content-MD5 değeri açıkça belirtebilirsiniz.

2009-09-19 ve daha yeni sürümler için ancak sürüm 2015-02-21'den önceki sürümler için, ekleme blobları içeren bir kapsayıcıda çağrı yapmak, listelemenin sonucu bir ekleme blobu içeriyorsa 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 , , , ve CopyProgress yalnızca CopyCompletionTime CopyStatusDescription 2012-02-12 ve sonraki sürümlerde görünür, bu işlem parametresini include={copy} içerir. Bu blob hiçbir zaman bir işlemde hedef olmadı ise veya bu blob, , veya kullanılarak yapılan bir son işlemden sonra değiştirilmişse Copy Blob Copy Blob bu öğeler Set Blob Properties Put Blob Put Block List görünmez. Bu öğeler ayrıca Blob Kopyalama tarafından 2012-02-12 sürümünden önce oluşturulan bir blobla birlikte görünmez.

sürüm 2013-08-15 ve daha yeni sürümlerde, öğesi blob uç noktasını belirten bir öznitelik ve kapsayıcının adını belirten bir EnumerationResults ServiceEndpoint alan ContainerName içerir. Önceki sürümlerde bu iki öznitelik alanda birlikte ContainerName birleştirii. Ayrıca 2013-08-15 ve daha yeni sürümlerde Url altındaki Blob öğesi kaldırılmıştır.

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

2015-12-11 ve üzeri List Blobs sürümler için öğesini ServerEncrypted döndürür. Blob ve uygulama meta verileri tamamen şifrelenirse bu öğe olarak ayarlanır true ve aksi false takdirde ayarlanır.

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

Sürüm 2017-04-17 ve üzeri için, bir erişim katmanı List Blobs AccessTier açıkça ayarlanmışsa öğesini döndürür. İzin verilen premium sayfa blobu katmanlarının listesi için bkz. VM'ler için yüksek Premium Depolama diskler ve yönetilen diskler. Blob Depolama veya Genel Amaçlı v2 hesapları için geçerli Hot / Cool / Archive değerlerdir. Blob yeniden dolum bekleniyor durumda ise geçerli ArchiveStatus değerlerden biri ile öğesi rehydrate-pending-to-hot / rehydrate-pending-to-cool döndürülür. Blok blobu katmanlama hakkında ayrıntılı bilgi için bkz. Hot, cool ve archive storage tiers.

Sürüm 2017-04-17 ve üzeri için List Blobs AccessTierInferred Blob Depolama veya v2 hesaplarında Genel Amaçlı döndürür. Blok blobu erişim katmanı ayarlanmamışsa depolama hesabı özelliklerinden katman çıkartır ve bu değer olarak true ayarlanır. Bu üst bilgi yalnızca katmanın hesap özelliğinden istenmiş olduğu durumda mevcuttur. Blok blobu katmanlama hakkında ayrıntılı bilgi için bkz. Hot, cool ve archive storage tiers.

Sürüm 2017-04-17 ve üzeri için List Blobs AccessTierChangeTime Blob Depolama veya v2 hesaplarında Genel Amaçlı döndürür. Bu yalnızca blok blobu katmanı ayarlanmışsa döndürülür. Tarih biçimi RFC 1123'ü izler. Daha fazla bilgi için bkz. Üst Bilgilerde Date-Time Değerlerin Gösterimi. Blok blobu katmanlama hakkında ayrıntılı bilgi için bkz. Hot, cool ve archive storage tiers.

sürüm 2017-07-29 ve üzeri Deleted için, ve DeletedTime bu işlem RemainingRetentionDays parametresini içerirken include={deleted} görüntülenir. Bu blob silinmemişse bu öğeler görünmez. Bu öğeler, yumuşak silme özelliği etkinleştirildiğinde işlemiyle silinen blob DELETE veya anlık görüntü için görünür. Deleted öğesi, yazılımdan silinen bloblar ve anlık görüntüler için true olarak ayarlanır. Deleted-Time blob'un silindiği zamanı belirtir. RemainingRetentionDays , geçici olarak silinen blobu blob hizmeti tarafından kalıcı olarak silinecek gün sayısını gösterir.

2017-11-09 ve üzeri sürümler için bu Creation-Time blob'un oluşturulma zamanı döndürür.

Sürüm 2019-02-02 ve üzeri için, blob müşteri tarafından sağlanan bir anahtarla List Blobs CustomerProvidedKeySha256 şifrelenirse öğ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 parametresini içerirse ve müşteri tarafından sağlanan anahtarla şifrelenmiş bir blobda uygulama meta verileri varsa, öğenin blobda işlem kapsamında şifresi çözülebilecek meta verilere sahip olduğunu belirten bir özniteliği include={metadata} Metadata Encrypted="true" List Blobs 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ısı.

Sürüm 2019-02-02 ve üzeri için, blob şifreleme kapsamıyla List Blobs EncryptionScope şifrelenirse öğesini döndürür. Değer, blobu şifrelemek için kullanılan şifreleme kapsamının adına ayarlanır. İşlem parametresini include={metadata} içerirse, blob'daki uygulama meta verileri saydam bir şekilde şifresi çözülecek ve öğesinde Metadata kullanılabilir.

Sürüm 2019-12-12 ve üzeri için, nesne yeniden dolum bekleniyor durumda ise Blob Depolama veya Genel Amaçlı v2 hesaplarında List Blobs RehydratePriority öğesini döndürür. Geçerli değerler: High / Standard . Blok blobu katmanlama hakkında ayrıntılı bilgi için bkz. Hot, cool ve archive storage tiers.

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

Sürüm 2019-12-12 ve üzeri için, blob'un geçerli sürümü için değeri olarak ayarlanmış öğesini döndürür ve salt okunur otomatik olarak oluşturulan sürümlerden List Blobs IsCurrentVersion ayırt true eder.

Sürüm 2019-12-12 ve üzeri için, bloblar için herhangi bir List Blobs TagCount etikete sahip öğeyi döndürür. öğesi Tags yalnızca bu işlem parametresini içerirse 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 Sealed Blobları için öğesini döndürür. Öğesi Sealed yalnızca Ekleme blobu korumalı olduğunda görünür. Ekleme Blobu korumalı değilse bu öğeler görünmez.

2020-02-10 ve üzeri sürümler List Blobs için öğesini LastAccessTime döndürür. Öğeler, depolama hesabının son erişim zamanı izleme ilkesine göre blob verilerine en son ne zaman erişil olduğunu gösterir. Depolama hesabında son erişim zamanı izleme ilkesi yoksa veya ilke devre dışı bırakılırsa öğe döndürülecek değildir. Hesabın son erişim zamanı izleme ilkesi ayarlama hakkında bilgi için bkz. Blob Hizmeti API'si. LastAccessTimeöğesi, blob meta verilerine son erişilen zamanı izlemez.

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

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

2020-06-12 ve üzeri sürümler için, hiyerarşik ad alanı etkinleştirilmiş hesaplar için, istek parametre içerdiğinde , ve List Blobs Owner öğesini Group Permissions Acl include={permissions} döndürür. Aclöğesinin, dosyada/dizinde ayarlanmış Access ve Default Acl'lerinin birleşik bir listesi olacağını unutmayın.

Hiyerarşik Ad Alanı etkin hesaplar için 2020-08-04 ve üzeri sürümler için silinen List Blobs DeletionId bloblar için öğesini döndürür. DeletionId , aynı yola sahip diğer silinen bloblardan ayırt etmek için bir yazılımdan silinen yolu benzersiz olarak tanımlayan imzasız 64 bit tanımlayıcıdı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>
        <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>
      </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ı Numaralar.

Yetkilendirme

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

Açıklamalar

Yanıtta Blob Özellikleri

Numaralandırılmamış blobların numaralandırılabilir olarak dahil ed999'a dahil edilebilir, bu nedenle bazı özellikler yanıtta döndürülene kadar bazı özelliklerin ayarlanmamış olduğunu unutmayın.

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

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

Sayfa blobları için öğesinde döndürülen Content-Length değer blob başlığının değerine x-ms-blob-content-length karşılık gelen değerdir.

Öğesi Content-MD5 yalnızca blobda 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 Content-MD5 veya Blob Özelliklerini Ayarla'ya çağırarak özelliğini ayarlayın. Sürüm 2012-02-12 ve daha yeni sürümlerde, istek bir MD5 üst bilgisi içermese bile blok Put Blob blobu Put Blob MD5 değerini ayarlar.

Yanıtta Meta Veriler

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

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

Bir meta veri adı-değer çifti 2009-09-19 sürümü tarafından zorlanan adlandırma kısıtlamalarını ihlal ediyorsa, yanıt gövdesi aşağıdaki XML parçasında gösterildiği gibi bir öğe içindeki sorunlu adı x-ms-invalid-name gösterir:

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

Yanıtta Etiketler

öğesi Tags yalnızca parametre include=tags URI'de belirtilmişse ve blobda etiketler varsa mevcuttur. öğesi içinde, her biri kullanıcı tanımlı Blob Dizini etiketlerini ve öğelerini içeren en fazla TagSet 10 Tag key öğe value döndürülür. Yanıtta etiketlerin sıralaması garanti edilemez.

Blobda Tags etiket yoksa ve öğeleri TagCount döndürülz.

Depolama hizmeti blob ile etiketleri arasında güçlü tutarlılık sağlar, ancak ikincil dizin nihai olarak tutarlıdır. Etiketler, Blobları Etiketlere Göre Bul işlemlerine görünmeden önce Liste Bloblarına verilen yanıtta görünür olabilir.

Yanıtta Anlık Görüntüler

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

Bir List Blobs sınırlayıcı ile çağrısı yaptısanız, numaralandırma anlık görüntüleri de ekamazsiniz. Her ikisini de içeren bir istek InvalidQueryParameter hatası (HTTP durum kodu 400 – Hatalı İstek) döndürür.

Yanıtta işlanmamış Bloblar

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

  • Last-Modified

  • Etag

  • Content-Type

  • Content-Encoding

  • Content-Language

  • Content-MD5

  • Cache-Control

  • Metadata

Yanıtta Silinen Bloblar

Silinen bloblar yanıtta yalnızca parametresi include=deleted URI'de belirtilmişse listelenir. Yanıtta listelenen silinen bloblar, silinen blobların etkin kiralamaları olamaz, kira öğelerini içermez.

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

Yanıtta Nesne Çoğaltma Meta Verileri

Bir nesne çoğaltma ilkesi bir blob üzerinde değerlendirildi ve Liste Blobları çağrısı 2019-12-12 veya sonraki bir sürümü kullanılarak yapılmış olduğunda OrMetadata öğesi mevcuttur. OrMetadataöğesinde, her bir ad-değer çiftinin değeri, çiftin adına karşılık gelen bir öğe içinde listelenir. Ad biçimi olarak kullanılır; burada, depolama hesabı üzerinde nesne çoğaltma ilkesi tanımlayıcısını temsil eden bir guid ve depolama kapsayıcısı üzerinde kural tanımlayıcısını temsil eden bir or-{policy-id}_{rule-id} {policy-id} {rule-id} guid'tir. Geçerli değerler: 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 Sabitlik İlkesi

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

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

Yanıtta Yasal Tutma

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

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

İşaretçi Değeri Kullanarak Sonuç Kümelerini Döndüren

parametresi için bir değer belirtir ve dönüş için blob sayısı bu değeri aşarsa veya için varsayılan değeri aşarsa, yanıt gövdesi sonraki blobu sonraki istekte geri dönecek şekilde gösteren bir maxresults maxresults öğe NextMarker içerir. Sonraki öğe kümesine dönmek için değerini sonraki istek için NextMarker URI'de işaretçi parametresi olarak belirtin.

değerinin NextMarker opak olarak kabul edilmelidir.

Blob Ad Alanını Çapraz Geçiş yapmak 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 geçişe olanak sağlar. Bu şekilde blobların sanal hiyerarşisini bir dosya sistemi gibi geçirebilirsiniz. Sınırlayıcı tek bir karakter veya dize olabilir. İstek bu parametreyi içerirken işlemi bir öğesi BlobPrefix döndürür. öğesi, adları sınırlayıcı karakterinin görünümüne kadar aynı alt dizeyle başlayan BlobPrefix tüm blobların yerine döndürülür. öğesinin değeri BlobPrefix alt dize+sınırlayıcıdır; burada alt dize bir veya daha fazla blob adı başlayan ortak alt dizedir ve sınırlayıcı sınırlayıcı parametresinin değeridir.

İstek URI'sinde parametresinin değerini belirterek bu ön ekle başlayan blobları listeleyen sonraki bir çağrı yapmak için değerini BlobPrefix BlobPrefix prefix kullanabilirsiniz.

Döndürülen her BlobPrefix öğenin, her öğede olduğu gibi en yüksek sonuç için Blob sayar.

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

CopyStatusDescription'da kopyalama hataları

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

  • Bir kopyalama denemesi başarısız olduğunda ve Blob hizmeti işlemi yeniden denese, olarak ayarlanır ve metin son kopyalama denemesi sırasında meydana gelen CopyStatus pending CopyStatusDescription başarısızlığı açıklar.

  • olarak CopyStatus failed ayarlanırsa, CopyStatusDescription metin kopyalama işlemi başarısız oldu neden olan hatayı açıklar.

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

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. Herhangi bir <ErrorCode öğesi görünürse, HTTP belirtiminin 3 basamaklı HTTP durum koduyla ilişkili standart hata metnini içeren bir > anahtar sözcük kullanılır. Bkz. REST API Hata Kodları.
Bilgi Hatanın tırnak içinde ayrıntılı açıklaması.

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

Önemli

Burada gösterilen açıklama metni, sürüm değişikliği olmadan bile uyarı olmadan değişebilir, bu nedenle tam olarak bu 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ı kopyalamayı tamamlanmadan önce iptal etti. Iptal empty
Kopyalama işlemi sırasında kaynak blobdan okuma sırasında bir hata oluştu, ancak işlem yeniden denenecek. bekleniyor 502 BadGateway "Kaynağı okurken yeniden denenebilir bir hatayla karşılaştı. Yeniden denenecek. Hata süresi: <zamanı > "
Kopyalama işlemi hedef bloba yazarken bir hata oluştu, ancak işlem yeniden denenecek. bekleniyor 500 InternalServerError "Yeniden denenebilir bir hatayla karşılaştı. Yeniden denenecek. Hata süresi: <zamanı > "
Bir kopyalama işlemi için kaynak blobdan okuma sırasında kurtarılamaz bir hata oluştu. başarısız 404 ResourceNotFound "Kaynak okurken kopyalama başarısız oldu." Not: Azure, bu temel alınan hatayı ResourceNotFound raporlarken ErrorCode <> döndürür. Yanıtta <ErrorCode öğesi yoksa HTTP durumunun standart bir dize > gösterimi NotFound görüntülenir.
Tüm kopyalama işlemlerini sınırlandıran zaman aşımı süresi. (Şu anda zaman aşımı süresi 2 haftadır.) başarısız 500 Operationiptal edildi "kopya izin verilen en uzun süreyi aştı."
Kopyalama işlemi kaynaktan okurken çok sık başarısız oldu ve başarı için en düşük deneme sayısına uymuyor. (Bu zaman aşımı, başarısız olmadan önce 2 hafta içinde çok zayıf bir kaynağın yeniden denenmesini önler). başarısız 500 Operationiptal edildi "kaynak okunurken kopyalama başarısız oldu."

Ayrıca bkz.

Durum ve hata kodları
Blob Hizmeti Hata Kodları