Ustawianie właściwości pliku

Operacja Set File Properties ustawia właściwości systemowe 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	Dostępny
Małe i Średnie Przedsiębiorstwa (SMB)
System plików sieciowych (NFS)

Prosić

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

Metoda	Identyfikator URI żądania	Wersja PROTOKOŁU HTTP
KŁAŚĆ	`https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=properties`	HTTP/1.1

Zastąp składniki ścieżki wyświetlane we własnym identyfikatorze URI żądania, w następujący sposób:

Składnik ścieżki	Opis
`myaccount`	Nazwa konta magazynu.
`myshare`	Nazwa udziału plików.
`mydirectorypath`	Fakultatywny. Ścieżka do katalogu nadrzędnego.
`myfile`	Nazwa pliku.

Aby uzyskać informacje o ograniczeniach nazewnictwa ścieżek, zobacz Nazwa i odwołania udziały, katalogi, pliki i metadane.

Parametry identyfikatora URI

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

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.

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 usług Azure Storage.
`x-ms-cache-control`	Fakultatywny. Modyfikuje ciąg kontrolki pamięci podręcznej dla pliku. Jeśli ta właściwość nie zostanie określona w żądaniu, właściwość zostanie wyczyszczone dla pliku. Kolejne wywołania funkcji Pobierz właściwości pliku nie zwrócą tej właściwości, chyba że zostanie ona jawnie ponownie ustawiona w pliku.
`x-ms-content-type`	Fakultatywny. Ustawia typ zawartości pliku. Jeśli ta właściwość nie zostanie określona w żądaniu, właściwość zostanie wyczyszczone dla pliku. Kolejne wywołania funkcji Pobierz właściwości pliku nie zwrócą tej właściwości, chyba że zostanie ona jawnie ponownie ustawiona w pliku.
`x-ms-content-md5`	Fakultatywny. Ustawia skrót MD5 pliku. Jeśli ta właściwość nie zostanie określona w żądaniu, właściwość zostanie wyczyszczone dla pliku. Kolejne wywołania funkcji Pobierz właściwości pliku nie zwrócą tej właściwości, chyba że zostanie ona jawnie ponownie ustawiona w pliku.
`x-ms-content-encoding`	Fakultatywny. Ustawia kodowanie zawartości pliku. Jeśli ta właściwość nie zostanie określona w żądaniu, właściwość zostanie wyczyszczone dla pliku. Kolejne wywołania funkcji Pobierz właściwości pliku nie zwrócą tej właściwości, chyba że zostanie ona jawnie ponownie ustawiona w pliku.
`x-ms-content-language`	Fakultatywny. Ustawia język zawartości pliku. Jeśli ta właściwość nie zostanie określona w żądaniu, właściwość zostanie wyczyszczone dla pliku. Kolejne wywołania funkcji Pobierz właściwości pliku nie zwrócą tej właściwości, chyba że zostanie ona jawnie ponownie ustawiona w pliku.
`x-ms-content-disposition`	Fakultatywny. Ustawia nagłówek `Content-Disposition` pliku. Jeśli ta właściwość nie zostanie określona w żądaniu, właściwość zostanie wyczyszczone dla pliku. Kolejne wywołania funkcji Pobierz właściwości pliku nie zwrócą tej właściwości, chyba że zostanie ona jawnie ponownie ustawiona w pliku.
`x-ms-content-length: bytes`	Fakultatywny. Zmienia rozmiar pliku na określony rozmiar. Jeśli określona wartość bajtu jest mniejsza niż bieżący rozmiar pliku, wszystkie zakresy powyżej określonej wartości bajtowej zostaną wyczyszczone.
`x-ms-file-creation-time: { preserve ¦ <DateTime> }`	Wymagana wersja 2019-02-02 do 2021-04-10. Opcjonalnie, wersja 2021-06-08 lub nowsza. Właściwość czasu utworzenia uniwersalnego czasu koordynowanego (UTC) dla pliku. Wartość `preserve` można przekazać, aby zachować istniejącą wartość bez zmian. Wartość domyślna to `preserve`.
`x-ms-file-last-write-time: { preserve ¦ <DateTime> }`	Wymagana 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 pliku. Wartość `preserve` można przekazać, aby zachować istniejącą wartość bez zmian. Jeśli `preserve` zostanie określony i rozmiar pliku zostanie zmieniony, czas ostatniego zapisu zostanie zaktualizowany do czasu bieżącego. Jeśli rozmiar pliku zostanie zmieniony, ale zostanie podany jawny znacznik czasu, zostanie użyty jawny znacznik czasu. Wartość domyślna to `preserve`.
`x-ms-lease-id:<ID>`	Wymagane, jeśli plik ma aktywną dzierżawę. Dostępne dla wersji 2019-02-02 lub nowszej. 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`	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 Monitorowanie usługi 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

Nagłówek żądania	Opis
`x-ms-file-change-time: { now ¦ <DateTime> }`	Fakultatywny. Wersja 2021-06-08 lub nowsza. Właściwość czasu uniwersalnego koordynowanego (UTC) dla pliku, sformatowana w formacie ISO 8601. Możesz użyć wartości `now`, aby wskazać czas żądania. Wartość domyślna to `now`.
`x-ms-file-permission: { preserve ¦ <SDDL> ¦ <binary> }`	W wersjach 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ń dla pliku określonego w języku definicji deskryptora zabezpieczeń (SDDL) lub (wersja 2024-11-04 lub nowsza) w formacie binarnego deskryptora zabezpieczeń zakodowanym w formacie base64. Można określić format używany z nagłówkiem `x-ms-file-permission-format`. Możesz użyć tego nagłówka, jeśli rozmiar uprawnień to 8 kibibajtów (KiB) lub mniej. W przeciwnym razie możesz użyć `x-ms-file-permission-key`. W przypadku określenia musi mieć właściciela, grupę i uznaniową listę kontroli dostępu (DACL). Wartość `preserve` można przekazać, aby zachować istniejącą wartość bez zmian. 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ść `preserve`.
`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` jest ustawiona na `preserve`, nie należy ustawiać tego nagłówka. Jeśli `x-ms-file-permission` jest ustawiona na dowolną inną wartość niż `preserve`, a jeśli ten nagłówek nie jest ustawiony, zostanie użyta wartość domyślna `sddl`.
`x-ms-file-permission-key: <PermissionKey>`	W wersjach 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. Klucz uprawnienia do ustawienia dla pliku. Można to 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ść `preserve` zostanie użyta dla nagłówka `x-ms-file-permission`.
`x-ms-file-attributes: { preserve ¦ <FileAttributeList> }`	Wymagana 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 pliku. Zobacz listę dostępnych atrybutów. Wartość `preserve` można przekazać, aby zachować istniejącą wartość bez zmian. Wartość domyślna to `preserve`.

Nagłówki żądań NFS

Nagłówek żądania	Opis
`x-ms-mode`	Wersja 2025-05-05 lub nowsza. Bity trybu, które mają być ustawione w pliku. Tryb jest reprezentowany w formacie 12-bitowym ósemkowym lub symbolicznym formacie "rwx". Zobacz uprawnienia do plików POSIX (tryb). Jeśli ta właściwość nie zostanie określona w żądaniu, istniejąca wartość pozostanie niezmieniona.
`x-ms-owner`	Wersja 2025-05-05 lub nowsza. Identyfikator użytkownika (UID) właściciela pliku, który ma zostać ustawiony w pliku. Jeśli ta właściwość nie zostanie określona w żądaniu, istniejąca wartość pozostanie niezmieniona.
`x-ms-group`	Wersja 2025-05-05 lub nowsza. Identyfikator grupy (GID) właściciela pliku, który ma zostać ustawiony w pliku. Jeśli ta właściwość nie zostanie określona w żądaniu, istniejąca wartość pozostanie niezmieniona.

Treść żądania

Żaden.

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. 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`	Zawiera wartość reprezentującą wersję pliku. Wartość jest ujęta w cudzysłów.
`Last-Modified`	Zwraca datę i godzinę ostatniej modyfikacji pliku. Format daty jest zgodny z RFC 1123. Aby uzyskać więcej informacji, zobacz Reprezentowanie wartości daty/godziny w nagłówkach. Każda operacja, która modyfikuje 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 plików używaną do wykonania żądania.
`Date` lub `x-ms-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 została pomyślnie zaszyfrowana przy użyciu określonego algorytmu. W przeciwnym razie wartość jest ustawiona na wartość `false`.
`x-ms-file-creation-time`	Wersja 2019-02-02 lub nowsza. Wartość daty/godziny UTC reprezentująca właściwość godzina utworzenia pliku.
`x-ms-file-last-write-time`	Wersja 2019-02-02 lub nowsza. Wartość daty/godziny UTC reprezentująca właściwość czas ostatniego zapisu dla pliku.
`x-ms-file-change-time`	Wersja 2019-02-02 lub nowsza. Wartość daty/godziny UTC reprezentująca właściwość change time dla pliku.
`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 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 będzie on 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 pliku.
`x-ms-file-attributes`	Wersja 2019-02-02 lub nowsza. 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	Opis
`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.

Treść odpowiedzi

Żaden.

Autoryzacja

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

Atrybuty systemu plików

Atrybut	Atrybut pliku Win32	Definicja
Tylko do odczytu	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	Atrybut_systemowy_pliku	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	Atrybut_pliku_ARCHIWUM	Plik, który jest plikiem archiwum. Aplikacje zwykle używają tego atrybutu do oznaczania plików do tworzenia kopii zapasowej lub usuwania.
Tymczasowy	ATTRIBUT PLIKU_TYMCZASOWY	Plik używany do przechowywania tymczasowego.
W trybie 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 (Zawartość Indeksowana)	Atrybut_pliku_nie_uwzględniany_w_indeksie_treści	Plik nie jest indeksowany przez usługę indeksowania zawartości.
NoScrubData (Dane bez zabezpieczenia)	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 liczby ósemkowe najniższego rzędu reprezentują uprawnienia dla właściciela/użytkownika, grupy i innych osób i są wskazywane za pomocą liczby ósemkowej (0-7), utworzonej przy użyciu bitowej kombinacji "4" (odczyt), "2" (zapis), "1" (wykonanie). Najwyższa liczba ósemkowa zamówienia (0–7) służy do wskazywania kombinacji uprawnień "4" (SetUID), "2" (SetGID), "1" (StickyBit).

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

Forma	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

Semantyka aktualizowania właściwości pliku jest następująca:

Rozmiar pliku jest modyfikowany tylko wtedy, gdy żądanie określa wartość nagłówka x-ms-content-length .
Jeśli żądanie ustawia tylko x-ms-content-length i żadne inne właściwości:
- Jeśli plik znajduje się w udziale plików z włączonym protokołem SMB, żadne inne właściwości pliku nie są modyfikowane.
- Jeśli plik znajduje się w udziale plików z włączonym protokołem NFS, czas zmiany pliku i czas ostatniego zapisu są modyfikowane.
Jeśli co najmniej jedna z poniższych właściwości jest ustawiona w żądaniu, wszystkie te właściwości są ustawione razem. Jeśli wartość nie jest podana dla określonej właściwości, gdy ustawiono co najmniej jedną z następujących właściwości, ta właściwość jest czyszczone dla pliku.
- x-ms-cache-control
- x-ms-content-type
- x-ms-content-md5
- x-ms-content-encoding
- x-ms-content-language

Nuta

Poprzednie właściwości pliku są oddzielone od właściwości systemu plików, które są dostępne dla klientów SMB. Klienci SMB nie mogą odczytywać, zapisywać ani modyfikować tych wartości właściwości.

Set File properties 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 kończy się niepowodzeniem z wartością 400 (InvalidQueryParameterValue).

Jeśli plik ma aktywną dzierżawę, klient musi określić prawidłowy identyfikator dzierżawy na żądanie, aby zapisać właściwości w pliku. Jeśli klient nie określi identyfikatora dzierżawy lub określi nieprawidłowy identyfikator dzierżawy, usługa plików zwraca kod stanu 412 (Niepowodzenie warunku wstępnego). Jeśli klient określa identyfikator dzierżawy, ale plik nie ma aktywnej dzierżawy, usługa plików zwraca również kod stanu 412 (Niepowodzenie warunku wstępnego).

Zobacz też

Operacje na plikach

Last updated on 2025-05-11

Udostępnij przez