Dela via


Ange katalogegenskaper

Den Set Directory Properties åtgärden anger systemegenskaper för den angivna katalogen. Den här åtgärden stöds i version 2019-02-02 och senare för filresurser med SMB-protokoll aktiverat och stöds i version 2025-05-05 och senare för filresurser med NFS-protokoll aktiverat.

Protokolltillgänglighet

Aktiverat filresursprotokoll Tillgänglig
SMB Ja
NFS Ja

Begäran

Den Set Directory Properties begäran skapas på följande sätt. Vi rekommenderar att du använder HTTPS.

Metod Begärande-URI HTTP-version
STÄLLA https://myaccount.file.core.windows.net/myshare/mydirectorypath/mydirectory?restype=directory&comp=properties HTTP/1.1

Ersätt sökvägskomponenterna som visas i begärande-URI:n med dina egna enligt följande:

Sökvägskomponent Beskrivning
myaccount Namnet på ditt lagringskonto.
myshare Namnet på filresursen.
mydirectorypath Valfri. Sökvägen till den överordnade katalogen.
mydirectory Namnet på filen.

Information om namngivningsbegränsningar för sökvägar finns i Namn och referensresurser, kataloger, filer och metadata.

URI-parametrar

Du kan ange följande ytterligare parametrar i begärande-URI:n:

Parameter Beskrivning
timeout Valfri. Parametern timeout uttrycks i sekunder. Mer information finns i Ange tidsgränser för filtjänståtgärder.

Begärandehuvuden

De obligatoriska och valfria begäranderubrikerna beskrivs i följande tabeller:

Vanliga begärandehuvuden

Begärandehuvud Beskrivning
Authorization Krävs. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Auktorisera begäranden till Azure Storage.
Date eller x-ms-date Krävs. Anger UTC (Coordinated Universal Time) för begäran. Mer information finns i Auktorisera begäranden till Azure Storage.
x-ms-version Krävs för alla auktoriserade begäranden. Anger vilken version av åtgärden som ska användas för den här begäran. Den här åtgärden stöds i version 2025-05-05 och senare för filresurser med NFS-protokollet aktiverat.

Mer information finns i Versionshantering för Azure Storage-tjänsterna.
x-ms-file-creation-time: { preserve ¦ <DateTime> } Krävs för versionerna 2019-02-02 till 2021-04-10. Valfritt för version 2021-06-08 och senare. Egenskapen Coordinated Universal Time (UTC) creation time för en katalog. Ett värde på preserve kan skickas för att hålla ett befintligt värde oförändrat. Standardvärdet är preserve.
x-ms-file-last-write-time: { preserve ¦ <DateTime> } Krävs för versionerna 2019-02-02 till 2021-04-10. Valfritt för version 2021-06-08 och senare. Den senaste skrivegenskapen coordinated Universal Time (UTC) för en katalog. Ett värde på preserve kan skickas för att hålla ett befintligt värde oförändrat. Standardvärdet är preserve.
x-ms-client-request-id Valfri. Tillhandahåller ett klientgenererat, täckande värde med en kibibytesteckengräns (KiB) som registreras i loggarna när loggningen konfigureras. Vi rekommenderar starkt att du använder det här huvudet för att korrelera aktiviteter på klientsidan med begäranden som servern tar emot. Mer information finns i Övervaka Azure Files-.
x-ms-file-request-intent Krävs om Authorization rubrik anger en OAuth-token. Acceptabelt värde är backup. Det här huvudet anger att Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action eller Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action ska beviljas om de ingår i RBAC-principen som tilldelats den identitet som är auktoriserad med hjälp av Authorization-huvudet. Tillgänglig för version 2022-11-02 och senare.
x-ms-allow-trailing-dot: { <Boolean> } Valfri. Version 2022-11-02 och senare. Det booleska värdet anger om en avslutande punkt som finns i begärande-URL:en ska trimmas eller inte.

