Získat objekt blob

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

Žádost

Požadavek Get Blob můžete vytvořit následujícím způsobem. Doporučujeme používat PROTOKOL HTTPS. Nahraďte myaccount názvem vašeho úložného účtu:

GET URI pro požadavek na metodu 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

Protokol HTTP/1.1

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

Když zadáváte požadavek na emulovanou storage službu, zadejte hostitelské jméno emulátoru a port Azure Blob Storage jako 127.0.0.1:10000, následované názvem emulovaného úložného účtu:

GET URI pro požadavek na metodu Verze protokolu HTTP
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.0

Protokol 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

Následující dodatečné parametry mohou být zadány na URI požadavku:

Parameter Description
snapshot Optional. Parametr snapshot je neprůhledná DateTime hodnota, která při přítomnosti určuje snapshot blobu, který má být načten. Pro více informací o práci s blob snapshoty viz Vytvořit snapshot blobu.
versionid Volitelné, verze 2019-12-12 a novější. Parametr versionid je neprůhledná DateTime hodnota, která v případě přítomnosti určuje verzi blobu, který má být získán.
timeout Optional. Parametr timeout je vyjádřen v sekundách. Pro více informací viz časové limity nastavení pro operace Blob Storage.

Hlavičky žádosti

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

Hlavička požadavku Description
Authorization Povinné. Určuje schéma autorizace, název účtu a podpis. Další informace najdete v tématu Autorizace požadavků na službu Azure Storage.
Date nebo x-ms-date Povinné. Určuje standard UTC (Coordinated Universal Time) pro požadavek. Další informace najdete v tématu Autorizace požadavků na službu Azure Storage.
x-ms-version Vyžadováno pro všechny autorizované požadavky. Dobrovolné 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 vykoná požadavek ve verzi 2009-09-19. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
Range Optional. Vraťte bajty blobu pouze v daném rozsahu.
x-ms-range Optional. Vraťte bajty blobu pouze v daném rozsahu. Pokud jsou oba Range a specifikoványx-ms-range, služba používá hodnotu .x-ms-range Pokud není uveden žádný rozsah, vrátí se celý obsah blobu. Pro více informací viz Specifikujte rozsah hlavičky pro operace Blob Storage.
x-ms-lease-id: <ID> Optional. Pokud je tato hlavička specifikována, operace se provádí pouze tehdy, pokud jsou splněny obě následující podmínky:

- Nájemní smlouva blobu je aktuálně platná.
- ID pronájmu uvedené v žádosti odpovídá ID pronájmu blobu.

Pokud je tato hlavička specifikována, ale není splněna žádná z těchto podmínek, požadavek selže a Get Blob operace selže se stavovým kódem 412 (Předpodmínka selhala).
x-ms-range-get-content-md5: true Optional. Když je tato hlavička nastavena na a true specifikována spolu se hlavičkou Range , služba vrátí hash MD5 pro daný rozsah, pokud je rozsah menší nebo roven 4 mebibajtům (MiB).

Pokud je hlavička specifikována bez hlavičky Range , služba vrátí stavový kód 400 (Bad Request).

Pokud je hlavička nastavena na true dobu, kdy rozsah přesahuje 4 MiB, služba vrátí stavový kód 400 (Špatný požadavek).
x-ms-range-get-content-crc64: true Optional. Když je tato hlavička nastavena na a true specifikována společně s hlavičkou Range , služba vrátí hash CRC64 pro rozsah, pokud je rozsah menší nebo roven velikosti 4 MiB.

Pokud je hlavička specifikována bez hlavičky Range , služba vrátí stavový kód 400 (Bad Request).

Pokud je hlavička nastavena na true dobu, kdy rozsah přesahuje 4 MiB, služba vrátí stavový kód 400 (Špatný požadavek).

Pokud jsou přítomny hlavičky i x-ms-range-get-content-md5 , x-ms-range-get-content-crc64 požadavek selže s 400 (Špatný požadavek).

