Ange filegenskaper
Den Set File Properties åtgärden anger systemegenskaper för filen.
Protokolltillgänglighet
| Aktiverat filresursprotokoll | Tillgänglig |
|---|---|
| SMB |
|
| NFS |
|
Begäran
Den Set File 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/myfile?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. |
myfile |
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-cache-control |
Valfri. Ändrar cachekontrollsträngen för filen. Om den här egenskapen inte anges i begäran rensas egenskapen för filen. Efterföljande anrop till Hämta filegenskaper returnerar inte den här egenskapen, såvida den inte uttryckligen anges på filen igen. |
x-ms-content-type |
Valfri. Anger filens innehållstyp. Om den här egenskapen inte anges i begäran rensas egenskapen för filen. Efterföljande anrop till Hämta filegenskaper returnerar inte den här egenskapen, såvida den inte uttryckligen anges på filen igen. |
x-ms-content-md5 |
Valfri. Anger filens MD5-hash. Om den här egenskapen inte anges i begäran rensas egenskapen för filen. Efterföljande anrop till Hämta filegenskaper returnerar inte den här egenskapen, såvida den inte uttryckligen anges på filen igen. |
x-ms-content-encoding |
Valfri. Anger filens innehållskodning. Om den här egenskapen inte anges i begäran rensas egenskapen för filen. Efterföljande anrop till Hämta filegenskaper returnerar inte den här egenskapen, såvida den inte uttryckligen anges på filen igen. |
x-ms-content-language |
Valfri. Anger filens innehållsspråk. Om den här egenskapen inte anges i begäran rensas egenskapen för filen. Efterföljande anrop till Hämta filegenskaper returnerar inte den här egenskapen, såvida den inte uttryckligen anges på filen igen. |
x-ms-content-disposition |
Valfri. Anger filens Content-Disposition-huvud.Om den här egenskapen inte anges i begäran rensas egenskapen för filen. Efterföljande anrop till Hämta filegenskaper returnerar inte den här egenskapen, såvida den inte uttryckligen anges på filen igen. |
x-ms-content-length: bytes |
Valfri. Ändrar storlek på en fil till den angivna storleken. Om det angivna bytevärdet är mindre än filens aktuella storlek rensas alla intervall ovanför det angivna bytevärdet. |
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 filen som anges i Security Descriptor Definition Language (SDDL) eller (version 2024-11-04 eller senare) i base64-kodad binär säkerhetsbeskrivningsformat. 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 enpreserve kan skickas för att hålla ett befintligt värde oförändrat.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. |
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> } |
Obligatorisk version 2019-02-02 till 2021-04-10. Valfritt, 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> } |
Obligatorisk version 2019-02-02 till 2021-04-10. Valfritt, version 2021-06-08 och senare. Tidsegenskapen Coordinated Universal Time (UTC) för att skapa en fil. 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> } |
Obligatorisk version 2019-02-02 till 2021-04-10. Valfritt, version 2021-06-08 och senare. Den senaste skrivegenskapen coordinated Universal Time (UTC) för en fil. Ett värde på preserve kan skickas för att hålla ett befintligt värde oförändrat. Om preserve anges och filens storlek ändras uppdateras den senaste skrivtiden till den aktuella tiden. Om filens storlek ändras, men en explicit tidsstämpel anges, används den explicita tidsstämpeln. Standardvärdet är preserve. |
x-ms-lease-id: <ID> |
Krävs om filen har ett aktivt lån. Tillgänglig för version 2019-02-02 och senare. |
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. Egenskapen Coordinated Universal Time (UTC) ändrar tid för filen, 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).
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 när filen 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 unikt den begäran som gjordes och kan användas för att felsöka begäran. Mer information finns i Felsöka API-åtgärder. |
x-ms-version |
Anger vilken version av filtjänsten som används 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 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 filens behörighet. |
x-ms-file-attributes |
Version 2019-02-02 och senare. Filsystemets attribut för filen. 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 filen. |
x-ms-file-last-write-time |
Version 2019-02-02 och senare. UTC-datum/tid-värdet som representerar den senaste skrivtidsegenskapen för filen. |
x-ms-file-change-time |
Version 2019-02-02 och senare. UTC-datum/tid-värdet som representerar egenskapen för ändringstid för filen. |
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 fil som är skrivskyddad. Program kan läsa filen, men kan inte skriva till den eller ta bort den. |
| Dold | FILE_ATTRIBUTE_HIDDEN | Filen är dold. Den ingår inte i en vanlig kataloglista. |
| System | FILE_ATTRIBUTE_SYSTEM | En fil som operativsystemet använder en del av eller endast använder. |
| Ingen | FILE_ATTRIBUTE_NORMAL | En fil som inte har andra attribut angivna. Det här attributet är endast giltigt när det används ensamt. |
| Arkiv | FILE_ATTRIBUTE_ARCHIVE | En fil som är en arkivfil. Program använder vanligtvis det här attributet för att markera filer för säkerhetskopiering eller borttagning. |
| Temporär | FILE_ATTRIBUTE_TEMPORARY | En fil som används för tillfällig lagring. |
| Offline | FILE_ATTRIBUTE_OFFLINE | Data för en fil ä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 | Filen 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
Semantiken för uppdatering av en fils egenskaper är följande:
En fils storlek ändras endast om begäran anger ett värde för
x-ms-content-length-huvudet.Om en begäran endast anger
x-ms-content-lengthoch inga andra egenskaper ändras inga andra egenskaper för filen.Om någon eller flera av följande egenskaper anges i begäran, anges alla dessa egenskaper tillsammans. Om ett värde inte anges för en angiven egenskap när minst en av följande egenskaper har angetts rensas den egenskapen för filen.
x-ms-cache-controlx-ms-content-typex-ms-content-md5x-ms-content-encodingx-ms-content-language
Not
De föregående filegenskaperna är separata från de filsystemegenskaper som är tillgängliga för SMB-klienter. SMB-klienter kan inte läsa, skriva eller ändra dessa egenskapsvärden.
Set File 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).
Om filen har ett aktivt lån måste klienten ange ett giltigt låne-ID för begäran om att skriva egenskaper till filen. Om klienten inte anger något låne-ID eller anger ett ogiltigt låne-ID returnerar filtjänsten statuskod 412 (villkoret misslyckades). Om klienten anger ett låne-ID men filen inte har något aktivt lån returnerar filtjänsten även statuskoden 412 (förhandsvillkoret misslyckades).