Nastavení vlastností adresáře
Operace Set Directory Properties
nastaví systémové vlastnosti pro zadaný adresář. Toto rozhraní API je k dispozici od verze 2019-02-02.2019.
Dostupnost protokolu
Povolený protokol sdílených složek | K dispozici. |
---|---|
SMB | |
NFS |
Žádost
Požadavek Set Directory 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/mydirectory?restype=directory&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. |
mydirectory |
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-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 adresář 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). Pokud chcete zachovat existující hodnotu beze změny, můžete předat hodnotu preserve .Poznámka: Můžete zadat nebo x-ms-file-permission x-ms-file-permission-key . Pokud není zadána žádná hlavička, použije se pro záhlaví x-ms-file-permission výchozí hodnotapreserve . |
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-permission x-ms-file-permission-key . Pokud není zadána žádná hlavička, použije se pro záhlaví x-ms-file-permission výchozí hodnotapreserve . |
x-ms-file-attributes: { preserve ¦ <FileAttributeList> } |
Povinné pro verze 2019-02-02 až 2021-04-10. Volitelné pro verzi 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é pro verze 2019-02-02 až 2021-04-10. Volitelné pro verzi 2021-06-08 a novější. Vlastnost čas vytvoření koordinovaného univerzálního času (UTC) pro adresář. 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é pro verze 2019-02-02 až 2021-04-10. Volitelné pro verzi 2021-06-08 a novější. Vlastnost posledního zápisu pro adresář 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-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 adresář 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).
Další 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 adresáře. 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 |
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žila 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 adresáři. |
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 času 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 čas posledního zápisu adresáře. |
x-ms-file-change-time |
Verze 2019-02-02 a novější. Hodnota data a času UTC, která představuje vlastnost čas změny 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ě 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 | Adresář, který je jen pro čtení. |
Skrytý | FILE_ATTRIBUTE_HIDDEN | Adresář je skrytý. Není součástí běžného výpisu adresáře. |
Systémový | FILE_ATTRIBUTE_SYSTEM | Adresář, který operační systém používá 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ě. |
Directory | FILE_ATTRIBUTE_DIRECTORY | Popisovač, který identifikuje adresář. |
Archiv | FILE_ATTRIBUTE_ARCHIVE | Adresář, který je archivní adresář. Aplikace obvykle používají tento atribut 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 se systémem Windows. Azure Files nepodporuje možnosti offline úložiště. |
NotContentIndexed | FILE_ATTRIBUTE_NOT_CONTENT_INDEXED | Adresář nemá indexovat služba indexování obsahu. |
NoScrubData | FILE_ATTRIBUTE_NO_SCRUB_DATA | Datový proud uživatele nemá číst skener integrity dat na pozadí. Tento atribut systému souborů je prezentován především kvůli zajištění kompatibility se systémem Windows. |
Poznámky
Set Directory 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 hodnotou 400 (InvalidQueryParameterValue).
Vlastnosti, které jsou nastavené v adresáři s Set Directory Properties
, se nešíří do žádného podadresáře pod tímto adresářem. Musíte volat Set Directory Properties
pro každý adresář, pro který chcete aktualizovat vlastnosti.