Tato hlavička je podporována ve verzích 2019-02-02 a novějších.
Origin Optional. Specifikuje původ, odkud je požadavek vydán. Přítomnost této hlavičky vede k sdílení zdrojů napříč zdroji (CORS) v odpovědi.
x-ms-upn Optional. Verze 2023-11-03 a novší. Platí pro účty s povoleným hierarchickým jmenným prostorem. Pokud je to pravda, hodnoty uživatelské identity vrácené v x-ms-owner, x-ms-group a x-ms-acl hlavičkách odpovědí budou transformovány z ID objektů Microsoft Entra na User Principal Names. Pokud je hodnota nepravdivá, jsou vráceny jako ID objektů Microsoft Entra. Výchozí hodnota je false. Všimněte si, že ID skupinových a aplikačních objektů nejsou překládány, protože nemají jedinečná přátelská jména.
x-ms-client-request-id Optional. Poskytuje klientem generovanou neprůhlednou hodnotu s limitem znaků 1 kibibajt (KiB), který je zaznamenán v analytických logech při zapnutí logování analytického úložiště. Důrazně doporučujeme používat tuto hlavičku při korelaci aktivit na straně klienta s požadavky, které server přijímá. Pro více informací viz O logování Azure Storage Analytics.
x-ms-structured-body Optional. Verze 2025-01-05 a novější. Pokud je to specifikováno, služba vrátí obsah blobu zakódovaný ve strukturovaném těle. Hodnota této hlavičky obsahuje verzi a vlastnosti schématu zpráv.

V současnosti je jedinou podporovanou XSM/1.0; properties=crc64hodnotou , což znamená, že odpověď použije kontrolní součet crc64 v zakódované zprávě. Pokud hodnota neodpovídá, operace selže s chybovým kódem 400 (Špatný požadavek).

Tato operace také podporuje použití podmíněných hlaviček pro čtení blobu pouze v případě, že je splněna zadaná podmínka. Pro více informací viz Specifikace podmíněných hlaviček pro operace Blob Storage.

Záhlaví požadavků (šifrovací klíče poskytované zákazníkem)

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

Hlavička požadavku Description
x-ms-encryption-key Povinné. Šifrovací klíč AES-256 kódovaný v Base64.
x-ms-encryption-key-sha256 Optional. Hash SHA256 kódovaný v Base64 kódování šifrovacího klíče.
x-ms-encryption-algorithm: AES256 Povinné. Specifikuje algoritmus pro šifrování. Hodnota této hlavičky musí být AES256.

Obsah požadavku

Žádné.

Odezva

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

Stavový kód

Úspěšná operace pro přečtení celého blobu vrátí stavový kód 200 (OK).

Úspěšná operace pro přečtení určeného rozsahu vrací stavový kód 206 (Částečný obsah).

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

Hlavičky odpovědi

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

Syntaxe Description
Last-Modified Datum/čas, kdy byla blob naposledy upravena. Formát data se řídí dokumentem RFC 1123.

Jakákoli operace, která upraví 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 dále. Datum/čas, kdy byla hmota vytvořena. Formát data se řídí dokumentem RFC 1123.
x-ms-meta-name:value Sada párů jméno-hodnota, která je s tímto blobem spojena jako uživatelem definovaná metadata.
x-ms-tag-count Verze 2019-12-12 a později. Pokud má blob nějaké tagy, tato hlavička vrátí počet tagů uložených na blobu. Hlavička se nevrátí, pokud na blobu nejsou žádné tagy.
Content-Length Počet bajtů přítomných v těle odpovědi.
Content-Type Typ obsahu určený pro blob. Výchozí typ obsahu je application/octet-stream.
Content-Range Označuje rozsah bajtů, které se vrátí v případě, že klient požádal o podmnožinu blobu nastavením hlavičky Range požadavku.
ETag Obsahuje hodnotu, kterou můžete použít k podmíněnému provádění operací. Pro více informací viz Specifikace podmíněných hlaviček pro operace 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á blob MD5 hash a tato Get Blob operace slouží ke čtení celého blobu, tato odpověď se vrátí, aby klient mohl zkontrolovat integritu obsahu zprávy.

