Megosztás:

Blob lekérése

A Get Blob művelet egy foltot olvas vagy letölt a rendszerből, beleértve annak metaadatait és tulajdonságait is. Telefonálhatsz is Get Blob , hogy elolvasd a pillanatképet.

Kérelem

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

GET módszerkérés URI 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érsz egy lekérdezést az emulált tároló szolgáltatás ellen, add meg az emulátor hosztnevét és Azure Blob Storage portját , 127.0.0.1:10000majd az emulált tárolófiók nevét:

GET módszerkérés URI 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övetkező további paraméterek megadhatók a kérés URI-n:

Paraméter Description
snapshot Opcionális. A snapshot paraméter egy átlátszatlan DateTime érték, amely amikor jelen van, megadja a visszanyerendő foltképet. További információért a blob snapshotokkal való munkáról lásd: Create an snapshot of a blob.
versionid Nem kötelező, 2019-12-12-es és újabb verziók. A versionid paraméter egy átlátszatlan DateTime érték, amely ha jelen van, megadja a lekérendő folb verzióját.
timeout Opcionális. A timeout paramétert másodpercben fejezzük ki. További információért lásd: Időtúllépések beállítása Blob Storage műveletekhez.

HTTP-kérés fejlécek

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

Kérések fejrész Description
Authorization Szükséges. Megadja az engedélyezési sémát, a fióknevet és az aláírást. További információ: Kérelmek engedélyezése az Azure Storage-.
Date vagy x-ms-date Szükséges. A kérelem koordinált egyetemes idejét (UTC) adja meg. További információ: Kérelmek engedélyezése az Azure Storage-.
x-ms-version Minden engedélyezett kéréshez szükséges. Anonim kérések esetén opcionális. A kérelemhez használni kívánt művelet verzióját adja meg. Ha ezt a fejlécet egy névtelen kérésnél kihagyják, akkor a szolgáltatás a 2009-09-19-es verzióval hajtja végre a kérést. További információ: Verziószámozás az Azure Storage-szolgáltatásokhoz.
Range Opcionális. A folt bájtjait csak a megadott tartományban adjuk vissza.
x-ms-range Opcionális. A folt bájtjait csak a megadott tartományban adjuk vissza. Ha mindkettő Range és x-ms-range meg van jelölve, a szolgáltatás a értékét x-ms-rangehasználja. Ha egyik tartomány sem van megadva, akkor a teljes folb tartalma visszakerül. További információért lásd: Specify a range header for Blob Storage műveletekhez.
x-ms-lease-id: <ID> Opcionális. Ha ez a fejléc meg van jelölve, a műveletet csak akkor hajtják végre, ha mindkét alábbi feltétel teljesül:

- A folt bérleti szerződése jelenleg érvényben van.
- A kérésben megadott bérleti azonosító megegyezik a blob bérleti azonosítójával.

Ha ez a fejléc meg van adva, de egyik feltétel sem teljesül, a kérés meghibásodik, és a Get Blob művelet a 412-es állapotkóddal (előfeltétel sikertelen) meghibásodik.
x-ms-range-get-content-md5: true Opcionális. Ha ezt a fejlécet a fejlécével Range együtt állítják true és megadják, a szolgáltatás visszaadja az MD5 hash-et a tartományra, amennyiben a tartomány mérete legfeljebb 4 mebibájt (MiB) lesz.

Ha a fejléc nincs Range megadva, a szolgáltatás 400-as állapotkódot ad vissza (Rossz kérés).

Ha a fejléc akkor van beállítva, true amikor a hatótávolság meghaladja a 4 MiB-t, a szolgáltatás 400-as állapotkódot (Rossz kérés) ad.
x-ms-range-get-content-crc64: true Opcionális. Ha ezt a fejlécet beállítjuk true és meg van jelölve vele Range , a szolgáltatás visszaadja a CRC64 hash-et a tartományra, amennyiben a távolság 4 MiB méretnél kisebb vagy egyenlő.

