Blobok listázása

A List Blobs művelet a megadott tároló alatti blobok listáját adja vissza.

Kérés

A List Blobs kérést az alábbiak szerint hozhatja létre. A HTTPS használata ajánlott. Cserélje le myaccount a tárfiók nevére.

Emulált tárolási szolgáltatás URI-ja

Amikor kérelmet küld az emulált tárolási szolgáltatásra, adja meg az emulátor gazdagépnevét és az Azure Blob Storage-portot 127.0.0.1:10000, majd az emulált tárfiók nevét.

További információ: Azurite Emulator használata helyi Azure Storage-fejlesztési.

URI-paraméterek

Az URI-n a következő további paramétereket adhatja meg.

Kérelemfejlécek

Az alábbi táblázat a szükséges és választható kérelemfejléceket ismerteti.

Kérelem törzse

Egyik sem.

Mintakérés

Tekintse meg Blob-erőforrások számbavétele mintakéréshez.

Válasz

A válasz tartalmaz egy HTTP-állapotkódot, egy válaszfejléceket és egy XML formátumú választörzset.

Állapotkód

A sikeres művelet a 200-ra (OK) vonatkozó állapotkódot adja vissza. Az állapotkódokkal kapcsolatos információkért lásd állapot- és hibakódokat.

Válaszfejlécek

A művelet válasza a következő fejléceket tartalmazza. A válasz további szabványos HTTP-fejléceket is tartalmazhat. Minden szabványos fejléc megfelel a HTTP/1.1 protokoll specifikációjának.

Válasz törzse

Az XML-válasz formátuma a következő.

Vegye figyelembe, hogy a Prefix, Marker, MaxResultsés Delimiter elemek csak akkor vannak jelen, ha a kérelem URI-ján meg lettek adva. Ha NextMarker üres, akkor a lista eredményei befejeződnek. Ha a NextMarkernem üresen, előfordulhat, hogy a lista eredményei befejeződnek vagy nem fejeződnek be. Ha az összes blobot listázni szeretné, folytassa a List Blobs hívását a következő jelölőértékekkel, amíg NextMarker üres nem lesz.

A pillanatképek, a blob metaadatai és a nem véglegesített blobok csak akkor szerepelnek a válaszban, ha meg vannak adva a kérés URI include paraméterével.

A 2009-09-19-es és újabb verziókban a blob tulajdonságai egy Properties elembe vannak ágyazva.

A 2009-09-19-es verziótól kezdve List Blobs a válasz törzsében a következő átnevezett elemeket adja vissza:

• Last-Modified (korábban LastModified)

• Content-Length (korábban Size)

• Content-Type (korábban ContentType)

• Content-Encoding (korábban ContentEncoding)

• Content-Language (korábban ContentLanguage)

A Content-MD5 elem a 2009-09-19-es és újabb verzióval létrehozott blobokhoz jelenik meg. A 2012-02-12-es és újabb verziókban a Blob Storage kiszámítja a blob feltöltésekor Content-MD5 értéket Blobhasználatával. A Blob Storage nem számítja ki ezt, amikor blobot hoz létre Tiltólistahasználatával. A blob létrehozásakor explicit módon beállíthatja a Content-MD5 értéket, vagy meghívhatja a Tiltólista vagy Blob tulajdonságainak beállítása műveleteket.

A 2009-09-19-es és újabb verziók esetében, de a 2015-02-21-es verzió előtt nem hívhat List Blobs hozzáfűző blobokat tartalmazó tárolón. A szolgáltatás a 409-et (Ütközés) állapotkódot adja vissza, ha a lista eredménye hozzáfűző blobot tartalmaz.

LeaseState és LeaseDuration csak a 2012-02-12-es és újabb verziókban jelennek meg.

