Pobieranie właściwości pliku

Operacja zwraca Get File Properties wszystkie metadane zdefiniowane przez użytkownika, standardowe właściwości HTTP oraz właściwości systemowe dla pliku. Nie zwraca zawartości pliku. 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 Available
SMB Tak
NFS Tak

Żądanie

Żądanie Get File Properties jest konstruowane w następujący sposób. Zalecamy używanie protokołu HTTPS.

Method Żądanie URI Wersja protokołu HTTP
HEAD https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile HTTP/1.1
HEAD https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?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 Description
myaccount Nazwa konta magazynowego.
myshare Nazwa udziału plików.
mydirectorypath Optional. Ścieżka do katalogu nadrzędnego.
myfile Nazwa pliku.

Informacje o ograniczeniach dotyczących nazewnictwa ścieżek można znaleźć w sekcji Nazwy i udostępnione źródła, katalogi, pliki i metadane.

Parametry identyfikatora URI

Na URI żądania można określić następujące dodatkowe parametry:

Parametr Description
sharesnapshot Optional. Wersja 2017-04-17 lub nowsza. Parametr sharesnapshot to nieprzezroczysta wartość DateTime, która po wystąpieniu określa snapshot share, aby zapytać o właściwości pliku.
timeout Optional. Parametr timeout jest wyrażony w sekundach. Więcej informacji można znaleźć w artykule Set time-outs for Azure Files operations.

Nagłówki żądań

Wymagane i opcjonalne nagłówki żądań są opisane w następujących tabelach:

Typowe nagłówki żądań

Nagłówek żądania Description
Autoryzacja Required. 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 Required. 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 usług Azure Storage.
x-ms-lease-id:<ID> Optional. Wersja 2019-02-02 i nowsze. Jeśli nagłówek jest określony, operacja jest wykonywana tylko wtedy, gdy dzierżawa pliku jest aktualnie aktywna, a identyfikator dzierżawy określony w żądaniu odpowiada identyfikatorowi dzierżawy pliku. Jeśli się nie zgadza, operacja kończy się niepowodzeniem z kodem statusowym 412 (Warunek wstępny nieudał).

Ten nagłówek jest ignorowany, jeśli plik znajduje się w udziale plików z włączonym protokołem NFS, który nie obsługuje dzierżaw plików.
x-ms-client-request-id Optional. Zapewnia nieprzejrzystą wartość generowaną przez klienta z limitem znaków 1 kibibajta (KiB), który jest zapisywany w logach analitycznych, gdy logowanie Azure analityka magazynu jest włączone. Gorąco zalecamy używanie tego nagłówka podczas korelowania działań po stronie klienta z żądaniami otrzymywanymi przez serwer. Aby uzyskać więcej informacji, zobacz Monitor Azure Blob Storage.
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> } Optional. 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

None.

Nagłówki żądań NFS

None.

Treść żądania

None.

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 Description
Last-Modified Zwraca datę i godzinę ostatniej modyfikacji pliku. Format daty jest zgodny ze standardem RFC 1123. Aby uzyskać więcej informacji, zobacz Reprezentowanie wartości daty/godziny w nagłówkach. Każda operacja modyfikującą plik lub jego właściwości aktualizuje czas ostatniej modyfikacji.
x-ms-meta-name:value Zestaw par imię-wartość powiązanych z tym plikiem jako metadane zdefiniowane przez użytkownika.
x-ms-type: <File> Zwraca typ File. Zastrzeżone do przyszłego użytku.
Content-Length Rozmiar pliku w bajtach. Ten nagłówek zwraca wartość x-ms-content-length nagłówka przechowywanego w pliku.
Content-Type Typ treści określony dla pliku. Jeśli nie określono żadnego typu zawartości, domyślnym typem zawartości jest application/octet-stream.
ETag Element ETag zawiera wartość, której można użyć do warunkowego wykonywania operacji. Wartość jest ujęta w cudzysłów.
Content-MD5 Jeśli nagłówek został ustawiony Content-MD5 dla pliku, zwracany jest nagłówek Content-MD5 odpowiedzi, aby klient mógł sprawdzić integralność treści wiadomości.
Content-Encoding Jeśli Content-Encoding nagłówek żądania został wcześniej ustawiony dla pliku, wartość jest Content-Encoding zwracana w tym nagłówku.
Content-Language Jeśli Content-Language nagłówek żądania został wcześniej ustawiony dla pliku, wartość jest Content-Language zwracana w tym nagłówku.
Cache-Control Jeśli Cache-Control nagłówek żądania został wcześniej ustawiony dla pliku, wartość jest Cache-Control zwracana w tym nagłówku.
Content-Disposition Zwraca wartość określoną dla nagłówka x-ms-content-disposition i określa, jak przetworzyć odpowiedź.