Ha a fejléc nincs Range megadva, a szolgáltatás 400-as állapotkódot ad vissza (Rossz kérés).

Ha a fejléc akkor van beállítva, true amikor a hatótávolság meghaladja a 4 MiB-t, a szolgáltatás 400-as állapotkódot (Rossz kérés) ad.

Ha mindkettő x-ms-range-get-content-md5 megvan, mind a x-ms-range-get-content-crc64 fejléc, a kérés megbukik egy 400-as (rossz kérés) érték esetén.

Ez a fejléc támogatott a 2019-02-02-2 és későbbi verziókban.
Origin Opcionális. Megadja a kérés kibocsátásának forrását. Ennek a fejlécnek a jelenléte kereszteredetű erőforrás-megosztási (CORS) fejléceket eredményez a válaszon.
x-ms-upn Opcionális. 2023-11-03 verzió és újabb. Érvényes azoknál a fiókoknál, amelyekben hierarchikus névtér engedélyezve van. Ha igaz, a felhasználói identitásértékek, amelyeket a x-ms-owner, x-ms-group és x-ms-acl a válaszfejlécek visszaadnak, a Microsoft Entra objektumazonosítókról Felhasználói Főnevekre alakulnak. Ha az érték hamis, akkor Microsoft Entra objektumazonosítóként jelennek meg. Az alapértelmezett érték a hamis. Fontos megjegyezni, hogy a csoport- és alkalmazásobjektum azonosítókat nem fordítják le, mert nincs egyedi barátságos nevük.
x-ms-client-request-id Opcionális. Egy kliens által generált, átlátszatlan értéket biztosít 1 kibibájtos (KiB) karakterkorláttal, amelyet az analitikai naplókban rögzítenek, amikor a tárolási analitikai naplózás engedélyezve van. Nagyon ajánljuk, hogy használd ezt a fejlécet, amikor az ügyféloldali tevékenységeket a szerver által érkező kérésekkel korrelálod. További információért lásd: Az Azure Storage Analytics naplózásról szóló részben.
x-ms-structured-body Opcionális. 2025-01-05 verzió és újabb. Ha megadják, a szolgáltatás visszaadja a strukturált test formátumban kódolt blob tartalmat. Ennek a fejlécnek az értéke tartalmazza az üzenetséma verzióját és tulajdonságait.

Jelenleg az egyetlen támogatott érték , XSM/1.0; properties=crc64amely jelzi, hogy a válasz crc64 ellenőrzőösszeg szegmenseket fog használni a kódolt üzenetben. Ha az érték nem egyezik meg, a művelet 400-as hibakóddal (Rossz kérés) meghibásodik.

Ez a művelet támogatja a feltételes fejlécek használatát is, hogy csak akkor olvassák a foltot, ha egy meghatározott feltétel teljesül. További információért lásd: Feltételes fejlécek megadása Blob Storage műveletekhez.

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

A 2019-02-02-es verziótól a következő fejléceket megadhatod a kéréshez, hogy egy ügyfél által biztosított kulmillal titkosított folgot olvasson. A titkosítás az ügyfél által biztosított kulmilla (és a hozzá tartozó fejlécekkel) opcionális. Ha egy blobot korábban titkosítottak egy ügyfél által biztosított kulminccsel, ezeket a fejléceket a kéréshez be kell illesztened az olvasási művelet sikeres befejezéséhez.

Kérések fejrész Description
x-ms-encryption-key Szükséges. A Base64-et kódolt AES-256 titkosítási kulcs.
x-ms-encryption-key-sha256 Opcionális. A Base64-et kódolt SHA256 hash a titkosítási kulcsról.
x-ms-encryption-algorithm: AES256 Szükséges. Megadja a titkosításhoz használt algoritmust. Ennek a fejlécnek az értéke .AES256

A kérés tartalma

Nincs.

Válasz

A válasz tartalmaz egy HTTP státuszkódot, egy válaszfejlécek készletét, valamint a választestet, amely tartalmazza a blob tartalmát.