Ve verzi 2012-02-12 a pozdějších nastavuje Put Blob hash hodnotu MD5 blokového blobu, i když Put Blob požadavek neobsahuje hlavičku MD5.

Pokud je požadavek na čtení stanoveného rozsahu a je x-ms-range-get-content-md5 nastaven na true, požadavek vrátí hash MD5 pro rozsah, pokud je velikost rozsahu menší nebo rovna 4 MiB.

Pokud žádná z těchto sad podmínek není , truenení pro hlavičku Content-MD5 vrácena žádná hodnota.

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

Pokud x-ms-range-get-content-md5 je nastaveno tak, true že dosah přesahuje 4 MiB, služba vrátí stavový kód 400 (Špatný požadavek).
x-ms-content-crc64 Pokud je požadavek na čtení určeného rozsahu a je x-ms-range-get-content-crc64 nastaven na true, požadavek vrátí hash CRC64 pro tento rozsah, pokud je velikost rozsahu menší nebo rovna 4 MiB.

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

Pokud x-ms-range-get-content-crc64 je nastaveno tak, true že dosah přesahuje 4 MiB, služba vrátí stavový kód 400 (Špatný požadavek).
Content-Encoding Vrátí hodnotu, která byla určena pro hlavičku požadavku Content-Encoding .
Content-Language Vrátí hodnotu, která byla určena pro hlavičku požadavku Content-Language .
Cache-Control Vráceno, pokud byla hlavička dříve určena pro blob.
Content-Disposition Vráceno pro žádosti proti verzi 2013-08-15 a novějších. Tato hlavička vrací hodnotu určenou pro hlavičku x-ms-blob-content-disposition .

Pole Content-Disposition hlavičky odpovědi poskytuje další informace o tom, jak zpracovávat payload odpovědi, a může být použito k připojení dalších metadat. Například pokud je hlavička nastavena na attachment, znamená to, že user-agent by neměl zobrazovat odpověď. Místo toho zobrazuje dialog Uložit jako s jiným názvem souboru než specifikovaným názvem blob.
x-ms-blob-sequence-number Aktuální pořadové číslo objektu blob stránky.

Tato hlavička se nevrací pro blokové nebo přidávací bloby.
x-ms-blob-type: <BlockBlob | PageBlob | AppendBlob> Vrátí typ blobu.
x-ms-copy-completion-time: <datetime> Verze 2012-02-12 a později. Čas ukončení poslední Copy Blob pokusné operace, kdy tato hmota byla cílovou skvrnou. Tato hodnota může určit čas dokončení, přerušení nebo neúspěšného pokusu o kopírování. Tato hlavička se neobjeví, pokud je kopie v procesu, pokud tato blob nikdy nebyla cílem v operaci, Copy Blob nebo pokud byla tato blob upravena po dokončené Copy Blob operaci, která používala Set Blob Properties, Put Blob, nebo Put Block List.
x-ms-copy-status-description: <error string> Verze 2012-02-12 a později. Objevuje se pouze tehdy, když x-ms-copy-status je nebo failed .pending Popisuje příčinu poslední závažné nebo ne závažné operace kopírování. Tato hlavička se neobjeví, pokud tento blob nikdy nebyl cílem v operaci, Copy Blob nebo pokud byl blob upraven po dokončené Copy Blob operaci, která používala Set Blob Properties, Put Blob, nebo Put Block List.
x-ms-copy-id: <id> Verze 2012-02-12 a později. Identifikátor řetězce pro poslední pokus Copy Blob o operaci, kde byl tento blob cílovým blobem. Tato hlavička se neobjeví, pokud tento blob nikdy nebyl cílem v operaci, Copy Blob nebo pokud byl blob upraven po dokončené Copy Blob operaci, která používala Set Blob Properties, Put Blob, nebo Put Block List.
x-ms-copy-progress: <bytes copied/bytes total> Verze 2012-02-12 a později. Obsahuje počet bajtů, které byly zkopírovány, a celkový počet bajtů ve zdroji při poslední Copy Blob pokusu o operaci, kde byl tento blob cílovým blobem. Může zobrazit od 0 až po Content-Length zkopírované bajty. Tato hlavička se neobjeví, pokud tento blob nikdy nebyl cílem v operaci, Copy Blob nebo pokud byl blob upraven po dokončené Copy Blob operaci, která používala Set Blob Properties, Put Blob, nebo Put Block List.
x-ms-copy-source: url Verze 2012-02-12 a později. URL o délce až 2 KiB, která určuje zdrojový blob nebo soubor použitý při poslední Copy Blob pokusu o operaci, kde byl tento blob cílovým blobem. Tato hlavička se neobjeví, pokud tento blob nikdy nebyl cílem v operaci, Copy Blob nebo pokud byl blob upraven po dokončené Copy Blob operaci, která používala Set Blob Properties, Put Blob, nebo Put Block List.

