Blob lekérése

A Get Blob művelet beolvas vagy letölt egy blobot a rendszerből, beleértve annak metaadatait és tulajdonságait. A pillanatképek olvasásához hívást is kezdeményezhet Get Blob .

Kérés

A kérést az Get Blob alábbiak szerint hozhatja létre. Javasoljuk, hogy HTTPS-t használjon. Cserélje le a myaccount kifejezést a tárfiók nevére:

GET metóduskérés URI-ja	HTTP-verzió
https://myaccount.blob.core.windows.net/mycontainer/myblob https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime> https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime>	HTTP/1.0 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:

GET metóduskérés URI-ja	HTTP-verzió
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob	HTTP/1.0 HTTP/1.1

További információ: Az Azure Storage Emulator használata fejlesztéshez és teszteléshez.

URI-paraméterek

A kérelem URI-ja a következő további paramétereket határozhatja meg:

Paraméter	Leírás
snapshot	Választható. A pillanatkép paraméter egy átlátszatlan DateTime érték, amely jelen esetben meghatározza a lekérni kívánt blobpillanatképet. A blobpillanatképek használatával kapcsolatos további információkért lásd: Létrehozás egy blob pillanatképét.
versionid	Nem kötelező, 2019-12-12-es és újabb verzió. A versionid paraméter egy átlátszatlan DateTime érték, amely jelen esetben meghatározza a lekérni kívánt blob verzióját.
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	Minden engedélyezett kéréshez szükséges. Névtelen kérések esetén nem kötelező. A kérelemhez használandó művelet verzióját adja meg. Ha ez a fejléc nincs megadva egy névtelen kéréshez, akkor a szolgáltatás a kérést a 2009-09-19-es verzióval hajtja végre. További információ: Az Azure Storage-szolgáltatások verziószámozása.
Range	Választható. A blob bájtjainak visszaadása csak a megadott tartományban.
x-ms-range	Választható. A blob bájtjainak visszaadása csak a megadott tartományban. Ha a és x-ms-range a érték is Range meg van adva, a szolgáltatás a értékét x-ms-rangehasználja. Ha egyik tartomány sincs megadva, a rendszer a teljes blobtartalmat adja vissza. További információ: A Blob Storage-műveletek tartományfejlécének megadása.
x-ms-lease-id: <ID>	Választható. Ha ez a fejléc van megadva, a művelet csak akkor lesz végrehajtva, ha az alábbi feltételek teljesülnek: – A blob bérlete jelenleg aktív. – A kérelemben megadott bérletazonosító megegyezik a blob bérletazonosítójával. Ha ez a fejléc meg van adva, de egyik feltétel sem teljesül, a kérés meghiúsul, és a művelet a Get Blob 412-s állapotkóddal meghiúsul (az előfeltétel sikertelen).
x-ms-range-get-content-md5: true	Választható. Ha a fejléc értéke és a fejléc együtt Range van true megadva, a szolgáltatás visszaadja a tartomány MD5-kivonatát, feltéve, hogy a tartomány mérete kisebb vagy egyenlő 4 bájtnál (MiB). Ha a fejléc fejléc nélkül Range van megadva, a szolgáltatás a 400-ás állapotkódot adja vissza (hibás kérés). Ha a fejléc értéke true akkor van beállítva, ha a tartomány meghaladja a 4 MiB-t, a szolgáltatás a 400 -os állapotkódot adja vissza (hibás kérés).
x-ms-range-get-content-crc64: true	Választható. Ha a fejléc értéke és a fejléc együtt Range van true megadva, a szolgáltatás a tartomány CRC64-kivonatát adja vissza, feltéve, hogy a tartomány kisebb vagy egyenlő 4 MiB-nél. Ha a fejléc fejléc nélkül Range van megadva, a szolgáltatás a 400-ás állapotkódot adja vissza (hibás kérés). Ha a fejléc értéke true akkor van beállítva, ha a tartomány meghaladja a 4 MiB-t, a szolgáltatás a 400 -os állapotkódot adja vissza (hibás kérés). Ha a és x-ms-range-get-content-crc64 a x-ms-range-get-content-md5 fejléc is jelen van, a kérés 400-zal (hibás kéréssel) meghiúsul. Ez a fejléc a 2019-02-02-s és újabb verziókban támogatott.
Origin	Választható. Meghatározza, hogy a kérelem melyik forrásból legyen kibocsátva. Ennek a fejlécnek a jelenléte az eltérő eredetű erőforrások megosztását (CORS) eredményezi a válaszban.
x-ms-upn	Választható. 2023-11-03-es és újabb verzió. Érvényes a hierarchikus névtérrel rendelkező fiókokra. Ha igaz, a , x-ms-group és x-ms-acl válaszfejlécekben x-ms-ownervisszaadott felhasználói identitásértékek Microsoft Entra objektumazonosítókból egyszerű felhasználónevekké alakulnak át. Ha az érték hamis, a függvény Microsoft Entra objektumazonosítóként adja vissza őket. Az alapértelmezett érték: hamis. Vegye figyelembe, hogy a csoport- és alkalmazásobjektum-azonosítók nincsenek lefordítva, mert nem rendelkeznek egyedi felhasználóbarát névvel.
x-ms-client-request-id	Választható. Ügyfél által generált, átlátszatlan értéket biztosít egy 1 kibibyte (KiB) karakterkorláttal, amelyet a rendszer akkor rögzít az elemzési naplókban, ha engedélyezve van a tárolóelemzés naplózása. Erősen ajánlott ezt a fejlécet használni, ha az ügyféloldali tevékenységeket a kiszolgáló által fogadott kérésekkel korrelálja. További információ: Tudnivalók az Azure Storage Analytics naplózásáról.