Állapotkód

Egy sikeres művelet a teljes tömb olvasására 200 (OK) állapotkódot ad.

Egy sikeres művelet egy meghatározott tartomány olvasásához a 206-os állapotkód (Partial Content) érkezik.

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.

Szemantika Description
Last-Modified Az a dátum/időpont, amikor a folt utoljára módosították. 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 verzió és újabb. A pöllyök létrehozásának dátuma/időpontja. A dátumformátum az RFC 1123-at követi.
x-ms-meta-name:value Egy név-érték párok halmaza, amely ehhez a tömbhöz felhasználó által definiált metaadatként kapcsolódik.
x-ms-tag-count 2019-12-12-2 verzió és újabb. Ha a folbnak van címkéje, ez a fejléc visszaadja a folban tárolt címkék számát. A fejléc nem jelenik meg, ha nincs címkék a folban.
Content-Length A választestben található bájtok száma.
Content-Type Az a tartalomtípus, amely a blob számára van megadva. Az alapértelmezett tartalomtípus a következő application/octet-stream.
Content-Range Jelzi, hogy mennyi bájttartomány jelenik meg, ha az ügyfél kér egy részhalmazt a folbból, a kérés fejlécének beállításával Range .
ETag Tartalmaz egy értéket, amellyel feltételesen végezhetsz műveleteket. További információért lásd: 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é van zárva.
Content-MD5 Ha a blobnak van MD5 hash, és ez Get Blob a művelet a teljes folb olvasása célja, akkor ez a válaszfejléc visszatér, hogy az ügyfél ellenőrizhesse az üzenet tartalmának integritását.

A 2012-02-12 és későbbi Put Blob verzióban beállítja egy blokk tömbje MD5 hash értékét akkor is, ha a Put Blob kérés nem tartalmaz MD5 fejléceget.

Ha a kérés egy meghatározott tartományt olvas, és a x-ms-range-get-content-md5 tartomány be truevan állítva, akkor a kérés MD5 hash-et ad a tartományra, amennyiben a tartomány mérete kisebb, mint 4 MiB.

Ha egyik feltétel sem , trueakkor nem tér vissza a Content-MD5 fejléc értéke.

Ha x-ms-range-get-content-md5 a fejléc nélkül Range van megadva, a szolgáltatás a 400-as (rossz kérés) állapotkódot adja vissza.

Ha x-ms-range-get-content-md5true a hatótávolság meghaladja a 4 MiB-t, akkor a szolgáltatás 400-as állapotkódot (Rossz kérés) ad.
x-ms-content-crc64 Ha a kérés egy meghatározott tartományt olvas, és a x-ms-range-get-content-crc64 tartomány be van állítva true, akkor a kérés CRC64 hash-et ad vissza a tartományra, amennyiben a tartomány mérete kisebb, mint 4 MiB.

Ha x-ms-range-get-content-crc64 a fejléc nélkül Range van megadva, a szolgáltatás a 400-as (rossz kérés) állapotkódot adja vissza.

Ha x-ms-range-get-content-crc64true a hatótávolság meghaladja a 4 MiB-t, akkor a szolgáltatás 400-as állapotkódot (Rossz kérés) ad.
Content-Encoding Visszaadja azt az értéket, amely a Content-Encoding kérés fejlécéhez volt megadva.
Content-Language Visszaadja azt az értéket, amely a Content-Language kérés fejlécéhez volt megadva.
Cache-Control Visszaadták, ha a fejléc korábban a folt számára volt megadva.
Content-Disposition Visszaküldtem a 2013-08-15-es verzió és későbbi verziók iránti kérelmeket. Ez a fejléc adja vissza azt az értéket, amelyet a x-ms-blob-content-disposition fejléchez megadott értéket adnak meg.

