Sdílet prostřednictvím

Získání objektu blob

  • Článek

Operace Get Blob načte nebo stáhne objekt blob ze systému, včetně jeho metadat a vlastností. Můžete také volat a Get Blob přečíst snímek.

Žádost

Požadavek můžete sestavit Get Blob následujícím způsobem. Doporučujeme používat protokol HTTPS. Nahraďte myaccount názvem vašeho účtu úložiště:

Identifikátor URI požadavku metody GET Verze PROTOKOLU HTTP
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

Identifikátor URI služby emulovaného úložiště

Když vytváříte požadavek na službu emulovaného úložiště, zadejte název hostitele emulátoru a port Azure Blob Storage jako 127.0.0.1:10000a pak název emulovaného účtu úložiště:

Identifikátor URI požadavku metody GET Verze PROTOKOLU HTTP
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.0

HTTP/1.1

Další informace najdete v tématu Použití emulátoru úložiště Azure pro vývoj a testování.

Parametry identifikátoru URI

V identifikátoru URI požadavku je možné zadat následující další parametry:

Parametr Popis
snapshot Nepovinný parametr. Parametr snapshot je neprůžná DateTime hodnota, která když je k dispozici, určuje snímek objektu blob, který se má načíst. Další informace o práci se snímky objektů blob najdete v tématu Create snímek objektu blob.
versionid Volitelné, verze 2019-12-12 a novější. Parametr versionid je neprůžná DateTime hodnota, pokud je k dispozici, určuje verzi objektu blob, který se má načíst.
timeout Nepovinný parametr. Parametr se timeout vyjadřuje v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace služby Blob Storage.

Hlavičky požadavku

Následující tabulka popisuje požadované a volitelné hlavičky požadavků.

Hlavička požadavku Popis
Authorization Povinná hodnota. Určuje schéma autorizace, název účtu a podpis. Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
Date nebo x-ms-date Povinná hodnota. Určuje formát UTC (Coordinated Universal Time). Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
x-ms-version Vyžaduje se pro všechny autorizované žádosti. Volitelné pro anonymní žádosti. Určuje verzi operace, která se má pro tento požadavek použít. Pokud je tato hlavička vynechána pro anonymní požadavek, služba provede požadavek ve verzi 2009-09-19. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
Range Nepovinný parametr. Vrátí bajty objektu blob pouze v zadaném rozsahu.
x-ms-range Nepovinný parametr. Vrátí bajty objektu blob pouze v zadaném rozsahu. Pokud jsou zadány hodnoty i Rangex-ms-range , služba použije hodnotu x-ms-range. Pokud není zadaný žádný rozsah, vrátí se celý obsah objektu blob. Další informace najdete v tématu Určení hlavičky rozsahu pro operace služby Blob Storage.
x-ms-lease-id: <ID> Nepovinný parametr. Pokud je zadána tato hlavička, operace se provede pouze v případě, že jsou splněny obě následující podmínky:

– Zapůjčení objektu blob je aktuálně aktivní.
– ID zapůjčení zadané v požadavku odpovídá ID zapůjčení objektu blob.

Pokud je tato hlavička zadána, ale není splněna která z těchto podmínek, požadavek selže a Get Blob operace selže se stavovým kódem 412 (Předběžná podmínka selhala).
x-ms-range-get-content-md5: true Nepovinný parametr. Pokud je tato hlavička nastavena na true hodnotu a zadána společně s Range touto hlavičkou, vrátí služba hodnotu hash MD5 pro rozsah, pokud je rozsah menší než nebo roven 4 mebibajtům (MiB).

Pokud je hlavička zadána bez hlavičky Range , vrátí služba stavový kód 400 (Chybný požadavek).

Pokud je hlavička nastavená na true hodnotu při překročení rozsahu 4 MiB, vrátí služba stavový kód 400 (Chybný požadavek).
x-ms-range-get-content-crc64: true Nepovinný parametr. Pokud je tato hlavička nastavena na true a zadána společně s Range hlavičkou, vrátí služba hodnotu hash CRC64 pro rozsah, pokud je rozsah menší než nebo roven 4 MiB.

