Ustawianie właściwości pliku
Operacja Set File Properties ustawia właściwości systemu w pliku.
Dostępność protokołu
| Włączony protokół udziału plików | Dostępne |
|---|---|
| SMB |  |
| NFS |  |
Żądanie
Żądanie Set File Properties może być skonstruowane w następujący sposób. Zalecamy korzystanie z protokołu HTTPS.
| Metoda | Identyfikator URI żądania | Wersja PROTOKOŁU HTTP |
|---|---|---|
| PUT | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=properties |
HTTP/1.1 |
Zastąp składniki ścieżki wyświetlane w identyfikatorze URI żądania własnymi elementami w następujący sposób:
| Składnik ścieżki | Opis |
|---|---|
myaccount |
Nazwa konta magazynu. |
myshare |
Nazwa udziału plików. |
mydirectorypath |
Opcjonalny. Ścieżka do katalogu nadrzędnego. |
myfile |
Nazwa pliku. |
Aby uzyskać informacje 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. |
Nagłówki żądań
Wymagane i opcjonalne nagłówki żądań zostały opisane w poniższej tabeli:
| 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 dla żądania godzinę w formacie uniwersalnego czasu koordynowanego (UTC). 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 dla usług Azure Storage. |
x-ms-cache-control |
Opcjonalny. 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 będą zwracać tej właściwości, chyba że zostanie jawnie ustawiona w pliku ponownie. |
x-ms-content-type |
Opcjonalny. 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 będą zwracać tej właściwości, chyba że zostanie jawnie ustawiona w pliku ponownie. |
x-ms-content-md5 |
Opcjonalny. 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 będą zwracać tej właściwości, chyba że zostanie jawnie ustawiona w pliku ponownie. |
x-ms-content-encoding |
Opcjonalny. 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 będą zwracać tej właściwości, chyba że zostanie jawnie ustawiona w pliku ponownie. |
x-ms-content-language |
Opcjonalny. 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 będą zwracać tej właściwości, chyba że zostanie jawnie ustawiona w pliku ponownie. |
x-ms-content-disposition |
Opcjonalny. Ustawia nagłówek pliku Content-Disposition .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 będą zwracać tej właściwości, chyba że zostanie jawnie ustawiona w pliku ponownie. |
x-ms-content-length: bytes |
Opcjonalny. Zmienia rozmiar pliku na określony rozmiar. Jeśli określona wartość bajtowa jest mniejsza niż bieżący rozmiar pliku, wszystkie zakresy powyżej określonej wartości bajtu są czyszczone. |
x-ms-file-permission: { preserve ¦ <SDDL> } |
W wersjach 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ń dla pliku określonego w języku SDDL (Security Descriptor Definition Language). 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ć polecenia x-ms-file-permission-key. Jeśli zostanie określony, musi mieć właściciela, grupę i uznaniową listę kontroli dostępu (DACL). Wartość może zostać przekazana preserve , aby zachować istniejącą wartość bez zmian.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 preserve . |
x-ms-file-permission-key: <PermissionKey> |
W wersjach 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. Klucz uprawnienia do ustawienia dla pliku. Można to 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, dla nagłówka zostanie użyta preserve wartość domyślna x-ms-file-permission . |
x-ms-file-attributes: { preserve ¦ <FileAttributeList> } |
Wymagane, wersja 2019-02-02 do 2021-04-10. Opcjonalnie, wersja 2021-06-08 i nowsze. Atrybuty systemu plików do ustawienia w pliku. Zobacz listę dostępnych atrybutów. Wartość może zostać przekazana preserve , aby zachować istniejącą wartość bez zmian. Wartość domyślna to preserve. |
x-ms-file-creation-time: { preserve ¦ <DateTime> } |
Wymagane, wersja 2019-02-02 do 2021-04-10. Opcjonalnie, wersja 2021-06-08 i nowsze. Właściwość czasu utworzenia uniwersalnego czasu koordynowanego (UTC) dla pliku. Wartość może preserve zostać przekazana, aby zachować istniejącą wartość bez zmian. Wartość domyślna to preserve. |
x-ms-file-last-write-time: { preserve ¦ <DateTime> } |
Wymagane, wersja 2019-02-02 do 2021-04-10. Opcjonalnie, wersja 2021-06-08 i nowsze. Właściwość uniwersalnego czasu koordynowanego (UTC) ostatniego zapisu dla pliku. Wartość może preserve zostać przekazana, aby zachować istniejącą wartość bez zmian. Jeśli preserve zostanie określony i rozmiar pliku zostanie zmieniony, czas ostatniego zapisu zostanie zaktualizowany do bieżącej godziny. Jeśli rozmiar pliku zostanie zmieniony, ale zostanie podana jawna sygnatura czasowa, zostanie użyta jawna sygnatura czasowa. 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. |
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. 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-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. |
Treść żądania
Brak.
Reakcja
Odpowiedź zawiera kod stanu HTTP i zestaw nagłówków odpowiedzi.
Kod stanu
Operacja zakończona powodzeniem zwraca kod stanu 200 (OK).
Aby uzyskać informacje o kodach stanu, zobacz Stan i kody błędów.
Nagłówki odpowiedzi
Odpowiedź na tę operację zawiera następujące nagłówki. 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ę 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 Reprezentacja 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 wykonane żądanie 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 ustawiana na true wartość , jeśli zawartość żądania zostanie pomyślnie zaszyfrowana przy użyciu określonego algorytmu. W przeciwnym razie wartość jest ustawiona na false. |
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 w pliku. Aby uzyskać więcej informacji, zobacz listę dostępnych atrybutów. |
x-ms-file-creation-time |
Wersja 2019-02-02 lub nowsza. Wartość daty/godziny UTC reprezentująca właściwość godziny utworzenia pliku. |
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 pliku. |
x-ms-file-change-time |
Wersja 2019-02-02 lub nowsza. Wartość daty/godziny UTC reprezentująca właściwość zmiany godziny dla 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 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 jest obecny w żądaniu, nie będzie on obecny w odpowiedzi. |
Treść odpowiedzi
Brak.
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 używany przez system operacyjny lub używany wyłącznie przez system operacyjny. |
| Brak | 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. |
| Tymczasowe | FILE_ATTRIBUTE_TEMPORARY | Plik używany do przechowywania tymczasowego. |
| Tryb 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 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. |
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-lengthi żadne inne właściwości, żadne inne właściwości pliku nie 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ą ustawiane razem. Jeśli wartość nie jest podana dla określonej właściwości po ustawieniu co najmniej jednej z następujących właściwości, ta właściwość jest czyszczone dla pliku.
x-ms-cache-controlx-ms-content-typex-ms-content-md5x-ms-content-encodingx-ms-content-language
Uwaga
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 migawce udziału kończy się niepowodzeniem z błędem 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śla 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).