CopyId, CopyStatus, CopySource, CopyProgress, CopyCompletionTimeés CopyStatusDescription csak a 2012-02-12-es és újabb verziókban jelennek meg, ha ez a művelet tartalmazza a include={copy} paramétert. Ezek az elemek nem jelennek meg, ha soha nem ez a blob volt a cél egy Copy Blob műveletben. Az elemek nem jelennek meg, ha a blobot egy befejezett Copy Blob művelet után módosították Set Blob Properties, Put Blobvagy Put Block Listhasználatával. Ezek az elemek nem jelennek meg a Blob másolásaáltal a 2012-02-12-es verzió előtt létrehozott blobokkal sem.

A 2013-08-15-ös és újabb verziókban a EnumerationResults elem tartalmaz egy ServiceEndpoint attribútumot, amely meghatározza a blobvégpontot. Ez az elem egy ContainerName mezőt is tartalmaz, amely megadja a tároló nevét. A korábbi verziókban ezt a két attribútumot egyesítették a ContainerName mezőben. A 2013-08-15-ös és újabb verziókban is eltávolítottuk a Blob alatti Url elemet.

A 2015-02-21-es és újabb verziók esetében List Blobs minden típusú blobot (blokkot, oldalt és hozzáfűző blobot) ad vissza.

A 2015-12-11-es és újabb verziók esetében List Blobs a ServerEncrypted elemet adja vissza. Ez az elem true van beállítva, ha a blob és az alkalmazás metaadatai teljesen titkosítva vannak, és más false.

A 2016-05-31-es és újabb verziók esetében List Blobs a növekményes másolási blobok és pillanatképek IncrementalCopy elemét adja vissza, az érték pedig true.

A 2017-04-17-es és újabb verziók esetében List Blobs a AccessTier elemet adja vissza, ha a hozzáférési szint kifejezetten be van állítva. Az engedélyezett prémium szintű lapblobszintek listáját Virtuális gépek nagy teljesítményű prémium szintű tárterületei és felügyelt lemezeicímű témakörben találja. Blob Storage- vagy általános célú v2-fiókok esetén az érvényes értékek Hot, Coolés Archive. Ha a blob rehidratált állapotban van, akkor a rendszer ArchiveStatus elemet az érvényes értékek (rehydrate-pending-to-hot, rehydrate-pending-to-coolvagy rehydrate-pending-to-cold) egyikével adja vissza. A blokkblobok rétegzésével kapcsolatos részletes információkért lásd gyakori elérésű, ritka elérésű és archív tárolási szinteket.

A 2017-04-17-es és újabb verziók esetében List Blobs a Blob Storage vagy az általános célú v2-fiókok AccessTierInferred elemét adja vissza. Ha a blokkblob nem rendelkezik a hozzáférési szint beállításával, a rétegadatok a tárfiók tulajdonságaiból következtetnek, és ez az érték true. Ez a fejléc csak akkor jelenik meg, ha a réteg a fióktulajdonságból származik.

A 2017-04-17-es és újabb verziók esetében List Blobs a Blob Storage vagy az általános célú v2-fiókok AccessTierChangeTime elemét adja vissza. Ez csak akkor lesz visszaadva, ha a blokkblob rétege valaha is be lett állítva. További információ: Dátum-idő értékek megjelenítése fejlécekben.

A 2017-07-29-es és újabb verziókban Deleted, DeletedTimeés RemainingRetentionDays jelenik meg, ha a művelet tartalmazza a include={deleted} paramétert. Ezek az elemek nem jelennek meg, ha ezt a blobot nem törölték. Ezek az elemek a DELETE művelettel törölt blobok vagy pillanatképek esetében jelennek meg, amikor engedélyezve lett a helyreállítható törlési funkció. A Deleted elem true a helyreállíthatóan törölt blobokhoz és pillanatképekhez. Deleted-Time a blob törlésének időpontjának felel meg. RemainingRetentionDays a helyreállíthatóan törölt blob végleges törlésének számát jelzi.

A 2017-11-09-es és újabb verziók esetében Creation-Time a blob létrehozásának időpontját adja vissza.