Pokud je hlavička zadána bez hlavičky Range , vrátí služba stavový kód 400 (Chybný požadavek).

Pokud je hlavička nastavená na true hodnotu při překročení rozsahu 4 MiB, vrátí služba stavový kód 400 (Chybný požadavek).

Pokud jsou k dispozici hlavičky i x-ms-range-get-content-md5x-ms-range-get-content-crc64 , požadavek selže s chybou 400 (Chybný požadavek).

Tato hlavička je podporovaná ve verzích 2019-02-02 a novějších.
Origin Nepovinný parametr. Určuje původ, ze kterého je žádost vystavena. Přítomnost této hlavičky má za následek hlavičky sdílení prostředků mezi zdroji (CORS) v odpovědi.
x-ms-upn Nepovinný parametr. Verze 2023-11-03 a novější. Platí pro účty s povoleným hierarchickým oborem názvů. Pokud je hodnota true, hodnoty identity uživatele vrácené v x-ms-ownerhlavičce a x-ms-aclx-ms-group odpovědi se transformují z ID objektů Microsoft Entra na hlavní názvy uživatelů. Pokud je hodnota false, vrátí se jako Microsoft Entra ID objektů. Výchozí hodnota je false (nepravda). Upozorňujeme, že ID objektů skupin a aplikací se nepřekládají, protože nemají jedinečné popisné názvy.
x-ms-client-request-id Nepovinný parametr. Poskytuje klientem vygenerovanou neprůsložnou hodnotu s limitem počtu znaků 1 kibibajt (KiB), která se zaznamená do protokolů analýzy, když je povolené protokolování Analýzy úložiště. Tuto hlavičku důrazně doporučujeme použít při korelaci aktivit na straně klienta s požadavky přijatými serverem. Další informace najdete v tématu Informace o protokolování azure Analýza úložiště.

Tato operace také podporuje použití podmíněných hlaviček ke čtení objektu blob pouze v případě, že je splněna zadaná podmínka. Další informace najdete v tématu Určení podmíněných hlaviček pro operace služby Blob Storage.

Hlavičky požadavku (šifrovací klíče poskytnuté zákazníkem)

Od verze 2019-02-02 můžete v požadavku zadat následující hlavičky na čtení objektu blob, který je šifrovaný pomocí klíče poskytnutého zákazníkem. Šifrování pomocí klíče poskytnutého zákazníkem (a odpovídající sady hlaviček) je volitelné. Pokud se objekt blob dříve zašifroval pomocí klíče poskytnutého zákazníkem, musíte do požadavku zahrnout tyto hlavičky, aby se operace čtení úspěšně dokončila.

Hlavička požadavku Popis
x-ms-encryption-key Povinná hodnota. Šifrovací klíč AES-256 s kódováním Base64.
x-ms-encryption-key-sha256 Nepovinný parametr. Hodnota hash SHA256 s kódováním Base64 šifrovacího klíče.
x-ms-encryption-algorithm: AES256 Povinná hodnota. Určuje algoritmus, který se má použít k šifrování. Hodnota této hlavičky musí být AES256.

Text požadavku

Žádné

Odpověď

Odpověď obsahuje stavový kód HTTP, sadu hlaviček odpovědi a tělo odpovědi, které obsahuje obsah objektu blob.

Stavový kód

Úspěšná operace čtení úplného objektu blob vrátí stavový kód 200 (OK).

Úspěšná operace čtení zadaného rozsahu vrátí stavový kód 206 (částečný obsah).

Další informace o stavových kódech najdete v tématu Kódy stavu a chyb.

Hlavičky odpovědi

Odpověď na tuto operaci obsahuje následující hlavičky. Odpověď může také obsahovat další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Syntax Description
Last-Modified Datum a čas poslední změny objektu blob. Formát data odpovídá dokumentu RFC 1123.