Ez a művelet a feltételes fejlécek használatát is támogatja a blob olvasásához, ha egy adott feltétel teljesül. További információ: Feltételes fejlécek megadása Blob Storage-műveletekhez.

Kérelemfejlécek (ügyfél által biztosított titkosítási kulcsok)

A 2019-02-02-es verziótól az ügyfél által megadott kulccsal titkosított blob olvasására vonatkozó kéréshez a következő fejléceket adhatja meg. Az ügyfél által megadott kulccsal (és a megfelelő fejléckészlettel) történő titkosítás nem kötelező. Ha egy blobot korábban ügyfél által megadott kulccsal titkosítottak, az olvasási művelet sikeres befejezéséhez fel kell vennie ezeket a fejléceket a kérelembe.

Kérelem fejléce	Leírás
x-ms-encryption-key	Kötelező. A Base64 kódolású AES-256 titkosítási kulcs.
x-ms-encryption-key-sha256	Választható. A titkosítási kulcs Base64 kódolású SHA256 kivonata.
x-ms-encryption-algorithm: AES256	Kötelező. Megadja a titkosításhoz használandó algoritmust. A fejléc értékének a következőnek kell lennie AES256: .

A kérés törzse

Nincsenek.

Reagálás

A válasz tartalmazza a HTTP-állapotkódot, a válaszfejlécek készletét és a válasz törzsét, amely a blob tartalmát tartalmazza.

Állapotkód

A teljes blob olvasásának sikeres művelete a 200-ra (OK) vonatkozó állapotkódot adja vissza.

A megadott tartomány olvasására irányuló sikeres művelet a 206-os állapotkódot (részleges tartalom) adja vissza.

További információ az állapotkódokról: Á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.

