Sdílet prostřednictvím

Nastavení vlastností adresáře

  • Článek

Operace Set Directory Properties nastaví systémové vlastnosti pro zadaný adresář. Toto rozhraní API je k dispozici od verze 2019-02-02.

Dostupnost protokolu

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

Prosba

Požadavek Set Directory 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/mydirectory?restype=directory&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.
mydirectory 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-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 adresář 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 zadaný, musí mít vlastníka, skupinu a volitelný seznam řízení přístupu (DACL). Pokud chcete zachovat existující hodnotu beze změny, můžete předat hodnotu preserve.

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-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> } Požadováno pro verze 2019-02-02-2021-04-10. Volitelné pro verzi 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> } Požadováno pro verze 2019-02-02-2021-04-10. Volitelné pro verzi 2021-06-08 a novější. Vlastnost času vytvoření koordinovaného univerzálního času (UTC) pro adresář. 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> } Požadováno pro verze 2019-02-02-2021-04-10. Volitelné pro verzi 2021-06-08 a novější. Vlastnost posledního zápisu pro adresář koordinovaného univerzálního času (UTC) 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-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) změní pro adresář 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).

Další informace o stavových kódech najdete 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 adresáře. 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 dá se 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žila 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 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.
x-ms-file-permission-key Verze 2019-02-02 a novější. Klíč oprávnění adresáře.
x-ms-file-attributes Verze 2019-02-02 a novější. Atributy systému souborů v adresáři. 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í adresáře.
x-ms-file-last-write-time Verze 2019-02-02 a novější. Hodnota data a času UTC, která představuje vlastnost času posledního zápisu pro adresář.
x-ms-file-change-time Verze 2019-02-02 a novější. Hodnota data a času UTC, která představuje vlastnost změnit čas pro adresář.
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 Adresář, který je jen pro čtení.
Schovaný FILE_ATTRIBUTE_HIDDEN Adresář je skrytý. Není součástí běžného seznamu adresářů.
Systém FILE_ATTRIBUTE_SYSTEM Adresář, ze kterého operační systém používá část nebo používá výhradně.
Žádný FILE_ATTRIBUTE_NORMAL Adresář, který nemá nastavené další atributy. Tento atribut je platný pouze v případě, že se používá samostatně.
Adresář FILE_ATTRIBUTE_DIRECTORY Popisovač, který identifikuje adresář.
Archivovat FILE_ATTRIBUTE_ARCHIVE Adresář, který je archivní adresář. Aplikace obvykle tento atribut používají k označení souborů pro zálohování nebo odebrání.
Offline FILE_ATTRIBUTE_OFFLINE Data adresáře 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 Adresář 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

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

Vlastnosti nastavené v adresáři s Set Directory Properties se nešíří do podadresářů pod tímto adresářem. Je nutné volat Set Directory Properties pro každý adresář, pro který chcete aktualizovat vlastnosti.

Viz také

operace v adresářích