Každá operace, která změní objekt blob, včetně aktualizace metadat nebo vlastností objektu blob, změní čas poslední změny objektu blob.
x-ms-creation-time Verze 2017-11-09 a novější. Datum a čas vytvoření objektu blob. Formát data odpovídá dokumentu RFC 1123.
x-ms-meta-name:value Sada párů název-hodnota, která je přidružená k tomuto objektu blob jako uživatelem definovaná metadata.
x-ms-tag-count Verze 2019-12-12 a novější. Pokud objekt blob obsahuje nějaké značky, vrátí tato hlavička počet značek, které jsou v objektu blob uložené. Pokud objekt blob neobsahuje žádné značky, hlavička se nevrátí.
Content-Length Počet bajtů v textu odpovědi.
Content-Type Typ obsahu, který je určený pro objekt blob. Výchozí typ obsahu je application/octet-stream.
Content-Range Určuje rozsah bajtů vrácených v případě, že klient požádal o podmnožinu objektu blob nastavením hlavičky Range požadavku.
ETag Obsahuje hodnotu, kterou můžete použít k podmíněnému provádění operací. Další informace najdete v tématu Určení podmíněných hlaviček pro operace služby Blob Storage. Pokud je verze požadavku 2011-08-18 nebo novější, hodnota ETag je uzavřena v uvozovkách.
Content-MD5 Pokud má objekt blob hodnotu hash MD5 a tato Get Blob operace má přečíst celý objekt blob, vrátí se tato hlavička odpovědi, aby klient mohl zkontrolovat integritu obsahu zprávy.

Ve verzi 2012-02-12 a novější Put Blob nastaví hodnotu hash MD5 objektu blob bloku, i když Put Blob požadavek neobsahuje hlavičku MD5.

Pokud má požadavek přečíst zadaný rozsah a x-ms-range-get-content-md5 je nastavený na true, vrátí požadavek hodnotu hash MD5 pro daný rozsah, pokud je velikost rozsahu menší než nebo rovna 4 MiB.

Pokud žádná z těchto sad podmínek není true, nevrátí se pro hlavičku Content-MD5 žádná hodnota.

Pokud x-ms-range-get-content-md5 je zadána bez hlavičky Range , vrátí služba stavový kód 400 (Chybný požadavek).

Pokud x-ms-range-get-content-md5 je nastavená hodnota , true když rozsah překročí 4 MiB, vrátí služba stavový kód 400 (Chybný požadavek).
x-ms-content-crc64 Pokud má požadavek přečíst zadaný rozsah a x-ms-range-get-content-crc64 hodnota je nastavená na truehodnotu , vrátí požadavek hodnotu hash CRC64 pro daný rozsah, pokud je velikost rozsahu menší než nebo rovna 4 MiB.

Pokud x-ms-range-get-content-crc64 je zadána bez hlavičky Range , vrátí služba stavový kód 400 (Chybný požadavek).

Pokud x-ms-range-get-content-crc64 je nastavená hodnota , true když rozsah překročí 4 MiB, vrátí služba stavový kód 400 (Chybný požadavek).
Content-Encoding Vrátí hodnotu, která byla zadána pro hlavičku Content-Encoding požadavku.
Content-Language Vrátí hodnotu, která byla zadána pro hlavičku Content-Language požadavku.
Cache-Control Vráceno, pokud byla pro objekt blob dříve zadána hlavička.
Content-Disposition Vráceno pro požadavky na verzi 2013-08-15 a novější. Tato hlavička vrátí hodnotu, která byla zadána pro hlavičku x-ms-blob-content-disposition .

Pole Content-Disposition hlavičky odpovědi sděluje další informace o tom, jak zpracovat datovou část odpovědi, a dá se použít k připojení dalších metadat. Pokud je například hlavička nastavená na attachmenthodnotu , znamená to, že by uživatelský agent neměl zobrazovat odpověď. Místo toho se zobrazí dialogové okno Uložit jako s jiným názvem souboru, než je zadaný název objektu blob.
x-ms-blob-sequence-number Aktuální pořadové číslo objektu blob stránky.