Pole Content-Disposition nagłówka odpowiedzi przekazuje dodatkowe informacje o tym, jak przetwarzać ładunek odpowiedzi, a także można go użyć do dołączenia dodatkowych metadanych. Na przykład, jeśli jest ustawiony na attachment, Content-Disposition oznacza, że agent użytkownika nie powinien wyświetlać odpowiedzi, lecz zamiast tego okno Zapisz jako (Save As).
x-ms-request-id Unikalnie identyfikuje złożone żądanie i może być użyty do jego rozwiązywania problemów. 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-copy-completion-time:<datetime> Wersja 2015-02-21 i nowsze. Czas zakończenia ostatniej próby operacji Kopiuj plik, gdzie ten plik był plikiem docelowym. Ta wartość może określać czas ukończenia, przerwania lub nieudanej próby kopiowania. Ten nagłówek nie pojawia się, jeśli kopia jest w trakcie oczekiwania, jeśli plik ten nigdy nie był celem w operacji Kopiuj plik lub jeśli plik został zmodyfikowany po zakończeniu operacji Kopiuj plik za pomocą Ustaw właściwości pliku lub Utwórz plik.
x-ms-copy-status-description: <error string> Wersja 2015-02-21 i nowsze. Pojawia się tylko wtedy, gdy x-ms-copy-status jest nieudana lub oczekująca. Opisuje przyczynę śmiertelnej lub nieśmiertelnej niepowodzenia operacji kopiowania. Ten nagłówek nie pojawia się, jeśli kopia jest w trakcie oczekiwania, jeśli plik ten nigdy nie był celem w operacji Kopiuj plik lub jeśli plik został zmodyfikowany po zakończeniu operacji Kopiuj plik za pomocą Ustaw właściwości pliku lub Utwórz plik.
x-ms-copy-id: <id> Wersja 2015-02-21 i nowsze. Identyfikator ciągu dla ostatniej próby operacji Kopiuj plik, gdzie ten plik był plikiem docelowym. Ten nagłówek nie pojawia się, jeśli plik nigdy nie był celem w operacji Kopiuj plik lub jeśli plik został zmodyfikowany po zakończeniu operacji Kopiuj plik za pomocą Ustaw właściwości pliku lub Utwórz plik.
x-ms-copy-progress: <bytes copied/bytes total> Wersja 2015-02-21 i nowsze. Zawiera liczbę skopiowanych bajtów oraz łączną liczbę bajtów w źródle w ostatniej próbie operacji Kopiuj plik, gdzie ten plik był plikiem docelowym. Może pokazać od 0 do liczby skopiowanych Content-Length bajtów. Ten nagłówek nie pojawia się, jeśli plik nigdy nie był celem w operacji Kopiuj plik lub jeśli plik został zmodyfikowany po zakończeniu operacji Kopiuj plik za pomocą Ustaw właściwości pliku lub Utwórz plik.
x-ms-copy-source: url Wersja 2015-02-21 i nowsze. URL o długości do 2 KB znaków, który określa plik źródłowy użyty w ostatniej próbie operacji Kopiowanie pliku , gdzie ten plik był plikiem docelowym. Usługa usuwa jedynie sygnaturę SAS (sig) przed przywróceniem tego nagłówka. Inne parametry SAS mogą pozostawać. Nie używaj tego nagłówka do pobierania ani ponownego używania danych uwierzytelniających SAS. Ten nagłówek nie pojawia się, jeśli plik nigdy nie był celem w operacji Kopiuj plik lub jeśli plik został zmodyfikowany po zakończeniu operacji Kopiuj plik za pomocą Ustaw właściwości pliku lub Utwórz plik.
x-ms-copy-status: <pending ¦ success ¦ aborted ¦ failed> Wersja 2015-02-21 i nowsze. Stan operacji kopiowania zidentyfikowany przez x-ms-copy-id, z następującymi wartościami:

- Sukces: Kopia zakończona pomyślnie.
- W trakcie realizacji: Kopia jest w trakcie realizacji. Sprawdź, x-ms-copy-status-description czy przerywane, nieśmiertelne błędy utrudniają proces kopiowania, ale nie powodują awarii.
- przerwana: Kopia została zakończona przez Abort Copy File.
- Niepowodzenie: Kopia niepowiodowana. Zobacz x-ms-copy-status-description szczegółowe informacje o awarii.

