Získání vlastností souboru

Článek
02/14/2024

Operace Get File Properties vrátí všechna uživatelem definovaná metadata, standardní vlastnosti HTTP a systémové vlastnosti souboru. Nevrací obsah souboru.

Dostupnost protokolu

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

Žádost

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

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
`HEAD`	`https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile`	HTTP/1.1
`HEAD`	`https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?sharesnapshot=<DateTime>`	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 cesty	Description
`myaccount`	Název vašeho účtu úložiště.
`myshare`	Název sdílené složky.
`mydirectorypath`	Nepovinný parametr. Cesta k nadřazené 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
`sharesnapshot`	Nepovinný parametr. Verze 2017-04-17 a novější. Parametr `sharesnapshot` je neprůzná hodnota DateTime, pokud je k dispozici, určuje snímek sdílené složky, který se má dotazovat na vlastnosti souboru.
`timeout`	Nepovinný parametr. Parametr se `timeout` vyjadřuje 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
Autorizace	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. Určuje verzi operace, která se má pro tento požadavek použít. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
`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. Pokud se neshoduje, 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á se zaznamená do protokolů analýzy, když je povolené protokolování Azure Analýza ú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 Monitorování Azure Blob Storage.
`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é 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á koncový tečka v adrese URL požadavku oříznout, 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 a sadu hlaviček odpovědi.

Stavový kód

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

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.

Hlavička odpovědi	Description
`Last-Modified`	Vrátí datum a čas poslední změny souboru. Formát data odpovídá dokumentu RFC 1123. Další informace najdete v tématu Reprezentace hodnot data a času v záhlavích. Všechny operace, které upraví soubor nebo jeho vlastnosti, aktualizují čas poslední změny.
`x-ms-meta-name:value`	Sada dvojic název-hodnota, které jsou přidruženy k tomuto souboru jako uživatelem definované metadata.
`x-ms-type: <File>`	Vrátí typ `File`. Vyhrazeno pro budoucí použití.
`Content-Length`	Velikost souboru v bajtech Tato hlavička vrátí hodnotu hlavičky `x-ms-content-length` , která je uložená se souborem.
`Content-Type`	Typ obsahu zadaný pro soubor. Pokud není zadaný žádný typ obsahu, výchozí typ obsahu je `application/octet-stream`.
`ETag`	Značka 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`	`Content-MD5` Pokud byla hlavička souboru nastavena, `Content-MD5` vrátí se hlavička odpovědi, aby klient mohl zkontrolovat integritu obsahu zprávy.
`Content-Encoding`	`Content-Encoding` Pokud byla hlavička požadavku pro soubor dříve nastavena, `Content-Encoding` vrátí se hodnota v této hlavičce.
`Content-Language`	`Content-Language` Pokud byla hlavička požadavku pro soubor dříve nastavena, `Content-Language` vrátí se hodnota v této hlavičce.
`Cache-Control`	`Cache-Control` Pokud byla pro soubor dříve nastavena hlavička požadavku, `Cache-Control` vrátí se v této hlavičce hodnota.
`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 můžete ho použít k připojení dalších metadat. Pokud je například nastavená hodnota `attachment`, `Content-Disposition` znamená, že by uživatel-agent neměl zobrazovat odpověď, ale místo toho by se mělo 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`	Označuje verzi služby, která byla použita ke spuštění požadavku.
`Date`	Hodnota data a času UTC vygenerovaná službou, která označuje čas, kdy byla odpověď inicializována.
`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 je č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 pomocí 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-status`doš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 je č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 pomocí 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 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 pomocí příkazu 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 zkopírovaných bajtů a celkový počet bajtů ve zdroji v poslední operaci Kopírování souboru , kde byl tento soubor cílovým souborem. Může zobrazit od 0 do počtu `Content-Length` zkopírovaných 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 pomocí příkazu Nastavit vlastnosti souboru nebo Vytvořit soubor.
`x-ms-copy-source: url`	Verze 2015-02-21 a novější. Adresa URL obsahující maximálně 2 kB znaků, 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 pomocí příkazu 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í, která je identifikována nástrojem `x-ms-copy-id`, s těmito hodnotami: - Úspěch: Kopírování bylo úspěšně dokončeno. - Čekající: 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í. - Přerušena: Kopírování bylo ukončeno přerušením kopírování souboru. - Se nezdařilo: 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 pomocí příkazu Nastavit vlastnosti souboru nebo Vytvořit soubor.
`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 zašifrovaná pomocí zadaného algoritmu. Hodnota je nastavena na `false` , pokud je soubor nešifrovaný nebo pokud jsou zašifrovány pouze části souboru nebo metadata aplikace.
`x-ms-file-permission-key`	Verze 2019-02-02 a novější. Klíč oprávnění k 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ů.
`x-ms-file-creation-time`	Verze 2019-02-02 a novější. Hodnota data a času UTC, která představuje vlastnost času vytvoření souboru.
`x-ms-file-last-write-time`	Verze 2019-02-02 a novější. Hodnota data a času UTC, která představuje vlastnost čas posledního zápisu souboru.
`x-ms-file-change-time`	Verze 2019-02-02 a novější. Hodnota data a času UTC, která představuje vlastnost čas změny souboru.
`x-ms-file-file-id`	Verze 2019-02-02 a novější. ID souboru.
`x-ms-file-parent-id`	Verze 2019-02-02 a novější. 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 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