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 Yes
NFS No

Żą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 usługi Azure Monitor 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.

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.
Katalog 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 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 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)

Zobacz też

Operacje na katalogach