Megosztás a következőn keresztül:

Blobok listázása

  • Cikk

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.

Módszer URI kérése HTTP-verzió
GET https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list HTTP/1.1

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.

Módszer URI kérése HTTP-verzió
GET http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container&comp=list HTTP/1.1

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.

Paraméter Leírás
prefix Szabadon választható. Szűri az eredményeket, hogy csak a megadott előtaggal kezdődő neveket tartalmazó blobokat adja vissza. Hierarchikus névtérrel rendelkező fiókokban hiba lép fel azokban az esetekben, amikor egy fájl neve megjelenik az előtag elérési útjának közepén. Előfordulhat például, hogy readmefile.txt nevű blobokat próbál meg megkeresni a folder1/folder2/readme/readmefile.txtelőtag elérési útján. Hiba jelenik meg, ha bármely almappában readmenevű fájl található.
delimiter Szabadon választható. Ha a kérelem tartalmazza ezt a paramétert, a művelet egy BlobPrefix elemet ad vissza a válasz törzsében. Ez az elem helyőrzőként működik az összes olyan blobhoz, amelynek neve ugyanazzal a részszűkítéssel kezdődik, egészen az elválasztó karakter megjelenésétől. A határoló karakter lehet egy karakter vagy egy sztring.
marker Szabadon választható. A következő listaművelettel visszaadandó listarészt azonosító sztringérték. A művelet egy jelölőértéket ad vissza a válasz törzsében, ha a visszaadott lista nem fejeződött be. Ezt követően egy későbbi hívásban a jelölőérték használatával kérheti le a listaelemek következő készletét.

A jelölő értéke átlátszatlan az ügyfél számára.
maxresults Szabadon választható. Meghatározza a visszaadandó blobok maximális számát, beleértve az összes BlobPrefix elemet. Ha a kérés nem ad meg maxresults, vagy 5000-nél nagyobb értéket ad meg, a kiszolgáló legfeljebb 5000 elemet ad vissza. Ha további eredményeket szeretne visszaadni, a szolgáltatás egy folytatási jogkivonatot ad vissza a NextMarker válaszelemben. Bizonyos esetekben előfordulhat, hogy a szolgáltatás a maxresultsáltal megadottnál kevesebb eredményt ad vissza, és egy folytatási jogkivonatot is visszaad.

Ha a maxresults nullánál kisebb vagy egyenlő értékre állítja, a 400-ás hibaválaszkód (hibás kérelem) jelenik meg.
include={snapshots,metadata,uncommittedblobs,copy,deleted,tags,versions,
deletedwithversions,immutabilitypolicy,legalhold,permissions}		 Szabadon választható. Egy vagy több adatkészletet határoz meg, amelyeket a válasz tartalmaz:

- snapshots: Azt határozza meg, hogy a pillanatképek szerepeljenek az enumerálásban. A pillanatképek a válaszban a legrégebbitől a legújabbig jelennek meg.
- metadata: Azt adja meg, hogy a blob metaadatai a válaszban legyenek visszaadva.
- uncommittedblobs: Azt a blobot adja meg, amelyekhez a blokkok fel lettek töltve, de tiltólistahasználatával nem véglegesítve, szerepelnie kell a válaszban.
- copy: 2012-02-12-es és újabb verzió. Megadja, hogy a válaszban szerepelnie kell az aktuális vagy az előző Copy Blob művelethez kapcsolódó metaadatoknak.
- deleted: 2017-07-29-es és újabb verzió. Meghatározza, hogy a helyreállíthatóan törölt blobokat szerepeltetni kell a válaszban.
- tags: 2019-12-12-es és újabb verzió. Megadja, hogy a válaszban szerepelnie kell a felhasználó által definiált blobindex-címkéknek.
- versions: 2019-12-12-es és újabb verzió. Megadja, hogy a blobok verzióinak szerepelnie kell az enumerálásban.
- deletedwithversions: 2020-10-02-es és újabb verzió. Azt határozza meg, hogy a törölt blobokat minden (aktív vagy törölt) verzióval fel kell venni a válaszba. A véglegesen törölt elemek mindaddig megjelennek a válaszban, amíg a szemétgyűjtés fel nem dolgozza őket. Használja a címkét \<HasVersionsOnly\>, és az értéket true.
- immutabilitypolicy: 2020-06-12-es és újabb verzió. Megadja, hogy az enumerálásnak tartalmaznia kell a dátumig nem módosítható szabályzatot és a blobok nem módosítható szabályzatmódját.
- legalhold: 2020-06-12-es és újabb verzió. Megadja, hogy az enumerálásnak tartalmaznia kell a blobok jogi visszatartását.
- permissions: 2020-06-12-es és újabb verzió. Csak hierarchikus névtérrel rendelkező fiókok esetén támogatott. Ha egy kérelem tartalmazza ezt a paramétert, akkor a felsorolt blobok vagy könyvtárak tulajdonosi, csoport-, engedély- és hozzáférés-vezérlési listája szerepelni fog az enumerálásban.