URL, která je vrácena v této hlavičce, obsahuje všechny parametry požadavku, které byly použity při kopírování na zdrojovém blobu. Pokud URL obsahuje token Shared Access Signature (SAS), podpis (sig parametr) nebude zahrnut.
x-ms-copy-status: <pending | success | aborted | failed> Verze 2012-02-12 a později. Stav kopírovací operace identifikovaný pomocí x-ms-copy-id s těmito hodnotami:

- success: Kopie úspěšně dokončena.
- pending: Kopie je v procesu. Zkontrolujte, x-ms-copy-status-description zda občasné, nefatální chyby zpomalují kopírovat, ale nezpůsobují selhání.
- aborted: Kopie byla ukončena .Abort Copy Blob
- failed: Kopie neprošla. Podrobnosti o selhání najdete v popisu x-ms-copy-status-description.

Tato hlavička se neobjeví, pokud tento blob nikdy nebyl cílem Copy Blob v operaci, nebo pokud byl blob upraven po dokončení Copy Blob operace, která používala Set Blob Properties, Put Blob, nebo Put Block List.
x-ms-lease-duration: <infinite | fixed> Verze 2012-02-12 a později. Při zapůjčení objektu blob určuje, jestli je zapůjčení nekonečné nebo pevné doby trvání.
x-ms-lease-state: <available | leased | expired | breaking | broken> Verze 2012-02-12 a později. Stav pronájmu blobu.
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 podán, a může být použit k jeho vyřešení problémů. Další informace najdete v tématu Řešení potíží s operacemi rozhraní API.
x-ms-version Označuje verzi Blob Storage, která byla použita k vykonání požadavku. Zahrnuto pro požadavky vytvořené verzí 2009-09-19 a pozdějšími.

