Blobok listázása

Cikk
03/16/2023

A List Blobs művelet a megadott tárolóban lévő blobok listáját adja vissza.

Kérés

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

Metódus	Kérés URI-ja	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érést küld az emulált tárolási szolgáltatásra, adja meg az emulátor gazdanevét és Azure Blob Storage portot 127.0.0.1:10000, majd az emulált tárfiók nevét.

Metódus	Kérés URI-ja	HTTP-verzió
`GET`	`http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container&comp=list`	HTTP/1.1

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

URI-paraméterek

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

Paraméter	Leírás
`prefix`	Választható. Szűri az eredményeket, hogy csak a megadott előtaggal kezdődő nevű blobokat adja vissza. A hierarchikus névtérrel rendelkező fiókokban hiba történik azokban az esetekben, amikor egy fájl neve megjelenik az előtag elérési útjának közepén. Megpróbálhatja például megkeresni a nevű `readmefile.txt` blobokat az előtag elérési útján `folder1/folder2/readme/readmefile.txt`. Hiba jelenik meg, ha bármely almappában található egy nevű `readme`fájl.
`delimiter`	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 minden olyan blob helyőrzőjeként működik, amelynek neve ugyanazzal a sztringgel kezdődik, egészen az elválasztó karakter megjelenésétől. Az elválasztó karakter lehet egy karakter vagy egy sztring.
`marker`	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`	Választható. Megadja a visszaadandó blobok maximális számát, beleértve az összes `BlobPrefix` elemet is. Ha a kérés nem adja meg `maxresults`a értéket, vagy 5000-nél nagyobb értéket ad meg, a kiszolgáló legfeljebb 5000 elemet ad vissza. Ha további eredményeket kell visszaadnia, a szolgáltatás egy folytatási jogkivonatot ad vissza a `NextMarker` válaszelemben. Bizonyos esetekben előfordulhat, hogy a szolgáltatás a által `maxresults`megadottnál kevesebb eredményt ad vissza, és egy folytatási jogkivonatot is visszaad. Ha nullánál kisebb vagy egyenlő értékre állítja `maxresults` be a hibát, a 400-es hibakód (hibás kérés) jelenik meg.
`include={snapshots,metadata,uncommittedblobs,copy,deleted,tags,versions,` `deletedwithversions,immutabilitypolicy,legalhold,permissions}`	Választható. Egy vagy több adathalmazt határoz meg, amely szerepel a válaszban: - `snapshots`: Azt adja meg, hogy a pillanatképeknek szerepelnie kell 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`: Megadja, hogy azokat a blobokat, amelyekhez a blokkok fel lettek töltve, de még nem véglegesítve lettek a Put Block List használatával, szerepeljen a válaszban. - `copy`: 2012-02-12-es és újabb verziók. Azt adja meg, hogy az aktuális vagy az előző `Copy Blob` művelethez kapcsolódó metaadatokat szerepeltetni kell a válaszban. -`deleted`: 2017-07-29-es és újabb verziók. Megadja, hogy a helyreállíthatóan törölt blobokat bele kell foglalni a válaszba. -`tags`: 2019-12-12-es és újabb verzió. Megadja, hogy a felhasználó által definiált blobindexcímkék szerepeljenek a válaszban. -`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 adja meg, hogy a (aktív vagy törölt) verziójú törölt blobok szerepelnie kell a válaszban. 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 módosíthatatlansági szabályzatot és a blobok módosíthatatlansági szabályzatmódját. -`legalhold`: 2020-06-12-es és újabb verzió. Meghatározza, hogy az enumerálásnak tartalmaznia kell a blobok jogi célú tárolását. -`permissions`: 2020-06-12-es és újabb verzió. Csak a hierarchikus névtérrel rendelkező fiókok esetében 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 egynél több beállítást szeretne megadni az URI-n, minden beállítást url-kódolású vesszővel (%82) kell elválasztania.
`showonly={deleted,files,directories}`	Választható. A válaszban visszaadandó adathalmazok egyikét adja meg: -`deleted`:Választható. 2020-08-04-es és újabb verzió. Csak hierarchikus névtérrel rendelkező 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` a paraméter is meg van adva, a kérés hibás kéréssel (400) meghiúsul. -`files`:Választható. 2020-12-06-os és újabb verzió. Csak hierarchikus névtérrel rendelkező fiókok esetén. Ha egy kérelem tartalmazza ezt a paramétert, a lista csak fájlokat tartalmaz. -`directories`:Választható. 2020-12-06-os és újabb verzió. Csak hierarchikus névtérrel rendelkező fiókok esetén. Ha egy kérelem tartalmazza ezt a paramétert, a lista csak könyvtárakat tartalmaz.
`timeout`	Választható. A `timeout` paraméter másodpercben van kifejezve. További információ: Időtúllépések beállítása Blob Storage-műveletekhez.