Syntax	Description
Last-Modified	A blob utolsó módosításának dátuma/időpontja. A dátumformátum az RFC 1123-at követi. Minden olyan művelet, amely módosítja a blobot, beleértve a blob metaadatainak vagy tulajdonságainak frissítését, megváltoztatja a blob utolsó módosítási időpontját.
x-ms-creation-time	2017-11-09-es és újabb verzió. A blob létrehozásának dátuma/időpontja. A dátumformátum az RFC 1123-at követi.
x-ms-meta-name:value	A blobhoz felhasználó által definiált metaadatokként társított név-érték párok halmaza.
x-ms-tag-count	2019-12-12-es és újabb verzió. Ha a blob tartalmaz címkéket, ez a fejléc a blobon tárolt címkék számát adja vissza. A rendszer nem adja vissza a fejlécet, ha nincsenek címkék a blobon.
Content-Length	A válasz törzsében található bájtok száma.
Content-Type	A blobhoz megadott tartalomtípus. Az alapértelmezett tartalomtípus: application/octet-stream.
Content-Range	Azt a bájttartományt jelzi, amelyet abban az esetben ad vissza, ha az ügyfél a kérelem fejlécének beállításával Range kérte a blob egy részhalmazát.
ETag	Olyan értéket tartalmaz, amellyel feltételesen hajthat végre műveleteket. További információ: Feltételes fejlécek megadása Blob Storage-műveletekhez. Ha a kérelem verziója 2011-08-18 vagy újabb, az ETag értéke idézőjelek közé kerül.
Content-MD5	Ha a blob MD5 kivonattal rendelkezik, és ez a Get Blob művelet a teljes blob olvasása, a rendszer visszaadja ezt a válaszfejlécet, hogy az ügyfél ellenőrizze az üzenettartalom integritását. A 2012-02-12-es és újabb verzióban akkor is beállítja a blokkblob MD5 kivonatértékét, Put Blob ha a Put Blob kérés nem tartalmaz MD5-fejlécet. Ha a kérelem egy megadott tartomány beolvasására szolgál, és a x-ms-range-get-content-md5 értéke true, a kérelem egy MD5-kivonatot ad vissza a tartományhoz, feltéve, hogy a tartomány mérete kisebb vagy egyenlő 4 MiB-nél. Ha egyik feltételkészlet sem az true, a fejléchez Content-MD5 nem ad vissza értéket. Ha x-ms-range-get-content-md5 a Range fejléc nélkül van megadva, a szolgáltatás a 400-ás állapotkódot adja vissza (hibás kérés). Ha x-ms-range-get-content-md5 a tartomány 4 MiB-t meghaladó értékre van állítva true , a szolgáltatás a 400-ás állapotkódot adja vissza (hibás kérelem).
x-ms-content-crc64	Ha a kérelem egy megadott tartomány beolvasására szolgál, és a x-ms-range-get-content-crc64 értéke true, a kérelem egy CRC64-kivonatot ad vissza a tartományhoz, feltéve, hogy a tartomány mérete kisebb vagy egyenlő 4 MiB-nél. Ha x-ms-range-get-content-crc64 a Range fejléc nélkül van megadva, a szolgáltatás a 400-ás állapotkódot adja vissza (hibás kérés). Ha x-ms-range-get-content-crc64 a tartomány 4 MiB-t meghaladó értékre van állítva true , a szolgáltatás a 400-ás állapotkódot adja vissza (hibás kérelem).
Content-Encoding	A kérelemfejléchez Content-Encoding megadott értéket adja vissza.
Content-Language	A kérelemfejléchez Content-Language megadott értéket adja vissza.
Cache-Control	Akkor adja vissza, ha a fejléc korábban meg lett adva a blobhoz.
Content-Disposition	A 2013-08-15-ös és újabb verzióval kapcsolatos kérések esetén ad vissza. Ez a fejléc a fejléchez x-ms-blob-content-disposition megadott értéket adja vissza. A Content-Disposition válaszfejléc mező további információkat közöl a válasz hasznos adatainak feldolgozásáról, és további metaadatok csatolására használható. Ha például a fejléc attachmentértéke , az azt jelzi, hogy a felhasználó-ügynök nem jelenítse meg a választ. Ehelyett egy Mentés másként párbeszédpanelt jelenít meg a megadott blobnéven kívül más fájlnévvel.
x-ms-blob-sequence-number	Egy lapblob aktuális sorszáma. Ez a fejléc nem jelenik meg blokkblobok vagy hozzáfűző blobok esetén.
x-ms-blob-type: <BlockBlob | PageBlob | AppendBlob>	A blob típusát adja vissza.
x-ms-copy-completion-time: <datetime>	2012-02-12-es és újabb verzió. Annak a legutóbbi kísérletnek Copy Blob a befejezési ideje, amelyben ez a blob volt a célblob. Ez az érték megadhatja a befejezett, megszakított vagy sikertelen másolási kísérletek időpontját. Ez az élőfej nem jelenik meg, ha egy másolat függőben van, ha ez a blob még soha nem volt cél egy Copy Blob műveletben, vagy ha a blobot módosították egy befejezett Copy Blob művelet után, amely a , Put Blobvagy Put Block Lista fájlt használtaSet Blob Properties.
x-ms-copy-status-description: <error string>	2012-02-12-es és újabb verzió. Csak akkor jelenik meg, ha x-ms-copy-status vagy failedpending. Az utolsó végzetes vagy nem végzetes másolási művelet okának ismertetése. Ez a fejléc nem jelenik meg, ha ez a blob még soha nem volt cél egy Copy Blob műveletben, vagy ha ezt a blobot módosították egy befejezett Copy Blob művelet után, amelyet használt Set Blob Properties, Put Blobvagy Put Block List.
x-ms-copy-id: <id>	2012-02-12-es és újabb verzió. A legutóbb megkísérelt Copy Blob művelet sztringazonosítója, ahol ez a blob volt a célblob. Ez a fejléc nem jelenik meg, ha ez a blob még soha nem volt cél egy Copy Blob műveletben, vagy ha ezt a blobot módosították egy befejezett Copy Blob művelet után, amelyet használt Set Blob Properties, Put Blobvagy Put Block List.
x-ms-copy-progress: <bytes copied/bytes total>	2012-02-12-es és újabb verzió. A másolt bájtok számát és a forrásban lévő összes bájtot tartalmazza az utolsó olyan Copy Blob műveletben, amelyben ez a blob volt a célblob. A program 0 és bájt között képes megjeleníteni a Content-Length másolt értékeket. Ez a fejléc nem jelenik meg, ha ez a blob még soha nem volt cél egy Copy Blob műveletben, vagy ha ezt a blobot módosították egy befejezett Copy Blob művelet után, amelyet használt Set Blob Properties, Put Blobvagy Put Block List.
x-ms-copy-source: url	2012-02-12-es és újabb verzió. Egy legfeljebb 2 KiB hosszúságú URL-cím, amely meghatározza a legutóbb megkísérelt Copy Blob műveletben használt forrásblobot vagy fájlt, ahol ez a blob volt a célblob. Ez a fejléc nem jelenik meg, ha ez a blob még soha nem volt cél egy Copy Blob műveletben, vagy ha ezt a blobot módosították egy befejezett Copy Blob művelet után, amelyet használt Set Blob Properties, Put Blobvagy Put Block List. Az ebben a fejlécben visszaadott URL-cím tartalmazza a forrásblob másolási műveletében használt kérésparamétereket, beleértve a forrásblob eléréséhez használt közös hozzáférésű jogosultságkód (SAS) jogkivonatot is.
x-ms-copy-status: <pending | success | aborted | failed>	2012-02-12-es és újabb verzió. Az x-ms-copy-id által azonosított másolási művelet állapota az alábbi értékekkel: - success: A másolás sikeresen befejeződött. - pending: A másolás folyamatban van. Ellenőrizze x-ms-copy-status-description , hogy az időszakos, nem végzetes hibák lassítják-e a másolási folyamatot, de nem okoznak-e hibát. - aborted: A másolás a következővel fejeződött be Abort Copy Blob: . - failed: A másolás nem sikerült. A hiba részleteiért tekintse meg az x-ms-copy-status-description fájlt. Ez a fejléc nem jelenik meg, ha ez a blob még soha nem volt cél egy Copy Blob műveletben, vagy ha ezt a blobot módosították egy befejezett Copy Blob művelet után, amelyet használt Set Blob Properties, Put Blobvagy Put Block List.
x-ms-lease-duration: <infinite | fixed>	2012-02-12-es és újabb verzió. Blob bérlete esetén meghatározza, hogy a bérlet végtelen vagy rögzített időtartamú-e.
x-ms-lease-state: <available | leased | expired | breaking | broken>	2012-02-12-es és újabb verzió. A blob bérletállapota.
x-ms-lease-status:<locked | unlocked>	A blob aktuális bérletállapota.
x-ms-request-id	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 kérés végrehajtásához használt Blob Storage-verziót jelzi. A 2009-09-19-es és újabb verzióval végrehajtott kérelmekhez tartozik. Ez a fejléc egy megadott verzió nélküli névtelen kérés esetén is vissza lesz adva, 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.
Accept-Ranges: bytes	Azt jelzi, hogy a szolgáltatás támogatja a részleges blobtartalomra vonatkozó kéréseket. A 2011-08-18-es és újabb verzióval, valamint az SDK 1.6-os és újabb verziójában elérhető helyi tárolási szolgáltatással érkező kérésekhez tartozik.
Date	A szolgáltatás által létrehozott UTC dátum/idő érték, amely a válasz indításának időpontját jelzi.
Access-Control-Allow-Origin	Akkor adja vissza, ha a kérelem fejlécet Origin tartalmaz, és a CORS engedélyezve van egyező szabmánnyal. Ez a fejléc a forráskérés fejlécének értékét adja vissza egyezés esetén.
Access-Control-Expose-Headers	Akkor adja vissza, ha a kérelem fejlécet Origin tartalmaz, és a CORS engedélyezve van egyező szabmánnyal. Visszaadja azoknak a válaszfejléceknek a listáját, amelyeket elérhetővé kell tenni az ügyfélnek vagy a kérés kiállítójának.
Vary	A cors-szabályok megadásakor a Origin fejléc értékével adja vissza. További részletekért lásd : CORS-támogatás az Azure Storage-szolgáltatásokhoz .
Access-Control-Allow-Credentials	Akkor adja vissza, ha a kérelem tartalmaz egy fejlécet Origin , és a CORS engedélyezve van egyező szabálysal, amely nem engedélyezi az összes forrást. Ez a fejléc a következőre truelesz állítva: .
x-ms-blob-committed-block-count	A blobban található véglegesített blokkok száma. Ez a fejléc csak hozzáfűző blobokhoz lesz visszaadva.
x-ms-server-encrypted: true/false	2015-12-11-es és újabb verziók. Ennek a fejlécnek az értéke akkor van beállítva true , ha a blobadatok és az alkalmazás metaadatai teljes mértékben titkosítva vannak a megadott algoritmussal. Ellenkező esetben az érték értékre false van állítva (ha a blob titkosítatlan, vagy ha csak a blob vagy az alkalmazás metaadatainak egy része van titkosítva).
x-ms-encryption-key-sha256	2019-02-02-es és újabb verzió. Ez a fejléc akkor jelenik meg, ha a blob ügyfél által megadott kulccsal van titkosítva.
x-ms-encryption-context	2021-08-06-os és újabb verzió. Ha a titkosítási környezet tulajdonságértéke be van állítva, akkor a beállított értéket adja vissza. Csak akkor érvényes, ha a fiókhoz engedélyezve van a hierarchikus névtér.
x-ms-encryption-scope	2019-02-02-es és újabb verzió. Ez a fejléc akkor jelenik meg, ha a blob titkosítási hatókörrel van titkosítva.
x-ms-blob-content-md5	2016-05-31-es és újabb verzió. Ha a blob MD5-kivonattal rendelkezik, és a kérelem tartományfejlécet (Tartomány vagy x-ms-tartomány) tartalmaz, a rendszer ezt a válaszfejlécet adja vissza a teljes blob MD5-értékével. Ez az érték lehet vagy nem egyenlő a Content-MD5 fejlécben visszaadott értékkel, és az utóbbit a kért tartományból számítja ki.
x-ms-client-request-id	A kérések és a megfelelő válaszok hibaelhárítására használható. A fejléc értéke megegyezik a x-ms-client-request-id kérelemben szereplő fejléc értékével, és az érték legfeljebb 1024 látható ASCII-karaktert tartalmaz. Ha a x-ms-client-request-id fejléc nem szerepel a kérelemben, akkor ez a fejléc nem szerepel a válaszban.
x-ms-last-access-time	2020-02-10-es és újabb verzió. Azt jelzi, hogy mikor fértek hozzá utoljára a blob adatai a tárfiók legutóbbi hozzáférési időkövető szabályzata alapján. A rendszer nem adja vissza a fejlécet, ha a tárfiók nem rendelkezik utolsó hozzáférési időkövetési szabályzattal, vagy ha a szabályzat le van tiltva. A tárfiók utolsó hozzáférési időkövetési szabályzatának beállításával kapcsolatos információkért lásd: Blob Service API.
x-ms-blob-sealed	2019-12-12-es és újabb verzió. Csak hozzáfűző blobokhoz ad vissza. Ha a hozzáfűző blobot lezárták, az érték a következő lesz true: . További információ: Hozzáfűző blobzár
x-ms-immutability-policy-until-date	2020-06-12-es és újabb verzió. Megadja a megőrzési dátumot a blobon beállított dátumig . Ez az a dátum, amíg a blob nem módosítható vagy törölhető. Csak akkor adja vissza, ha a blobon módosíthatatlansági szabályzat van beállítva. A fejléc értéke RFC1123 formátumban van.
x-ms-immutability-policy-mode: unlocked/locked	2020-06-12-es és újabb verzió. Akkor adja vissza, ha a blobon módosíthatatlansági szabályzat van beállítva. Az értékek a következők: unlocked és locked. unlocked azt jelzi, hogy a felhasználó módosíthatja a szabályzatot a megőrzés dátumig történő növelésével vagy csökkentésével. locked azt jelzi, hogy ezek a műveletek tiltottak.
x-ms-legal-hold: true/false	2020-06-12-es és újabb verzió. Ez a fejléc nem lesz visszaadva, ha nincs jogi célú visszatartás a blobon. Ennek a fejlécnek az értéke akkor true van beállítva, ha a blob jogi célú visszatartást tartalmaz, és értéke true. Ellenkező esetben az érték értékre false van állítva, ha a blob jogi célú visszatartást tartalmaz, és értéke false.
x-ms-owner	2020-06-12-es és újabb verzió, csak a hierarchikus névtérrel rendelkező fiókok esetében. A fájl vagy könyvtár tulajdonos-felhasználóját adja vissza.
x-ms-group	2020-06-12-es és újabb verzió, csak a hierarchikus névtérrel rendelkező fiókok esetében. A fájl vagy könyvtár tulajdonoscsoportját adja vissza.
x-ms-permissions	2020-06-12-es és újabb verzió, csak a hierarchikus névtérrel rendelkező fiókok esetében. Visszaadja a felhasználó, csoport és egyéb engedélyeket a fájlban vagy könyvtárban. Minden egyes engedély formátuma [r,w,x,-]{3} .
x-ms-acl	2023-11-03-es és újabb verzió. Csak a hierarchikus névtérrel rendelkező fiókok esetében. A felhasználó,csoport és más fájlokhoz vagy címtárakhoz beállított hozzáférési és alapértelmezett hozzáférés-vezérlési lista kombinált listáját adja vissza. Minden hozzáférés-vezérlési bejegyzés (ACE) egy hatókörből, egy típusból, egy felhasználó- vagy csoportazonosítóból és a formátumú [scope]:[type]:[id]:[permissions]engedélyekből áll. A default hatókör azt jelzi, hogy az ACE egy könyvtár alapértelmezett ACL-jéhez tartozik; ellenkező esetben a hatókör implicit, az ACE pedig a hozzáférési ACL-hez tartozik. Minden egyes engedély formátuma [r,w,x,-]{3} .
x-ms-resource-type	2020-10-02-es és újabb verzió, csak a hierarchikus névtérrel rendelkező fiókok esetében. Az elérési út erőforrástípusát adja vissza, amely lehet file vagy directory.