Tato hlavička se také vrací pro anonymní požadavky bez specifikované verze, pokud byl kontejner označen pro veřejný přístup pomocí verze Blob Storage 2009-09-19.
Accept-Ranges: bytes Označuje, že služba podporuje požadavky na částečný obsah objektu blob. Zahrnuto pro požadavky prováděné pomocí verze 2011-08-18 a novějších, a pro lokální úložnou službu ve verzi SDK 1.6 a novějších.
Date Hodnota data a času UTC vygenerovaná službou, která označuje čas zahájení odpovědi.
Access-Control-Allow-Origin Vráceno, pokud požadavek obsahuje Origin hlavičku a CORS je povolen s odpovídajícím pravidlem. Tato hlavička vrací hodnotu hlavičky požadavku původu v případě shody.
Access-Control-Expose-Headers Vráceno, pokud požadavek obsahuje Origin hlavičku a CORS je povolen s odpovídajícím pravidlem. Vrací seznam hlaviček odpovědí, které mají být zpřístupněny klientovi nebo vydavateli požadavku.
Vary Vrací se hodnota hlavičky, Origin když jsou specifikována pravidla CORS. Podrobnosti viz podpora CORS pro Azure Storage služby .
Access-Control-Allow-Credentials Vráceno, pokud požadavek obsahuje Origin hlavičku a CORS je povolen s odpovídajícím pravidlem, které nepovoluje všechny originy. Tato hlavička bude nastavena na true.
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 pozdější. Hodnota této hlavičky je nastavena na , true pokud jsou blob data a metadata aplikace zcela zašifrována pomocí specifikovaného algoritmu. Jinak je hodnota nastavena na ( false když je blob nešifrován, nebo pokud jsou zašifrovány pouze části blobu či metadat aplikace).
x-ms-encryption-key-sha256 Verze 2019-02-02 a dále. Tato hlavička se vrátí, pokud je blob zašifrován zákazníkem zadaným klíčem.
x-ms-encryption-context Verze 2021-08-06 a pozdější. Pokud je nastavena hodnota vlastnosti kontextu šifrování, vrátí nastavenou hodnotu. Platné pouze v případě, že je pro účet povolený hierarchický obor názvů.
x-ms-encryption-scope Verze 2019-02-02 a dále. Tato hlavička se vrátí, pokud je blob zašifrován šifrovacím rozsahem.
x-ms-blob-content-md5 Verze 2016-05-31 a později. Pokud má blob MD5 hash a pokud požadavek obsahuje hlavičku rozsahu (Range nebo x-ms-range), tato odpověď hlavička se vrátí s hodnotou MD5 hodnoty celého blobu. Tato hodnota může, ale nemusí být rovna hodnotě vrácené v hlavičce Content-MD5, přičemž ta je vypočítána z požadovaného rozsahu.
x-ms-client-request-id Lze použít k řešení problémů s požadavky a odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě hlavičky x-ms-client-request-id, pokud se nachází v požadavku a hodnota neobsahuje více než 1 024 viditelných znaků ASCII. Pokud x-ms-client-request-id hlavička není v požadavku přítomna, není v odpovědi přítomna.
x-ms-last-access-time Verze 2020-02-10 a novší. Označuje poslední přístup k datům blobu na základě politiky sledování času posledního přístupu úložiště. Hlavička se nevrátí, pokud účet úložiště nemá politiku sledování času posledního přístupu, nebo pokud je politika deaktivovaná. Pro informace o nastavení politiky sledování času posledního přístupu k úložišti viz Blob Service API.
x-ms-blob-sealed Verze 2019-12-12 a později. Vracel se jen kvůli append blobs. Pokud byl připojený blob zapečetěn, hodnota by byla true. Pro více informací viz Append Blob Seal
x-ms-immutability-policy-until-date Verze 2020-06-12 a pozdější. Specifikuje dobu udržení do data, které je na blobu nastaveno. To je datum, do kterého může být blob chráněn před úpravou nebo smazáním. Vráceno pouze tehdy, pokud je na blobu nastavena politika neměnnosti. Hodnota této hlavičky je ve RFC1123 formátu.
x-ms-immutability-policy-mode: unlocked/locked Verze 2020-06-12 a pozdější. Vráceno, pokud je na blobu nastavena politika neměnnosti. Hodnoty jsou unlocked a locked. unlocked Označuje, že uživatel může politiku změnit zvýšením nebo snížením doby udržení až do data. locked označuje, že tyto činnosti jsou zakázány.
x-ms-legal-hold: true/false Verze 2020-06-12 a pozdější. Tato hlavička se nevrátí, pokud na blob není právní zadržení. Hodnota této hlavičky je nastavena na , true pokud blob obsahuje legální držení a jeho hodnota je true. Jinak je hodnota nastavena na , false pokud blob obsahuje legální držení a jeho hodnota je false.
x-ms-owner Verze 2020-06-12 a pozdější, pouze pro účty s povoleným hierarchickým jmenným prostorem. Vrátí vlastníka-uživatele souboru nebo adresáře.
x-ms-group Verze 2020-06-12 a pozdější, pouze pro účty s povoleným hierarchickým jmenným prostorem. Vrátí skupinu vlastníka souboru nebo adresáře.
x-ms-permissions Verze 2020-06-12 a pozdější, pouze pro účty s povoleným hierarchickým jmenným prostorem. Vrací nastavení oprávnění pro uživatele, skupinu a další v souboru nebo adresáři. Každé individuální povolení je ve formátu [r,w,x,-]{3} .
x-ms-acl Verze 2023-11-03 a novší. Pouze pro účty s povoleným hierarchickým jmenným prostorem. Vrátí kombinovaný seznam přístupových a výchozích kontrolních seznamů přístupu, které jsou nastaveny pro uživatele, skupinu a další v souboru nebo adresáři. Každý záznam v řízení přístupu (ACE) se skládá z rozsahu, typu, identifikátoru uživatele nebo skupiny a oprávnění ve formátu [scope]:[type]:[id]:[permissions]. Rozsah označuje default , že ACE patří do výchozího ACL adresáře; jinak je rozsah implicitní a ACE patří do přístupové ACL. Každé individuální povolení je ve formátu [r,w,x,-]{3} .
x-ms-resource-type Verze 2020-10-02 a pozdější, pouze pro účty s povoleným hierarchickým jmenným prostorem. Vrací typ zdroje pro cestu, který může být buď file nebo directory.