A 2019-02-02-es és újabb verziók esetében List Blobs a CustomerProvidedKeySha256 elemet adja vissza, ha a blob ügyfél által megadott kulccsal van titkosítva. Az érték a blob titkosításához használt kulcs SHA-256 kivonatára lesz beállítva. Ezenkívül ha a művelet tartalmazza a include={metadata} paramétert, és egy ügyfél által megadott kulccsal titkosított blobon vannak alkalmazás metaadatai, a Metadata elem Encrypted="true" attribútummal fog rendelkezni. Ez az attribútum azt jelzi, hogy a blob olyan metaadatokkal rendelkezik, amelyeket nem lehet visszafejteni a List Blobs művelet részeként. A blobok metaadatainak eléréséhez hívja meg Blob tulajdonságainak lekérése vagy Blob-metaadatok lekérése az ügyfél által megadott kulccsal.

A 2019-02-02-es és újabb verziók esetében List Blobs a EncryptionScope elemet adja vissza, ha a blob titkosítási hatókörrel van titkosítva. Az érték a blob titkosításához használt titkosítási hatókör nevére lesz beállítva. Ha a művelet tartalmazza a include={metadata} paramétert, a blobon lévő alkalmazás metaadatai transzparensen visszafejthetők, és elérhetők a Metadata elemben.

A 2019-12-12-es és újabb verziók esetében List Blobs a Blob Storage vagy az általános célú v2-fiókok RehydratePriority elemét adja vissza, ha az objektum rehydrate pending állapotban van. Az érvényes értékek a következők: High és Standard.

A 2019-12-12-es és újabb verziók esetében a List Blobs a blobok és a létrehozott blobverziók VersionId elemét adja vissza, ha a verziószámozás engedélyezve van a fiókban.

A 2019-12-12-es és újabb verziók esetében List Blobs a blob aktuális verziójának IsCurrentVersion elemét adja vissza. Az érték trueértékre van állítva. Ez az elem lehetővé teszi az aktuális verzió megkülönböztetése az írásvédett, automatikusan létrehozott verzióktól.

A 2019-12-12-es és újabb verziók esetében List Blobs a címkékkel rendelkező blobok TagCount elemét adja vissza. A Tags elem csak akkor jelenik meg, ha ez a művelet tartalmazza a include={tags} paramétert. Ezek az elemek nem jelennek meg, ha nincsenek címkék a blobon.

A 2019-12-12-es és újabb verziók esetében List Blobs a hozzáfűző blobok Sealed elemét adja vissza. A Sealed elem csak akkor jelenik meg, ha a hozzáfűző blobot lezárták. Ezek az elemek nem jelennek meg, ha a hozzáfűző blob nincs lezárva.

A 2020-02-10-es és újabb verziók esetében List Blobs a LastAccessTime elemet adja vissza. Az elem a tárfiók utolsó hozzáférési időkövető szabályzatának megfelelően jeleníti meg, hogy mikor fértek hozzá utoljára a blob adatai. A rendszer nem adja vissza az elemet, ha a tárfiók nem rendelkezik ezzel a szabályzattal, vagy a szabályzat le van tiltva. A fiók utolsó hozzáférési időkövető szabályzatának beállításáról további információt a Blob Service APIcímű cikkben talál. A LastAccessTime elem nem követi nyomon a blob metaadatainak legutóbbi elérésének időpontját.

A 2020-06-12-es és újabb verziók esetében List Blobs a ImmutabilityPolicyUntilDate és ImmutabilityPolicyMode elemeket adja vissza, ha ez a művelet tartalmazza a include={immutabilitypolicy} paramétert.

A 2020-06-12-es és újabb verziók esetében List Blobs a LegalHold elemet adja vissza, ha ez a művelet tartalmazza a include={legalhold} paramétert.

A 2020-06-12-es és újabb verziókban a hierarchikus névtérrel rendelkező fiókok esetében List Blobs a Owner, Group, Permissionsés Acl elemeket adja vissza. A kérelemnek tartalmaznia kell a include={permissions} paramétert. Vegye figyelembe, hogy a Acl elem a fájlban vagy könyvtárban beállított hozzáférési és alapértelmezett hozzáférés-vezérlési listák kombinált listája.