Választörzs

A válasz törzse tartalmazza a blob tartalmát.

Mintaválasz

Status Response:  
HTTP/1.1 200 OK  
  
Response Headers:  
x-ms-blob-type: BlockBlob  
x-ms-lease-status: unlocked  
x-ms-lease-state: available  
x-ms-meta-m1: v1  
x-ms-meta-m2: v2  
Content-Length: 11  
Content-Type: text/plain; charset=UTF-8  
Date: <date>  
ETag: "0x8CB171DBEAD6A6B"  
Vary: Origin  
Last-Modified: <date>  
x-ms-version: 2015-02-21  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-copy-id: 36650d67-05c9-4a24-9a7d-a2213e53caf6  
x-ms-copy-source: <url>  
x-ms-copy-status: success  
x-ms-copy-progress: 11/11  
x-ms-copy-completion-time: <date>  
  

Engedélyezés

Az azure storage-beli adathozzáférési műveletek meghívásakor engedélyezés szükséges. A műveletet az Get Blob alábbiak szerint engedélyezheti.

Fontos

A Microsoft a Microsoft Entra ID felügyelt identitásokkal való használatát javasolja az Azure Storage felé irányuló kérések engedélyezéséhez. Microsoft Entra ID a megosztott kulcsos hitelesítéshez képest kiemelkedő biztonságot és könnyű használatot biztosít.

