Získání vlastností souboru

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-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 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

Žádné

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.

Viz také

Operace na Azure Files