Tato hlavička se nevrací pro objekty blob bloku ani doplňovací objekty blob.
x-ms-blob-type: <BlockBlob | PageBlob | AppendBlob> Vrátí typ objektu blob.
x-ms-copy-completion-time: <datetime> Verze 2012-02-12 a novější. Čas ukončení posledního pokusu o Copy Blob operaci, kdy tento objekt blob byl cílovým objektem blob. Tato hodnota může určovat čas dokončení, přerušení nebo neúspěšného pokusu o kopírování. Tato hlavička se nezobrazí, pokud čeká na kopírování, pokud tento objekt blob nikdy nebyl cílem operace Copy Blob nebo pokud se tento objekt blob změnil po ukončení Copy Blob operace, která použila Set Blob Properties, Put Blobnebo Put Block List.
x-ms-copy-status-description: <error string> Verze 2012-02-12 a novější. Zobrazí se pouze v případě, že x-ms-copy-status je failed nebo pending. Popisuje příčinu posledního závažného nebo nezásadového selhání operace kopírování. Tato hlavička se nezobrazí, pokud tento objekt blob nikdy nebyl cílem operace Copy Blob nebo pokud se objekt blob změnil po ukončení Copy Blob operace, která použila Set Blob Properties, Put Blobnebo Put Block List.
x-ms-copy-id: <id> Verze 2012-02-12 a novější. Identifikátor řetězce pro poslední pokus o Copy Blob operaci, kde tento objekt blob byl cílovým objektem blob. Tato hlavička se nezobrazí, pokud tento objekt blob nikdy nebyl cílem operace Copy Blob nebo pokud se objekt blob změnil po ukončení Copy Blob operace, která použila Set Blob Properties, Put Blobnebo Put Block List.
x-ms-copy-progress: <bytes copied/bytes total> Verze 2012-02-12 a novější. Obsahuje počet bajtů, které byly zkopírovány, a celkový počet bajtů ve zdroji při posledním pokusu o Copy Blob operaci, kdy tento objekt blob byl cílovým objektem blob. Může zobrazovat zkopírované bajty od 0 k Content-Length bajtům. Tato hlavička se nezobrazí, pokud tento objekt blob nikdy nebyl cílem operace Copy Blob nebo pokud se objekt blob změnil po ukončení Copy Blob operace, která použila Set Blob Properties, Put Blobnebo Put Block List.
x-ms-copy-source: url Verze 2012-02-12 a novější. Adresa URL o délce až 2 KiB, která určuje zdrojový objekt blob nebo soubor použitý při posledním pokusu o Copy Blob operaci, kde tento objekt blob byl cílovým objektem blob. Tato hlavička se nezobrazí, pokud tento objekt blob nikdy nebyl cílem operace Copy Blob nebo pokud se objekt blob změnil po ukončení Copy Blob operace, která použila Set Blob Properties, Put Blobnebo Put Block List.

Adresa URL vrácená v této hlavičce obsahuje všechny parametry požadavku použité v operaci kopírování zdrojového objektu blob, včetně tokenu sdíleného přístupového podpisu (SAS), který se použil pro přístup ke zdrojovému objektu blob.
x-ms-copy-status: <pending | success | aborted | failed> Verze 2012-02-12 a novější. Stav operace kopírování identifikovaný pomocí x-ms-copy-id s těmito hodnotami:

- success: Kopírování bylo úspěšně dokončeno.
- pending: Probíhá kopírování. Zkontrolujte x-ms-copy-status-description , jestli přerušované chyby, které nejsou závažné, nezpomalují průběh kopírování, ale nezpůsobují selhání.
- aborted: Kopírování bylo ukončeno uživatelem Abort Copy Blob.
- failed: Kopírování se nezdařilo. Podrobnosti o selhání najdete v tématu x-ms-copy-status-description.