A Content-Disposition válaszfejléc mező további információkat közvetít a válasz hasznos raher feldolgozásáról, és további metaadatok csatolására is használható. Például, ha a fejléc , attachmentaz azt jelzi, hogy a felhasználó-ügynöknek nem szabad megjelenítenie a választ. Ehelyett egy Save As párbeszédet mutat, amelynek fájlneve nem a megadott folb név.
x-ms-blob-sequence-number Egy lapblob aktuális sorszáma.

Ez a fejléc nem jelenik meg blokk vagy append foltok esetén.
x-ms-blob-type: <BlockBlob | PageBlob | AppendBlob> Visszaadja a folt típusát.
x-ms-copy-completion-time: <datetime> 2012-02-12 verzió és újabb. Az utolsó műveleti kísérlet Copy Blob befejezési ideje, ahol ez a folt volt a célfolt. Ez az érték megadhatja a 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 folt soha nem volt célpont egy Copy Blob műveletben, vagy ha ezt a folt egy lezárt Copy Blob művelet után módosították, amely , Put Blob, vagy Put Block List.Set Blob Properties
x-ms-copy-status-description: <error string> 2012-02-12 verzió és újabb. Csak akkor jelenik meg, ha x-ms-copy-status az 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 folt soha nem volt célpontja egy Copy Blob műveletben, vagy ha ezt a foltot módosították egy lezárt Copy Blob művelet után, amely , Put Blob, vagy Put Block List.Set Blob Properties
x-ms-copy-id: <id> 2012-02-12 verzió és újabb. Egy stringazonosító az utolsó próbálkozás Copy Blob műveletéhez, ahol ez a blob volt a célfolt. Ez a fejléc nem jelenik meg, ha ez a folt soha nem volt célpontja egy Copy Blob műveletben, vagy ha ezt a foltot módosították egy lezárt Copy Blob művelet után, amely , Put Blob, vagy Put Block List.Set Blob Properties
x-ms-copy-progress: <bytes copied/bytes total> 2012-02-12 verzió és újabb. Tartalmazza a másolt bájtok számát és az összes bájtot a forrásban az utolsó próbálkozás Copy Blob során, ahol ez a blob volt a célfolt. 0-tól Content-Length a másolt bájtig mutathat. Ez a fejléc nem jelenik meg, ha ez a folt soha nem volt célpontja egy Copy Blob műveletben, vagy ha ezt a foltot módosították egy lezárt Copy Blob művelet után, amely , Put Blob, vagy Put Block List.Set Blob Properties
x-ms-copy-source: url 2012-02-12 verzió és újabb. Egy legfeljebb 2 KiB hosszú URL, amely meghatározza az utolsó próbálkozás Copy Blob során használt forrásfolt vagy fájlt, ahol ez a folb volt a célfolt. Ez a fejléc nem jelenik meg, ha ez a folt soha nem volt célpontja egy Copy Blob műveletben, vagy ha ezt a foltot módosították egy lezárt Copy Blob művelet után, amely , Put Blob, vagy Put Block List.Set Blob Properties

A fejlécben visszaadott URL tartalmazza azokat a kérésparamétereket, amelyeket a forrás blob másolási műveletében használtak, beleértve a közös hozzáférési aláírás (SAS) tokent, amelyet a forrás tömbhöz használtak.
x-ms-copy-status: <pending | success | aborted | failed> 2012-02-12 verzió és újabb. Az x-ms-copy-id által azonosított másolási művelet állapota, ezekkel az értékekkel:

- success: A másolat sikeresen elkészült.
- pending: A szöveg folyamatban van. Ellenőrizd, x-ms-copy-status-description hogy az időszakos, nem halálos hibák lassítják-e a másolás előrehaladását, de nem okoznak hibát.
- aborted: A másolatot .Abort Copy Blob
- failed: A másolat meghibásodott. A hiba részleteiért lásd az x-ms-copy-status-description oldalt.