Ha több beállítást szeretne megadni az URI-n, az egyes beállításokat URL-kódolású vesszővel ("%82") kell elválasztania.
showonly={deleted,files,directories} Szabadon választható. A válaszban visszaadandó adathalmazok egyikét adja meg:

- deleted: Nem kötelező. 2020-08-04-es és újabb verzió. Csak hierarchikus névtérrel engedélyezett fiókok esetén. Ha egy kérelem tartalmazza ezt a paramétert, a lista csak helyreállíthatóan törölt blobokat tartalmaz. Vegye figyelembe, hogy a POSIX ACL engedélyezési tartalék nem támogatott a helyreállíthatóan törölt blobok listázása esetén. Ha include=deleted is meg van adva, a kérés hibás kéréssel (400) meghiúsul.
- files: Nem kötelező. 2020-12-06-os és újabb verzió. Csak hierarchikus névtérrel engedélyezett fiókok esetén. Ha egy kérelem tartalmazza ezt a paramétert, a lista csak fájlokat tartalmaz.
- directories: Nem kötelező. 2020-12-06-os és újabb verzió. Csak hierarchikus névtérrel engedélyezett fiókok esetén. Ha egy kérelem tartalmazza ezt a paramétert, a lista csak könyvtárakat tartalmaz.
timeout Szabadon választható. A timeout paraméter másodpercben van kifejezve. További információ: A Blob Storage-műveletek időkorlátjának beállítása.

Kérelemfejlécek

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

Kérelem fejléce Leírás
Authorization Szükséges. Megadja az engedélyezési sémát, a fióknevet és az aláírást. További információ: Kérelmek engedélyezése az Azure Storage-.
Date vagy x-ms-date Szükséges. A kérelem koordinált egyetemes idejét (UTC) adja meg. További információ: Kérelmek engedélyezése az Azure Storage-.
x-ms-version Az összes engedélyezett kéréshez kötelező, névtelen kérésekhez pedig nem kötelező. A kérelemhez használni kívánt művelet verzióját adja meg. További információ: Az Azure Storage-szolgáltatások verziószámozása.
x-ms-client-request-id Szabadon választható. Ügyfél által generált, átlátszatlan értéket biztosít egy 1 kibibyte (KiB) karakterkorláttal, amelyet a naplózás konfigurálásakor rögzít a naplókban. Javasoljuk, hogy ezt a fejlécet használva korrelálja az ügyféloldali tevékenységeket a kiszolgáló által kapott kérésekkel. További információ: Monitor Azure Blob Storage.
x-ms-upn Szabadon választható. Csak akkor érvényes, ha a fiókhoz engedélyezve van egy hierarchikus névtér, és include=permissions szerepel a kérelemben. Ha true, a rendszer a <Tulajdonos>, <Csoport>és <Acl> mezőkben visszaadott felhasználói identitásértékeket a Microsoft Entra objektumazonosítókból egyszerű felhasználónevekké alakítja át. Ha false, az értékek Microsoft Entra objektumazonosítóként lesznek visszaadva. Az alapértelmezett érték a false. Vegye figyelembe, hogy a csoport- és alkalmazásobjektum-azonosítók nincsenek lefordítva, mert nem rendelkeznek egyedi felhasználóbarát névvel.

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álaszfejléc Leírás
Content-Type Azt a formátumot adja meg, amelyben az eredmények vissza lesznek adva. Ez az érték jelenleg application/xml.
x-ms-request-id Ez a fejléc egyedileg azonosítja a végrehajtott kérést, és a kérés hibaelhárításához használható. További információ: API-műveletek hibaelhárítása.
x-ms-version A Blob Storage kérés futtatásához használt verzióját jelzi. Ezt a fejlécet a rendszer a 2009-09-19-es és újabb verzióval küldött kérelmek esetén adja vissza.

Ez a fejléc névtelen kérések esetén is vissza lesz adva egy megadott verzió nélkül, ha a tárolót a Blob Storage 2009-09-19-es verziójával jelölte meg nyilvános hozzáférésre.
Date UTC dátum/idő érték, amely a válasz indításának időpontját jelzi. A szolgáltatás létrehozza ezt az értéket.
x-ms-client-request-id Ezzel a fejlécmel elháríthatja a kéréseket és a megfelelő válaszokat. Ennek az élőfejnek az értéke megegyezik a x-ms-client-request-id fejléc értékével, ha az szerepel a kérelemben. Az érték legfeljebb 1024 látható ASCII-karakter lehet. Ha a x-ms-client-request-id fejléc nem szerepel a kérelemben, akkor ez a fejléc nem jelenik meg a válaszban.

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. A NextMarker elem csak akkor rendelkezik értékkel, ha a lista eredményei nem fejeződnek be.

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