Tato hlavička se nezobrazí, pokud tento objekt blob nikdy nebyl cílem operace Copy Blob nebo pokud se objekt blob změnil po dokončení Copy Blob operace, která použila Set Blob Properties, Put Blobnebo Put Block List.
x-ms-lease-duration: <infinite | fixed> Verze 2012-02-12 a novější. Když je objekt blob zapůjčený, určuje, jestli má zapůjčení neomezenou nebo pevnou dobu trvání.
x-ms-lease-state: <available | leased | expired | breaking | broken> Verze 2012-02-12 a novější. Stav zapůjčení objektu blob.
x-ms-lease-status:<locked | unlocked> Aktuální stav zapůjčení objektu blob.
x-ms-request-id Jednoznačně identifikuje požadavek, který byl proveden, a lze ho použít k řešení potíží s požadavkem. Další informace najdete v tématu Řešení potíží s operacemi rozhraní API.
x-ms-version Označuje verzi služby Blob Storage, která se použila ke spuštění požadavku. Zahrnuté pro požadavky, které byly provedeny ve verzi 2009-09-19 a novější.

Tato hlavička se vrátí také pro anonymní požadavky bez zadané verze, pokud byl kontejner označen pro veřejný přístup pomocí služby Blob Storage verze 2009-09-19.
Accept-Ranges: bytes Označuje, že služba podporuje požadavky na částečný obsah objektu blob. Zahrnuté pro požadavky vytvořené pomocí verze 2011-08-18 a novější a pro službu místního úložiště v sadě SDK verze 1.6 a novější.
Date Hodnota data a času UTC vygenerovaná službou, která označuje čas, kdy byla odpověď inicializována.
Access-Control-Allow-Origin Vrátí se, pokud požadavek obsahuje hlavičku Origin a CORS je povolený s odpovídajícím pravidlem. Tato hlavička vrátí hodnotu hlavičky požadavku původu v případě shody.
Access-Control-Expose-Headers Vrátí se, pokud požadavek obsahuje hlavičku Origin a CORS je povolený s odpovídajícím pravidlem. Vrátí seznam hlaviček odpovědi, které mají být zpřístupněny klientovi nebo vystaviteli požadavku.
Vary Vrátí se s hodnotou hlavičky Origin při zadání pravidel CORS. Podrobnosti najdete v tématu Podpora CORS pro služby Azure Storage .
Access-Control-Allow-Credentials Vrátí se, pokud požadavek obsahuje hlavičku Origin a CORS je povolené s odpovídajícím pravidlem, které nepovoluje všechny zdroje. Tato hlavička bude nastavená na truehodnotu .
x-ms-blob-committed-block-count Počet potvrzených bloků, které jsou přítomné v objektu blob. Tato hlavička se vrátí jenom pro doplňovací objekty blob.
x-ms-server-encrypted: true/false Verze 2015-12-11 a novější. Hodnota této hlavičky je nastavená na true , pokud jsou data objektů blob a metadata aplikace zcela šifrovaná pomocí zadaného algoritmu. V opačném případě je hodnota nastavená na false hodnotu (pokud je objekt blob nešifrovaný nebo pokud jsou šifrované jenom části metadat objektu blob nebo aplikace).
x-ms-encryption-key-sha256 Verze 2019-02-02 a novější. Tato hlavička se vrátí, pokud je objekt blob šifrovaný pomocí klíče poskytnutého zákazníkem.
x-ms-encryption-context Verze 2021-08-06 a novější. Pokud je nastavená hodnota vlastnosti kontextu šifrování, vrátí se nastavená hodnota. Platí jenom v případě, že je pro účet povolený hierarchický obor názvů.
x-ms-encryption-scope Verze 2019-02-02 a novější. Tato hlavička se vrátí, pokud je objekt blob šifrovaný s oborem šifrování.
x-ms-blob-content-md5 Verze 2016-05-31 a novější. Pokud má objekt blob hodnotu hash MD5 a požadavek obsahuje hlavičku rozsahu (range nebo x-ms-range), vrátí se tato hlavička odpovědi s hodnotou MD5 celého objektu blob. Tato hodnota se může nebo nemusí rovnat hodnotě, která je vrácena v hlavičce Content-MD5, přičemž druhá hodnota se vypočítá z požadovaného rozsahu.
x-ms-client-request-id Dá se použít k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě x-ms-client-request-id hlavičky, pokud je v požadavku, a hodnota neobsahuje více než 1 024 viditelných znaků ASCII. Pokud hlavička x-ms-client-request-id v požadavku není, není tato hlavička v odpovědi.
x-ms-last-access-time Verze 2020-02-10 a novější. Označuje čas posledního přístupu k datům objektu blob na základě zásad posledního sledování času přístupu účtu úložiště. Hlavička se nevrátí, pokud účet úložiště nemá zásadu posledního sledování času přístupu nebo pokud je zásada zakázaná. Informace o nastavení zásad posledního sledování času přístupu k účtu úložiště najdete v tématu Rozhraní API služby Blob Service.
x-ms-blob-sealed Verze 2019-12-12 a novější. Vráceno pouze pro doplňovací objekty blob. Pokud je doplňovací objekt blob zapečetěný, hodnota by byla true. Další informace najdete v tématu Doplňovací pečeť objektů blob.
x-ms-immutability-policy-until-date Verze 2020-06-12 a novější. Určuje uchovávání do data nastaveného v objektu blob. Toto je datum, do kterého je možné objekt blob chránit před úpravami nebo odstraněním. Vrátí se jenom v případě, že je v objektu blob nastavená zásada neměnnosti. Hodnota této hlavičky je ve formátu RFC1123.
x-ms-immutability-policy-mode: unlocked/locked Verze 2020-06-12 a novější. Vrátí se, pokud je v objektu blob nastavená zásada neměnnosti. Hodnoty jsou unlocked a locked. unlocked označuje, že uživatel může zásadu změnit zvýšením nebo snížením doby uchovávání do data. locked označuje, že tyto akce jsou zakázány.
x-ms-legal-hold: true/false Verze 2020-06-12 a novější. Pokud objekt blob nemá blokování z právních důvodů, tato hlavička se nevrátí. Hodnota této hlavičky je nastavená na true , pokud objekt blob obsahuje blokování z právních důvodů a jeho hodnota je true. V opačném případě se hodnota nastaví na false , pokud objekt blob obsahuje blokování z právních důvodů a jeho hodnota je false.
x-ms-owner Verze 2020-06-12 a novější, pouze pro účty s povoleným hierarchickým oborem názvů. Vrátí vlastníka a uživatele souboru nebo adresáře.
x-ms-group Verze 2020-06-12 a novější, pouze pro účty s povoleným hierarchickým oborem názvů. Vrátí vlastnící skupinu souboru nebo adresáře.
x-ms-permissions Verze 2020-06-12 a novější, pouze pro účty s povoleným hierarchickým oborem názvů. Vrátí oprávnění nastavená pro uživatele, skupinu a další v souboru nebo adresáři. Jednotlivá oprávnění jsou ve [r,w,x,-]{3} formátu.
x-ms-acl Verze 2023-11-03 a novější. Pouze pro účty s povoleným hierarchickým oborem názvů. Vrátí kombinovaný seznam přístupu a výchozí seznam řízení přístupu, které jsou nastaveny pro uživatele, skupiny a další v souboru nebo adresáři. Každá položka řízení přístupu (ACE) se skládá z oboru, typu, identifikátoru uživatele nebo skupiny a oprávnění ve formátu [scope]:[type]:[id]:[permissions]. Obor default označuje, že ACE patří do výchozího seznamu ACL pro adresář. V opačném případě je obor implicitní a ACE patří do seznamu ACL pro přístup. Jednotlivá oprávnění jsou ve [r,w,x,-]{3} formátu.
x-ms-resource-type Verze 2020-10-02 a novější, pouze pro účty s povoleným hierarchickým oborem názvů. Vrátí typ prostředku pro cestu, která může být buď file nebo directory.