A 2020-06-12-es és újabb verziókban a hierarchikus névtérrel rendelkező fiókok esetében a határolóval rendelkező List Blobs a BlobPrefix elem Properties elemét adja vissza. Ez megfelel a könyvtár tulajdonságainak.

A 2020-08-04-es és újabb verziókban a hierarchikus névtérrel rendelkező fiókok esetében List Blobs a törölt blobok DeletionId elemét adja vissza. DeletionId egy aláíratlan, 64 bites azonosító. Az elem egyedileg azonosítja a helyreállíthatóan törölt elérési utat, hogy megkülönböztesse az azonos elérési úttal rendelkező többi törölt blobtól.

A 2020-10-02-es és újabb verziókban a hierarchikus névtérrel rendelkező fiókok esetében List Blobs az elérési út ResourceType tulajdonságelemét adja vissza. Ez lehet file vagy directory.

A 2021-02-12-es és újabb verziók esetében a List Blobs százalékban kódolja (RFC 2396-ra) az összes BlobName vagy BlobPrefixName elemértéket. Pontosabban azoknál az értékeknél, amelyek xml-ben nem érvényes karaktereket tartalmaznak (U+FFFE vagy U+FFFF). Kódolás esetén a Name elem tartalmaz egy Encoded=true attribútumot. Vegye figyelembe, hogy ez csak az XML-ben érvénytelen karaktereket tartalmazó Name elemértékek esetében fordul elő, a válasz többi Name eleme nem.

A 2021-06-08-s és újabb verziókban a hierarchikus névtérrel rendelkező fiókok esetében List Blobs a Placeholder tulajdonságelemet adja vissza. Ezt az elemet adja vissza a helyőrző könyvtárak BlobPrefix elemében, ha a törölt blobokat elválasztójellel listázta. Ezek a helyőrző könyvtárak megkönnyítik a helyreállíthatóan törölt blobokra való navigálást.

A 2021-06-08-s és újabb verziókban a hierarchikus névtérrel rendelkező fiókok esetében List Blobs a EncryptionContext elemet adja vissza. Ha a titkosítási környezet tulajdonságértéke be van állítva, akkor a megadott értéket adja vissza.

A 2020-02-10-es és újabb verziókban a hierarchikus névtérrel rendelkező fiókok esetében List Blobs a törölt blobok Expiry-Time elemét adja vissza. Expiry-Time a fájl lejáratának időpontja, és a rendszer visszaadja a fájlnak, ha a lejárati idő azonos.

<?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>  

Mintaválasz

Példaválaszért lásd bloberőforrások számbavétele.

Felhatalmazás

Az Azure Storage-beli adathozzáférési műveletek meghívásához engedélyezésre van szükség. Az alábbi módon engedélyezheti a List Blobs műveletet.

Megjegyzések

Blobtulajdonságok a válaszban

Ha kérte, hogy a nem véglegesített blobok szerepeljen az enumerálásban, vegye figyelembe, hogy bizonyos tulajdonságok csak a blob véglegesítése után lesznek beállítva. Előfordulhat, hogy egyes tulajdonságok nem lesznek visszaadva a válaszban.

A x-ms-blob-sequence-number elem csak lapblobok esetén lesz visszaadva.

A OrMetadata elem csak blokkblobok esetén lesz visszaadva.

Lapblobok esetén a Content-Length elemben visszaadott érték a blob x-ms-blob-content-length fejlécének értékének felel meg.

A Content-MD5 elem csak akkor jelenik meg a válasz törzsében, ha a blobon a 2009-09-19-es vagy újabb verzióval lett beállítva. A blob létrehozásakor beállíthatja a Content-MD5 tulajdonságot, vagy meghívhatja Blob tulajdonságainak beállítása. A 2012-02-12-es és újabb verziókban Put Blob beállítja a blokkblob MD5-értékét, még akkor is, ha a Put Blob kérés nem tartalmaz MD5-fejlécet.

