Ange katalogegenskaper
Åtgärden Set Directory Properties anger systemegenskaper för den angivna katalogen. Det här API:et är tillgängligt från och med version 2019-02-02.
Protokolltillgänglighet
| Aktiverat filresursprotokoll | Tillgängligt |
|---|---|
| SMB |
|
| NFS |
|
Förfrågan
Begäran Set Directory Properties kan konstrueras på följande sätt. Vi rekommenderar att du använder HTTPS.
| Metod | URI för förfrågan | HTTP-version |
|---|---|---|
| PUT | 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 | Description |
|---|---|
myaccount |
Namnet på ditt lagringskonto. |
myshare |
Namnet på filresursen. |
mydirectorypath |
Valfritt. 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 |
Valfritt. 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ärandehuvudena beskrivs i följande tabell:
| 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 Coordinated Universal Time (UTC) 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. Mer information finns i Versionshantering för Azure Storage-tjänsterna. |
x-ms-file-permission: { preserve ¦ <SDDL> } |
I versionerna 2019-02-02 till 2021-04-10 krävs det här huvudet om x-ms-file-permission-key det 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 katalogen som anges i SDDL (Security Descriptor Definition Language). 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 har angetts måste den ha en dacl (owner, group, and discretionary access control list). Om du vill behålla ett befintligt värde oförändrat kan du skicka värdet preserve.Obs! Du kan ange antingen x-ms-file-permission eller x-ms-file-permission-key. Om inget av preserve huvudena anges används standardvärdet för för x-ms-file-permission rubriken. |
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 det inte anges. Från och med version 2021-06-08 är båda rubrikerna valfria. Nyckeln för behörigheten 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 preserve huvudena anges används standardvärdet för för x-ms-file-permission rubriken. |
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 för 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. |
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. Tidsegenskapen Coordinated Universal Time (UTC) för att skapa 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 |
Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en teckengräns på 1 kibibyte (KiB) som registreras i loggarna när loggning har konfigurerats. 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-change-time: { now ¦ <DateTime> } |
Valfritt. Version 2021-06-08 och senare. UtC-egenskapen (Coordinated Universal Time) ändrar tid för katalogen, formaterad i ISO 8601-format. Du kan använda värdet now för för att ange tiden för begäran. Standardvärdet är now. |
x-ms-file-request-intent |
Krävs om Authorization huvudet 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 DEN RBAC-princip som tilldelats den identitet som har behörighet med hjälp av Authorization huvudet. Tillgänglig för version 2022-11-02 och senare. |
x-ms-allow-trailing-dot: { <Boolean> } |
Valfritt. 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. Mer information finns i Namnge och referera till resurser, kataloger, filer och metadata. |
Begärandetext
Inga.
Svarsåtgärder
Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.
Statuskod
En lyckad åtgärd returnerar statuskod 200 (OK).
Mer information om statuskoder finns i Status och felkoder.
Svarshuvuden
Svaret för den här åtgärden innehåller följande rubriker. Svaret kan också innehålla ytterligare HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med http/1.1-protokollspecifikationen.
| Svarsrubrik | Description |
|---|---|
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-/tidsvärden i rubriker. Alla åtgärder som ändrar katalogen eller dess egenskaper uppdaterar den senaste ändringstiden. Åtgärder på filer påverkar inte den senaste ändringstiden för katalogen. |
x-ms-request-id |
Identifierar 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 DATUM-/tidsvärde för UTC 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 anges till 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-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 listan över tillgängliga attribut. |
x-ms-file-creation-time |
Version 2019-02-02 och senare. Datum/tid-värdet i UTC som representerar egenskapen för att skapa tid för katalogen. |
x-ms-file-last-write-time |
Version 2019-02-02 och senare. Datum-/tidsvärdet FÖR UTC som representerar den senaste skrivtidsegenskapen för katalogen. |
x-ms-file-change-time |
Version 2019-02-02 och senare. Datum-/tidsvärdet UTC 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 x-ms-client-request-id för rubriken om det finns i begäran och värdet inte innehåller fler än 1 024 synliga ASCII-tecken. Om rubriken x-ms-client-request-id inte finns i begäran finns den inte i svaret. |
Själva svaret
Inga.
Auktorisering
Endast kontoinnehavaren 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 presenteras 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 presenteras främst för att ge kompatibilitet med Windows. |
Kommentarer
Set Directory Properties stöds inte på 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 den katalogen. Du måste anropa Set Directory Properties för varje katalog som du vill uppdatera egenskaper för.