Nastavení vlastností adresáře
Operace Set Directory Properties nastaví systémové vlastnosti pro zadaný adresář. Tato operace se podporuje ve verzi 2019-02-02 a novější pro sdílené složky s povoleným protokolem SMB a podporuje se ve verzi 2025-05-05 a novější pro sdílené složky s povoleným protokolem NFS.
Dostupnost protokolu
| Povolený protokol sdílené složky | K dispozici |
|---|---|
| SMB |
|
| NFS |
|
Prosba
Požadavek Set Directory Properties je vytvořen 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ích tabulkách:
Běžné hlavičky požadavků
| 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. Tato operace je podporována ve verzi 2025-05-05 a novější pro sdílené složky s povoleným protokolem NFS. Další informace najdete v tématu Správa verzí pro služby Azure Storage. |
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ář. Hodnotu preserve lze předat, 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) Hodnotu preserve lze předat, 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-request-intent |
Vyžaduje se, pokud hlavička Authorization určuje token OAuth. Přijatelná hodnota je backup. Tato hlavička určuje, že se mají udělit Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action nebo Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action, 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. Tato hlavička se ignoruje, pokud se cíl nachází ve sdílené složce s povoleným protokolem NFS, který ve výchozím nastavení podporuje koncové tečky. Další informace najdete v tématu Pojmenování a odkazování na sdílené složky, adresáře, soubory a metadata. |
Hlavičky požadavků jenom smb
| Hlavička požadavku | Popis |
|---|---|
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-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ž preservea pokud tato hlavička není nastavená, 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ů. Hodnotu preserve lze předat, aby stávající hodnota zůstala beze změny. Výchozí hodnota je preserve. |
Pouze hlavičky požadavků NFS
| Hlavička požadavku | Popis |
|---|---|
x-ms-mode |
Verze 2025-05-05 a novější. Bity režimu, které se mají nastavit v souboru. Režim je reprezentován ve 12bitovém osmičkovém formátu nebo symbolickém formátu rwx. Viz oprávnění k souborům POSIX (režim). |
x-ms-owner |
Verze 2025-05-05 a novější. Identifikátor uživatele (UID) vlastníka souboru, který se má v souboru nastavit. |
x-ms-group |
Verze 2025-05-05 a novější. Identifikátor skupiny (GID) vlastníka souboru, který se má v souboru nastavit. |
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 zahrnuje hlavičky v následujících tabulkách. Odpověď může obsahovat také další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.
Běžná hlavička odpovědi
| 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-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. |
Hlavičky odpovědi pouze smb
| Hlavička odpovědi | Popis |
|---|---|
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ů. |
Pouze hlavičky odpovědi NFS
| Hlavička odpovědi | Popis |
|---|---|
x-ms-mode |
Verze 2025-05-05 a novější. Režim adresáře. Viz oprávnění k souborům POSIX (režim). |
x-ms-owner |
Verze 2025-05-05 a novější. Identifikátor uživatele (UID) vlastníka adresáře. |
x-ms-group |
Verze 2025-05-05 a novější. Identifikátor skupiny (GID) vlastníka adresáře. |
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. |
Oprávnění k souborům POSIX (režim)
Oprávnění k souborům POSIX je možné zadat číselně v osmičkovém formátu 12bitového formátu nebo v symbolickém formátu rwx. Příklady:
- "0644" nebo "rw-r--r--": Uživatel (vlastník souboru) má oprávnění ke čtení a zápisu. Skupina má oprávnění ke čtení. Ostatní mají oprávnění ke čtení.
- 0755 nebo rwxr-xr-x: Uživatel (vlastník souboru) má oprávnění ke čtení, zápisu a spuštění. Skupina má oprávnění ke čtení a spuštění. Ostatní mají oprávnění ke čtení a spouštění.
Číselný osmičkový formát
Tři osmičková čísla nejnižšího pořadí představují oprávnění pro vlastníka/uživatele, skupinu a další a označují se pomocí osmičkového čísla (0–7), která se vytvoří pomocí bitové kombinace 4 (čtení), 2 (zápis), 1 (Spustit). Osmičkové číslo nejvyššího pořadí (0–7) se používá k označení kombinace oprávnění 4 (SetUID), 2 (SetGID), 1 (StickyBit).
| Formát | Povolení |
|---|---|
| 0700 | Uživatel (vlastník souboru) má oprávnění ke čtení, zápisu a spuštění. |
| 0400 | Uživatel má oprávnění ke čtení. |
| 0200 | Uživatel má oprávnění k zápisu. |
| 0100 | Uživatel má oprávnění ke spuštění. |
| 0070 | Skupina má oprávnění ke čtení, zápisu a spuštění. |
| 0040 | Skupina má oprávnění ke čtení. |
| 0020 | Skupina má oprávnění k zápisu. |
| 0010 | Skupina má oprávnění ke spuštění. |
| 0007 | Ostatní mají oprávnění ke čtení, zápisu a spouštění. |
| 0004 | Ostatní mají oprávnění ke čtení. |
| 0002 | Ostatní mají oprávnění k zápisu. |
| 0001 | Ostatní mají oprávnění ke spuštění. |
| 4000 | Nastavte efektivní ID uživatele v souboru. |
| 2000 | Nastavte pro soubor efektivní ID skupiny. |
| 1000 | Nastavit na označení, že soubor lze odstranit nebo přejmenovat pouze vlastníkem souboru, vlastníkem adresáře nebo uživatelem root. |
Symbolický formát rwx
Oprávnění pro vlastníka/uživatele, skupinu a další uživatele jsou označená pomocí kombinace znaků r (Read), w (Write) a x (Execute).
| Formát | Povolení |
|---|---|
| rwx------ | Uživatel (vlastník souboru) má oprávnění ke čtení, zápisu a spuštění. |
| r-------- | Uživatel má oprávnění ke čtení. |
| -w------- | Uživatel má oprávnění k zápisu. |
| --x------ | Uživatel má oprávnění ke spuštění. |
| ---rwx--- | Skupina má oprávnění ke čtení, zápisu a spuštění. |
| ---r----- | Skupina má oprávnění ke čtení. |
| ----w---- | Skupina má oprávnění k zápisu. |
| -----x--- | Skupina má oprávnění ke spuštění. |
| ------rwx | Ostatní mají oprávnění ke čtení, zápisu a spouštění. |
| ------r-- | Ostatní mají oprávnění ke čtení. |
| -------w- | Ostatní mají oprávnění k zápisu. |
| --------x | Ostatní mají oprávnění ke spuštění. |
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