Kérésfejlécek

Az alábbi táblázat a szükséges és nem kötelező kérelemfejléceket ismerteti.

Kérelem fejléce	Leírás
`Authorization`	Kötelező. 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-ba.
`Date` vagy `x-ms-date`	Kötelező. Megadja a kérés egyezményes világidő (UTC) formátumban kifejezett időpontját. További információ: Kérelmek engedélyezése az Azure Storage-ba.
`x-ms-version`	Az összes engedélyezett kéréshez szükséges, a 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`	Választható. Ügyfél által generált, átlátszatlan értéket biztosít egy 1 kib-os (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ó: Monitorozási Azure Blob Storage.
`x-ms-upn`	Választható. Csak akkor érvényes, ha a fiókhoz engedélyezve van egy hierarchikus névtér, és `include=permissions` a kérésben szerepel. Ha `true`, a Tulajdonos>, <Csoport <>és <ACL> mezőkben visszaadott felhasználói identitásértékek Microsoft Entra objektumazonosítókról egyszerű felhasználónevekké alakulnak át. Ha `false`, az értékek Microsoft Entra objektumazonosítóként lesznek visszaadva. Az alapértelmezett érték `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.

A kérés törzse

Nincsenek.

Mintakérés

Lásd: Bloberőforrások számbavétele mintakéréshez.

Reagálás

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

Válaszfejlécek