Text odpovědi

Tělo odpovědi obsahuje obsah objektu blob.

Ukázková odpověď

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>

Autorizace

Při volání jakékoli operace přístupu k datům ve službě Azure Storage se vyžaduje autorizace. Operaci můžete autorizovat, Get Blob jak je popsáno níže.

Důležité

Microsoft doporučuje používat Microsoft Entra ID se spravovanými identitami k autorizaci požadavků do služby Azure Storage. Microsoft Entra ID ve srovnání s autorizací sdíleného klíče poskytuje vynikající zabezpečení a snadné použití.

Azure Storage podporuje autorizaci požadavků na data objektů blob pomocí Microsoft Entra ID. S Microsoft Entra ID můžete pomocí řízení přístupu na základě role v Azure (Azure RBAC) udělit oprávnění k objektu zabezpečení. Objektem zabezpečení může být uživatel, skupina, instanční objekt aplikace nebo spravovaná identita Azure. Objekt zabezpečení je ověřen Microsoft Entra ID, aby vrátil token OAuth 2.0. Token se pak dá použít k autorizaci požadavku na službu Blob Service.

Další informace o autorizaci pomocí Microsoft Entra ID najdete v tématu Autorizace přístupu k objektům blob pomocí Microsoft Entra ID.

Oprávnění

