Ustawianie właściwości pliku

  • Artykuł

Operacja Set File Properties ustawia właściwości systemu w pliku.

Dostępność protokołu

Włączony protokół udziału plików Dostępny
SMB Tak
NFS nie

Prosić

Żądanie Set File Properties można skonstruować 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ń 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 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. Aby uzyskać więcej informacji, zobacz Przechowywanie wersji dla 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 Pobierz właściwości pliku nie będą zwracać tej właściwości, chyba że zostanie jawnie ustawiona na pliku ponownie.
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 Pobierz właściwości pliku nie będą zwracać tej właściwości, chyba że zostanie jawnie ustawiona na pliku ponownie.
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 Pobierz właściwości pliku nie będą zwracać tej właściwości, chyba że zostanie jawnie ustawiona na pliku ponownie.
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 Pobierz właściwości pliku nie będą zwracać tej właściwości, chyba że zostanie jawnie ustawiona na pliku ponownie.
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 Pobierz właściwości pliku nie będą zwracać tej właściwości, chyba że zostanie jawnie ustawiona na pliku ponownie.
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 Pobierz właściwości pliku nie będą zwracać tej właściwości, chyba że zostanie jawnie ustawiona na pliku ponownie.
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-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 Security Descriptor Definition Language (SDDL) lub (wersja 2024-11-04 lub nowsza) w formacie kodowanego binarnym deskryptorze zabezpieczeń. 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że zostać przekazana, 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-key jest ustawiona na preserve, nie należy ustawiać tego nagłówka. Jeśli x-ms-file-permission-key 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że zostać przekazana, aby zachować istniejącą wartość bez zmian. Wartość domyślna to preserve.
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że zostać przekazana, 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że zostać przekazana, aby zachować istniejącą wartość bez zmian. Jeśli określono preserve i rozmiar pliku zostanie zmieniony, czas ostatniego zapisu zostanie zaktualizowany do bieżącej godziny. 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.
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-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-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. Aby uzyskać więcej informacji, zobacz Nazewnictwo i odwoływanie się do udziałów, katalogów, plików i metadanych.

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.

Nagłówki odpowiedzi

Odpowiedź dla tej operacji zawiera następujące nagłówki. Odpowiedź może również zawierać dodatkowe standardowe nagłówki HTTP. Wszystkie standardowe nagłówki 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 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-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ść 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.

Treść odpowiedzi

Żaden.

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.

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 żadnych innych 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ą 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 w usłudze Azure Files