Det här huvudet ignoreras om målet finns på en filresurs med NFS-protokollet aktiverat, vilket stöder avslutande punkt som standard.

Mer information finns i Namngivning och referens av resurser, kataloger, filer och metadata.

Endast SMB-begärandehuvuden

Begärandehuvud Beskrivning
x-ms-file-change-time: { now ¦ <DateTime> } Valfri. Version 2021-06-08 och senare. UtC-egenskapen (Coordinated Universal Time) ändrar tid för katalogen, formaterad i FORMATET ISO 8601. Du kan använda värdet now för att ange tidpunkten för begäran. Standardvärdet är now.
x-ms-file-permission: { preserve ¦ <SDDL> ¦ <binary> } I versionerna 2019-02-02 till 2021-04-10 krävs det här huvudet om x-ms-file-permission-key inte anges. Från och med version 2021-06-08 är båda rubrikerna valfria. Den här behörigheten är säkerhetsbeskrivningen för den katalog som anges i SDDL(Security Descriptor Definition Language) eller (version 2024-11-04 eller senare) i base64-kodad binära säkerhetsbeskrivningsformatet. Du kan ange vilket format som ska användas med x-ms-file-permission-format-huvudet. Du kan använda det här huvudet om behörighetsstorleken är 8 kibibyte (KiB) eller mindre. Annars kan du använda x-ms-file-permission-key. Om den anges måste den ha en ägare, grupp och diskretionär åtkomstkontrollista (DACL). Om du vill behålla ett befintligt värde oförändrat kan du skicka ett värde på preserve.

Obs: Du kan ange antingen x-ms-file-permission eller x-ms-file-permission-key. Om inget av huvudena anges används standardvärdet för preserve för x-ms-file-permission-huvudet.
x-ms-file-permission-format: { sddl ¦ binary } Valfri. Version 2024-11-04 eller senare. Anger om värdet som skickas i x-ms-file-permission är i SDDL eller i binärt format. Om x-ms-file-permission är inställt på preservebör det här huvudet inte anges. Om x-ms-file-permission är inställt på något annat värde än preserveoch om det här huvudet inte har angetts används standardvärdet för sddl.
x-ms-file-permission-key: <PermissionKey> I versionerna 2019-02-02 till 2021-04-10 krävs det här huvudet om x-ms-file-permission inte anges. Från och med version 2021-06-08 är båda rubrikerna valfria. Nyckeln för den behörighet som ska anges för filen. Detta kan skapas med hjälp av api:et Create-Permission.

Obs: Du kan ange antingen x-ms-file-permission eller x-ms-file-permission-key. Om inget av huvudena anges används standardvärdet för preserve för x-ms-file-permission-huvudet.
x-ms-file-attributes: { preserve ¦ <FileAttributeList> } Krävs för versionerna 2019-02-02 till 2021-04-10. Valfritt för version 2021-06-08 och senare. De filsystemattribut som ska anges i filen. Se listan över tillgängliga attribut. Ett värde på preserve kan skickas för att hålla ett befintligt värde oförändrat. Standardvärdet är preserve.

Endast NFS-begärandehuvuden

Begärandehuvud Beskrivning
x-ms-mode Version 2025-05-05 och senare. De lägesbitar som ska anges i filen. Läget representeras i 12-bitars numeriskt oktalt format eller det symboliska rwx-formatet. Se POSIX-filbehörigheter (läge).
x-ms-owner Version 2025-05-05 och senare. Användaridentifieraren (UID) för filägaren som ska anges för filen.
x-ms-group Version 2025-05-05 och senare. Gruppidentifieraren (GID) för den filägare som ska anges för filen.

Begärandetext

Ingen.

Svar

Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.

Statuskod

En lyckad åtgärd returnerar statuskod 200 (OK). Information om statuskoder finns i Status och felkoder.

Svarshuvuden