Ez a fejléc nem jelenik meg, ha ez a folt soha nem volt célállomás egy Copy Blob műveletben, vagy ha ezt a foltot módosították egy befejezett Copy Blob művelet után, amely , Put Blob, vagy Put Block List.Set Blob Properties
x-ms-lease-duration: <infinite | fixed> 2012-02-12 verzió és újabb. Blob bérlete esetén megadja, 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 verzió és újabb. A folt bérleti állapota.
x-ms-lease-status:<locked | unlocked> A blob aktuális bérletállapota.
x-ms-request-id Egyedien azonosítja a kérelmet, és használható a kérés hibaelhárítására. További információ: API-műveletek hibaelhárítása.
x-ms-version Jelzi a Blob Storage verziót, amelyet a kérés végrehajtásához használtak. Tartalmazva olyan kérésekhez, amelyeket a 2009-09-19-19 vagy újabb verzióval indítottak.

Ez a fejléc névtelen kérések esetén is visszakerül, ha a konténert a Blob Storage 2009-09-19 verzióval jelölték nyilvánosra hozzáférésre.
Accept-Ranges: bytes Azt jelzi, hogy a szolgáltatás támogatja a részleges blobtartalomra vonatkozó kéréseket. Mellékelve olyan kérésekhez, amelyeket a 2011-08-18-as verzió vagy újabb verzió használatával tesznek, valamint az SDK 1.6-os és újabb verzió helyi tároló szolgáltatására.
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 Visszaküldve, ha a kérés fejlécet tartalmaz Origin , és a CORS egy egyeztetési szabály engedélyezett. Ez a fejléc adja vissza az eredeti kérés fejlécének értékét az egyezés esetén.
Access-Control-Expose-Headers Visszaküldve, ha a kérés fejlécet tartalmaz Origin , és a CORS egy egyeztetési szabály engedélyezett. Visszaadja a válaszfejlécek listáját, amelyeket a kérés kliense vagy kibocsátója számára kell kitárni.
Vary A fejléc értékével Origin jelenik meg, amikor a CORS szabályokat megadják. Részletekért lásd az Azure Storage szolgáltatások CORS támogatását .
Access-Control-Allow-Credentials Visszaküldve, ha a kérés fejlécet Origin tartalmaz, és a CORS egy megfelelőbb szabály van engedélyezve, amely nem engedélyezi az összes eredetet. Ez a fejléc beállítása .true
x-ms-blob-committed-block-count A blobban található véglegesített blokkok száma. Ez az élőfej csak hozzáfűző blobokhoz lesz visszaadva.
x-ms-server-encrypted: true/false 2015-12-11 verzió és újabb. Ennek a fejlécnek az értéke akkor van beállítva, true ha a blob adatok és az alkalmazás metaadatai teljesen titkosítva vannak a megadott algoritmussal. Ellenkező esetben az érték a következő módra van állítva, false ha a blob titkosítatlan, vagy ha csak a blob vagy az alkalmazás metaadat egyes részei vannak titkosítva).
x-ms-encryption-key-sha256 2019-02-02 verzió és újabb. Ez a fejléc akkor jelenik meg, ha a blobot egy ügyfél által biztosított kulgyal titkosítják.
x-ms-encryption-context 2021-08-06 verzió és újabb. Ha a titkosítási környezet tulajdonságértéke be van állítva, akkor a megadott értéket adja vissza. Csak akkor érvényes, ha a hierarchikus névtér engedélyezve van a fiókhoz.
x-ms-encryption-scope 2019-02-02 verzió és újabb. Ez a fejléc akkor jelenik meg, ha a blob titkosított scope-val van titkosítva.
x-ms-blob-content-md5 2016-05-31 verzió és újabb. Ha a tömbnek van MD5 hash, és ha a kérés tartalmaz egy tartományfejlécet (Range vagy x-ms-range), akkor ez a válaszfejléc a teljes blob MD5 értékének értékével kapja vissza. Ez az érték lehet, hogy nem lehet megegyezni a Content-MD5 fejlécében visszaadott értékkel, ahol az utóbbit a kért tartományból számítják.
x-ms-client-request-id A kérések és a megfelelő válaszok hibaelhárítására használható. Ennek az élőfejnek az értéke megegyezik a x-ms-client-request-id fejléc értékével, ha az szerepel a kérelemben, és az érték legfeljebb 1024 látható ASCII-karaktert tartalmaz. Ha a x-ms-client-request-id fejléc nincs jelen a kérésben, akkor ez a fejléc nincs jelen a válaszban.
x-ms-last-access-time 2020-02-10 verzió és újabb. Jelzi, mikor érhették el utoljára a blob adatait a tárolószámla utolsó hozzáférési idő követési szabályzata alapján. A fejléc nem kerül vissza, ha a tárolófióknak nincs utolsó hozzáférési időkövetési szabályzata, vagy ha a szabályzat ki van tiltva. A tárolófiók utolsó hozzáférési idő követési szabályzatának beállításáról információért lásd: Blob Service API.
x-ms-blob-sealed 2019-12-12-2 verzió és újabb. Csak append blob-okhoz adtam vissza. Ha az append blob le van pecsételve, az érték .true További információért lásd: Append Blob Seal
x-ms-immutability-policy-until-date 2020-06-12 verzió és újabb. Megadja a folban beállított megtartási dátumot . Ez az a dátum, amitől a folt védhető a módosítástól vagy törléstől. Csak akkor tér vissza, ha a bloban állítva van módosíthatatlansági politika. Ennek a fejlécnek az értéke RFC1123 formátumban van.
x-ms-immutability-policy-mode: unlocked/locked 2020-06-12 verzió és újabb. Visszaküldve, ha a bloban állítanak be egy módosíthatatlansági szabályzatot. Az értékek unlocked és locked. unlocked azt jelzi, hogy a felhasználó megváltoztathatja a szabályzatot azzal, hogy növeli vagy csökkenti a megtartást az egészen a dátumig. locked jelzi, hogy ezek a tevékenységek tilosak.
x-ms-legal-hold: true/false 2020-06-12 verzió és újabb. Ez a fejléc nem kerül vissza, ha nincs jogi rögzítés a folban. Ennek a fejlécnek az értéke akkor van beállítva, true ha a tömb tartalmaz egy jogszerű tartalékot, és az értéke .true Ellenkező esetben az érték akkor van beállítva, false ha a blob tartalmaz egy legális tartást, és az értéke .false
x-ms-owner 2020-06-12 és újabb verzió, csak olyan fiókoknál, amelyekben hierarchikus névtér engedélyezett. Visszaadja a fájl vagy könyvtár tulajdonos-felhasználóját.
x-ms-group 2020-06-12 és újabb verzió, csak olyan fiókoknál, amelyekben hierarchikus névtér engedélyezett. Visszaadja a fájl vagy könyvtár tulajdonoscsoportját.
x-ms-permissions 2020-06-12 és újabb verzió, csak olyan fiókoknál, amelyekben hierarchikus névtér engedélyezett. Visszaadja a fájlban vagy könyvtárban a felhasználó, csoport és egyéb jogosultságokat. Minden egyes engedély formátumban [r,w,x,-]{3} van.
x-ms-acl 2023-11-03 verzió és újabb. Csak olyan fiókoknál, amelyeknél hierarchikus névtér engedélyezve van. Visszaadja a fájlban vagy könyvtárban a felhasználó, csoport és egyéb felhasználók számára beállított hozzáférési és alapértelmezett hozzáférési vezérlő listát. Minden hozzáférési vezérlő bejegyzés (ACE) egy hatótávból, típusból, felhasználói vagy csoportazonosítóból, valamint jogosultságokból áll a formátumban [scope]:[type]:[id]:[permissions]. A default scope azt jelzi, hogy az ACE egy könyvtár alapértelmezett ACL-jéhez tartozik; különben a scope implicit, az ACE pedig az access ACL-hez tartozik. Minden egyes engedély formátumban [r,w,x,-]{3} van.
x-ms-resource-type 2020-10-02 és újabbá vált, csak olyan fiókokhoz, amelyekben hierarchikus névtér engedélyezett. Visszaadja az útvonal erőforrás típusát, amely lehet vagy filedirectory.