Hlavičky odpovědí (strukturované tělo)

Od verze 2025-01-05 budou následující hlavičky vráceny, pokud požadavek odešle platnou x-ms-structured-body hlavičku.

Hlavička odpovědi Description
Content-Length Bude délka zakódované odezvy (nejen délka vráceného obsahu blobu).
x-ms-structured-body Hodnota této hlavičky je rovna hodnotě zaslané v požadavku, která musí být XSM/1.0; properties=crc64aktuálně .
x-ms-structured-content-length Hodnota této hlavičky je délka vráceného obsahu blobu a vždy bude menší než Content-Length hodnota hlavičky kvůli kódování zpráv.

Obsah odpovědi

Tělo odpovědi obsahuje obsah blobu.

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>

Authorization

Autorizace se vyžaduje při volání jakékoli operace přístupu k datům ve službě Azure Storage. Operaci Get Blob můžete autorizovat, 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 poskytuje vynikající zabezpečení a snadné použití v porovnání s autorizací sdíleného klíče.

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

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

Povolení

Níže je uvedena akce RBAC potřebná pro uživatele, skupinu, spravovanou identitu nebo instanční objekt Microsoftu pro volání operace Get Blob a nejméně privilegované předdefinované 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

Pro page blob operace nad rozsahem stránek, Get Blob které ještě neobsahují obsah nebo byly vyčištěny, vrací nuly pro tyto bajty.

Pokud voláte Get Blob blob stránky bez specifikovaného rozsahu, služba vrátí rozsah stránek až do specifikované hodnoty hlavičky x-ms-blob-content-length . Pro stránky, které postrádají obsah, služba vrací nuly pro tyto bajty.

Pro append blob Get Blob operace vrací hlavičku x-ms-blob-committed-block-count . Tato hlavička ukazuje počet popsaných bloků v blobu. Hlavička x-ms-blob-committed-block-count se nevrací u blokových nebo stránkových blobů.

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

Hlavička x-ms-version je potřeba k získání blobu, který patří do soukromého kontejneru. Pokud blob patří do kontejneru, který je k dispozici pro plný nebo částečný veřejný přístup, může jej přečíst jakýkoli klient bez specifikace verze; Servisní verze není potřeba pro získání blobu patřícího do veřejného kontejneru. Pro více informací viz Omezit přístup ke kontejnerům a blobům.

Operace Get Blob na archivovaném blokovém blobu selže.

Kopírování operací

Pro ověření, zda byla operace dokončena Copy Blob , nejprve zkontrolujte, zda x-ms-copy-id hodnota hlavičky cílového blobu odpovídá kopii ID poskytnuté původním voláním do Copy Blob. Shoda zajišťuje, že jiná aplikace kopii nezrušila a nespustila novou Copy Blob operaci. Dále zkontrolujte hlavičku x-ms-copy-status: success . Mějte však na paměti, že všechny zápisové operace na blob kromě Lease, , a Put Page operace odstraní všechny Put Blockx-ms-copy-*vlastnosti blobu. Tyto vlastnosti také nejsou kopírovány Copy Blob operacemi, které používají verze Blob Storage starší než 12. 2. 2012.