Microsoft Entra ID (ajánlott)

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 azure-beli szerepköralapú hozzáférés-vezérléssel (Azure RBAC) adhat engedélyeket egy rendszerbiztonsági tagnak. A rendszerbiztonsági tag lehet felhasználó, csoport, alkalmazás-szolgáltatásnév vagy Azure-beli felügyelt identitás. A rendszerbiztonsági tag hitelesítését a Microsoft Entra ID végzi egy OAuth 2.0-jogkivonat visszaadásához. A jogkivonat ezután a Blob szolgáltatásra irányuló 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: Blobokhoz való hozzáférés 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, felügyelt identitás vagy szolgáltatásnév meghívja a műveletet, valamint a legkevésbé emelt jogosultságú beépített Azure RBAC-szerepkört, amely tartalmazza ezt a Get Blob műveletet:

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

A szerepkörök Azure RBAC-vel való hozzárendelésével kapcsolatos további információkért lásd: Azure-szerepkör hozzárendelése blobadatokhoz való hozzáféréshez.

Közös hozzáférésű jogosultságkódok (SAS)

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. Az SAS-sel részletesen szabályozhatja, 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 mennyi ideig érvényes az SAS.

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

Ajánlott biztonsági gyakorlatként azt javasoljuk, hogy a tárfiókkulcs helyett Microsoft Entra hitelesítő adatokat használjon, ami könnyebben feltörhető. Ha az alkalmazás kialakítása közös hozzáférésű jogosultságkódokat igényel, Microsoft Entra hitelesítő adatokkal hozzon létre egy felhasználódelegálási SAS-t, ha lehetséges.

