Vytvořit adresář
Operace Create Directory vytvoří nový adresář pod zadanou sdílenou složkou nebo nadřazeným adresářem. Prostředek adresáře obsahuje vlastnosti daného adresáře. Neobsahuje seznam souborů ani podadresářů obsažených v adresáři. 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 Create Directory je vytvořen následujícím způsobem. Doporučujeme používat PROTOKOL HTTPS.
| Metoda | Identifikátor URI požadavku | Verze HTTP |
|---|---|---|
| VLOŽIT | https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory |
HTTP/1.1 |
Nahraďte komponenty cesty v identifikátoru URI požadavku vlastními, jak je znázorněno v následující tabulce:
| 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ému adresáři, kde se má vytvořit mydirectory. Pokud není zadána nadřazená cesta k adresáři, vytvoří se adresář v zadané sdílené složce. Pokud je zadaný nadřazený adresář, musí již existovat ve sdílené složce, abyste mohli vytvořit mydirectory. |
mydirectory |
Název adresáře, který chcete vytvořit. |
Další 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
Pro identifikátor 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 čas koordinovaného univerzálního času (UTC) požadavku. 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-meta-name:value |
Volitelný. Verze 2015-02-21 nebo novější Pár název-hodnota, který se má přidružit k adresáři jako metadata. Názvy metadat musí dodržovat pravidla pojmenování pro identifikátory jazyka C# . |
x-ms-file-creation-time: { now ¦ <DateTime> } |
Povinné: verze 2019-02-02-2021-04-10. Volitelné: verze 2021-06-08 a novější. Vlastnost času vytvoření koordinovaného univerzálního času (UTC) pro adresář. Hodnotu now můžete použít k označení času požadavku. Výchozí hodnota je now. |
x-ms-file-last-write-time: { now ¦ <DateTime> } |
Povinné: verze 2019-02-02 až 2021-04-10. Volitelné: verze 2021-06-08 nebo novější. Vlastnost posledního zápisu pro adresář ve standardu UTC (Coordinated Universal Time). Hodnotu now můžete použít k označení času požadavku. Výchozí hodnota je now. |
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ý. Vlastnost času koordinovaného univerzálního času (UTC) pro adresář mění ve formátu ISO 8601. Verze 2021-06-08 a novější. Hodnotu now můžete použít k označení času požadavku. Výchozí hodnota je now. |
x-ms-file-permission: { inherit ¦ <SDDL> ¦ <binary> } |
Ve verzi 2019-02-02 až 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. Tato hlavička se dá použít, pokud je velikost oprávnění větší než 8 kibibajtů (KiB). 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). Můžete předat hodnotu inherit, která dědí z nadřazeného adresáře.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 inherit. |
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 inherit, nemělo by být toto záhlaví nastaveno. Pokud je x-ms-file-permission-key nastavena na jinou hodnotu než inherita pokud tato hlavička není nastavená, použije se výchozí hodnota sddl. |
x-ms-file-permission-key: <PermissionKey> |
Klíč oprávnění, které se má nastavit pro adresář. Ve verzi 2019-02-02 až 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é. Tento klíč můžete 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 inherit pro hlavičku x-ms-file-permission. |
x-ms-file-attributes |
Povinné: verze 2019-02-02 až 2021-04-10. Volitelné: verze 2021-06-08 a novější. Atributy systému souborů, které se mají nastavit v adresáři. Prohlédněte si seznam dostupných atributů. Výchozí hodnota je Directory. |
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. Výchozí hodnota je 0755. Viz oprávnění k souborům POSIX (režim). 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. Výchozí hodnota je 0 (kořen). |
x-ms-group |
Verze 2025-05-05 a novější. Identifikátor skupiny (GID) vlastníka souboru, který se má v souboru nastavit. Výchozí hodnota je 0 (kořen). |
Text požadavku
Žádný.
Ukázkový požadavek
PUT https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory? restype=directory HTTP/1.1
Request headers:
x-ms-version: 2014-02-14
x-ms-date: Mon, 27 Jan 2014 22:50:32 GMT
x-ms-meta-Category: Images
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 201 (vytvořeno). Další informace o stavových kódech najdete 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 adresáře uzavřenou 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 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 služby Azure Files, která se použila k provedení požadavku. |
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 nebo 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 a false jinak. |
x-ms-file-creation-time |
Hodnota data a času UTC, která představuje vlastnost čas vytvoření adresáře. |
x-ms-file-last-write-time |
Hodnota data a času UTC, která představuje vlastnost času posledního zápisu pro adresář. |
x-ms-file-change-time |
Hodnota data a času UTC, která představuje vlastnost změnit čas pro adresář. |
x-ms-file-file-id |
ID souboru adresáře. |
x-ms-file-parent-id |
ID nadřazeného souboru adresáře. |
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ž 1024 viditelných znaků ASCII. Pokud v požadavku není hlavička x-ms-client-request-id, tato hlavička v odpovědi neexistuje. |
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á hodnota je: Directory. |
Text odpovědi
Žádný.
Ukázková odpověď
Response status:
HTTP/1.1 201 Created
Response headers:
Transfer-Encoding: chunked
Date: Mon, 27 Jan 2014 23:00:12 GMT
ETag: "0x8CB14C3E29B7E82"
Last-Modified: Mon, 27 Jan 2014 23:00:06 GMT
x-ms-version: 2014-02-14
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 | 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 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 s Windows. Služba Azure Files ji nepodporuje s možnostmi 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živatelů, který není číst 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 spuš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 se při zavolání Create Directory odstraní adresář se stejným názvem, server vrátí stavový kód 409 (Konflikt) a poskytne další informace o chybě, které značí, že se adresář odstraňuje.
Pokud adresář nebo soubor se stejným názvem již existuje, operace selže se stavovým kódem 409 (konflikt). Pokud nadřazený adresář neexistuje, operace selže se stavovým kódem 412 (předběžná podmínka se nezdařila).
Není možné vytvořit hierarchii adresářů s jedinou operací Create Directory. Adresář můžete vytvořit pouze v případě, že jeho bezprostřední nadřazený objekt již existuje, jak je uvedeno v cestě. Pokud nadřazený adresář neexistuje, operace selže se stavovým kódem 412 (předběžná podmínka se nezdařila).
Create Directory 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)
Viz také
operace v adresářích