Nastavení vlastností souboru

Článek
02/14/2024

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

Dostupnost protokolu

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

Žádost

Požadavek Set File Properties 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
PUT	`https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=properties`	HTTP/1.1

Následujícím způsobem nahraďte komponenty cesty 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 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 můžete 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 souborové služby.

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 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`	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.
`x-ms-cache-control`	Nepovinný parametr. Upraví řídicí řetězec mezipaměti pro soubor. Pokud tato vlastnost není v požadavku zadaná, vymaže se vlastnost souboru. Následná volání funkce Získat vlastnosti souboru nevrátí tuto vlastnost, pokud není znovu explicitně nastavena na soubor.
`x-ms-content-type`	Nepovinný parametr. Nastaví typ obsahu souboru. Pokud tato vlastnost není v požadavku zadaná, vymaže se vlastnost souboru. Následná volání funkce Získat vlastnosti souboru nevrátí tuto vlastnost, pokud není znovu explicitně nastavena na soubor.
`x-ms-content-md5`	Nepovinný parametr. Nastaví hodnotu hash MD5 souboru. Pokud tato vlastnost není v požadavku zadaná, vymaže se vlastnost souboru. Následná volání funkce Získat vlastnosti souboru nevrátí tuto vlastnost, pokud není znovu explicitně nastavena na soubor.
`x-ms-content-encoding`	Nepovinný parametr. Nastaví kódování obsahu souboru. Pokud tato vlastnost není v požadavku zadaná, vymaže se vlastnost souboru. Následná volání funkce Získat vlastnosti souboru nevrátí tuto vlastnost, pokud není znovu explicitně nastavena na soubor.
`x-ms-content-language`	Nepovinný parametr. Nastaví jazyk obsahu souboru. Pokud tato vlastnost není v požadavku zadaná, vymaže se vlastnost souboru. Následná volání funkce Získat vlastnosti souboru nevrátí tuto vlastnost, pokud není znovu explicitně nastavena na soubor.
`x-ms-content-disposition`	Nepovinný parametr. Nastaví hlavičku `Content-Disposition` souboru. Pokud tato vlastnost není v požadavku zadaná, vymaže se vlastnost souboru. Následná volání funkce Získat vlastnosti souboru nevrátí tuto vlastnost, pokud není znovu explicitně nastavena na soubor.
`x-ms-content-length: bytes`	Nepovinný parametr. Změní velikost souboru na zadanou velikost. Pokud je zadaná hodnota bajtu menší než aktuální velikost souboru, všechny oblasti nad zadanou hodnotou bajtu se vymažou.
`x-ms-file-permission: { preserve ¦ <SDDL> }`	Ve verzích 2019-02-02 až 2021-04-10 je tato hlavička povinná, pokud `x-ms-file-permission-key` není zadána. Od verze 2021-06-08 jsou obě hlavičky volitelné. Toto oprávnění je popisovač zabezpečení pro soubor zadaný v jazyce SDDL (Security Descriptor Definition Language). 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 zadaný, musí mít vlastníka, skupinu a volitelný seznam řízení přístupu (DACL). Hodnota `preserve` může být předána, aby se stávající hodnota nezměnila. Poznámka: Můžete zadat nebo `x-ms-file-permissionx-ms-file-permission-key`. Pokud není zadána žádná hlavička, použije se výchozí hodnota `preserve` .
`x-ms-file-permission-key: <PermissionKey>`	Ve verzích 2019-02-02 až 2021-04-10 je tato hlavička povinná, pokud `x-ms-file-permission` není zadána. Od verze 2021-06-08 jsou obě hlavičky volitelné. Klíč oprávnění, které se má pro soubor nastavit. Můžete ho `Create-Permission` vytvořit pomocí rozhraní API. Poznámka: Můžete zadat nebo `x-ms-file-permissionx-ms-file-permission-key`. Pokud není zadána žádná hlavička, použije se pro záhlaví `x-ms-file-permission` výchozí hodnota`preserve`.
`x-ms-file-attributes: { preserve ¦ <FileAttributeList> }`	Povinné, verze 2019-02-02 až 2021-04-10. Volitelné, verze 2021-06-08 a novější. Atributy systému souborů, které mají být v souboru nastaveny. Podívejte se na seznam dostupných atributů. Hodnota `preserve` může být předána, aby se stávající hodnota nezměnila. Výchozí hodnota je `preserve`.
`x-ms-file-creation-time: { preserve ¦ <DateTime> }`	Povinné, verze 2019-02-02 až 2021-04-10. Volitelné, verze 2021-06-08 a novější. Vlastnost čas vytvoření souboru ve standardu UTC (Coordinated Universal Time). Hodnota `preserve` může být předána, aby se stávající hodnota nezměnila. Výchozí hodnota je `preserve`.
`x-ms-file-last-write-time: { preserve ¦ <DateTime> }`	Povinné, verze 2019-02-02 až 2021-04-10. Volitelné, verze 2021-06-08 a novější. Vlastnost posledního zápisu souboru ve standardu UTC (Coordinated Universal Time). Hodnota `preserve` může být předána, aby se stávající hodnota nezměnila. Pokud `preserve` je zadána a velikost souboru se změní, čas posledního zápisu se aktualizuje na aktuální čas. Pokud se změní velikost souboru, ale je k dispozici 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`	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-change-time: { now ¦ <DateTime> }`	Nepovinný parametr. Verze 2021-06-08 a novější. Vlastnost změnit čas koordinovaného univerzálního času (UTC) pro soubor formátovaný ve formátu ISO 8601. K označení času požadavku můžete použít hodnotu `now` . Výchozí hodnota je `now`.
`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 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 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
`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 najdete v tématu Reprezentace hodnot data a času v záhlavích. Každá 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`	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 souborové služby, která se používá ke spuštění požadavku.
`Date` nebo `x-ms-date`	Hodnota data a času UTC vygenerovaná službou, která označuje čas, kdy byla odpověď inicializována.
`x-ms-request-server-encrypted: true/false`	Verze 2017-04-17 a novější. Hodnota této hlavičky je nastavena na `true` , pokud je obsah požadavku úspěšně zašifrován pomocí zadaného algoritmu. V opačném případě je hodnota nastavena na `false`hodnotu .
`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ů 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 č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-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í, nebude v odpovědi.

Text odpovědi

Žádné

Autorizace

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

Atributy systému souborů

Atribut	Atribut souboru Win32	Definice
ReadOnly	FILE_ATTRIBUTE_READONLY	Soubor, který je jen pro čtení. Aplikace můžou soubor číst, ale nemůžou do něj zapisovat ani ho odstranit.
Skrytý	FILE_ATTRIBUTE_HIDDEN	Soubor je skrytý. Není součástí běžného výpisu adresáře.
Systémový	FILE_ATTRIBUTE_SYSTEM	Soubor, který operační systém používá 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ě.
Archiv	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 primárně kvůli zajištění kompatibility se systémem Windows. Azure Files nepodporuje možnosti offline úložiště.
NotContentIndexed	FILE_ATTRIBUTE_NOT_CONTENT_INDEXED	Služba indexování obsahu soubor indexovat nemá.
NoScrubData	FILE_ATTRIBUTE_NO_SCRUB_DATA	Uživatelský datový proud se nemá číst skenerem integrity dat na pozadí. Tento atribut systému souborů je prezentován primárně kvůli zajištění kompatibility se systémem Windows.

Poznámky

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

Velikost souboru se změní 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é další vlastnosti souboru.
Pokud je v požadavku nastavena jedna nebo více následujících vlastností, jsou všechny tyto vlastnosti nastaveny společně. Pokud se pro zadanou vlastnost nezadá hodnota, když je nastavená alespoň jedna z následujících vlastností, tato vlastnost se pro soubor vymaže.
- 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 klientům SMB. Klienti SMB nemohou tyto hodnoty vlastností číst, zapisovat ani upravovat.

Set File properties se nepodporuje u snímku sdílené složky, 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 s chybou 400 (InvalidQueryParameterValue).

Pokud má soubor aktivní zapůjčení, musí klient zadat platné ID zapůjčení v požadavku na zápis vlastností do souboru. Pokud klient nezadá ID zapůjčení nebo zadá neplatné ID zapůjčení, služba File vrátí stavový kód 412 (Předběžná podmínka se nezdařila). Pokud klient zadá 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 na Azure Files