Poznámka:

URL, která se vrátí v hlavičce x-ms-copy-source , obsahuje všechny parametry požadavku, které byly použity při kopírování na zdrojovém blobu. Pokud byl k přístupu ke zdrojovému blobu použit token Shared Access Signature (SAS), SAS token se objeví v hlavičce x-ms-copy-source , když Get Blob je vyvolán na cílovém blobu, ale podpis (sig parametr dotazu) bude odstraněn.

Když x-ms-copy-status: failed se objeví v odpovědi, obsahuje x-ms-copy-status-description více informací o selhání Copy Blob .

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

Součást Description
Stavový kód HTTP Standardní třímístné celé číslo, které určuje selhání.
Kód chyby Klíčové slovo, které popisuje chybu, a které poskytuje Azure v elementu <ErrorCode> . Pokud se neobjeví <žádný prvek ErrorCode> , použije se klíčové slovo obsahující standardní chybový text spojený se třímístným HTTP stavovým kódem ve specifikaci HTTP. Viz chybové kódy Common REST API.
Information Podrobný popis selhání, ukrytý uvozovkami.

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

Důležité

Popisy chyb v této tabulce se mohou změnit bez varování, 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 kopírování dříve, než byla dokončena. Přerušena empty
Při čtení ze zdrojového blobu během kopírování došlo k selhání, ale operace bude zopakována. Čeká se na zadání 502 BadGateway "Došlo k chybě opakovatelné při čtení zdroje. Zkusí to znovu. Čas poruchy: <čas>"
Při zápisu do cílového blobu kopírovací operace došlo k selhání, ale operace bude znovu vyzkoušena. Čeká se na zadání 500 InternalServerError "Došlo k chybě opakovatelné. Zkusí to znovu. Čas poruchy: <čas>"
Při čtení ze zdrojového objektu blob operace kopírování došlo k neopravitelné chybě. selhalo 404 ResourceNotFound "Kopie selhala při čtení zdroje."

Poznámka: Když služba nahlásí tuto základní chybu, vrací se v ResourceNotFound prvku ErrorCode . Pokud se v odpovědi neobjevil žádný ErrorCode prvek, objeví se standardní reprezentace HTTP stavu, například NotFound, ve tvaru řetězce.
Vypršel časový limit pro všechny operace kopírování. (V současnosti je doba přestávky 2 týdny.) selhalo 500 OperationCancelled "Kopie překročila maximální povolenou dobu.".
Kopírování při čtení ze zdroje selhávalo příliš často a nedosáhlo minimálního poměru pokusů k úspěchům. (Tento časový limit zabraňuje opakování velmi špatného zdroje během dvou týdnů před selháním). selhalo 500 OperationCancelled "Kopie selhala při čtení zdroje"

x-ms-last-access-time Sleduje čas, kdy byla data BLOB přístupná, na základě politiky sledování času posledního přístupu úložiště. Přístup k metadatům blobu nemění jeho poslední dobu přístupu.

Fakturování

Požadavky na stanovení cen mohou pocházet od klientů, kteří používají rozhraní API služby Blob Storage, a to buď přímo prostřednictvím rozhraní REST API služby Blob Storage, nebo z klientské knihovny Azure Storage. Za tyto žádosti se účtují poplatky za transakci. Typ transakce má vliv na způsob účtování poplatků. Například transakce čtení narůstají do jiné fakturační kategorie než transakce zápisu. Následující tabulka uvádí kategorii fakturace pro Get Blob požadavky na základě typu účtu úložiště:

Operation Typ účtu úložiště Kategorie fakturace
Získat objekt blob Objekt blob bloku Premium
Standard pro obecné účely verze 2
Standard pro obecné účely verze 1		 Operace čtení

Další informace o cenách pro zadanou kategorii fakturace najdete v tématu Ceny služby Azure Blob Storage.

Viz také

Autorizace požadavků na Azure Storage
Kódy stavu a chyb
kódy chyb Blob Storage
Nastavte časové limity pro operace Blob Storage

  • Last updated on