Metaadatok a válaszban

A Metadata elem csak akkor jelenik meg, ha a include=metadata paraméter meg lett adva az URI-n. Az Metadata elemen belül az egyes név-érték párok értéke szerepel a pár nevének megfelelő elemen belül.

Vegye figyelembe, hogy az ezzel a paraméterrel kért metaadatokat a Blob Storage 2009-09-19-es verziójának elnevezési korlátozásaival összhangban kell tárolni. Ezzel a verzióval kezdődően az összes metaadatnévnek meg kell felelnie C#-azonosítókelnevezési konvencióinak.

Ha egy metaadat-név-érték pár megsérti ezeket az elnevezési korlátozásokat, a válasz törzse egy x-ms-invalid-name elem problémás nevét jelzi. Az alábbi XML-töredék a következőt mutatja:

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

Címkék a válaszban

A Tags elem csak akkor jelenik meg, ha a include=tags paraméter meg van adva az URI-ban, és ha vannak címkék a blobon. A TagSet elemen belül legfeljebb 10 Tag elem lesz visszaadva, amelyek mindegyike tartalmazza a felhasználó által definiált blobindexcímkék key és value. A címkék sorrendje nem garantált a válaszban.

A Tags és TagCount elemek nem jelennek meg, ha nincsenek címkék a blobon.

A tárolási szolgáltatás erős konzisztenciát tart fenn egy blob és címkéi között, de a másodlagos index végül konzisztens. A címkék a List Blobs adott válaszában láthatók, mielőtt azok láthatók lennének Find Blobs by Tags műveletekben.

Pillanatképek a válaszban

A pillanatképek csak akkor jelennek meg a válaszban, ha a include=snapshots paraméter meg lett adva az URI-ban. A válaszban felsorolt pillanatképek nem tartalmazzák a LeaseStatus elemet, mert a pillanatképek nem rendelkezhetnek aktív bérletekkel.

A 2021-06-08-as és újabb szolgáltatásverzióval meghívhatja List Blobs egy elválasztójellel, és pillanatképeket is felvehet az enumerálásba. A 2021-06-08 előtti szolgáltatásverziók esetén a mindkettőt tartalmazó kérés InvalidQueryParameter hibát ad vissza (HTTP-állapotkód: 400 – Hibás kérés).

Nem véglegesített blobok a válaszban

A nem véglegesített blobok csak akkor jelennek meg a válaszban, ha a include=uncommittedblobs paraméter meg lett adva az URI-ban. A válaszban felsorolt nem véglegesített blobok nem tartalmazzák az alábbi elemek egyikét sem:

• Last-Modified

• Etag

• Content-Type

• Content-Encoding

• Content-Language

• Content-MD5

• Cache-Control

• Metadata

Törölt blobok a válaszban

A törölt blobok csak akkor jelennek meg a válaszban, ha a include=deleted paraméter meg lett adva az URI-ban. A válaszban felsorolt törölt blobok nem tartalmazzák a Bérlet elemeket, mert a törölt blobok nem rendelkezhetnek aktív bérletekkel.

A törölt pillanatképek akkor jelennek meg a listaválaszban, ha include=deleted,snapshot van megadva az URI-n.

Objektumreplikációs metaadatok a válaszban

A OrMetadata elem akkor jelenik meg, ha egy objektumreplikációs szabályzatot kiértékeltek egy blobon, és a List Blobs hívás a 2019-12-12-es vagy újabb verzióval történt. Az OrMetadata elemen belül az egyes név-érték párok értéke szerepel a pár nevének megfelelő elemen belül. A név formátuma or-{policy-id}_{rule-id}, ahol a {policy-id} egy GUID, amely a tárfiók objektumreplikációs házirend-azonosítóját jelöli. {rule-id} egy GUID, amely a tárolóban lévő szabályazonosítót jelöli. Az érvényes értékek a következők: complete vagy 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>  
…  
  

Módosíthatatlansági szabályzat a válaszban

