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ępny
SMB
NFS

Prosić

Żą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
KŁAŚĆ	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	Fakultatywny. Ścieżka do katalogu nadrzędnego.
mydirectory	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-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ń katalogu określonego w Security Descriptor Definition Language (SDDL) lub (wersja 2024-11-04 lub nowsza) w formacie kodowanego w formacie base64 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. Jeśli jest określony, musi mieć właściciela, grupę i uznaniową listę kontroli dostępu (DACL). Aby zachować istniejącą wartość bez zmian, możesz przekazać wartość preserve. 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-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> }	Wymagane w wersjach 2019-02-02-2021-04-10. Opcjonalnie w wersji 2021-06-08 lub nowszej. 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> }	Wymagane w wersjach 2019-02-02-2021-04-10. Opcjonalnie w wersji 2021-06-08 lub nowszej. Właściwość czasu utworzenia uniwersalnego czasu koordynowanego (UTC) dla katalogu. 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> }	Wymagane w wersjach 2019-02-02-2021-04-10. Opcjonalnie w wersji 2021-06-08 lub nowszej. Właściwość ostatniego zapisu koordynowanego czasu uniwersalnego (UTC) dla katalogu. Wartość preserve może zostać przekazana, aby zachować istniejącą wartość bez zmian. Wartość domyślna to preserve.
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 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 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ć więcej informacji na temat kodów 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 katalogu. 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, 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 ustawiona na true, jeśli zawartość żądania zostanie 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 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ść godzina 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ść godziny zmiany katalogu.
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	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.
Żaden	FILE_ATTRIBUTE_NORMAL	Katalog, który nie ma innych atrybutów ustawionych. Ten atrybut jest prawidłowy tylko wtedy, gdy jest używany samodzielnie.
Katalog	FILE_ATTRIBUTE_DIRECTORY	Dojście identyfikujące 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.
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. Usługa 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 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).

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ć Set Directory Properties dla każdego katalogu, dla którego chcesz zaktualizować właściwości.

Zobacz też

operacje w katalogach