A műveletre adott válasz 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	Description
`Content-Type`	Azt a formátumot adja meg, amelyben a rendszer visszaadja az eredményeket. Ez az érték jelenleg a .`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. A rendszer ezt a fejlécet adja vissza a 2009-09-19-es és újabb verziójú kérésekhez. Ezt a fejlécet a rendszer névtelen kérések esetén is visszaadja, a megadott verzió nélkül, ha a tárolót a Blob Storage 2009-09-19-es verziójával jelölték 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. A fejléc értéke megegyezik a fejléc értékével `x-ms-client-request-id` , 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álasztörzs

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

Vegye figyelembe, hogy a Prefix, Marker, MaxResultsés Delimiter elemek csak akkor vannak jelen, ha meg lettek adva a kérelem URI-ján. Az NextMarker elem csak akkor rendelkezik értékkel, ha a listaeredmények 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 include kérelem URI-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 List Blobs verziótól kezdődően a következő átnevezett elemeket adja vissza a válasz törzsében:

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)

Az 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 a Blob Put Blob használatával kiszámítja az Content-MD5 értéket, amikor feltölt egy blobot. A Blob Storage ezt nem számítja ki, amikor blobot hoz létre a Tiltólista elhelyezése funkcióval. A blob létrehozásakor explicit módon beállíthatja az Content-MD5 értéket, vagy meghívhatja a Tiltólista elhelyezése vagy a 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ót. A szolgáltatás a 409- (ütközési) á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 jelenik meg.

CopyId, CopyStatus, CopySource, CopyProgress, , CopyCompletionTimeés CopyStatusDescription csak akkor jelenik meg a 2012-02-12-es és újabb verzióban, ha ez a művelet tartalmazza a paramétert include={copy} . Ezek az elemek nem jelennek meg, ha ez a blob még soha nem volt 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 a , Put Blobvagy Put Block Lista használatávalSet Blob Properties. Ezek az elemek nem jelennek meg a Copy Blob által létrehozott blobokkal a 2012-02-12-es verzió előtt.

A 2013-08-15-ös és újabb verzióban az 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 ez a két attribútum együtt lett kombinálva a ContainerName mezőben. A 2013-08-15-ös és újabb verzióban is eltávolítottuk a Url alatti Blob elemet.

A 2015-02-21-es és újabb List Blobs verziók esetében a függvény minden típusú blobot (blokk, oldal és hozzáfűző blob) ad vissza.

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

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

A 2017-04-17-es és újabb verziók esetében a rendszer az AccessTier elemet adja vissza, List Blobs ha a hozzáférési szint kifejezetten be van állítva. Az engedélyezett prémium szintű lapblobszintek listáját lásd: Nagy teljesítményű prémium szintű tárolás és felügyelt lemezek virtuális gépekhez. 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át állapotban van, akkor ArchiveStatus a rendszer az elemet az érvényes értékek egyikével (rehydrate-pending-to-hot, rehydrate-pending-to-coolvagy rehydrate-pending-to-cold) 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 szintek.

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

A 2017-04-17-es és újabb List Blobs verziók esetében a Blob Storage vagy az AccessTierChangeTime általános célú v2-fiókok 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 ábrázolása fejlécekben.

A 2017-07-29-es és újabb verziók esetében a , és akkor jelenik meg, Deletedha a művelet tartalmazza a paramétertinclude={deleted}.RemainingRetentionDaysDeletedTime Ezek az elemek nem jelennek meg, ha ezt a blobot nem törölték. Ezek az elemek a művelettel DELETE törölt blobok vagy pillanatképek esetében jelennek meg, amikor engedélyezve lett a helyreállítható törlés funkció. Az Deleted elem a helyreállíthatóan törölt blobokhoz és pillanatképekhez van beállítva true . Deleted-Time a blob törlésének időpontjának felel meg. RemainingRetentionDays Azt jelzi, hogy hány nap elteltével törölnek véglegesen egy helyreállíthatóan törölt blobot.

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

A 2019-02-02-es és újabb verzió esetén az CustomerProvidedKeySha256 elemet adja vissza, List Blobs 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. Emellett ha a művelet tartalmazza a include={metadata} paramétert, és egy ügyfél által megadott kulccsal titkosított blobon vannak alkalmazás-metaadatok, az Metadata elem attribútummal fog rendelkezni Encrypted="true" . Ez az attribútum azt jelzi, hogy a blob olyan metaadatokkal rendelkezik, amelyek nem fejthetők vissza a List Blobs művelet részeként. A blobok metaadatainak eléréséhez hívja meg a Blob tulajdonságainak lekérése vagy a Blob metaadatainak lekérése az ügyfél által megadott kulccsal.

A 2019-02-02-es és újabb verziók esetében az EncryptionScope elemet adja vissza, List Blobs 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 az Metadata elemben.

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

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

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

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

A 2019-12-12-es és újabb List Blobs verziók esetében a hozzáfűző blobok elemét Sealed adja vissza. Az 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 List Blobs verziók esetében az elemet adja LastAccessTime vissza. Az elem azt mutatja, hogy a blob adatai mikor fértek hozzá utoljára a tárfiók utolsó hozzáférési időkövető szabályzatának megfelelően. 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ési szabályzatának beállításáról a Blob Service API-t ismertető cikkben talál további információt. Az 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 List Blobs verziók esetében a és ImmutabilityPolicyMode az ImmutabilityPolicyUntilDate elemeket adja vissza, ha ez a művelet tartalmazza a paramétertinclude={immutabilitypolicy}.

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

A 2020-06-12-es és újabb verzió esetén a hierarchikus névtérrel rendelkező List Blobs fiókok esetében a Owner, Group, Permissionsés Acl az elemeket adja vissza. A kérelemnek tartalmaznia kell a paramétert include={permissions} . Vegye figyelembe, hogy az 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ó esetén a hierarchikus névtérrel rendelkező List Blobs fiókok esetén a határolóval visszaadja az PropertiesBlobPrefix elem elemét. Ez megfelel a könyvtár tulajdonságainak.

A 2020-08-04-es és újabb verzió esetén a hierarchikus névtérrel rendelkező List Blobs fiókok esetében a DeletionId törölt blobok 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 azt az azonos elérési úttal rendelkező többi törölt blobtól.

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

A 2021-02-12-es és újabb List Blobs verziók esetében az összes BlobName vagy BlobPrefixName elemérték (RFC 2396 szerint) százalékban lesz kódolva. Konkrétan a nem XML-ben érvényes karaktereket tartalmazó értékek esetében (U+FFFE vagy U+FFFF) teszi ezt meg. Kódolás esetén az Name elem tartalmaz egy Encoded=true attribútumot. Vegye figyelembe, hogy ez csak az Name XML-ben érvénytelen karaktereket tartalmazó elemértékek esetében fordul elő, a válasz többi Name eleme nem.

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

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

A 2020-02-10-es és újabb verzió esetén a hierarchikus névtérrel rendelkező List Blobs fiókok esetében a Expiry-Time törölt blobok elemét adja vissza. Expiry-Time az az idő, amikor a fájl lejár, és a rendszer visszaadja a fájlnak, ha a lejárat ugyanazon az időponton van beállítva.

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

Lásd: Bloberőforrások számbavétele a mintaválaszhoz.

Engedélyezés

Az Azure Storage-ban bármilyen adathozzáférési művelet meghívásához engedélyezésre van szükség. A műveletet az List Blobs alábbiak szerint engedélyezheti.

Az Azure Storage támogatja az Microsoft Entra ID használatát a blobadatokra irányuló kérések engedélyezéséhez. A Microsoft Entra ID azure-beli szerepköralapú hozzáférés-vezérléssel (Azure RBAC) adhat engedélyeket egy biztonsági tagnak. A rendszerbiztonsági tag lehet felhasználó, csoport, alkalmazásszolgáltatásnév vagy Azure-beli felügyelt identitás. A rendszerbiztonsá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 szembeni kérések engedélyezésére használható.

További információ a Microsoft Entra ID használatával történő engedélyezésről: Blobok hozzáférésének engedélyezése Microsoft Entra ID használatával.

Engedélyek

Az alábbiakban azokat az RBAC-műveletet soroljuk fel, amelyek szükségesek ahhoz, hogy egy Microsoft Entra felhasználó, csoport 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:

Azure RBAC-művelet:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read
Legkevésbé emelt szintű beépített szerepkör:Storage Blob-adatolvasó

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

A közös hozzáférésű jogosultságkód (SAS) biztonságos delegált hozzáférést biztosít a tárfiók erőforrásaihoz. Sas esetén részletes vezérléssel rendelkezik arról, hogy az ügyfél hogyan férhet hozzá az adatokhoz. Megadhatja, hogy az ügyfél milyen erőforráshoz férhet hozzá, milyen engedélyekkel rendelkezik ezekhez az erőforrásokhoz, és hogy az SAS mennyi ideig érvényes.

A List Blobs művelet háromféle közös hozzáférésű jogosultságkódot támogat: a felhasználói delegálási SAS-t, a szolgáltatás SAS-t és a fiók SAS-t.

Ajánlott biztonsági gyakorlatként azt javasoljuk, hogy a tárfiókkulcs helyett Microsoft Entra hitelesítő adatokat használjon, amelyek könnyebben sérülhetnek. Ha az alkalmazás kialakításához közös hozzáférésű jogosultságkódra van szükség, Microsoft Entra hitelesítő adatokkal hozzon létre egy felhasználói delegálási SAS-t, ha lehetséges.

Ha a megosztott kulcs hozzáférése nincs engedélyezve a tárfiókhoz, a Blob Storage-ra irányuló kérések esetén a szolgáltatás SAS-jogkivonata vagy a fiók SAS-jogkivonata nem lesz engedélyezve. További információ: A megosztott kulcs letiltása hogyan befolyásolja az SAS-jogkivonatokat.

Felhasználói delegálási SAS

A felhasználói delegálási SAS-t Microsoft Entra hitelesítő adatokkal és az SAS-hez megadott engedélyekkel védik.

A List Blobs művelet tárolóerőforráshoz delegált SAS-jogkivonat használatával történő meghívásához a listához (l) szükséges a felhasználói delegálási SAS-jogkivonat részeként.

A felhasználói delegálási SAS-ről további információt a Felhasználói delegálási SAS létrehozása című témakörben talál.

Szolgáltatás SAS

A szolgáltatás SAS-t a tárfiókkulcs védi. A szolgáltatás sasa egyetlen Azure Storage-szolgáltatásban, például a blobtárolóban delegálja a hozzáférést egy erőforráshoz.

A List Blobs művelet tárolóerőforráshoz delegált SAS-jogkivonat használatával történő meghívásához a szolgáltatás SAS-jogkivonatának részeként a List (l) engedély szükséges.

A szolgáltatás SAS-járól további információt a Szolgáltatás SAS létrehozása című témakörben talál.

Fiók SAS-fiókja

A fiók SAS-jének biztonságát a tárfiókkulcs biztosítja. A fiókalapú SAS egy vagy több tárolószolgáltatás erőforrásaihoz nyújt hozzáférést. A szolgáltatáson vagy a felhasználói delegálási SAS-en keresztül elérhető összes művelet fiók SAS-en keresztül is elérhető.

Az alábbi táblázat az aláírt erőforrástípust és az aláírt engedélyeket jelzi, amelyet a hozzáférés delegálásakor meg kell adni:

Művelet	Aláírt szolgáltatás	Aláírt erőforrástípus	Aláírt engedély
Blobok listázása	Blob (b)	Tároló (c)	Lista (l)

További információ a fiók SAS-járól: Fiók SAS létrehozása.

Megjegyzések

Blobtulajdonságok a válaszban

Ha azt 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 rendszer csak oldalblobok esetén adja vissza az elemet.

Az OrMetadata elem csak blokkblobok esetén lesz visszaadva.

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

Az 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 tulajdonságot a Content-MD5 blob létrehozásakor vagy a Blob tulajdonságainak beállítása meghívásával állíthatja be. A 2012-02-12-es és újabb Put Blob verzióban 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

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

Vegye figyelembe, hogy az ezzel a paraméterrel kért metaadatokat a Blob Storage 2009-09-19 verziójának elnevezési korlátozásaival összhangban kell tárolni. Ezzel a verzióval kezdődően minden metaadatnévnek meg kell felelnie a C#-azonosítók elnevezé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 jelzi a problémás nevet egy elemen x-ms-invalid-name belül. 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

Az 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. TagSet Az elemen belül legfeljebb 10 Tag elem lesz visszaadva, amelyek mindegyike tartalmazza a és a valuekey felhasználó által definiált blobindex-címkéket. A címkék sorrendje nem garantált a válaszban.

A Tags és TagCount az elemek nem lesznek visszaadva, ha nincsenek címkék a blobon.

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

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-n. A válaszban felsorolt pillanatképek nem tartalmazzák az LeaseStatus elemet, mert a pillanatképek nem rendelkezhetnek aktív bérletekkel.

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

Nem véglegesített blobok a válaszban

A nem véglegesített blobok csak akkor szerepelnek a válaszban, ha a include=uncommittedblobs paramétert az URI-n adták meg. A válaszban felsorolt, nem véglegesített blobok nem tartalmazzák az alábbi elemeket:

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-n. A válaszban felsorolt törölt blobok nem tartalmazzák a Bérlet elemet, mert a törölt blobok nem rendelkezhetnek aktív bérletekkel.

A törölt pillanatképek szerepelnek a listaválaszban, ha include=deleted,snapshot az URI-ban meg van adva.

Objektumreplikációs metaadatok a válaszban

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

  
…  
<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 az 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 mentesség a válaszban

Az 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 értéket ad meg a maxresults paraméterhez, és a visszaadandó blobok száma meghaladja ezt az értéket, vagy meghaladja a paraméter alapértelmezett értékét maxresults, a választörzs tartalmaz egy NextMarker elemet. Ez az elem a következő blobot jelzi, amely egy későbbi kérelemre tér vissza. Bizonyos esetekben a szolgáltatás akkor is visszaadhatja az NextMarker elemet, ha a visszaadott eredmények száma kisebb, mint a értéke maxresults.

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

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

A delimiter paraméter lehetővé teszi, hogy a hívó felhasználó által konfigurált elválasztó használatával lépjen á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 rendszer az elemet az összes olyan blob helyett adja vissza, amelynek neve ugyanazzal az alkarakterrel kezdődik, egészen a határoló karakter megjelenésig. Az elem értéke BlobPrefixa substring+halimiter, ahol a sztring az egy vagy több blobneveket elindító gyakori részsztring, a határoló pedig a delimiter paraméter értéke.

Az érték BlobPrefix használatával további hívást kezdeményezhet az ezzel az előtaggal kezdődő blobok listázására. Ehhez adja meg a paraméter értékét BlobPrefix a prefix kérelem URI-ján.

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

A blobok betűrendben jelennek meg a válasz törzsében, és a nagybetűk jelennek meg először.

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, CopyStatus a beállítás értéke pending , ha a Blob Storage továbbra is újrapróbálkozást hajt végre a művelettel. A CopyStatusDescription szöveg azt a hibát írja le, amely az utolsó másolási kísérlet során fordulhatott elő.
Ha CopyStatus a értékre failedvan á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.

Összetevő	Leírás
HTTP-állapotkód	Standard háromjegyű egész szám, amely megadja a hibát.
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 egy kulcsszót ad vissza, amely a HTTP-specifikációban szereplő háromjegyű HTTP-állapotkódhoz társított szabványos hibaszöveget tartalmazza. További információ: Common REST API hibakódok.
Tájékoztatás	A hiba részletes leírása idézőjelekben.

Az alábbi táblázat a CopyStatus gyakori hibaforgatókönyvek és CopyStatusDescription -értékek leírását 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 ezt a szöveget egyeztesd.

Eset	Állapotérték másolása	Állapot leírásának másolása érték
A másolási művelet sikeresen befejeződött.	sikeres	ü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 rendszer újra meg fogja próbálni végrehajtani a műveletet.	függőben	502 BadGateway "Újrapróbálkozható hibát észlelt a forrás beolvasásakor. Újra próbálkozik. Hiba időpontja: <idő>"
Hiba történt egy másolási művelet célblobjára való íráskor. A rendszer újra meg fogja próbálni végrehajtani a műveletet.	függőben	500 InternalServerError "Újrapróbálkozható hibát észlelt. Újra próbálkozik. 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 beolvasásakor". Amikor a szolgáltatás ezt a mögöttes hibát jelenti, az <ErrorCode> elemben jelenik `ResourceNotFound` meg. Ha a válaszban nem <jelent meg ErrorCode> elem, megjelenik a HTTP-állapot szabványos sztringje, például `NotFound`a .
Az összes másolási műveletet korlátozó időkorlát. (Az időtúllépési időszak jelenleg két hét.)	sikertelen	500 OperationCancelled "A másolat túllépte a maximálisan engedélyezett időt."
A másolási művelet túl gyakran meghiúsult a forrásból való beolvasáskor, és nem felelt meg a sikeres 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ással).	sikertelen	500 OperationCancelled "A másolat nem sikerült a forrás beolvasá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 befolyásolja a fiók terhelését. 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 a kérelmek számlázási kategóriáját List Blobs 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 a Azure Blob Storage Díjszabás című témakörben talál további információt.

Lásd még

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