Ha a tárfiók esetében nincs engedélyezve a megosztott kulcshoz való hozzáférés, a blobtárolónak küldött 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ódelegálási SAS

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

Get Blob A művelet tárolóba vagy bloberőforrásba delegált SAS-jogkivonattal történő meghívásához olvasási (r) engedély szükséges a felhasználódelegálási SAS-jogkivonat részeként.

A felhasználódelegálási SAS-ről a felhasználói delegálási SAS Létrehozás című témakörben olvashat bővebben.

Szolgáltatási SAS

A szolgáltatás SAS-jének védelme a tárfiók kulccsal történik. A szolgáltatás sasa egyetlen Azure Storage-szolgáltatásban, például a Blob Storage-ban delegálja az erőforrásokhoz való hozzáférést.

Get Blob A művelet tárolóba vagy bloberőforrásba delegált SAS-jogkivonattal történő meghívásához olvasási (r) engedély szükséges a szolgáltatás SAS-jogkivonatának részeként.

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

Fiók SAS-fiókja

A fiók SAS-jének védelme a tárfiók kulcsával történik. 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ó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 kell megadni:

Művelet	Aláírt szolgáltatás	Aláírt erőforrástípus	Aláírt engedély
Blob lekérése	Blob (b)	Objektum (o)	Olvasás (r)

