Získat soubor

Operace Get File přečte nebo stáhne soubor ze systému, včetně jeho metadat a vlastností.

Dostupnost protokolu

Povolený protokol sdílených složek	K dispozici.
SMB
NFS

Žádost

Požadavek Get File může být vytvořen následujícím způsobem. Doporučujeme použít https.

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
GET	https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile	HTTP/1.1

Následujícím způsobem nahraďte komponenty cesty, které jsou uvedené v identifikátoru URI požadavku, vlastními:

Komponenta Cesta	Description
myaccount	Název vašeho účtu úložiště.
myshare	Název sdílené složky.
mydirectorypath	Nepovinný parametr. Cesta k adresáři.
myfile	Název souboru.

Informace o omezeních pojmenování cest najdete v tématu Názvy a odkazy na sdílené složky, adresáře, soubory a metadata.

Parametry identifikátoru URI

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

Parametr	Popis
timeout	Nepovinný parametr. Parametr timeout je vyjádřen v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace Azure Files.

Hlavičky požadavku

Požadované a volitelné hlavičky požadavků jsou popsané v následující tabulce:

Hlavička požadavku	Popis
Authorization	Povinná hodnota. Určuje autorizační schéma, 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	Povinné pro všechny autorizované žádosti. Určuje verzi operace, která se má použít pro tento požadavek. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
Range	Nepovinný parametr. Vrátí data souboru pouze ze zadané oblasti bajtů.
x-ms-range	Nepovinný parametr. Vrátí data souboru pouze ze zadané oblasti bajtů. Pokud jsou zadány obě Rangex-ms-range a, služba použije hodnotu x-ms-range. Pokud není zadán ani jeden, vrátí se celý obsah souboru. Další informace najdete v tématu Určení záhlaví rozsahu pro operace Azure Files.
x-ms-range-get-content-md5: true	Nepovinný parametr. Pokud je tato hlavička nastavená na true a je zadána společně se záhlavím Range , vrátí služba hodnotu hash MD5 pro oblast, pokud je rozsah menší nebo roven 4 mebibajtům (MiB). Pokud je tato hlavička zadána bez hlavičky Range , vrátí služba stavový kód 400 (Chybný požadavek). Pokud je tato hlavička nastavená na true velikost rozsahu větší než 4 MiB, vrátí služba stavový kód 400 (chybný požadavek).
x-ms-lease-id:<ID>	Nepovinný parametr. Verze 2019-02-02 a novější. Pokud je zadána hlavička, operace se provede pouze v případě, že je zapůjčení souboru aktuálně aktivní a ID zapůjčení zadané v požadavku odpovídá ID zapůjčení souboru. V opačném případě operace selže se stavovým kódem 412 (předběžná podmínka selhala).
x-ms-client-request-id	Nepovinný parametr. Poskytuje klientem vygenerovanou neprůselnou hodnotu s limitem počtu znaků 1 kibibajt (KiB), který je zaznamenán v protokolech při konfiguraci protokolování. Důrazně doporučujeme použít tuto hlavičku ke korelaci aktivit na straně klienta s požadavky, které server přijímá. Další informace najdete v tématu Monitorování Azure Files.
x-ms-file-request-intent	Vyžaduje se, pokud Authorization hlavička určuje token OAuth. Přijatelná hodnota je backup. Tato hlavička určuje, že Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action by se měly udělit nebo Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action , pokud jsou zahrnuté v zásadách RBAC přiřazených k identitě, která je autorizována pomocí hlavičky Authorization . K dispozici pro verzi 2022-11-02 a novější.
x-ms-allow-trailing-dot: { <Boolean> }	Nepovinný parametr. Verze 2022-11-02 a novější. Logická hodnota určuje, jestli se má v adrese URL požadavku oříznout koncová tečka, nebo ne. Další informace najdete v tématu Pojmenování sdílených složek, adresářů, souborů a metadat a odkazování na nich.

Text požadavku

Žádné

Odpověď

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

Stavový kód

Úspěšná operace vrátí stavový kód 200 (OK).

Informace o stavových kódech najdete v tématu Stavové kódy a kódy 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.

