Vytvořit adresář
Operace Create Directory
vytvoří nový adresář v zadané sdílené složce nebo nadřazené adresáři. Prostředek adresáře obsahuje vlastnosti daného adresáře. Neobsahuje seznam souborů nebo podadresářů obsažených v adresáři.
Dostupnost protokolu
Povolený protokol sdílených složek | K dispozici. |
---|---|
SMB | |
NFS |
Žádost
Požadavek můžete vytvořit Create Directory
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/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 Cesta | Description |
---|---|
myaccount |
Název vašeho účtu úložiště. |
myshare |
Název sdílené složky. |
myparentdirectorypath |
Nepovinný parametr. Cesta k nadřazeného adresáři, ve kterém má být vytvořen adresář mydirectory . Pokud je cesta nadřazeného adresáře vynechána, vytvoří se adresář v zadané sdílené složce. Pokud je zadaný nadřazený adresář, musí již existovat v rámci sdílené složky, abyste mohli vytvořit adresář mydirectory. |
mydirectory |
Název adresáře, který se má vytvořit. |
Další informace o omezeních názvů 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. |
Text požadavku
Žádné
Hlavičky požadavku
Požadované a volitelné hlavičky požadavků jsou popsané v následující tabulce:
Parametr | Popis |
---|---|
Authorization |
Povinná hodnota. Určuje autorizační schéma, 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 čas koordinovaného univerzálního času (UTC) požadavku. 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-meta-name:value |
Nepovinný parametr. Verze 2015-02-21 nebo novější. Pár název-hodnota, který se přidruží k adresáři jako metadata. Názvy metadat musí splňovat pravidla pojmenování identifikátorů jazyka C#. |
x-ms-file-permission: { inherit ¦ <SDDL> } |
Ve verzi 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 je možné 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). Z nadřazeného inherit adresáře můžete předat hodnotu zdědit.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 výchozí hodnota inherit . |
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 je tato hlavička povinná, pokud x-ms-file-permission není zadána. Od verze 2021-06-08 jsou obě hlavičky volitelné. Tento klíč můžete vytvořit pomocí Create-Permission 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í hodnotainherit . |
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. Podívejte se na seznam dostupných atributů. Výchozí hodnota je Adresář. |
x-ms-file-creation-time: { now ¦ <DateTime> } |
Povinné: verze 2019-02-02 až 2021-04-10. Volitelné: verze 2021-06-08 a novější. Vlastnost čas vytvoření koordinovaného univerzálního času (UTC) pro adresář. K označení času požadavku můžete použít hodnotu now . 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 koordinovaného univerzálního času (UTC) pro adresář K označení času požadavku můžete použít hodnotu now . Výchozí hodnota je now . |
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. Vlastnost změnit čas koordinovaného univerzálního času (UTC) pro adresář ve formátu ISO 8601. Verze 2021-06-08 a novější. 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é 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á koncový tečka v adrese URL požadavku oříznout, nebo ne. Další informace najdete v tématu Pojmenování sdílených složek, adresářů, souborů a metadat a odkazování na nich. |
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 Kódy stavu a chyb.
Hlavičky odpovědi
Odpověď na tuto operaci obsahuje hlavičky popsané v následující tabulce. 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 adresáře uzavřenou v uvozovkách. |
Last-Modified |
Vrátí datum a čas poslední změny adresáře. Formát data odpovídá dokumentu RFC 1123. Další informace najdete v tématu Reprezentace hodnot data a času v záhlavích. Všechny operace, které změní adresář nebo jeho vlastnosti, aktualizují č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 Azure Files verzi, která byla použita ke spuštění požadavku. |
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 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-permission-key |
Klíč oprávnění adresáře. |
x-ms-file-attributes |
Atributy systému souborů v adresáři. Podívejte se na seznam dostupných atributů. |
x-ms-file-creation-time |
Hodnota data a času UTC, která představuje vlastnost času vytvoření adresáře. |
x-ms-file-last-write-time |
Hodnota data a času UTC, která představuje vlastnost posledního zápisu pro adresář. |
x-ms-file-change-time |
Datum a čas 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, pokud se nachází v požadavku a hodnota obsahuje maximálně 1024 viditelných x-ms-client-request-id znaků ASCII. Pokud se hlavička x-ms-client-request-id v požadavku nenachází, v odpovědi se tato hlavička nenachází. |
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
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 seznamu adresářů. |
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ý jenom 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 primárně kvůli zajištění kompatibility se systémem Windows. Azure Files ho nepodporuje s možnostmi úložiště offline. |
NotContentIndexed | FILE_ATTRIBUTE_NOT_CONTENT_INDEXED | Adresář nesmí indexovat služba indexování obsahu. |
NoScrubData | FILE_ATTRIBUTE_NO_SCRUB_DATA | Datový proud uživatelů, který skener integrity dat na pozadí nebude číst. Tento atribut systému souborů je prezentován primárně kvůli zajištění kompatibility se systémem Windows. |
Poznámky
Pokud je adresář se stejným názvem při volání odstraněn Create Directory
, server vrátí stavový kód 409 (Konflikt) a poskytne další informace o chybě, které indikují, že se adresář odstraňuje.
Pokud už adresář nebo soubor se stejným názvem 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 selhala).
Hierarchii adresářů není možné vytvořit pomocí jedné Create Directory
operace. 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 selhala).
Create Directory
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 se snímkem sdílené složky selže s chybou 400 (InvalidQueryParameterValue).