A fiók SAS-éről további információt a fiók SAS-Létrehozás című témakörben talál.

Megosztott kulcs

A művelet támogatja a Get Blobmegosztott kulcs engedélyezését. A fiókkulcsokkal való engedélyezés a legtöbb esetben nem ajánlott, mivel kevésbé biztonságos.

A Microsoft azt javasolja, hogy lehetőség szerint tiltsa le a megosztott kulcs engedélyezését a tárfiókhoz. További információ: Engedélyezés megakadályozása megosztott kulccsal.

Megjegyzések

Lapblobok esetén a Get Blob tartalommal még nem rendelkező vagy törölt lapok tartományán végrehajtott műveletek nullákat ad vissza ezekhez a bájtokhoz.

Ha olyan lapblobot hív Get Blob meg, amelynek nincs megadva tartománya, a szolgáltatás a fejléc megadott értékének x-ms-blob-content-length megfelelő oldaltartományt adja vissza. A tartalom nélküli lapok esetében a szolgáltatás nullákat ad vissza ezekhez a bájtokhoz.

Hozzáfűző blob esetén a művelet a Get Blob fejlécet x-ms-blob-committed-block-count adja vissza. Ez a fejléc a blobban lévő véglegesített blokkok számát jelzi. A x-ms-blob-committed-block-count blokkblobok és lapblobok fejléce nem lesz visszaadva.

Egy Get Blob művelet miB-enként két percet is végrehajthat. Ha a művelet átlagosan több mint két percet vesz igénybe MiB-enként, a művelet időtúllépést fog végezni.

