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.
Dostępność protokołu
| Włączony protokół udziału plików | Dostępny |
|---|---|
| SMB |
|
| NFS |
|
Prosić
Żądanie Create Directory można skonstruować w następujący sposób. Zalecamy używanie protokołu HTTPS.
| Metoda | Identyfikator URI żądania | Wersja PROTOKOŁU HTTP |
|---|---|---|
PUT |
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 pominięto ścieżkę katalogu nadrzędnego, 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. |
Treść żądania
Żaden.
Nagłówki żądań
Wymagane i opcjonalne nagłówki żądań zostały opisane w poniższej tabeli:
| Parametr | 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. 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-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-key jest ustawiona na inherit, nie należy ustawiać tego nagłówka. Jeśli x-ms-file-permission-key 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. |
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-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-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. Aby uzyskać więcej informacji, zobacz Nazewnictwo i odwoływanie się do udziałów, katalogów, plików i metadanych. |
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 opisane w poniższej tabeli. Odpowiedź może również zawierać dodatkowe standardowe nagłówki HTTP. Wszystkie standardowe nagłówki są zgodne ze specyfikacją protokołu HTTP/1.1 .
| 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-permission-key |
Klucz uprawnienia do katalogu. |
x-ms-file-attributes |
Atrybuty systemu plików w katalogu. Zobacz listę dostępnych atrybutów. |
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. |
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. |
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 zakończy się niepowodzeniem z wartością 400 (InvalidQueryParameterValue)
Zobacz też
operacje w katalogach