Ten nagłówek nie pojawia się, jeśli plik nigdy nie był celem w operacji Kopiuj plik lub jeśli plik został zmodyfikowany po zakończeniu operacji Kopiuj plik za pomocą Ustaw właściwości pliku lub Utwórz plik.
x-ms-server-encrypted: true/false Wersja 2017-04-17 lub nowsza. Wartość tego nagłówka jest ustawiona na , true jeśli dane pliku i metadane aplikacji są całkowicie zaszyfrowane przy użyciu określonego algorytmu. Wartość jest ustalana tak, false że plik jest nieszyfrowany lub gdy zaszyfrowane są tylko części pliku lub metadanych aplikacji.
x-ms-file-creation-time Wersja 2019-02-02 i nowsze. Wartość UTC daty/godziny reprezentującej właściwość czasu utworzenia pliku.
x-ms-file-last-write-time Wersja 2019-02-02 i nowsze. Wartość daty/godziny UTC reprezentująca właściwość czas ostatniego zapisu dla pliku.
x-ms-file-change-time Wersja 2019-02-02 i nowsze. Wartość UTC daty/godziny reprezentującej właściwość zmiany czasu dla pliku.
x-ms-file-id Wersja 2019-02-02 i nowsze. Identyfikator pliku.
x-ms-file-parent-id Wersja 2019-02-02 i nowsze. Identyfikator pliku nadrzędnego.
x-ms-lease-duration:infinite Wersja 2019-02-02 i nowsze. Gdy plik jest dzierżawiony, określa, że umowa trwa nieskończony.
x-ms-lease-state:<available;leased;broken> Wersja 2019-02-02 i nowsze. Gdy plik jest dzierżawiony, określa się stan dzierżawy pliku.
x-ms-lease-status:<locked;unlocked> Wersja 2019-02-02 i nowsze. Gdy plik jest dzierżawiony, określa status dzierżawy pliku.
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 Description
x-ms-file-permission-key Wersja 2019-02-02 i nowsze. Klucz uprawnienia do pliku.
x-ms-file-attributes Wersja 2019-02-02 i nowsze. Atrybuty systemu plików pliku. Aby uzyskać więcej informacji, zobacz listę dostępnych atrybutów.

Nagłówki odpowiedzi tylko systemu plików NFS

Nagłówek odpowiedzi Description
x-ms-mode Wersja 2025-05-05 lub nowsza. Tryb pliku. Zobacz uprawnienia do plików POSIX (tryb).
x-ms-owner Wersja 2025-05-05 lub nowsza. Identyfikator użytkownika (UID) właściciela pliku.
x-ms-group Wersja 2025-05-05 lub nowsza. Identyfikator grupy (GID) właściciela pliku.
x-ms-link-count Wersja 2025-05-05 lub nowsza. Liczba linków pliku.
x-ms-file-file-type Wersja 2025-05-05 lub nowsza. Typ pliku, możliwe wartości to: Regular, Symlink.

Treść odpowiedzi

None.

Przykładowa odpowiedź

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
x-ms-type: File  
x-ms-meta-m1: v1  
x-ms-meta-m2: v2  
Content-Length: 11  
Content-Type: text/plain; charset=UTF-8  
Date: <date>  
ETag: "0x8CB171DBEAD6A6B"  
Last-Modified: <date>  
x-ms-version: 2019-02-02  
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0  
x-ms-copy-id: 36650d67-05c9-4a24-9a7d-a2213e53caf6  
x-ms-copy-source: <url>  
x-ms-copy-status: success  
x-ms-copy-progress: 11/11  
x-ms-copy-completion-time: <date>  
x-ms-lease-duration: infinite   
x-ms-lease-state: leased 
x-ms-lease-status: locked

Autoryzacja

Tylko właściciel konta może wywołać tę operację.

Atrybuty systemu plików

Attribute Atrybut pliku Win32 Definition
ReadOnly FILE_ATTRIBUTE_READONLY Plik, który jest tylko do odczytu. Aplikacje mogą odczytać plik, ale nie mogą go zapisać 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.
None FILE_ATTRIBUTE_NORMAL Plik, który nie ma innych atrybutów ustawionych. Ten atrybut jest prawidłowy tylko wtedy, gdy jest używany samodzielnie.
Archive 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.
Temporary ATTRIBUT PLIKU_TYMCZASOWY 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. Azure Files nie obsługuje opcji przechowywania 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 powinien być 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". Examples:

  • "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.

Informacje dodatkowe

Operacje na plikach

  • Ostatnia aktualizacja o