Fontos

A Microsoft azt javasolja, hogy felügyelt identitásokkal használja a Microsoft Entra ID-t az Azure Storage-kérelmek engedélyezéséhez. A Microsoft Entra ID kiváló biztonságot és egyszerű használatot biztosít a megosztott kulcsok engedélyezéséhez képest.

Az Azure Storage támogatja a Microsoft Entra ID használatát a blobadatokra irányuló kérések engedélyezéséhez. A Microsoft Entra ID-val azure-beli szerepköralapú hozzáférés-vezérléssel (Azure RBAC) adhat engedélyeket egy biztonsági tagnak. A biztonsági tag lehet felhasználó, csoport, alkalmazásszolgáltatásnév vagy Azure-beli felügyelt identitás. A biztonsági tagot a Microsoft Entra ID hitelesíti egy OAuth 2.0-jogkivonat visszaadásához. A jogkivonat ezután a Blob szolgáltatással kapcsolatos kérések engedélyezésére használható.

A Microsoft Entra ID használatával történő engedélyezésről további információt A blobok hozzáférésének engedélyezése a Microsoft Entra-azonosítóvalcímű témakörben talál.

Engedélyek

Az alábbiakban azokat az RBAC-műveletet soroljuk fel, amelyek szükségesek ahhoz, hogy egy Microsoft Entra-felhasználó, csoport, felügyelt identitás vagy szolgáltatásnév meghívja a List Blobs műveletet, valamint a legkevésbé kiemelt, beépített Azure RBAC-szerepkört, amely tartalmazza ezt a műveletet:

Ha include=tagsad meg:

A szerepkörök Azure RBAC-vel való hozzárendeléséről további információt Azure-szerepkör hozzárendelése a blobadatokhoz való hozzáféréshezcímű témakörben talál.

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

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.

Komponens Leírás
HTTP-állapotkód A hibát meghatározó standard háromjegyű egész szám.
Hibakód A hibát leíró kulcsszó. Ezt az Azure biztosítja az <ErrorCode> elemben. Ha nem jelenik meg <ErrorCode> elem, a szolgáltatás a HTTP-specifikációban szereplő háromjegyű HTTP-állapotkódhoz társított szabványos hibaszöveget tartalmazó kulcsszót ad vissza. További információ: Common REST API hibakódok.
Információ A hiba részletes leírása idézőjelekben.

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

Fontos

Az itt látható leírásszöveg figyelmeztetés nélkül is változhat, még verziómódosítás nélkül is. Ne hagyatkozz arra, hogy pontosan megfeleltetd ezt a szöveget.

Forgatókönyv Állapotérték másolása Az Állapot leírásának másolása érték
A másolási művelet sikeresen befejeződött. siker üres
A felhasználó megszakította a másolási műveletet, mielőtt befejeződött volna. Megszakadt üres
Hiba történt, amikor a forrásblobból olvas egy másolási művelet során. A művelet újrapróbálkozott. függő 502 BadGateway "Újrapróbálkozható hiba történt a forrás olvasásakor. Újra próbálkozik. A hiba időpontja: <idő>"
Hiba történt a másolási művelet cél blobjára való íráskor. A művelet újrapróbálkozott. függő 500 InternalServerError "Újrapróbálkozható hiba történt. Újra próbálkozik. A hiba időpontja: <idő>"
Helyreállíthatatlan hiba történt egy másolási művelet forrásblobjából való olvasáskor. sikertelen 404 ResourceNotFound "A másolás nem sikerült a forrás olvasása során". Amikor a szolgáltatás ezt a mögöttes hibát jelenti, ResourceNotFound ad vissza a <ErrorCode> elemben. Ha a válaszban nem jelenik meg <ErrorCode> elem, megjelenik a HTTP-állapot szabványos sztringje, például NotFound.
Az összes másolási műveletet korlátozó időtúllépési időszak. (Az időtúllépési időszak jelenleg két hét.) sikertelen 500 OperationCancelled "A másolat túllépte a megengedett maximális időt."
A másolási művelet túl gyakran meghiúsult a forrásból való olvasáskor, és nem felelt meg a sikertelen kísérletek minimális arányának. (Ez az időtúllépés megakadályozza, hogy két héttel a sikertelenség előtt újrapróbálkozzon egy nagyon gyenge forrás. sikertelen 500 OperationCancelled "A másolat nem sikerült a forrás olvasásakor."

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:

Művelet Tárfiók típusa Számlázási kategória
Blobok listázása Prémium szintű blokkblob
Standard általános célú v2
Standard általános célú v1		 Tárolóműveletek listázása és létrehozása

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