Ustawianie właściwości katalogu

Operacja Set Directory Properties ustawia właściwości systemu dla określonego katalogu. Ten interfejs API jest dostępny w wersji 2019-02-02.

Dostępność protokołu

Włączony protokół udziału plików	Dostępne
SMB
NFS

Żądanie

Żądanie Set Directory Properties można skonstruować w następujący sposób. Zalecamy używanie protokołu HTTPS.

Metoda	Identyfikator URI żądania	Wersja PROTOKOŁU HTTP
PUT	https://myaccount.file.core.windows.net/myshare/mydirectorypath/mydirectory?restype=directory&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	Opcjonalny. Ścieżka do katalogu nadrzędnego.
mydirectory	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ń opisano 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 usług Azure Storage.
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ń katalogu 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żna użyć polecenia x-ms-file-permission-key. Jeśli jest określona, musi mieć listę właścicieli, grup i uznaniowych kontroli dostępu (DACL). Aby zachować istniejącą wartość bez zmian, możesz przekazać wartość .preserve 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ść preserve domyślna nagłówka x-ms-file-permission .
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, zostanie użyta wartość preserve domyślna nagłówka x-ms-file-permission .
x-ms-file-attributes: { preserve ¦ <FileAttributeList> }	Wymagane dla wersji 2019-02-02 do 2021-04-10. Opcjonalnie dla wersji 2021-06-08 lub nowszej. Atrybuty systemu plików, które mają być ustawione w pliku. Zobacz listę dostępnych atrybutów. Wartość może preserve zostać przekazana, aby zachować istniejącą wartość bez zmian. Wartość domyślna to preserve.
x-ms-file-creation-time: { preserve ¦ <DateTime> }	Wymagane dla wersji 2019-02-02 do 2021-04-10. Opcjonalnie dla wersji 2021-06-08 lub nowszej. Właściwość czasu tworzenia uniwersalnego czasu koordynowanego (UTC) dla katalogu. 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 dla wersji 2019-02-02 do 2021-04-10. Opcjonalnie dla wersji 2021-06-08 lub nowszej. Właściwość ostatniego zapisu koordynowanego czasu uniwersalnego (UTC) dla katalogu. Wartość może preserve zostać przekazana, aby zachować istniejącą wartość bez zmian. Wartość domyślna to preserve.
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 katalogu, 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ć więcej informacji na temat kodów stanu, zobacz Kody stanu i 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 katalogu. 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, która została użyta 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 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.
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ść zmiany godziny 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 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	Katalog, który jest tylko do odczytu.
Ukryty	FILE_ATTRIBUTE_HIDDEN	Katalog jest ukryty. Nie jest on uwzględniony w zwykłej liście katalogów.
System	FILE_ATTRIBUTE_SYSTEM	Katalog używany przez system operacyjny lub używany wyłącznie.
Brak	FILE_ATTRIBUTE_NORMAL	Katalog, który nie ma innych atrybutów ustawionych. Ten atrybut jest prawidłowy tylko wtedy, gdy jest używany samodzielnie.
Directory	FILE_ATTRIBUTE_DIRECTORY	Uchwyt identyfikujący katalog.
Archiwum	FILE_ATTRIBUTE_ARCHIVE	Katalog, który jest katalogiem archiwum. Aplikacje zazwyczaj używają tego atrybutu do oznaczania plików do tworzenia kopii zapasowej lub usuwania.
Tryb offline	FILE_ATTRIBUTE_OFFLINE	Dane katalogu 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	Katalog 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

Set Directory Properties nie jest obsługiwana w migawki 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).

Właściwości ustawione w katalogu z Set Directory Properties nie są propagowane do żadnych podkatalogów pod tym katalogiem. Należy wywołać dla Set Directory Properties każdego katalogu, dla którego chcesz zaktualizować właściwości.

Zobacz też

Operacje na katalogach