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ępne |
|---|---|
| SMB |  |
| NFS |  |
Żądanie
Żądanie można skonstruować Create Directory 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 |
Opcjonalny. Ścieżka do katalogu nadrzędnego, w którym ma zostać utworzona mojakatalog . Jeśli pominięto ścieżkę katalogu nadrzędnego, katalog zostanie utworzony w określonym udziale. Jeśli zostanie określony katalog nadrzędny, musi już istnieć w udziale, zanim będzie można utworzyć katalog mydirectory. |
mydirectory |
Nazwa katalogu do utworzenia. |
Aby uzyskać więcej informacji na temat ograniczeń nazewnictwa ścieżek, zobacz Nazwy i udziały referencyjne, katalogi, pliki i metadane.
Parametry identyfikatora URI
W identyfikatorze URI żądania można określić następujące dodatkowe parametry.
| Parametr | Opis |
|---|---|
timeout |
Opcjonalny. Parametr jest wyrażony timeout w sekundach. Aby uzyskać więcej informacji, zobacz Ustawianie limitów czasu dla operacji usługi plików. |
Treść żądania
Brak.
Nagłówki żądań
Wymagane i opcjonalne nagłówki żądań opisano 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 godzinę uniwersalnego czasu koordynowanego (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 usług Azure Storage. |
x-ms-meta-name:value |
Opcjonalny. Wersja 2015-02-21 lub nowsza. Para name-value do skojarzenia z katalogiem jako metadanych. Nazwy metadanych muszą być zgodne z regułami nazewnictwa identyfikatorów języka C#. |
x-ms-file-permission: { inherit ¦ <SDDL> } |
W wersji 2019-02-02 do 2021-04-10 ten nagłówek jest wymagany, jeśli x-ms-file-permission-key nie zostanie określony. Od wersji 2021-06-08 oba nagłówki są opcjonalne. To uprawnienie jest deskryptorem zabezpieczeń katalogu określonego w języku SDDL (Security Descriptor Definition Language). Ten nagłówek może być używany, jeśli rozmiar uprawnień wynosi ponad 8 kibibajtów (KiB). W przeciwnym razie można użyć polecenia x-ms-file-permission-key. Jeśli jest określona, musi mieć listę właścicieli, grup i uznaniowych kontroli dostępu (DACL). Możesz przekazać wartość do inherit dziedziczenia z katalogu nadrzędnego.Uwaga: możesz określić wartość x-ms-file-permission lub x-ms-file-permission-key. Jeśli żaden nagłówek nie zostanie określony, zostanie użyta wartość domyślna inherit . |
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 x-ms-file-permission nie zostanie określony. Od wersji 2021-06-08 oba nagłówki są opcjonalne. Ten klucz można utworzyć przy użyciu interfejsu Create-Permission API.Uwaga: możesz określić wartość x-ms-file-permission lub x-ms-file-permission-key. Jeśli żaden nagłówek nie zostanie określony, zostanie użyta wartość inherit domyślna 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ść uniwersalnego czasu koordynowanego (UTC) dla katalogu. Możesz użyć wartości , now aby wskazać czas żądania. Wartość domyślna to now. |
x-ms-client-request-id |
Opcjonalny. Udostępnia 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 Monitorowanie Azure Files. |
x-ms-file-change-time: { now ¦ <DateTime> } |
Opcjonalny. Właściwość czasu uniwersalnego koordynowanego (UTC) dla katalogu zmienia się w formacie ISO 8601. Wersja 2021-06-08 i nowsza. Możesz użyć wartości , now aby wskazać czas żądania. Wartość domyślna to now. |
x-ms-file-request-intent |
Wymagane, jeśli Authorization nagłówek określa token OAuth. Akceptowalna wartość to backup. Ten nagłówek określa, że wartość Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action lub Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action powinna zostać udzielona, jeśli zostaną one uwzględnione w zasadach RBAC przypisanych do tożsamości, która jest autoryzowana przy użyciu nagłówka Authorization . Dostępne dla wersji 2022-11-02 lub nowszej. |
x-ms-allow-trailing-dot: { <Boolean> } |
Opcjonalny. Wersja 2022-11-02 lub nowsza. Wartość logiczna określa, czy końcowa kropka obecna w adresie URL żądania powinna być przycinana, 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=
Reakcja
Odpowiedź zawiera kod stanu HTTP i zestaw nagłówków odpowiedzi.
Kod stanu
Operacja zakończona powodzeniem zwraca kod stanu 201 (utworzono).
Aby uzyskać więcej informacji na temat kodów stanu, zobacz Kody stanu i błędów.
Nagłówki odpowiedzi
Odpowiedź na tę operację zawiera nagłówki opisane w poniższej tabeli. Odpowiedź może również zawierać dodatkowe standardowe nagłówki HTTP. Wszystkie nagłówki standardowe 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 Reprezentacja 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 wpływają na czas ostatniej modyfikacji katalogu. |
x-ms-request-id |
Jednoznacznie identyfikuje żądanie, które zostało wykonane i może być używane 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ę 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 ustawiana na true wartość , jeśli zawartość żądania zostanie pomyślnie zaszyfrowana przy użyciu określonego algorytmu i false w inny sposób. |
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ść godziny 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, która reprezentuje właściwość zmiany godziny 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 im odpowiedziami. Wartość tego nagłówka jest równa wartości x-ms-client-request-id nagłówka, jeśli znajduje się w żądaniu, a wartość nie zawiera więcej niż 1024 widocznych znaków ASCII. x-ms-client-request-id Jeśli nagłówek nie znajduje się w żądaniu, ten nagłówek nie jest obecny w odpowiedzi. |
Treść odpowiedzi
Brak.
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. |
| Brak | FILE_ATTRIBUTE_NORMAL | Katalog, który nie ma innych atrybutów ustawionych. Ten atrybut jest prawidłowy tylko wtedy, gdy jest używany samodzielnie. |
| Directory | FILE_ATTRIBUTE_DIRECTORY | Uchwyt identyfikujący 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. |
| Tryb 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. Azure Files nie obsługuje go 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 Create Directory wywołaniu, serwer zwraca kod stanu 409 (konflikt) i zawiera 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 kończy się niepowodzeniem z kodem stanu 412 (Warunek wstępny nie powiodło się).
Nie można utworzyć hierarchii katalogów za pomocą jednej Create Directory operacji. 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 kończy się niepowodzeniem z kodem stanu 412 (Warunek wstępny nie powiodło się).
Create Directory nie jest obsługiwana w migawki 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)