Svaret för den här åtgärden innehåller rubrikerna i följande tabeller. Svaret kan också innehålla ytterligare HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med HTTP/1.1-protokollspecifikationen.

Vanliga svarshuvuden

Svarsrubrik Beskrivning
ETag Innehåller ett värde som representerar filens version. Värdet omges av citattecken.
Last-Modified Returnerar datum och tid då katalogen senast ändrades. Datumformatet följer RFC 1123. Mer information finns i Representera datum/tid-värden i rubriker. Alla åtgärder som ändrar katalogen eller dess egenskaper uppdaterar den senaste ändrade tiden. Åtgärder på filer påverkar inte den senast ändrade tiden för katalogen.
x-ms-request-id Identifierar den begäran som gjordes unikt och kan användas för att felsöka begäran. Mer information finns i Felsöka API-åtgärder.
x-ms-version Anger den filtjänstversion som användes för att köra begäran.
Date eller x-ms-date Ett UTC-datum/tid-värde som genereras av tjänsten, vilket anger den tid då svaret initierades.
x-ms-request-server-encrypted: true/false Version 2017-04-17 och senare. Värdet för det här huvudet är inställt på true om innehållet i begäran har krypterats med hjälp av den angivna algoritmen. Annars är värdet inställt på false.
x-ms-file-creation-time Version 2019-02-02 och senare. UTC-datum/tid-värdet som representerar egenskapen för att skapa tid för katalogen.
x-ms-file-last-write-time Version 2019-02-02 och senare. UTC-datum/tid-värdet som representerar den senaste skrivtidsegenskapen för katalogen.
x-ms-file-change-time Version 2019-02-02 och senare. UTC-datum/tid-värdet som representerar egenskapen för ändringstid för katalogen.
x-ms-client-request-id Kan användas för att felsöka begäranden och motsvarande svar. Värdet för det här huvudet är lika med värdet för x-ms-client-request-id-huvudet om det finns i begäran och värdet inte innehåller fler än 1 024 synliga ASCII-tecken. Om den x-ms-client-request-id rubriken inte finns i begäran visas den inte i svaret.

Endast SMB-svarshuvuden

Svarsrubrik Beskrivning
x-ms-file-permission-key Version 2019-02-02 och senare. Nyckeln för behörigheten för katalogen.
x-ms-file-attributes Version 2019-02-02 och senare. Filsystemattributen i katalogen. Mer information finns i lista över tillgängliga attribut.

Endast NFS-svarshuvuden

Svarsrubrik Beskrivning
x-ms-mode Version 2025-05-05 och senare. Läget för katalogen. Se POSIX-filbehörigheter (läge).
x-ms-owner Version 2025-05-05 och senare. Användaridentifieraren (UID) för katalogägaren.
x-ms-group Version 2025-05-05 och senare. Gruppidentifieraren (GID) för katalogägaren.

Svarstext

Ingen.

Tillstånd

Endast kontoägaren kan anropa den här åtgärden.

Filsystemattribut

Attribut Win32-filattribut Definition
ReadOnly FILE_ATTRIBUTE_READONLY En katalog som är skrivskyddad.
Dold FILE_ATTRIBUTE_HIDDEN Katalogen är dold. Den ingår inte i en vanlig kataloglista.
System FILE_ATTRIBUTE_SYSTEM En katalog som operativsystemet använder en del av eller endast använder.
Ingen FILE_ATTRIBUTE_NORMAL En katalog som inte har andra attribut angivna. Det här attributet är endast giltigt när det används ensamt.
Katalog FILE_ATTRIBUTE_DIRECTORY Referensen som identifierar en katalog.
Arkiv FILE_ATTRIBUTE_ARCHIVE En katalog som är en arkivkatalog. Program använder vanligtvis det här attributet för att markera filer för säkerhetskopiering eller borttagning.
Offline FILE_ATTRIBUTE_OFFLINE Data i en katalog är inte tillgängliga omedelbart. Det här filsystemattributet visas främst för att ge kompatibilitet med Windows. Azure Files stöder inte lagringsalternativ offline.
NotContentIndexed FILE_ATTRIBUTE_NOT_CONTENT_INDEXED Katalogen ska inte indexeras av innehållsindexeringstjänsten.
NoScrubData FILE_ATTRIBUTE_NO_SCRUB_DATA Användardataströmmen ska inte läsas av bakgrundsdataintegritetsskannern. Det här filsystemattributet visas främst för att ge kompatibilitet med Windows.

