Nastavení vlastností souboru

Operace Set File Properties nastaví systémové vlastnosti souboru.

Dostupnost protokolu

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

Prosba

Požadavek Set File Properties lze vytvořit následujícím způsobem. Doporučujeme používat PROTOKOL HTTPS.

Metoda	Identifikátor URI požadavku	Verze HTTP
DÁT	https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=properties	HTTP/1.1

Součásti cesty zobrazené v identifikátoru URI požadavku nahraďte vlastními, a to následujícím způsobem:

Komponenta Path	Popis
myaccount	Název vašeho účtu úložiště.
myshare	Název sdílené složky.
mydirectorypath	Volitelný. Cesta k nadřazeného 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 můžete 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 souborové služby.

Hlavičky požadavku

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

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. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
x-ms-cache-control	Volitelný. Upraví řídicí řetězec mezipaměti pro soubor. Pokud tato vlastnost není v požadavku zadána, vlastnost se vymaže pro soubor. Následná volání Získat vlastnosti souboru tuto vlastnost nevrátí, pokud není explicitně nastavena na soubor znovu.
x-ms-content-type	Volitelný. Nastaví typ obsahu souboru. Pokud tato vlastnost není v požadavku zadána, vlastnost se vymaže pro soubor. Následná volání Získat vlastnosti souboru tuto vlastnost nevrátí, pokud není explicitně nastavena na soubor znovu.
x-ms-content-md5	Volitelný. Nastaví hodnotu hash MD5 souboru. Pokud tato vlastnost není v požadavku zadána, vlastnost se vymaže pro soubor. Následná volání Získat vlastnosti souboru tuto vlastnost nevrátí, pokud není explicitně nastavena na soubor znovu.
x-ms-content-encoding	Volitelný. Nastaví kódování obsahu souboru. Pokud tato vlastnost není v požadavku zadána, vlastnost se vymaže pro soubor. Následná volání Získat vlastnosti souboru tuto vlastnost nevrátí, pokud není explicitně nastavena na soubor znovu.
x-ms-content-language	Volitelný. Nastaví jazyk obsahu souboru. Pokud tato vlastnost není v požadavku zadána, vlastnost se vymaže pro soubor. Následná volání Získat vlastnosti souboru tuto vlastnost nevrátí, pokud není explicitně nastavena na soubor znovu.
x-ms-content-disposition	Volitelný. Nastaví hlavičku Content-Disposition souboru. Pokud tato vlastnost není v požadavku zadána, vlastnost se vymaže pro soubor. Následná volání Získat vlastnosti souboru tuto vlastnost nevrátí, pokud není explicitně nastavena na soubor znovu.
x-ms-content-length: bytes	Volitelný. Změní velikost souboru na zadanou velikost. Pokud je zadaná bajtová hodnota menší než aktuální velikost souboru, vymažou se všechny rozsahy nad zadanou hodnotou bajtů.
x-ms-file-permission: { preserve ¦ <SDDL> ¦ <binary> }	Ve verzích 2019-02-02-2021-04-10 se tato hlavička vyžaduje, pokud není zadána x-ms-file-permission-key. Od verze 2021-06-08 jsou obě hlavičky volitelné. Toto oprávnění je popisovač zabezpečení pro soubor zadaný v SDDL (Security Descriptor Definition Language) nebo (verze 2024-11-04 nebo novější) ve formátu binární popisovač zabezpečení. Můžete určit, který formát se má použít se záhlavím x-ms-file-permission-format. Tuto hlavičku můžete použít, pokud je velikost oprávnění 8 kibibajtů (KiB) nebo menší. V opačném případě můžete použít x-ms-file-permission-key. Pokud je uvedeno, musí mít vlastníka, skupinu a volitelný seznam řízení přístupu (DACL). Hodnota preserve může být předána, aby stávající hodnota zůstala beze změny. Poznámka: Můžete zadat x-ms-file-permission nebo x-ms-file-permission-key. Pokud není zadána žádná hlavička, použije se výchozí hodnota preserve.
x-ms-file-permission-format: { sddl ¦ binary }	Volitelný. Verze 2024-11-04 nebo novější Určuje, zda hodnota předaná v x-ms-file-permission je v SDDL nebo v binárním formátu. Pokud je x-ms-file-permission-key nastavená na preserve, nemělo by být toto záhlaví nastaveno. Pokud je x-ms-file-permission-key nastavena na jinou hodnotu než preserve, a pokud toto záhlaví není nastaveno, použije se výchozí hodnota sddl.
x-ms-file-permission-key: <PermissionKey>	Ve verzích 2019-02-02-2021-04-10 se tato hlavička vyžaduje, pokud není zadána x-ms-file-permission. Od verze 2021-06-08 jsou obě hlavičky volitelné. Klíč oprávnění, které se má pro soubor nastavit. Můžete ho vytvořit pomocí rozhraní API Create-Permission. Poznámka: Můžete zadat x-ms-file-permission nebo x-ms-file-permission-key. Pokud není zadána žádná hlavička, použije se výchozí hodnota preserve pro hlavičku x-ms-file-permission.
x-ms-file-attributes: { preserve ¦ <FileAttributeList> }	Povinné, verze 2019-02-02-2021-04-10. Volitelné, verze 2021-06-08 a novější. Atributy systému souborů, které mají být nastaveny v souboru. Prohlédněte si seznam dostupných atributů. Hodnota preserve může být předána, aby stávající hodnota zůstala beze změny. Výchozí hodnota je preserve.
x-ms-file-creation-time: { preserve ¦ <DateTime> }	Povinné, verze 2019-02-02-2021-04-10. Volitelné, verze 2021-06-08 a novější. Vlastnost času vytvoření koordinovaného univerzálního času (UTC) pro soubor. Hodnota preserve může být předána, aby stávající hodnota zůstala beze změny. Výchozí hodnota je preserve.
x-ms-file-last-write-time: { preserve ¦ <DateTime> }	Povinné, verze 2019-02-02-2021-04-10. Volitelné, verze 2021-06-08 a novější. Vlastnost posledního zápisu pro soubor ve standardu UTC (Coordinated Universal Time). Hodnota preserve může být předána, aby stávající hodnota zůstala beze změny. Pokud je zadán preserve a změní se velikost souboru, aktualizuje se čas posledního zápisu na aktuální čas. Pokud se změní velikost souboru, ale zobrazí se explicitní časové razítko, použije se explicitní časové razítko. Výchozí hodnota je preserve.
x-ms-lease-id: <ID>	Vyžaduje se, pokud má soubor aktivní zapůjčení. K dispozici pro verzi 2019-02-02 a novější.
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-change-time: { now ¦ <DateTime> }	Volitelný. Verze 2021-06-08 a novější Vlastnost času koordinovaného univerzálního času (UTC) pro soubor formátovaná ve formátu ISO 8601 Hodnotu now můžete použít k označení času požadavku. Výchozí hodnota je now.
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 Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action nebo Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action by měly být uděleny, 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. Další informace najdete v tématu Pojmenování a odkazování na sdílené složky, adresáře, soubory a metadata.

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

