Utwórz katalog
Operacja Create Directory tworzy nowy katalog w określonym udziale lub katalogu nadrzędnym. Zasób katalogu zawiera właściwości tego katalogu. Nie zawiera listy plików ani podkatalogów zawartych w katalogu. Ta operacja jest obsługiwana w wersji 2025-05-05 i nowszych dla udziałów plików z włączonym protokołem NFS.
Dostępność protokołu
| Włączony protokół udziału plików | Dostępny |
|---|---|
| SMB |
|
| NFS |
|
Prosić
Żądanie Create Directory jest konstruowane w następujący sposób. Zalecamy używanie protokołu HTTPS.
| Metoda | Identyfikator URI żądania | Wersja PROTOKOŁU HTTP |
|---|---|---|
| POŁÓŻ | https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory |
HTTP/1.1 |
Zastąp składniki ścieżki we własnym identyfikatorze URI żądania, jak pokazano w poniższej tabeli:
| Składnik ścieżki | Opis |
|---|---|
myaccount |
Nazwa konta magazynu. |
myshare |
Nazwa udziału plików. |
myparentdirectorypath |
Fakultatywny. Ścieżka do katalogu nadrzędnego, w którym ma zostać utworzona mydirectory. Jeśli ścieżka katalogu nadrzędnego zostanie pominięta, katalog zostanie utworzony w określonym udziale. Jeśli katalog nadrzędny jest określony, musi już istnieć w udziale, zanim będzie można utworzyć mydirectory. |
mydirectory |
Nazwa katalogu do utworzenia. |
Aby uzyskać więcej informacji na temat ograniczeń nazewnictwa ścieżek, zobacz Nazwa i udziały referencyjne, katalogi, pliki i metadane.
Parametry identyfikatora URI
Możesz określić następujące dodatkowe parametry dla identyfikatora URI żądania.
| Parametr | Opis |
|---|---|
timeout |
Fakultatywny. Parametr timeout jest wyrażony w sekundach. Aby uzyskać więcej informacji, zobacz Ustawianie limitów czasu dla operacji usługi plików. |
Nagłówki żądań
Wymagane i opcjonalne nagłówki żądań są opisane w następujących tabelach:
Typowe nagłówki żądań
| Nagłówek żądania | Opis |
|---|---|
Authorization |
Wymagane. Określa schemat autoryzacji, nazwę konta i podpis. Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage. |
Date lub x-ms-date |
Wymagane. Określa czas uniwersalny koordynowany (UTC) dla żądania. Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage. |
x-ms-version |
Wymagane dla wszystkich autoryzowanych żądań. Określa wersję operacji do użycia dla tego żądania. Ta operacja jest obsługiwana w wersji 2025-05-05 i nowszych dla udziałów plików z włączonym protokołem NFS. Aby uzyskać więcej informacji, zobacz Przechowywanie wersji dla usług Azure Storage. |
x-ms-meta-name:value |
Fakultatywny. Wersja 2015-02-21 lub nowsza. Para name-value do skojarzenia z katalogiem jako metadane. Nazwy metadanych muszą być zgodne z regułami nazewnictwa dla identyfikatorów języka C# . |
x-ms-file-creation-time: { now ¦ <DateTime> } |
Wymagane: wersja 2019-02-02 do 2021-04-10. Opcjonalnie: wersja 2021-06-08 i nowsza. Właściwość czasu utworzenia uniwersalnego czasu koordynowanego (UTC) dla katalogu. Możesz użyć wartości now, aby wskazać czas żądania. Wartość domyślna to now. |
x-ms-file-last-write-time: { now ¦ <DateTime> } |
Wymagane: wersja 2019-02-02 do 2021-04-10. Opcjonalnie: wersja 2021-06-08 lub nowsza. Właściwość ostatniego zapisu koordynowanego czasu uniwersalnego (UTC) dla katalogu. Możesz użyć wartości now, aby wskazać czas żądania. Wartość domyślna to now. |
x-ms-client-request-id |
Fakultatywny. Zapewnia nieprzezroczystą wartość wygenerowaną przez klienta z limitem znaków 1-kibibyte (KiB), który jest rejestrowany w dziennikach podczas konfigurowania rejestrowania. Zdecydowanie zalecamy używanie tego nagłówka do korelowania działań po stronie klienta z żądaniami odbieranymi przez serwer. Aby uzyskać więcej informacji, zobacz Monitor Azure Files. |
x-ms-file-request-intent |
Wymagane, jeśli nagłówek Authorization określa token OAuth. Akceptowalna wartość to backup. Ten nagłówek określa, że Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action lub Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action należy przyznać, jeśli są one uwzględnione w zasadach RBAC przypisanych do tożsamości autoryzowanej przy użyciu nagłówka Authorization. Dostępne dla wersji 2022-11-02 lub nowszej. |
x-ms-allow-trailing-dot: { <Boolean> } |
Fakultatywny. Wersja 2022-11-02 lub nowsza. Wartość logiczna określa, czy końcowa kropka obecna w adresie URL żądania powinna zostać przycięta, czy nie. Ten nagłówek jest ignorowany, jeśli element docelowy znajduje się w udziale plików z włączonym protokołem NFS, który domyślnie obsługuje kropkę końcową. Aby uzyskać więcej informacji, zobacz Nazewnictwo i odwoływanie się do udziałów, katalogów, plików i metadanych. |
Tylko nagłówki żądań protokołu SMB
| Nagłówek żądania | Opis |
|---|---|
x-ms-file-change-time: { now ¦ <DateTime> } |
Fakultatywny. Właściwość czasu uniwersalnego koordynowanego (UTC) dla katalogu zmienia wartość w formacie ISO 8601. Wersja 2021-06-08 i nowsze. Możesz użyć wartości now, aby wskazać czas żądania. Wartość domyślna to now. |
x-ms-file-permission: { inherit ¦ <SDDL> ¦ <binary> } |
W wersji 2019-02-02 do 2021-04-10 ten nagłówek jest wymagany, jeśli nie określono x-ms-file-permission-key. Od wersji 2021-06-08 oba nagłówki są opcjonalne. To uprawnienie jest deskryptorem zabezpieczeń katalogu określonego w Security Descriptor Definition Language (SDDL) lub (wersja 2024-11-04 lub nowsza) w formacie kodowanego w formacie base64 binarnym deskryptorze zabezpieczeń. Można określić format używany z nagłówkiem x-ms-file-permission-format. Tego nagłówka można użyć, jeśli rozmiar uprawnień wynosi ponad 8 kibibajtów (KiB). W przeciwnym razie możesz użyć x-ms-file-permission-key. Jeśli jest określony, musi mieć właściciela, grupę i uznaniową listę kontroli dostępu (DACL). Wartość inherit można przekazać do dziedziczenia z katalogu nadrzędnego.Uwaga: można określić x-ms-file-permission lub x-ms-file-permission-key. Jeśli żaden nagłówek nie zostanie określony, zostanie użyta domyślna wartość inherit. |
x-ms-file-permission-format: { sddl ¦ binary } |
Fakultatywny. Wersja 2024-11-04 lub nowsza. Określa, czy wartość przekazywana w x-ms-file-permission jest w formacie SDDL, czy w formacie binarnym. Jeśli x-ms-file-permission jest ustawiona na inherit, nie należy ustawiać tego nagłówka. Jeśli x-ms-file-permission jest ustawiona na dowolną inną wartość niż inherit, a jeśli ten nagłówek nie jest ustawiony, zostanie użyta wartość domyślna sddl. |
x-ms-file-permission-key: <PermissionKey> |
Klucz uprawnienia do ustawienia dla katalogu. W wersji 2019-02-02 do 2021-04-10 ten nagłówek jest wymagany, jeśli nie określono x-ms-file-permission. Od wersji 2021-06-08 oba nagłówki są opcjonalne. Ten klucz można utworzyć przy użyciu interfejsu API Create-Permission.Uwaga: można określić x-ms-file-permission lub x-ms-file-permission-key. Jeśli żaden nagłówek nie zostanie określony, domyślna wartość inherit zostanie użyta dla nagłówka x-ms-file-permission. |
x-ms-file-attributes |
Wymagane: wersja 2019-02-02 do 2021-04-10. Opcjonalnie: wersja 2021-06-08 lub nowsza. Atrybuty systemu plików, które mają być ustawione w katalogu. Zobacz listę dostępnych atrybutów. Wartość domyślna to Katalog. |
Nagłówki żądań NFS
| Nagłówek żądania | Opis |
|---|---|
x-ms-mode |
Wersja 2025-05-05 lub nowsza. Bity trybu, które mają być ustawione w pliku. Tryb jest reprezentowany w formacie 12-bitowym ósemkowym lub symbolicznym formacie "rwx". Wartość domyślna to 0755. Zobacz uprawnienia do plików POSIX (tryb). Zobacz uprawnienia do plików POSIX (tryb). |
x-ms-owner |
Wersja 2025-05-05 lub nowsza. Identyfikator użytkownika (UID) właściciela pliku, który ma zostać ustawiony w pliku. Wartość domyślna to 0 (root). |
x-ms-group |
Wersja 2025-05-05 lub nowsza. Identyfikator grupy (GID) właściciela pliku, który ma zostać ustawiony w pliku. Wartość domyślna to 0 (root). |
Treść żądania
Żaden.
Przykładowe żądanie
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=
Odpowiedź
Odpowiedź zawiera kod stanu HTTP i zestaw nagłówków odpowiedzi.
Kod stanu
Pomyślna operacja zwraca kod stanu 201 (Utworzono). Aby uzyskać więcej informacji na temat kodów stanu, zobacz Stan i kody błędów.
Nagłówki odpowiedzi
Odpowiedź dla tej operacji zawiera nagłówki w poniższych tabelach. Odpowiedź może również zawierać dodatkowe standardowe nagłówki HTTP. Wszystkie standardowe nagłówki są zgodne ze specyfikacją protokołu HTTP/1.1 .
Typowe nagłówki odpowiedzi
| Nagłówek odpowiedzi | Opis |
|---|---|
ETag |
Zawiera wartość reprezentującą wersję katalogu ujętą w cudzysłów. |
Last-Modified |
Zwraca datę i godzinę ostatniej modyfikacji katalogu. Format daty jest zgodny z RFC 1123. Aby uzyskać więcej informacji, zobacz Reprezentowanie wartości daty/godziny w nagłówkach. Każda operacja modyfikując katalog lub jego właściwości aktualizuje czas ostatniej modyfikacji. Operacje na plikach nie mają wpływu na czas ostatniej modyfikacji katalogu. |
x-ms-request-id |
Jednoznacznie identyfikuje żądanie, które zostało wykonane i może służyć do rozwiązywania problemów z żądaniem. Aby uzyskać więcej informacji, zobacz Rozwiązywanie problemów z operacjami interfejsu API. |
x-ms-version |
Wskazuje wersję usługi Azure Files, która została użyta do wykonania żądania. |
Date |
Wartość daty/godziny UTC wygenerowana przez usługę, która wskazuje godzinę zainicjowania odpowiedzi. |
x-ms-request-server-encrypted: true/false |
Wersja 2017-04-17 lub nowsza. Wartość tego nagłówka jest ustawiona na true, jeśli zawartość żądania zostanie pomyślnie zaszyfrowana przy użyciu określonego algorytmu, a w przeciwnym razie false. |
x-ms-file-creation-time |
Wartość daty/godziny UTC reprezentująca właściwość godzina utworzenia katalogu. |
x-ms-file-last-write-time |
Wartość daty/godziny UTC reprezentująca właściwość czasu ostatniego zapisu dla katalogu. |
x-ms-file-change-time |
Data/godzina UTC reprezentująca właściwość godziny zmiany katalogu. |
x-ms-file-file-id |
Identyfikator pliku katalogu. |
x-ms-file-parent-id |
Identyfikator pliku nadrzędnego katalogu. |
x-ms-client-request-id |
Może służyć do rozwiązywania problemów z żądaniami i odpowiadającymi odpowiedziami. Wartość tego nagłówka jest równa wartości nagłówka x-ms-client-request-id, jeśli jest obecna w żądaniu, a wartość nie zawiera więcej niż 1024 widocznych znaków ASCII. Jeśli nagłówek x-ms-client-request-id nie znajduje się w żądaniu, ten nagłówek nie jest obecny w odpowiedzi. |
Tylko nagłówki odpowiedzi protokołu SMB
| Nagłówek odpowiedzi | Opis |
|---|---|
x-ms-file-permission-key |
Wersja 2019-02-02 lub nowsza. Klucz uprawnienia do katalogu. |
x-ms-file-attributes |
Wersja 2019-02-02 lub nowsza. Atrybuty systemu plików w katalogu. Aby uzyskać więcej informacji, zobacz listę dostępnych atrybutów. |
Nagłówki odpowiedzi tylko systemu plików NFS
| Nagłówek odpowiedzi | Opis |
|---|---|
x-ms-mode |
Wersja 2025-05-05 lub nowsza. Tryb katalogu. Zobacz uprawnienia do plików POSIX (tryb). |
x-ms-owner |
Wersja 2025-05-05 lub nowsza. Identyfikator użytkownika (UID) właściciela katalogu. |
x-ms-group |
Wersja 2025-05-05 lub nowsza. Identyfikator grupy (GID) właściciela katalogu. |
x-ms-file-file-type |
Wersja 2025-05-05 lub nowsza. Typ pliku, możliwa wartość to: Directory. |
Treść odpowiedzi
Żaden.
Przykładowa odpowiedź
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
Autoryzacja
Tylko właściciel konta może wywołać tę operację.
Atrybuty systemu plików
| Atrybut | Atrybut pliku Win32 | Definicja |
|---|---|---|
| ReadOnly | FILE_ATTRIBUTE_READONLY | Katalog, który jest tylko do odczytu. |
| Ukryty | FILE_ATTRIBUTE_HIDDEN | Katalog jest ukryty. Nie jest on uwzględniony w zwykłej liście katalogów. |
| System | FILE_ATTRIBUTE_SYSTEM | Katalog używany przez system operacyjny lub używany wyłącznie. |
| Żaden | FILE_ATTRIBUTE_NORMAL | Katalog, który nie ma innych atrybutów ustawionych. Ten atrybut jest prawidłowy tylko wtedy, gdy jest używany samodzielnie. |
| Katalog | FILE_ATTRIBUTE_DIRECTORY | Dojście identyfikujące katalog. |
| Archiwum | FILE_ATTRIBUTE_ARCHIVE | Katalog, który jest katalogiem archiwum. Aplikacje zwykle używają tego atrybutu do oznaczania plików do tworzenia kopii zapasowej lub usuwania. |
| Offline | FILE_ATTRIBUTE_OFFLINE | Dane katalogu nie są natychmiast dostępne. Ten atrybut systemu plików jest przedstawiany głównie w celu zapewnienia zgodności z systemem Windows. Usługa Azure Files nie obsługuje jej z opcjami magazynu w trybie offline. |
| NotContentIndexed | FILE_ATTRIBUTE_NOT_CONTENT_INDEXED | Katalog nie jest indeksowany przez usługę indeksowania zawartości. |
| NoScrubData | FILE_ATTRIBUTE_NO_SCRUB_DATA | Strumień danych użytkownika, który nie jest odczytywany przez skaner integralności danych w tle. Ten atrybut systemu plików jest przedstawiany głównie w celu zapewnienia zgodności z systemem Windows. |
Uprawnienia do plików POSIX (tryb)
Uprawnienia do plików POSIX można określić numerycznie w 12-bitowym formacie ósemkowym lub w formacie symbolicznym "rwx". Przykłady:
- "0644" lub "rw-r--r--": Użytkownik (właściciel pliku) ma uprawnienie do odczytu, zapisu. Grupa ma uprawnienia do odczytu. Inne osoby mają uprawnienia do odczytu.
- "0755" lub "rwxr-xr-x": Użytkownik (właściciel pliku) ma uprawnienie do odczytu, zapisu i wykonywania, grupa ma uprawnienie do odczytu i wykonywania, inni mają uprawnienia do odczytu i wykonywania.
Format ósemki liczbowej
Trzy najniższe liczby ósemkowe reprezentują uprawnienia właściciela/użytkownika, grupy i innych oraz są wskazywane przy użyciu liczby ósemkowej (0–7), utworzonej przy użyciu kombinacji bitowej "4" (Odczyt), "2" (Zapis), "1" (Wykonywanie). Najwyższa liczba ósemkowa zamówienia (0–7) służy do wskazywania kombinacji uprawnień "4" (SetUID), "2" (SetGID), "1" (StickyBit).
| Forma | Pozwolenie |
|---|---|
| 0700 | Użytkownik (właściciel pliku) ma uprawnienia do odczytu, zapisu i wykonywania. |
| 0400 | Użytkownik ma uprawnienia do odczytu. |
| 0200 | Użytkownik ma uprawnienia do zapisu. |
| 0100 | Użytkownik ma uprawnienie do wykonywania. |
| 0070 | Grupa ma uprawnienia do odczytu, zapisu i wykonywania. |
| 0040 | Grupa ma uprawnienia do odczytu. |
| 0020 | Grupa ma uprawnienia do zapisu. |
| 0010 | Grupa ma uprawnienie do wykonywania. |
| 0007 | Inne osoby mają uprawnienia do odczytu, zapisu i wykonywania. |
| 0004 | Inne osoby mają uprawnienia do odczytu. |
| 0002 | Inni mają uprawnienia do zapisu. |
| 0001 | Inne osoby mają uprawnienia do wykonywania. |
| 4000 | Ustaw obowiązujący identyfikator użytkownika w pliku. |
| 2000 | Ustaw obowiązujący identyfikator grupy w pliku. |
| 1000 | Ustaw wartość wskazującą, że plik można usunąć lub zmienić jego nazwę tylko przez właściciela pliku, właściciela katalogu lub użytkownika głównego. |
Format symboliczny "rwx"
Uprawnienia właściciela/użytkownika, grupy i innych osób są wskazywane przy użyciu kombinacji znaków "r" (Read), "w" (Write) i "x" (Execute).
| Forma | Pozwolenie |
|---|---|
| rwx------ | Użytkownik (właściciel pliku) ma uprawnienia do odczytu, zapisu i wykonywania. |
| r-------- | Użytkownik ma uprawnienia do odczytu. |
| -w------- | Użytkownik ma uprawnienia do zapisu. |
| --x------ | Użytkownik ma uprawnienie do wykonywania. |
| ---rwx--- | Grupa ma uprawnienia do odczytu, zapisu i wykonywania. |
| ---r----- | Grupa ma uprawnienia do odczytu. |
| ----w---- | Grupa ma uprawnienia do zapisu. |
| -----x--- | Grupa ma uprawnienie do wykonywania. |
| ------rwx | Inne osoby mają uprawnienia do odczytu, zapisu i wykonywania. |
| ------r — | Inne osoby mają uprawnienia do odczytu. |
| -------w- | Inni mają uprawnienia do zapisu. |
| --------x | Inne osoby mają uprawnienia do wykonywania. |
Uwagi
Jeśli katalog o tej samej nazwie jest usuwany po wywołaniu Create Directory, serwer zwraca kod stanu 409 (konflikt) i udostępnia dodatkowe informacje o błędzie wskazujące, że katalog jest usuwany.
Jeśli katalog lub plik o tej samej nazwie już istnieje, operacja kończy się niepowodzeniem z kodem stanu 409 (konflikt). Jeśli katalog nadrzędny nie istnieje, operacja zakończy się niepowodzeniem z kodem stanu 412 (Warunek wstępny nie powiodło się).
Nie można utworzyć hierarchii katalogów z pojedynczą operacją Create Directory. Katalog można utworzyć tylko wtedy, gdy jego bezpośredni element nadrzędny już istnieje, jak określono w ścieżce. Jeśli katalog nadrzędny nie istnieje, operacja zakończy się niepowodzeniem z kodem stanu 412 (Warunek wstępny nie powiodło się).
Create Directory nie jest obsługiwana w migawce udziału, która jest kopią udziału tylko do odczytu. Próba wykonania tej operacji na migawki udziału kończy się niepowodzeniem z wartością 400 (InvalidQueryParameterValue)
Zobacz też
operacje w katalogach