Válaszfejlécek (strukturált test)

A 2025-01-05 verziótól a következő fejléceket visszaküldik, ha a kérés érvényes x-ms-structured-body fejlécet küld.

Válaszfejléc Description
Content-Length A kódolt válasz hossza lesz (nem csak a visszaküldött blob tartalmának hossza).
x-ms-structured-body Ennek a fejlécnek az értéke megegyezik a kérésben elküldött értékkel, amelynek jelenleg annak kell lennie XSM/1.0; properties=crc64.
x-ms-structured-content-length Ennek a fejlécnek az értéke a visszaküldött blob tartalom hossza, és az üzenetkódolás miatt mindig kisebb, mint a Content-Length fejléc értéke.

Válasz törzse

A választest tartalmazza a folt 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>

Authorization

Az Azure Storage-ban bármely adatelérési művelet meghívásakor engedélyezésre van szükség. Az alábbi módon engedélyezheti a Get Blob műveletet.

Fontos

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

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

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

Permissions

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 Get Blob műveletet, valamint a legkevésbé kiemelt, beépített Azure RBAC-szerepkört, amely tartalmazza ezt a műveletet:

További információ a szerepkörök Azure RBAC használatával való hozzárendeléséről: Azure-szerepkör hozzárendelése blobadatokhoz való hozzáféréshez.