Informace o stavových kódech naleznete v tématu Stav a kódy chyb.

Hlavičky odpovědi

Odpověď pro 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.

Hlavička odpovědi	Popis
ETag	Obsahuje hodnotu, která představuje verzi souboru. Hodnota je uzavřena v uvozovkách.
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í adresář nebo jeho vlastnosti, aktualizuje čas poslední změny. Operace se soubory nemají vliv na čas poslední změny adresáře.
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	Označuje verzi souborové služby, která se používá k provedení požadavku.
Date nebo x-ms-date	Hodnota data a času UTC vygenerovaná službou, která označuje čas zahájení odpovědi.
x-ms-request-server-encrypted: true/false	Verze 2017-04-17 a novější Hodnota této hlavičky je nastavená na true, pokud se obsah požadavku úspěšně zašifruje pomocí zadaného algoritmu. V opačném případě je hodnota nastavena na false.
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ů v 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 čas 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 posledního času zápisu souboru.
x-ms-file-change-time	Verze 2019-02-02 a novější. Hodnota data a času UTC, která představuje vlastnost změnit čas 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ě 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, nezobrazí se v odpovědi.

Text odpovědi

Žádný.

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.

Poznámky

Sémantika aktualizace vlastností souboru je následující:

• Velikost souboru se upraví jenom v případě, že požadavek určuje hodnotu hlavičky x-ms-content-length.

• Pokud požadavek nastaví pouze x-ms-content-length a žádné další vlastnosti, nebudou změněny žádné jiné vlastnosti souboru.

• Pokud je v požadavku nastavena některá z následujících vlastností, všechny tyto vlastnosti jsou nastaveny společně. Pokud hodnota není zadána pro zadanou vlastnost, pokud je nastavena alespoň jedna z následujících vlastností, je tato vlastnost pro soubor vymazána.

  • x-ms-cache-control
  • x-ms-content-type
  • x-ms-content-md5
  • x-ms-content-encoding
  • x-ms-content-language

Poznámka

Předchozí vlastnosti souboru jsou oddělené od vlastností systému souborů, které jsou k dispozici pro klienty SMB. Klienti SMB nemohou tyto hodnoty vlastností číst, zapisovat ani upravovat.

Set File properties se na snímku sdílené složky nepodporuje, což je kopie sdílené složky jen pro čtení. Pokus o provedení této operace na snímku sdílené složky selže se 400 (InvalidQueryParameterValue).

Pokud má soubor aktivní zapůjčení, musí klient v požadavku zadat platné ID zapůjčení pro zápis vlastností do souboru. Pokud klient nezadá ID zapůjčení nebo určuje neplatné ID zapůjčení, vrátí služba File stavový kód 412 (předběžná podmínka se nezdařila). Pokud klient určuje ID zapůjčení, ale soubor nemá aktivní zapůjčení, vrátí služba File také stavový kód 412 (předběžná podmínka se nezdařila).

Viz také

operace ve službě Azure Files