Hlavička odpovědi	Description
Last-Modified	Vrátí datum a čas poslední změny souboru. Formát data se řídí dokumentem RFC 1123. Další informace najdete v tématu Reprezentace hodnot data a času v záhlavích. Každá operace, která upraví soubor nebo jeho vlastnosti, aktualizuje čas poslední změny.
x-ms-meta-name:value	Sada párů název-hodnota přidružených k tomuto souboru jako uživatelem definovaná metadata.
Content-Length	Počet bajtů v textu odpovědi.
Content-Type	Typ obsahu zadaný pro soubor. Výchozí typ obsahu je application/octet-stream.
Content-Range	Rozsah bajtů vrácený v případě, že klient požádal o podmnožinu souboru nastavením hlavičky Range požadavku.
ETag	Obsahuje hodnotu, kterou můžete použít k podmíněnému provádění operací. Hodnota je uzavřena v uvozovkách.
Content-MD5	Pokud má soubor hodnotu hash MD5 a požadavek na přečtení celého souboru, vrátí se tato hlavička odpovědi, aby klient mohl zkontrolovat integritu obsahu zprávy. Pokud má požadavek přečíst zadaný rozsah a x-ms-range-get-content-md5 hodnota je nastavená na true, vrátí požadavek hodnotu hash MD5 pro oblast, pokud je velikost rozsahu menší nebo rovna 4 MiB. Pokud žádná z těchto sad podmínek není true, není vrácena žádná hodnota pro hlavičku Content-MD5 . Pokud x-ms-range-get-content-md5 je zadána bez hlavičky rozsahu, 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).
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átí se, pokud byl dříve zadán pro soubor.
Content-Disposition	Vrátí hodnotu, která byla zadána pro hlavičku x-ms-content-disposition a určuje způsob zpracování odpovědi. Pole Content-Disposition záhlaví odpovědi sděluje další informace o tom, jak zpracovat datovou část odpovědi, a dá se také použít k připojení dalších metadat. Pokud je například nastavená hodnota attachment, Content-Disposition znamená, že user-agent by neměl zobrazovat odpověď, ale místo toho by měl zobrazit okno Uložit jako.
x-ms-request-id	Jedineč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	Verze služby, která se použila ke spuštění požadavku.
Accept-Ranges: bytes	Označuje, že služba podporuje požadavky na částečný obsah souborů.
Date	Date
x-ms-copy-completion-time:<datetime>	Verze 2015-02-21 a novější. Čas ukončení poslední operace kopírování souboru , kdy byl tento soubor cílovým souborem. 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 soubor nikdy nebyl cílem operace Kopírování souboru nebo pokud byl tento soubor změněn po dokončení operace Kopírování souboru , která používala nastavení vlastností souboru nebo Vytvoření souboru.
x-ms-copy-status-description: <error string>	Verze 2015-02-21 a novější. Zobrazí se pouze v případě, že x-ms-copy-statusdošlo k selhání nebo čekání na vyřízení. Popisuje příčinu závažného nebo jiného závažného selhání operace kopírování. Tato hlavička se nezobrazí, pokud tento soubor nikdy nebyl cílem operace Kopírování souboru nebo pokud byl tento soubor změněn po dokončení operace Kopírování souboru , která používala nastavení vlastností souboru nebo vytvoření souboru.
x-ms-copy-id: <id>	Verze 2015-02-21 a novější. Identifikátor řetězce posledního pokusu o operaci Kopírování souboru , kde byl tento soubor cílovým souborem. Tato hlavička se nezobrazí, pokud soubor nikdy nebyl cílem operace Kopírování souboru nebo pokud byl tento soubor změněn po dokončené operaci Kopírování souboru , která používala nastavení vlastností souboru nebo vytvoření souboru.
x-ms-copy-progress: <bytes copied/bytes total>	Verze 2015-02-21 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 operaci Kopírování souboru , kde byl tento soubor cílovým souborem. Může zobrazit od 0 do počtu zkopírovaných Content-Length bajtů. Tato hlavička se nezobrazí, pokud tento soubor nikdy nebyl cílem operace Kopírování souboru nebo pokud byl tento soubor změněn po dokončení operace Kopírování souboru , která používala nastavení vlastností souboru nebo vytvoření souboru.
x-ms-copy-source: url	Verze 2015-02-21 a novější. Adresa URL o délce až 2 kB, která určuje zdrojový soubor, který byl použit při posledním pokusu o operaci Kopírování souboru , kde byl tento soubor cílovým souborem. Tato hlavička se nezobrazí, pokud tento soubor nikdy nebyl cílem operace Kopírování souboru nebo pokud byl tento soubor změněn po dokončení operace Kopírování souboru , která používala nastavení vlastností souboru nebo vytvoření souboru.
x-ms-copy-status: <pending ¦ success ¦ aborted ¦ failed>	Verze 2015-02-21 a novější. Stav operace kopírování, která je identifikována nástrojem x-ms-copy-id, s těmito hodnotami: - pending: Probíhá kopírování. Zkontrolujte x-ms-copy-status-description , jestli občasné, ne závažné chyby brání průběhu kopírování, ale nezpůsobují selhání. - success: Kopírování bylo úspěšně dokončeno. - aborted: Kopírování bylo ukončeno přerušením kopírování souboru. - 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 soubor nikdy nebyl cílem operace Kopírování souboru nebo pokud byl tento soubor změněn po dokončení operace Kopírování souboru , která používala nastavení vlastností souboru nebo vytvoření souboru.
x-ms-content-md5	Od verze 2016-05-31 platí, že pokud má soubor 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 souboru. Tato hodnota se může nebo nemusí rovnat hodnotě vrácené v Content-MD5 hlavičce, která se vypočítá z požadovaného rozsahu.
x-ms-server-encrypted: true/false	Verze 2017-04-17 a novější. Hodnota této hlavičky je nastavena na true , pokud jsou data souboru a metadata aplikace zcela šifrovaná pomocí zadaného algoritmu. Pokud je soubor nešifrovaný nebo pokud jsou zašifrovány jenom části metadat souboru nebo aplikace, je hodnota nastavená na false.
x-ms-file-permission-key	Klíč oprávnění k souboru.
x-ms-file-attributes	Atributy systému souborů v souboru. Další informace najdete v seznamu dostupných atributů.
x-ms-file-creation-time	Hodnota data a času UTC, která představuje vlastnost času vytvoření souboru.
x-ms-file-last-write-time	Hodnota data a času UTC, která představuje vlastnost posledního času zápisu souboru.
x-ms-file-change-time	Datum a čas UTC, která představuje vlastnost čas změny souboru.
x-ms-file-file-id	ID souboru.
x-ms-file-parent-id	ID nadřazeného souboru souboru.
x-ms-lease-duration:infinite	Verze 2019-02-02 a novější. Při zapůjčení souboru určuje, že zapůjčení má neomezenou dobu trvání.
x-ms-lease-state: <available, leased, broken>	Verze 2019-02-02 a novější. Při zapůjčení souboru určuje stav zapůjčení souboru.
x-ms-lease-status: <locked, unlocked>	Verze 2019-02-02 a novější. Při zapůjčení souboru určuje stav zapůjčení souboru.
x-ms-client-request-id	Dá se použít k řešení potíží s požadavky a jejich 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í v odpovědi.

Text odpovědi

Text odpovědi obsahuje obsah souboru.

Ukázková odpověď

Response Status:
HTTP/1.1 200 OK

Response Headers:
x-ms-type: File
x-ms-meta-m1: v1
x-ms-meta-m2: v2
Content-Length: 11
Content-Type: text/plain; charset=UTF-8
Date: <date>
ETag: "0x8CB171DBEAD6A6B"
Last-Modified: <date>
x-ms-version: 2019-02-02
Server: Windows-Azure-File/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>
x-ms-lease-duration: infinite
x-ms-lease-state: leased
x-ms-lease-status: locked

Autorizace

Tuto operaci může volat pouze vlastník účtu.

Poznámky

Volání Get File v rozsahu, který ještě neobsahuje obsah nebo který byl vymazán, vrátí pro 0 tyto bajty.

Pokud voláte Get File bez zadaného rozsahu, vrátí služba rozsah bajtů až do hodnoty zadané pro hlavičku x-ms-content-length . U všech oblastí, které neobsahují obsah, vrátí 0 služba tyto bajty.

Operace Get File je povolena dvě minuty na dokončení MiB. Vyprší časový limit operací, které v průměru na MiB zaberou déle než dvě minuty.

Viz také

Operace na Azure Files