A x-ms-version fejléc egy privát tárolóhoz tartozó blob lekéréséhez szükséges. Ha a blob olyan tárolóhoz tartozik, amely teljes vagy részleges nyilvános hozzáféréshez érhető el, bármely ügyfél elolvashatja verzió megadása nélkül; a szolgáltatás verziója nem szükséges egy nyilvános tárolóhoz tartozó blob lekéréséhez. További információkért lásd: Restrict access to containers and blobs (A tárolókhoz és blobokhoz való hozzáférés korlátozása).

Az Get Blob archivált blokkblobok művelete sikertelen lesz.

Másolási műveletek

Annak megállapításához, hogy egy Copy Blob művelet befejeződött-e, először ellenőrizze, hogy a x-ms-copy-id célblob fejlécének értéke megegyezik-e az eredeti hívásban Copy Blobmegadott másolási azonosítóval. Az egyezés biztosítja, hogy egy másik alkalmazás ne szakítsa meg a másolatot, és ne indítson el egy új Copy Blob műveletet. Ezután keresse meg a fejlécet x-ms-copy-status: success . Vegye figyelembe azonban, hogy a blobok összes írási művelete a , Put Pagea és Put Block a kivételével Leaseminden tulajdonságot eltávolít x-ms-copy-* a blobból. Ezeket a tulajdonságokat a Blob Storage 2012-02-12-nél korábbi verzióit Copy Blob használó műveletek sem másolják.

Figyelmeztetés

A fejlécben visszaadott URL-cím tartalmazza a x-ms-copy-source forrásblob másolási műveletében használt kérésparamétereket. Ha SAS-jogkivonatot használ a forrásblob eléréséhez, az SAS-jogkivonat megjelenik a x-ms-copy-source fejlécben, amikor Get Blob a célblobon meghívják.

Amikor x-ms-copy-status: failed megjelenik a válaszban, x-ms-copy-status-description további információt tartalmaz a Copy Blob hibáról.

Minden érték három mezőjét x-ms-copy-status-description az alábbi táblázat ismerteti:

Összetevő	Leírás
HTTP-állapotkód	Egy standard 3 jegyű egész szám, amely megadja a hibát.
Hibakód	A hibát leíró kulcsszó, amelyet az Azure az <ErrorCode> elemben biztosít. Ha nem <jelenik meg ErrorCode> elem, a rendszer a HTTP-specifikációban szereplő 3 jegyű HTTP-állapotkódhoz társított szabványos hibaszöveget tartalmazó kulcsszót használja. Lásd : Gyakori REST API-hibakódok.
Tájékoztatás	A hiba részletes leírása idézőjelek között.

A x-ms-copy-status gyakori hibaforgatókönyvek és x-ms-copy-status-description -értékek leírását az alábbi táblázat ismerteti:

Fontos

A táblázatban szereplő hibaleírások figyelmeztetés nélkül, akár verziómódosítás nélkül is változhatnak, így előfordulhat, hogy nem pontosan egyeznek a szövegével.

Eset	x-ms-copy-status érték	x-ms-copy-status-description é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 a forrásblobból való olvasáskor egy másolási művelet során, de a rendszer újra meg fogja próbálni a műveletet.	függőben	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 egy másolási művelet célblobjára való íráskor, de a művelet újra meg lesz próbálva.	függőben	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ó beolvasáskor.	sikertelen	404 ResourceNotFound "A másolás nem sikerült a forrás olvasásakor". Megjegyzés: Amikor a szolgáltatás ezt a mögöttes ResourceNotFound hibát jelenti, az az ErrorCode elemben tér vissza. Ha a válaszban nem ErrorCode jelenik meg elem, megjelenik a HTTP-állapot szabványos sztringje, például NotFounda .
Az összes másolási műveletet korlátozó időkorlát. (Az időtúllépési időszak jelenleg 2 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".

x-ms-last-access-time nyomon követi a blob adatainak elérésének időpontját a tárfiók legutóbbi hozzáférési időkövető szabályzata alapján. A blob metaadatainak elérése nem változtatja meg az utolsó hozzáférési idejét.

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 Get Blob mutatja be:

Művelet	Tárfiók típusa	Számlázási kategória
Blob lekérése	Prémium szintű blokkblob Standard általános célú v2 Standard általános célú v1	Olvasási műveletek

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

Kérések engedélyezése az Azure Storage-ba
Állapot- és hibakódok
Blob Storage-hibakódok
Időtúllépések beállítása a Blob Storage-műveletekhez