Pobieranie właściwości katalogu
Operacja Get Directory Properties zwraca wszystkie właściwości systemu dla określonego katalogu i może służyć do sprawdzania istnienia katalogu. Zwrócone dane nie zawierają plików w katalogu ani żadnych podkatalogach. 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 Get Directory Properties jest konstruowane w następujący sposób. Zalecamy używanie protokołu HTTPS.
| Metoda | Identyfikator URI żądania | Wersja PROTOKOŁU HTTP |
|---|---|---|
| GET/HEAD | https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory |
HTTP/1.1 |
| GET/HEAD | https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory&sharesnapshot=<DateTime> |
HTTP/1.1 |
Zastąp składniki ścieżki, które są wyświetlane w identyfikatorze URI żądania własnym, w następujący sposób:
| Składnik ścieżki | Opis |
|---|---|
myaccount |
Nazwa konta magazynu. |
myshare |
Nazwa udziału plików. |
myparentdirectorypath |
Fakultatywny. Ścieżka do katalogu nadrzędnego. |
mydirectory |
Nazwa katalogu. |
Aby uzyskać informacje o ograniczeniach nazewnictwa ścieżek, zobacz Nazwa i odwołania udziały, katalogi, pliki i metadane.
Parametry identyfikatora URI
Dla identyfikatora URI żądania można określić następujące dodatkowe parametry:
| Parametr | Opis |
|---|---|
sharesnapshot |
Fakultatywny. Wersja 2017-04-17 lub nowsza. Parametr sharesnapshot jest nieprzezroczystą wartością DateTime, która w chwili obecnej określa migawkę udziału, aby wykonać zapytanie o właściwości katalogu |
timeout |
Fakultatywny. Parametr timeout jest wyrażony w sekundach. Aby uzyskać więcej informacji, zobacz Ustawianie limitów czasu dla operacji usługi Azure Files. |
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 uniwersalny czas 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-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
Żaden.
Nagłówki żądań NFS
Żaden.
Treść żądania
Żaden.
Przykładowe żądanie
HEAD https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory HTTP/1.1
Request Headers:
x-ms-version: 2015-02-21
x-ms-date: <date>
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=
Odpowiedź
Odpowiedź zawiera kod stanu HTTP i zestaw nagłówków odpowiedzi.
Kod stanu
Pomyślna operacja zwraca kod stanu 200 (OK). Aby uzyskać informacje o kodach 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 |
Element ETag zawiera wartość, której można użyć do warunkowego wykonywania operacji. Wartość jest ujęta 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. Operacje na plikach w katalogu nie mają wpływu na czas ostatniej modyfikacji katalogu. |
x-ms-meta-name:value |
Zestaw par nazwa-wartość, które zawierają metadane katalogu. |
x-ms-request-id |
Zwraca unikatowy identyfikator żądania, który może pomóc w rozwiązywaniu 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, 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-server-encrypted: true/false |
Wersja 2017-04-17 lub nowsza. Wartość tego nagłówka jest ustawiona na true, jeśli metadane katalogu są całkowicie szyfrowane przy użyciu określonego algorytmu. Jeśli metadane nie są szyfrowane, wartość jest ustawiona na false. |
x-ms-file-creation-time |
Wersja 2019-02-02 lub nowsza. Wartość daty/godziny UTC reprezentująca właściwość godziny utworzenia katalogu. |
x-ms-file-last-write-time |
Wersja 2019-02-02 lub nowsza. Wartość daty/godziny UTC reprezentująca właściwość czasu ostatniego zapisu dla katalogu. |
x-ms-file-change-time |
Wersja 2019-02-02 lub nowsza. Wartość daty/godziny UTC reprezentująca właściwość godziny zmiany katalogu. |
x-ms-file-file-id |
Wersja 2019-02-02 lub nowsza. Identyfikator pliku katalogu. |
x-ms-file-parent-id |
Wersja 2019-02-02 lub nowsza. 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 nagłówka x-ms-client-request-id, jeśli znajduje się 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, 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żliwe wartości to: Directory. |
Treść odpowiedzi
Żaden.
Przykładowa odpowiedź
Response Status:
HTTP/1.1 200 OK
Response Headers:
Transfer-Encoding: chunked
Date: <date>
ETag: "0x8CAFB82EFF70C46"
Last-Modified: <date>
x-ms-version: 2015-02-21
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 | Plik, który jest tylko do odczytu. Aplikacje mogą odczytywać plik, ale nie mogą go zapisywać ani usuwać. |
| Ukryty | FILE_ATTRIBUTE_HIDDEN | Plik jest ukryty. Nie jest on uwzględniony w zwykłej liście katalogów. |
| System | FILE_ATTRIBUTE_SYSTEM | Plik, który system operacyjny używa części lub używa wyłącznie. |
| Żaden | FILE_ATTRIBUTE_NORMAL | Plik, który nie ma innych atrybutów ustawionych. Ten atrybut jest prawidłowy tylko wtedy, gdy jest używany samodzielnie. |
| Archiwum | FILE_ATTRIBUTE_ARCHIVE | Plik, który jest plikiem archiwum. Aplikacje zwykle używają tego atrybutu do oznaczania plików do tworzenia kopii zapasowej lub usuwania. |
| Tymczasowy | FILE_ATTRIBUTE_TEMPORARY | Plik używany do przechowywania tymczasowego. |
| Offline | FILE_ATTRIBUTE_OFFLINE | Dane pliku 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 opcji magazynu w trybie offline. |
| NotContentIndexed | FILE_ATTRIBUTE_NOT_CONTENT_INDEXED | Plik nie jest indeksowany przez usługę indeksowania zawartości. |
| NoScrubData | FILE_ATTRIBUTE_NO_SCRUB_DATA | Strumień danych użytkownika 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. Inne osoby 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).
| Format | 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).
| Format | 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 określona ścieżka katalogu nie istnieje, żądanie zakończy się niepowodzeniem z kodem stanu 404 (Nie znaleziono).
Zobacz też
operacje w katalogach