Získání vlastností adresáře
Operace Get Directory Properties vrátí všechny systémové vlastnosti zadaného adresáře a dá se také použít ke kontrole existence adresáře. Vrácená data neobsahují soubory v adresáři ani žádné podadresáře. Tato operace je podporována 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 Get 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 |
|---|---|---|
| GET/HEAD | https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory |
HTTP/1.1 |
| GET/HEAD | https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory&sharesnapshot=<DateTime> |
HTTP/1.1 |
Součásti cesty, které se zobrazují v identifikátoru URI požadavku, nahraďte vlastními:
| Komponenta Path | Popis |
|---|---|
myaccount |
Název vašeho účtu úložiště. |
myshare |
Název sdílené složky. |
myparentdirectorypath |
Volitelný. Cesta k nadřazeného adresáři. |
mydirectory |
Název adresáře. |
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 je možné zadat následující další parametry:
| Parametr | Popis |
|---|---|
sharesnapshot |
Volitelný. Verze 2017-04-17 a novější Parametr sharesnapshot je neprůhlenou hodnotou DateTime, která při přítomnosti určuje snímek sdílené složky, který se má dotazovat na vlastnosti adresáře. |
timeout |
Volitelný. Parametr timeout se vyjadřuje v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace azure Files. |
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-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
Žádný.
Pouze hlavičky požadavků NFS
Žádný.
Text požadavku
Žádný.
Ukázkový požadavek
HEAD https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory HTTP/1.1
Request Headers:
x-ms-version: 2015-02-21
x-ms-date: <date>
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=
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 |
ETag obsahuje hodnotu, kterou můžete použít k podmíněnému provádění operací. 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. Operace se soubory v adresáři nemají vliv na čas poslední změny adresáře. |
x-ms-meta-name:value |
Sada párů název-hodnota, které obsahují metadata pro adresář. |
x-ms-request-id |
Vrátí jedinečný identifikátor požadavku, který vám může pomoct s řešením potíží s požadavkem. Další informace najdete v tématu Řešení potíží s operacemi rozhraní API. |
x-ms-version |
Označuje verzi služby, která byla použita k provedení požadavku. |
Date |
Hodnota data a času UTC vygenerovaná službou, která označuje čas zahájení odpovědi. |
x-ms-server-encrypted: true/false |
Verze 2017-04-17 a novější Hodnota této hlavičky je nastavena na true pokud jsou metadata adresáře zcela šifrovaná pomocí zadaného algoritmu. Pokud metadata nejsou šifrovaná, je hodnota nastavená 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-file-file-id |
Verze 2019-02-02 a novější. ID souboru adresáře. |
x-ms-file-parent-id |
Verze 2019-02-02 a novější. ID nadřazeného souboru adresáře. |
x-ms-client-request-id |
Dá se použít k řešení potíží s požadavky a jejich 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, není v odpovědi k dispozici. |
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. |
x-ms-file-file-type |
Verze 2025-05-05 a novější. Typ souboru, možné hodnoty jsou: Directory. |
Text odpovědi
Žádný.
Ukázková odpověď
Response Status:
HTTP/1.1 200 OK
Response Headers:
Transfer-Encoding: chunked
Date: <date>
ETag: "0x8CAFB82EFF70C46"
Last-Modified: <date>
x-ms-version: 2015-02-21
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
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. |
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
Pokud zadaná cesta k adresáři neexistuje, požadavek selže se stavovým kódem 404 (Nenalezena).
Viz také
operace v adresářích