Megjegyzések

Egy oldaltömb esetén egy Get Blob olyan oldaltartományon átfutó művelet, amelyen még nincs tartalom vagy amelyeket töröltek, nullát ad ezekre a bájtokra.

Ha egy oldaltömböt hívunk Get Blob meg, amelynek tartománya nincs megadva, a szolgáltatás visszaadja az oldalak tartományát a fejléchez megadott értékig x-ms-blob-content-length . Azok az oldalak, amelyeknél nincs tartalom, a szolgáltatás nullát ad vissza ezekre a bájtokra.

Egy append blob esetén a Get Blob művelet visszaadja a x-ms-blob-committed-block-count fejlécet. Ez a fejléc jelzi, hány elkötelezett blokk a folban. A x-ms-blob-committed-block-count fejlécet nem térik vissza blokk vagy oldalfoltok esetén.

Egy Get Blob művelet MiB-enként két perc engedélyezett. Ha a művelet átlagosan két percnél tovább tart MiB-enként, az időlejár.

A x-ms-version fejlécnek szükséges egy privát konténerhez tartozó folt visszanyeréséhez. Ha a blob egy olyan konténerhez tartozik, amely teljes vagy részleges nyilvános hozzáférésre elérhető, bármely kliens elolvashatja anélkül, hogy megjelölné a verziót; A szolgáltatási verzió nem szükséges egy nyilvános konténerhez tartozó blob lekéréséhez. További információért lásd: Korlátozza a hozzáférést konténerek és foltok számára.

Egy Get Blob archivált blokk tömbön végzett művelet megbukik.

Másolási műveletek

Annak megállapítására, hogy egy Copy Blob művelet befejeződött-e, először ellenőrizzük, hogy a x-ms-copy-id cél blob fejlécértéke egyezik-e az eredeti Copy Blobhívás által biztosított másolati azonosítóval. Az egyezés biztosítja, hogy egy másik alkalmazás ne abortálja a másolatot, és ne indítson új Copy Blob műveletet. Ezután nézd meg a x-ms-copy-status: success fejlécet. Azonban ne feledd, hogy minden írási művelet egy blobon kivéve Lease, Put Pageés Put Block az műveletek eltávolítják az összes x-ms-copy-* tulajdonságot a blobból. Ezeket a tulajdonságokat nem másolják le azok Copy Blob az műveletek, amelyek a 2012-02-12 előtti Blob Storage verziókat használják.

Figyelmeztetés

