Blob lekérése

A Get Blob művelet egy blobot olvas be vagy tölt le a rendszerből, beleértve annak metaadatait és tulajdonságait. A pillanatképek olvasásához is hívhat hívásokat Get Blob .

Kérés

A kérést a Get Blob következőképpen 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 gazdagépnevé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érendő blob-pillanatképet. A blob-pillanatképek használatával kapcsolatos további információkért lásd: Blob pillanatképének létrehozása.
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érendő 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érések 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érések 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álni kívánt művelet verzióját adja meg. Ha ezt a fejlécet nem adja meg egy névtelen kéréshez, a szolgáltatás a 2009-09-19-es verzióval hajtja végre a kérést. 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 mindkettő Range és x-ms-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 meg van adva, 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 Get Blob művelet a 412-s állapotkóddal meghiúsul (az előfeltétel sikertelen).
x-ms-range-get-content-md5: true	Választható. Ha ez a fejléc a fejlécmel Range együtt van beállítva true és meg van adva, a szolgáltatás a tartomány MD5 kivonatát adja vissza, feltéve, hogy a tartomány kisebb vagy egyenlő, mint 4 bájt (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-ás állapotkódot adja vissza (hibás kérelem).
x-ms-range-get-content-crc64: true	Választható. Ha ez a fejléc a fejlécmel Range együtt van beállítva true és meg van adva, 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-ás állapotkódot adja vissza (hibás kérelem). 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 származik. Ennek a fejlécnek a jelenléte a válasz forrásközi erőforrás-megosztási (CORS-) fejléceit eredményezi.
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 rendszer akkor rögzít az elemzési naplókban, ha engedélyezve van a tárolóelemzési naplózás. Erősen javasoljuk, hogy ezt a fejlécet használja, amikor az ügyféloldali tevékenységeket a kiszolgáló által fogadott kérésekkel korrelálja. További információ: Az Azure Storage Analytics naplózása.

Ez a művelet 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 megadott titkosítási kulcsok)

A 2019-02-02-es verziótól a következő fejléceket adhatja meg a kérelemben egy ügyfél által megadott kulccsal titkosított blob olvasására. 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 végrehajtásához 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álni kívánt 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ók. 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 fejléc nem lesz visszaadva, 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 akkor 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ék idézőjelek közé kerül.
Content-MD5	Ha a blob MD5-kivonattal rendelkezik, és ez Get Blob a művelet a teljes blob olvasása, a rendszer ezt a válaszfejlécet adja vissza, hogy az ügyfél ellenőrizni tudja az üzenettartalom integritását. A 2012-02-12-es és újabb verziókban 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 , truea Content-MD5 fejléchez 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 értéke akkor van beállítva true , 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-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, akkor 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 értéke akkor van beállítva true , 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).
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 visszaadva. Ez a fejléc a fejléchez x-ms-blob-content-disposition megadott értéket adja vissza. A Content-Disposition válasz fejlécmezője további információkat közöl a válasz hasznos adatainak feldolgozásáról, és további metaadatok csatolására is használható. Ha például a fejléc attachmentértéke , az azt jelzi, hogy a felhasználói ü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	Az oldalblob aktuális sorszáma. Ez a fejléc nem jelenik meg blokkblobok vagy hozzáfűző blobok esetében.
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 egy befejezett, megszakított vagy sikertelen másolási kísérlet időpontját. Ez a fejléc 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 ezt a blobot módosították egy befejezett Copy Blob művelet után, amely a , Put Blobvagy Put Block Listparancsot 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 hibájának okát ismerteti. 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 Copy BlobSet 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 Copy BlobSet 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 Copy BlobSet Blob Properties, Put Blobvagy Put Block List.
x-ms-copy-source: url	2012-02-12-es és újabb verzió. Legfeljebb 2 kib hosszúságú URL-cím, amely meghatározza a legutóbbi kísérlet Copy Blob során 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 Copy BlobSet 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, hogy x-ms-copy-status-description az időszakos, nem végzetes hibák lelassítják-e a másolási folyamatot, de nem okoznak-e hibát. - aborted: A másolás befejeződött a következővel Abort Copy Blob: . - failed: A másolás nem sikerült. A hiba részleteit az x-ms-copy-status-description szakaszban találja. Ez a fejléc nem jelenik meg, ha ez a blob soha nem volt cél egy Copy Blob műveletben, vagy ha ezt a blobot módosították egy , Put BlobCopy BlobSet Blob Propertiesvagy .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 küldött kérésekhez tartozik. Ez a fejléc a megadott verzió nélküli névtelen kérések esetén is megjelenik, ha a tároló nyilvános hozzáférésre lett megjelölve a Blob Storage 2009-09-19-es verziójával.
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 végrehajtott 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 tartalmaz fejlécet Origin , és a CORS engedélyezve van egy megfelelő 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 tartalmaz fejlécet Origin , és a CORS engedélyezve van egy megfelelő szabmánnyal. Azon válaszfejlécek listáját adja vissza, 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 egy olyan egyező szabánnyal, amely nem engedélyezi az összes forrást. Ez a fejléc a következőre lesz állítva: true.
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 fájl vagy könyvtár "felhasználó", "csoport" és "egyéb" engedélyeit. Minden egyes engedély [r,w,x,-]{3} formátumban van.
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.

Microsoft Entra ID

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 vagy szolgáltatásnév meghívja a Get Blob műveletet, valamint a legkevésbé emelt szintű 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-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.

További információ a felhasználódelegálási SAS-ről: Felhasználódelegálási SAS létrehozása.

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.

További információ a szolgáltatás SAS-járól: Szolgáltatás SAS létrehozása.

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)

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

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-nak
Állapot- és hibakódok
Blob Storage-hibakódok
Időtúllépések beállítása a Blob Storage-műveletekhez