Získat soubor

Operace Get File načte nebo stáhne soubor ze systému, včetně jeho metadat a vlastností. Tato operace je podporována ve verzi 2025-05-05 a novější pro sdílené složky s povoleným protokolem NFS.

Dostupnost protokolu

Povolený protokol sdílené složky	K dispozici
SMB
NFS

Prosba

Požadavek Get File je vytvořen následujícím způsobem. Doporučujeme používat PROTOKOL HTTPS.

Metoda	Identifikátor URI požadavku	Verze HTTP
DOSTAT	https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile	HTTP/1.1

Součásti cesty, které se zobrazují v identifikátoru URI požadavku, nahraďte vlastními:

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

Informace o omezeních pojmenování cest najdete v tématu Název a referenční 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	Volitelný. Parametr timeout se vyjadřuje v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace azure Files.

Hlavičky požadavku

Povinná a volitelná hlavička požadavku jsou popsána v následujících tabulkách:

Běžné hlavičky požadavků

Hlavička požadavku	Popis
Authorization	Požadovaný. 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	Požadovaný. 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žaduje se pro všechny autorizované žádosti. Určuje verzi operace, která se má pro tento požadavek použít. Tato operace je podporována ve verzi 2025-05-05 a novější pro sdílené složky s povoleným protokolem NFS. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
Range	Volitelný. Vrátí data souboru pouze ze zadané oblasti bajtů.
x-ms-range	Volitelný. Vrátí data souboru pouze ze zadané oblasti bajtů. Pokud jsou zadány Range i x-ms-range, služba použije hodnotu x-ms-range. Pokud není zadána žádná hodnota, vrátí se celý obsah souboru. Další informace najdete v tématu Zadání hlavičky rozsahu pro operace azure Files.
x-ms-range-get-content-md5: true	Volitelný. Pokud je tato hlavička nastavená na true a je zadaná společně s hlavičkou Range, vrátí služba hodnotu hash MD5 pro rozsah, pokud je rozsah menší nebo roven 4 mebibajtem (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 pokud rozsah překročí velikost 4 MiB, vrátí služba stavový kód 400 (Chybný požadavek).
x-ms-lease-id:<ID>	Volitelný. 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. Jinak operace selže se stavovým kódem 412 (předběžná podmínka se nezdařila). Tato hlavička se ignoruje, pokud se soubor nachází ve sdílené složce s povoleným protokolem NFS, který nepodporuje zapůjčení souborů.
x-ms-client-request-id	Volitelný. Poskytuje hodnotu vygenerovanou klientem, neprůshlenou hodnotou s limitem 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í služby Azure Files.
x-ms-file-request-intent	Vyžaduje se, pokud hlavička Authorization určuje token OAuth. Přijatelná hodnota je backup. Tato hlavička určuje, že se mají udělit Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action nebo Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action, pokud jsou zahrnuty do zásad RBAC přiřazené k identitě, která je autorizovaná pomocí hlavičky Authorization. K dispozici pro verzi 2022-11-02 a novější.
x-ms-allow-trailing-dot: { <Boolean> }	Volitelný. Verze 2022-11-02 a novější. Logická hodnota určuje, jestli by se měla oříznout koncová tečka v adrese URL požadavku, nebo ne. Tato hlavička se ignoruje, pokud se cíl nachází ve sdílené složce s povoleným protokolem NFS, který ve výchozím nastavení podporuje koncové tečky. Další informace najdete v tématu Pojmenování a odkazování na sdílené složky, adresáře, soubory a metadata.

Hlavičky požadavků jenom smb

Žádný.

Pouze hlavičky požadavků NFS

Žádný.

Text požadavku

Žádný.

Odpověď

Odpověď obsahuje stavový kód HTTP, sadu hlaviček odpovědí a text 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 naleznete v tématu Stav a kódy chyb.

Hlavičky odpovědi

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

Běžná hlavička odpovědi

Hlavička odpovědi	Popis
Last-Modified	Vrátí datum a čas poslední změny souboru. Formát data se řídí dokumentem RFC 1123. Další informace naleznete v tématu Reprezentace hodnot data a času v záhlavích. Jakákoli 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živatelsky definovaná metadata.
Content-Length	Počet bajtů, které jsou přítomné 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ých v případě, že klient požadoval podmnožinu souboru nastavením hlavičky požadavku Range.
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 je přečíst celý soubor, vrátí se tato hlavička odpovědi, aby klient mohl zkontrolovat integritu obsahu zprávy. Pokud požadavek čte zadanou oblast a x-ms-range-get-content-md5 je nastavená na true, vrátí požadavek hodnotu hash MD5 pro rozsah, pokud je velikost rozsahu menší nebo rovna 4 MiB. Pokud není žádná z těchto sad podmínek true, pro hlavičku Content-MD5 se nevrátí žádná hodnota. Pokud x-ms-range-get-content-md5 zadáte bez hlavičky rozsahu, vrátí služba stavový kód 400 (Chybný požadavek). Pokud je x-ms-range-get-content-md5 nastavená na true, když rozsah překročí 4 MiB, vrátí služba stavový kód 400 (chybný požadavek).
Content-Encoding	Vrátí hodnotu zadanou pro hlavičku požadavku Content-Encoding.
Content-Language	Vrátí hodnotu zadanou pro hlavičku požadavku Content-Language.
Cache-Control	Je vrácena, pokud byla dříve zadána pro soubor.
Content-Disposition	Vrátí hodnotu zadanou pro hlavičku x-ms-content-disposition a určuje, jak zpracovat odpověď. Pole hlavičky odpovědi Content-Disposition 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á na attachment, Content-Disposition indikuje, že uživatel-agent by neměl zobrazit odpověď, ale místo toho by měl zobrazit okno Uložit jako.
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	Verze služby, která byla použita k provedení požadavku.
Accept-Ranges: bytes	Označuje, že služba podporuje požadavky na částečný obsah souboru.
Date	Date
x-ms-copy-completion-time:<datetime>	Verze 2015-02-21 a novější Čas ukončení posledního pokusu operace kopírování souboru, kde byl tento soubor cílovým souborem. 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 nezobrazí, pokud kopie čeká na vyřízení, pokud tento soubor nikdy nebyl cílem operace Kopírovat soubor nebo pokud byl tento soubor změněn po ukončení operace Kopírovat soubor, která používala Nastavit vlastnosti souboru nebo Vytvořit soubor.
x-ms-copy-status-description: <error string>	Verze 2015-02-21 a novější Zobrazí se pouze v případech, kdy x-ms-copy-statusselhala nebo čekající. Popisuje příčinu závažné nebo ne fatální operace kopírování. Tato hlavička se nezobrazí, pokud tento soubor nikdy nebyl cílem operace Kopírovat soubor nebo pokud byl tento soubor upraven po ukončení operace Kopírovat soubor, která používala Nastavit vlastnosti souboru nebo Vytvořit soubor.
x-ms-copy-id: <id>	Verze 2015-02-21 a novější Identifikátor řetězce posledního pokusu Operace 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írovat soubor nebo pokud byl tento soubor změněn po ukončení operace Kopírovat soubor, která používala Nastavit vlastnosti souboru nebo Vytvořit soubor.
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 v posledním pokusu kopírování souboru operace, 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írovat soubor nebo pokud byl tento soubor upraven po ukončení operace Kopírovat soubor, která používala Nastavit vlastnosti souboru nebo Vytvořit soubor.
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 kopírování souboru operace, ve které byl tento soubor cílovým souborem. Tato hlavička se nezobrazí, pokud tento soubor nikdy nebyl cílem operace Kopírovat soubor nebo pokud byl tento soubor upraven po dokončení operace Kopírovat soubor, která používala Nastavit vlastnosti souboru nebo Vytvořit soubor.
x-ms-copy-status: <pending ¦ success ¦ aborted ¦ failed>	Verze 2015-02-21 a novější Stav operace kopírování identifikovaný x-ms-copy-ids těmito hodnotami: - pending: Probíhá kopírování. Zkontrolujte, x-ms-copy-status-description, pokud přerušované, 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í skončilo Abort Copy File . - failed: Kopírování se nezdařilo. Podrobnosti o selhání najdete v x-ms-copy-status-description. Tato hlavička se nezobrazí, pokud tento soubor nikdy nebyl cílem operace Kopírovat soubor nebo pokud byl tento soubor změněn po dokončení operace Kopírovat soubor, která používala Nastavit vlastnosti souboru nebo Vytvořit soubor.
x-ms-content-md5	Od verze 2016-05-31 platí, že pokud má soubor hodnotu hash MD5 a pokud 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 hlavičce Content-MD5, 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šifrované pouze části metadat souboru nebo aplikace, je hodnota nastavena na false.
x-ms-file-creation-time	Hodnota data a času UTC, která představuje vlastnost čas 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	Hodnota data a času UTC, která představuje vlastnost změnit čas 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ě 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 v požadavku není hlavička x-ms-client-request-id, není v odpovědi k dispozici.

Hlavičky odpovědi pouze smb

Hlavička odpovědi	Popis
x-ms-file-permission-key	Verze 2019-02-02 a novější. Klíč oprávnění souboru.
x-ms-file-attributes	Verze 2019-02-02 a novější. Atributy systému souborů souboru. Další informace najdete v seznamu dostupných atributů.

Pouze hlavičky odpovědi NFS

Hlavička odpovědi	Popis
x-ms-mode	Verze 2025-05-05 a novější. Režim souboru. Viz oprávnění k souborům POSIX (režim).
x-ms-owner	Verze 2025-05-05 a novější. Identifikátor uživatele (UID) vlastníka souboru.
x-ms-group	Verze 2025-05-05 a novější. Identifikátor skupiny (GID) vlastníka souboru.
x-ms-link-count	Verze 2025-05-05 a novější. Počet odkazů souboru.

Text odpovědi

Tělo 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

Oprávnění

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

Atributy systému souborů

Atribut	Atribut souboru Win32	Definice
Jen pro čtení	FILE_ATTRIBUTE_READONLY	Soubor, který je jen pro čtení. Aplikace můžou soubor číst, ale nemůžou do něj zapisovat ani je odstraňovat.
Schovaný	FILE_ATTRIBUTE_HIDDEN	Soubor je skrytý. Není součástí běžného seznamu adresářů.
Systém	FILE_ATTRIBUTE_SYSTEM	Soubor, ze kterého operační systém používá část nebo používá výhradně.
Žádný	FILE_ATTRIBUTE_NORMAL	Soubor, který nemá nastavené další atributy. Tento atribut je platný pouze v případě, že se používá samostatně.
Archivovat	FILE_ATTRIBUTE_ARCHIVE	Soubor, který je archivní soubor. Aplikace obvykle používají tento atribut k označení souborů pro zálohování nebo odebrání.
Dočasný	FILE_ATTRIBUTE_TEMPORARY	Soubor, který se používá pro dočasné úložiště.
Offline	FILE_ATTRIBUTE_OFFLINE	Data souboru nejsou k dispozici okamžitě. Tento atribut systému souborů je prezentován především kvůli zajištění kompatibility s Windows. Služba Azure Files nepodporuje možnosti offline úložiště.
NotContentIndexed	FILE_ATTRIBUTE_NOT_CONTENT_INDEXED	Soubor není indexován službou indexování obsahu.
NoScrubData	FILE_ATTRIBUTE_NO_SCRUB_DATA	Datový proud uživatele nemusí být čten skenerem integrity dat na pozadí. Tento atribut systému souborů je prezentován především kvůli zajištění kompatibility s Windows.

Oprávnění k souborům POSIX (režim)

Oprávnění k souborům POSIX je možné zadat číselně v osmičkovém formátu 12bitového formátu nebo v symbolickém formátu rwx. Příklady:

• "0644" nebo "rw-r--r--": Uživatel (vlastník souboru) má oprávnění ke čtení a zápisu. Skupina má oprávnění ke čtení. Ostatní mají oprávnění ke čtení.
• 0755 nebo rwxr-xr-x: Uživatel (vlastník souboru) má oprávnění ke čtení, zápisu a spuštění. Skupina má oprávnění ke čtení a spuštění. Ostatní mají oprávnění ke čtení a spouštění.

Číselný osmičkový formát

Tři osmičková čísla nejnižšího pořadí představují oprávnění pro vlastníka/uživatele, skupinu a další a označují se pomocí osmičkového čísla (0–7), která se vytvoří pomocí bitové kombinace 4 (čtení), 2 (zápis), 1 (Spustit). Osmičkové číslo nejvyššího pořadí (0–7) se používá k označení kombinace oprávnění 4 (SetUID), 2 (SetGID), 1 (StickyBit).

Formát	Povolení
0700	Uživatel (vlastník souboru) má oprávnění ke čtení, zápisu a spuštění.
0400	Uživatel má oprávnění ke čtení.
0200	Uživatel má oprávnění k zápisu.
0100	Uživatel má oprávnění ke spuštění.
0070	Skupina má oprávnění ke čtení, zápisu a spuštění.
0040	Skupina má oprávnění ke čtení.
0020	Skupina má oprávnění k zápisu.
0010	Skupina má oprávnění ke spuštění.
0007	Ostatní mají oprávnění ke čtení, zápisu a spouštění.
0004	Ostatní mají oprávnění ke čtení.
0002	Ostatní mají oprávnění k zápisu.
0001	Ostatní mají oprávnění ke spuštění.
4000	Nastavte efektivní ID uživatele v souboru.
2000	Nastavte pro soubor efektivní ID skupiny.
1000	Nastavit na označení, že soubor lze odstranit nebo přejmenovat pouze vlastníkem souboru, vlastníkem adresáře nebo uživatelem root.

Symbolický formát rwx

Oprávnění pro vlastníka/uživatele, skupinu a další uživatele jsou označená pomocí kombinace znaků r (Read), w (Write) a x (Execute).

Formát	Povolení
rwx------	Uživatel (vlastník souboru) má oprávnění ke čtení, zápisu a spuštění.
r--------	Uživatel má oprávnění ke čtení.
-w-------	Uživatel má oprávnění k zápisu.
--x------	Uživatel má oprávnění ke spuštění.
---rwx---	Skupina má oprávnění ke čtení, zápisu a spuštění.
---r-----	Skupina má oprávnění ke čtení.
----w----	Skupina má oprávnění k zápisu.
-----x---	Skupina má oprávnění ke spuštění.
------rwx	Ostatní mají oprávnění ke čtení, zápisu a spouštění.
------r--	Ostatní mají oprávnění ke čtení.
-------w-	Ostatní mají oprávnění k zápisu.
--------x	Ostatní mají oprávnění ke spuštění.

Poznámky

Volání Get File přes rozsah, který ještě nemá obsah nebo který byl vymazán, vrátí 0 pro tyto bajty.

Pokud voláte Get File bez zadané oblasti, 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í služba 0 pro tyto bajty.

Dokončení operace Get File je povoleno dvě minuty na MiB. V průměru vyprší časový limit operací, které za MiB trvá déle než dvě minuty.

Viz také

Operace se soubory