Níže jsou uvedené akce RBAC potřebné k volání operace Microsoft Entra uživatele, skupiny, spravované identity nebo instančního objektu Get Blob a nejméně privilegované integrované role Azure RBAC, která zahrnuje tuto akci:

Další informace o přiřazování rolí pomocí Azure RBAC najdete v tématu Přiřazení role Azure pro přístup k datům objektů blob.

Poznámky

V případě objektu blob stránky vrátí operace v rozsahu stránek, Get Blob které ještě nemají obsah nebo byly vymazány, nuly pro tyto bajty.

Pokud zavoláte Get Blob na objekt blob stránky bez zadaného rozsahu, vrátí služba rozsah stránek až do zadané hodnoty pro hlavičku x-ms-blob-content-length . Pro všechny stránky, které nemají obsah, vrátí služba nuly pro tyto bajty.

Pro doplňovací objekt blob Get Blob vrátí operace hlavičku x-ms-blob-committed-block-count . Tato hlavička označuje počet potvrzených bloků v objektu blob. Hlavička x-ms-blob-committed-block-count se nevrací pro objekty blob bloku nebo objekty blob stránky.

Operace Get Blob je povolena dvě minuty na dokončení MiB. Pokud operace trvá v průměru déle než dvě minuty na MiB, vyprší časový limit operace.

Hlavička x-ms-version se vyžaduje k načtení objektu blob, který patří do privátního kontejneru. Pokud objekt blob patří do kontejneru, který je k dispozici pro úplný nebo částečný veřejný přístup, může ho každý klient číst bez zadání verze. Verze služby se nevyžaduje pro načtení objektu blob, který patří do veřejného kontejneru. Další informace najdete v tématu Omezení přístupu ke kontejnerům a objektům blob.

Operace Get Blob s archivovaným objektem blob bloku selže.

Operace kopírování

Pokud chcete zjistit, jestli Copy Blob se operace dokončila, nejprve zkontrolujte, jestli x-ms-copy-id se hodnota hlavičky cílového objektu blob shoduje s ID kopírování, které bylo poskytnuto původním voláním objektu Copy Blob. Shoda zajistí, že jiná aplikace nepřesune kopírování a nezačne novou Copy Blob operaci. Dále zkontrolujte hlavičku x-ms-copy-status: success . Mějte ale na paměti, že všechny operace zápisu v objektu blob s výjimkou LeasePut Pageoperací , a Put Block odeberou z objektu blob všechny x-ms-copy-* vlastnosti. Tyto vlastnosti také nezkopírují operace, Copy Blob které používají verze služby Blob Storage starší než 2012-02-12.

Upozornění

Adresa URL vrácená v x-ms-copy-source hlavičce obsahuje všechny parametry požadavku, které byly použity při operaci kopírování ve zdrojovém objektu blob. Pokud pro přístup ke zdrojovému objektu blob použijete token SAS, zobrazí se tento token SAS v x-ms-copy-source hlavičce při Get Blob zavolání v cílovém objektu blob.

