Ange katalogegenskaper
Den Set Directory Properties åtgärden 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änglig |
|---|---|
| SMB |
|
| NFS |
|
Begäran
Den Set Directory Properties begäran kan 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 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 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. Mer information finns i Versionshantering för Azure Storage-tjänsterna. |
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-key har angetts till preserveska det här huvudet inte anges. Om x-ms-file-permission-key ä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. |
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-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-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. Mer information finns i Namngivning och referens av resurser, kataloger, filer och metadata. |
Begärandetext
Ingen.
Svar
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 standard-HTTP-huvuden. Alla standardhuvuden överensstämmer med HTTP/1.1-protokollspecifikationen.
| 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-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. |
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. |
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. |
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.