POSIX-filbehörigheter (läge)

POSIX-filbehörigheter kan anges antingen numeriskt i ett 12-bitars numeriskt oktalt format eller i ett symboliskt "rwx"-format. Exempel:

  • "0644" eller "rw-r--r--": Användaren (filägaren) har läs-, skrivbehörighet. Gruppen har läsbehörighet. Andra har läsbehörighet.
  • "0755" eller "rwxr-xr-x": Användaren (filägaren) har läs-, skriv- och körningsbehörighet. Gruppen har läs- och körningsbehörighet. Andra har läs- och körningsbehörighet.

Numeriskt oktalt format

De tre lägsta oktala nummerordningen representerar behörigheterna för ägare/användare, grupp och andra och anges med ett oktalt tal (0-7), som bildas med hjälp av en bitvis kombination av "4" (Läs), "2" (Skriv), "1" (Kör). Det högsta oktala antalet i ordningen (0–7) används för att ange en kombination av behörigheterna "4" (SetUID), "2" (SetGID), "1" (StickyBit).

Format Tillåtelse
0700 Användaren (filägaren) har läs-, skriv- och körningsbehörighet.
0400 Användaren har läsbehörighet.
0200 Användaren har skrivbehörighet.
0100 Användaren har körningsbehörighet.
0070 Gruppen har läs-, skriv- och körningsbehörighet.
0040 Gruppen har läsbehörighet.
0020 Gruppen har skrivbehörighet.
0010 Gruppen har körningsbehörighet.
0007 Andra har läs-, skriv- och körningsbehörighet.
0004 Andra har läsbehörighet.
0002 Andra har skrivbehörighet.
0001 Andra har körningsbehörighet.
4000 Ange ett effektivt användar-ID för filen.
2000 Ange effektivt grupp-ID för filen.
1000 Ange för att ange att filen endast kan tas bort eller byta namn på filens ägare, katalogägare eller rotanvändare.

Symboliskt "rwx"-format

Behörigheter för ägare/användare, grupp och andra anges med hjälp av en kombination av tecknen "r" (Läs), "w" (Skrivning) och "x" (Kör).

Format Tillåtelse
rwx------ Användaren (filägaren) har läs-, skriv- och körningsbehörighet.
r-------- Användaren har läsbehörighet.
-w------- Användaren har skrivbehörighet.
--x------ Användaren har körningsbehörighet.
---rwx--- Gruppen har läs-, skriv- och körningsbehörighet.
-------- Gruppen har läsbehörighet.
----w---- Gruppen har skrivbehörighet.
-----x--- Gruppen har körningsbehörighet.
------rwx Andra har läs-, skriv- och körningsbehörighet.
------r... Andra har läsbehörighet.
------- Andra har skrivbehörighet.
--------x Andra har körningsbehörighet.

Anmärkningar

Set Directory Properties stöds inte i en resursögonblicksbild, vilket är en skrivskyddad kopia av en resurs. Ett försök att utföra den här åtgärden på en resursögonblicksbild misslyckas med 400 (InvalidQueryParameterValue).

Egenskaper som anges i en katalog med Set Directory Properties sprids inte till underkataloger under katalogen. Du måste anropa Set Directory Properties för varje katalog som du vill uppdatera egenskaper för.

Se även

åtgärder för kataloger