A ImmutabilityPolicyUntilDate és ImmutabilityPolicyMode elemek csak akkor vannak jelen, ha a include=immutabilitypolicy paraméter meg lett adva az URI-n.

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

Jogi visszatartás a válaszban

A LegalHold elem csak akkor jelenik meg, ha a include=legalhold paraméter meg lett adva az URI-n.

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

Eredményhalmazok visszaadása jelölőérték használatával

Ha a maxresults paraméter értékét adja meg, és a visszaadandó blobok száma meghaladja ezt az értéket, vagy meghaladja a maxresultsalapértelmezett értékét, a válasz törzse egy NextMarker elemet tartalmaz. Ez az elem a következő blobot jelzi, amely egy későbbi kérésre tér vissza. Bizonyos esetekben a szolgáltatás akkor is visszaadhatja a NextMarker elemet, ha a visszaadott eredmények száma kisebb, mint a maxresultsértéke.

A következő elemkészlet visszaadásához adja meg a NextMarker értékét az URI jelölőparamétereként a következő kéréshez. Vegye figyelembe, hogy a NextMarker értékét átlátszatlanként kell kezelni.

Határoló használata a blobnévtér átjárásához

A delimiter paraméter lehetővé teszi, hogy a hívó egy felhasználó által konfigurált elválasztó használatával lépkedjen át a blobnévtéren. Ily módon úgy haladhat át a blobok virtuális hierarchiájában, mintha fájlrendszer lenne. A határoló karakter lehet egy karakter vagy egy sztring.

Ha a kérelem tartalmazza ezt a paramétert, a művelet egy BlobPrefix elemet ad vissza. A BlobPrefix elemet a rendszer az összes olyan blob helyett adja vissza, amelynek neve ugyanazzal a sztringgel kezdődik, egészen az elválasztó karakter megjelenésétől. A BlobPrefix elem értéke substring+delimiter, ahol a blobneveket kezdő gyakori részszúrás, elválasztó pedig a delimiter paraméter értéke.

A BlobPrefix értékével további hívást kezdeményezhet az előtaggal kezdődő blobok listázására. Ehhez meg kell adnia a BlobPrefix értékét a kérelem URI-jának prefix paraméteréhez.

Vegye figyelembe, hogy minden visszaadott BlobPrefix elem a maximális eredmény felé számít, ahogyan az egyes Blob elemek is.

A blobok betűrendben vannak felsorolva a válasz törzsében, elsőként nagybetűkkel.

Másolási hibák a másolási állapot leírásában

CopyStatusDescription további információt tartalmaz a Copy Blob hibáról.

• Ha egy másolási kísérlet meghiúsul, CopyStatuspending, ha a Blob Storage továbbra is újrapróbálkozza a műveletet. A CopyStatusDescription szöveg azt a hibát írja le, amely az utolsó másolási kísérlet során fordulhatott elő.

• Ha CopyStatusfailedértékre van állítva, a CopyStatusDescription szöveg azt a hibát írja le, amely miatt a másolási művelet meghiúsult.

Az alábbi táblázat az összes CopyStatusDescription érték mezőit ismerteti.

Az alábbi táblázat a gyakori hibaforgatókönyvek CopyStatus és CopyStatusDescription értékeit ismerteti.

Számlázás

A díjszabási kérések olyan ügyfelektől származhatnak, amelyek Blob Storage API-kat használnak közvetlenül a Blob Storage REST API-ból vagy egy Azure Storage-ügyfélkódtárból. Ezek a kérések tranzakciónkénti díjakat halmoznak fel. A tranzakció típusa hatással van a fiók díjának módjára. Az olvasási tranzakciók például más számlázási kategóriába tartoznak, mint az írási tranzakciók. Az alábbi táblázat a tárfiók típusa alapján List Blobs kérelmek számlázási kategóriáját mutatja be:

A megadott számlázási kategória díjszabásáról az Azure Blob Storage díjszabási című témakörben olvashat.

Lásd még:

Állapot- és hibakódok
Blob Storage hibakódjai