Když x-ms-copy-status: failed se zobrazí v odpovědi, x-ms-copy-status-description obsahuje další informace o Copy Blob selhání.

Tři pole každé x-ms-copy-status-description hodnoty jsou popsána v následující tabulce:

Komponenta Popis
Stavový kód HTTP Standardní 3místné celé číslo, které určuje chybu.
Kód chyby Klíčové slovo, které popisuje chybu, kterou poskytuje Azure v elementu <ErrorCode> . Pokud se nezobrazí žádný <element ErrorCode> , použije se klíčové slovo, které obsahuje standardní text chyby, který je přidružený ke 3místnému stavovém kódu HTTP ve specifikaci HTTP. Viz Běžné kódy chyb rozhraní REST API.
Informace Podrobný popis selhání v uvozovkách.

Hodnoty x-ms-copy-status a x-ms-copy-status-description běžných scénářů selhání jsou popsané v následující tabulce:

Důležité

Popisy chyb v této tabulce se můžou změnit bez upozornění, a to i bez změny verze, takže nemusí přesně odpovídat vašemu textu.

Scenario hodnota x-ms-copy-status hodnota x-ms-copy-status-description
Operace kopírování byla úspěšně dokončena. úspěch empty
Uživatel přerušil operaci kopírování před jejím dokončením. Přerušena empty
Při čtení ze zdrojového objektu blob během operace kopírování došlo k chybě, ale operace se bude opakovat. pending 502 BadGateway Při čtení zdroje došlo k chybě, která se dá opakovat. Zkusí to znovu. Čas selhání: <čas>"
Při zápisu do cílového objektu blob operace kopírování došlo k chybě, ale operace se bude opakovat. pending 500 InternalServerError "Zjistila se opakovatelná chyba. Zkusí to znovu. Čas selhání: <čas>"
Při čtení ze zdrojového objektu blob operace kopírování došlo k neopravitelné chybě. failed 404 ResourceNotFound Při čtení zdroje se nezdařilo kopírování.

Poznámka: Když služba hlásí tuto základní chybu, vrátí ResourceNotFound se v elementu ErrorCode . Pokud se v odpovědi nezobrazí žádný ErrorCode prvek, zobrazí se standardní řetězcová reprezentace stavu HTTP, například NotFound.
Časový limit omezující všechny operace kopírování uplynul. (V současné době je časový limit 2 týdny.) failed 500 OperaceCancelled "Kopie překročila maximální povolený čas."
Operace kopírování příliš často selhala při čtení ze zdroje a nesplněla minimální poměr pokusů k úspěchům. (Tento časový limit zabraňuje opakování velmi špatného zdroje po dobu dvou týdnů před selháním.) failed 500 OperationCancelled "Kopie selhala při čtení zdroje."

x-ms-last-access-time sleduje čas, kdy byl přístup k datům objektu blob, na základě zásad posledního sledování času přístupu účtu úložiště. Přístup k metadatům objektu blob nezmění jeho čas posledního přístupu.

Fakturace

Žádosti o ceny můžou pocházet od klientů, kteří používají rozhraní BLOB Storage API, a to buď přímo prostřednictvím rozhraní REST API služby Blob Storage, nebo z klientské knihovny Služby Azure Storage. Tyto požadavky načítají poplatky za transakci. Typ transakce ovlivňuje způsob účtování poplatku za účet. Například transakce čtení se načítají do jiné kategorie fakturace než transakce zápisu. Následující tabulka ukazuje kategorii fakturace pro Get Blob žádosti založené na typu účtu úložiště:

Operace Typ účtu úložiště Kategorie fakturace
Získání objektu blob Objekt blob bloku úrovně Premium
Standard pro obecné účely v2
Standard pro obecné účely v1		 Operace čtení

Informace o cenách pro zadanou kategorii fakturace najdete v tématu Azure Blob Storage Ceny.

Viz také

Autorizace žádostí do Služby Azure Storage
Stavové kódy a kódy chyb
Kódy chyb služby Blob Storage
Nastavení časových limitů pro operace služby Blob Storage