A fejlécben visszaküldött x-ms-copy-source URL tartalmazza azokat a kérésparamétereket, amelyeket a forrás blob másolási műveletében használtak. Ha SAS tokent használsz a forrás blob eléréséhez, az a SAS token megjelenik a x-ms-copy-source fejlécben, amikor Get Blob a cél blobban hívják.

Amikor x-ms-copy-status: failed megjelenik a válaszban, x-ms-copy-status-description további információkat 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 írja le:

Összetevő Description
HTTP-állapotkód Egy szabványos 3 jegyű egész szám, amely meghatározza a hibát.
Hibakód Egy kulcsszó, amely leírja a hibát, amelyet az Azure biztosít a <ErrorCode> elemben. Ha nem <jelenik meg ErrorCode> elem, akkor egy olyan kulcsszót használnak, amely szabványos hibaszöveget tartalmaz, amely a HTTP specifikációban található 3 jegyű HTTP státuszkódhoz kapcsolódik. Lásd a Common REST API hibakódokat.
Információ A hiba részletes leírása, idézőjelben mellékelve.

A x-ms-copy-status gyakori hibásodás forgatókönyvek és x-ms-copy-status-description értékei az alábbi táblázatban találhatók:

Fontos

A táblázatban található hibaleírások figyelmeztetés nélkül változhatnak, még verzióváltás nélkül is, így lehet, hogy nem egyeznek pontosan a szövegeddel.

Scenario x-ms-copy-status érték x-ms-copy-status-description érték
A másolási művelet sikeresen befejeződött. siker üres
A felhasználó megszakította a másolási műveletet, mielőtt befejeződött volna. Megszakadt üres
Hiba történt, amikor a forrásfolból olvastak másolat közben, de a műveletet újra meg fogják próbálni. 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, amikor a cél blokba írtak egy másolási műveletet, de a műveletet újra meg fogják próbálni. 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ó olvasáskor. sikertelen 404 ResourceNotFound "A forrás olvasása során hiba történt."

Megjegyzés: Amikor a szolgáltatás ezt az alapvető hibát jelenti, az elemben tér vissza ResourceNotFoundErrorCode . Ha a válaszban nem ErrorCode jelent meg elem, megjelenik egy szabványos string megjelenítése a HTTP státuszról, például NotFound, .
Az összes másolási műveletet korlátozó időtúllépési időszak. (Jelenleg a szüneti időszak 2 hét.) sikertelen 500 OperationCancelled "A másolat túllépte a megengedett maximális időt."
A másolási művelet túl gyakran bukott el a forrásból való olvasáskor, és nem felelt meg a minimális próbálkozások és sikerek arányának. (Ez az időtúllépés megakadályozza, hogy két héttel a sikertelenség előtt újrapróbálkozzon egy nagyon gyenge forrás. sikertelen 500 OperationCancelled "A másolat nem sikerült a forrás olvasásakor."

x-ms-last-access-time Követi a Blob adataihoz való hozzáférés idejét a tárolófiók utolsó hozzáférési idő követési szabályzata alapján. Egy folb metaadataihoz való hozzáférés nem változtatja meg az utolsó hozzáférési időt.

Számlázás

A díjszabási kérelmek származhatnak olyan ügyfelektől, amelyek Blob Storage API-kat használnak, közvetlenül a Blob Storage REST API-n keresztül, vagy egy Azure Storage ügyféloldali kódtárból. Ezek a kérések tranzakciónként halmozódnak fel. A tranzakció típusa befolyásolja a számla terhelésének módját. Az olvasási tranzakciók például más számlázási kategóriába halmozódnak fel, mint az írási tranzakciók. Az alábbi táblázat a tárfiók típusa alapján a kérések Get Blob számlázási kategóriáját mutatja be:

Operation Tárfiók típusa Számlázási kategória
Blob lekérése Prémium blokk blob
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ával kapcsolatos további információkért lásd: Azure Blob Storage díjszabása.

Lásd még

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

  • Last updated on