Dela via

Hämta filegenskaper

  • Artikel

Åtgärden Get File Properties returnerar alla användardefinierade metadata, http-standardegenskaper och systemegenskaper för filen. Den returnerar inte innehållet i filen. Den här åtgärden stöds i version 2025-05-05 och senare för filresurser med NFS-protokollet aktiverat.

Protokolltillgänglighet

Aktiverat filresursprotokoll Tillgänglig
SMB Ja
NFS Ja

Begäran

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

Metod Begärande-URI HTTP-version
HEAD https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile HTTP/1.1
HEAD https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?sharesnapshot=<DateTime> 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

Följande ytterligare parametrar kan anges på begärande-URI:n:

Parameter Beskrivning
sharesnapshot Valfri. Version 2017-04-17 och senare. Parametern sharesnapshot är ett ogenomskinliga DateTime-värde som när det finns anger resursögonblicksbilden för att fråga efter filegenskaperna.
timeout Valfri. Parametern timeout uttrycks i sekunder. Mer information finns i Ange tidsgränser för Azure Files-åtgärder.

Begärandehuvuden

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

Vanliga begärandehuvuden

Begärandehuvud Beskrivning
Tillstånd 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-lease-id:<ID> Valfri. Version 2019-02-02 och senare. Om rubriken anges utförs åtgärden endast om filens lån för närvarande är aktivt och låne-ID:t som anges i begäran matchar låne-ID:t för filen. Om den inte matchar misslyckas åtgärden med statuskoden 412 (förhandsvillkoret misslyckades).

Det här huvudet ignoreras om filen finns på en filresurs med NFS-protokollet aktiverat, vilket inte stöder fillån.
x-ms-client-request-id Valfri. Tillhandahåller ett klientgenererat, täckande värde med en kibibytesteckengräns (KiB), som registreras i analysloggarna när Azure Storage Analytics-loggning är aktiverad. Vi rekommenderar starkt att du använder det här huvudet när du korrelerar aktiviteter på klientsidan med begäranden som tas emot av servern. Mer information finns i Övervaka Azure Blob Storage-.
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

Ingen.

Endast NFS-begärandehuvuden

Ingen.

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
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 filen eller dess egenskaper uppdaterar den senaste ändrade tiden.
x-ms-meta-name:value En uppsättning namn/värde-par som är associerade med den här filen som användardefinierade metadata.
x-ms-type: <File> Returnerar typen File. Reserverad för framtida användning.
Content-Length Storleken på filen i byte. Det här huvudet returnerar värdet för x-ms-content-length-huvudet som lagras med filen.
Content-Type Den innehållstyp som har angetts för filen. Om ingen innehållstyp har angetts är standardinnehållstypen application/octet-stream.
ETag ETag innehåller ett värde som du kan använda för att utföra åtgärder villkorligt. Värdet omges av citattecken.
Content-MD5 Om Content-MD5-huvudet har angetts för filen returneras Content-MD5-svarshuvudet så att klienten kan söka efter meddelandets innehållsintegritet.
Content-Encoding Om Content-Encoding begärandehuvudet tidigare har angetts för filen returneras värdet Content-Encoding i det här huvudet.
Content-Language Om Content-Language begärandehuvudet tidigare har angetts för filen returneras värdet Content-Language i det här huvudet.
Cache-Control Om Cache-Control begärandehuvudet tidigare har angetts för filen returneras värdet Cache-Control i det här huvudet.
Content-Disposition Returnerar det värde som angavs för x-ms-content-disposition-huvudet och anger hur svaret ska bearbetas.

Fältet Content-Disposition-svarshuvud förmedlar ytterligare information om hur du bearbetar svarsnyttolasten och du kan använda den för att bifoga ytterligare metadata. Om det till exempel är inställt på attachmentanger Content-Disposition att användaragenten inte ska visa svaret, utan att det ska visa ett Spara som-fönster i stället.
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 den tjänstversion som användes för att köra begäran.
Date Ett UTC-datum/tid-värde som genereras av tjänsten, vilket anger den tid då svaret initierades.
x-ms-copy-completion-time:<datetime> Version 2015-02-21 och senare. Avslutningstiden för det senaste försöket kopieringsfil åtgärd där den här filen var målfilen. Det här värdet kan ange tidpunkten för ett slutfört, avbrutet eller misslyckat kopieringsförsök. Det här huvudet visas inte om en kopia väntar, om den här filen aldrig har varit målet i en kopieringsfil åtgärd, eller om filen har ändrats efter en avslutad åtgärden Kopiera fil med hjälp av Ange filegenskaper eller Skapa fil.
x-ms-copy-status-description: <error string> Version 2015-02-21 och senare. Visas bara när x-ms-copy-statusmisslyckades eller väntar på. Den beskriver orsaken till ett allvarligt eller icke-dödligt kopieringsfel. Det här huvudet visas inte om en kopia väntar, om den här filen aldrig har varit målet i en kopieringsfil åtgärd, eller om filen har ändrats efter en avslutad åtgärden Kopiera fil med hjälp av Ange filegenskaper eller Skapa fil.
x-ms-copy-id: <id> Version 2015-02-21 och senare. Strängidentifieraren för det senaste försöket kopiera fil åtgärd där den här filen var målfilen. Det här huvudet visas inte om den här filen aldrig har varit målet i en kopieringsfil åtgärd, eller om filen har ändrats efter en avslutad åtgärden Kopiera fil med hjälp av Ange filegenskaper eller Skapa fil.
x-ms-copy-progress: <bytes copied/bytes total> Version 2015-02-21 och senare. Innehåller antalet kopierade byte och det totala antalet byte i källan under det senaste försöket kopieringsfil åtgärd där filen var målfilen. Kan visa mellan 0 och antalet Content-Length byte som kopieras. Det här huvudet visas inte om den här filen aldrig har varit målet i en kopieringsfil åtgärd, eller om filen har ändrats efter en avslutad åtgärden Kopiera fil med hjälp av Ange filegenskaper eller Skapa fil.
x-ms-copy-source: url Version 2015-02-21 och senare. En URL på upp till 2 KB-tecken som anger källfilen som användes i det senaste försöket Kopiera fil åtgärd där den här filen var målfilen. Det här huvudet visas inte om den här filen aldrig har varit målet i en kopieringsfil åtgärd, eller om filen har ändrats efter en avslutad åtgärden Kopiera fil med hjälp av Ange filegenskaper eller Skapa fil.
x-ms-copy-status: <pending ¦ success ¦ aborted ¦ failed> Version 2015-02-21 och senare. Tillståndet för kopieringsåtgärden som identifieras av x-ms-copy-idmed följande värden:

- lyckades: Kopiering har slutförts.
- väntar: Kopiering pågår. Kontrollera x-ms-copy-status-description om tillfälliga, icke-dödliga fel hindrar kopieringsförloppet men inte orsakar fel.
- avbröts: Kopiering avslutades av Avbryt kopieringsfil.
- misslyckades: Kopiering misslyckades. Mer information om fel finns i x-ms-copy-status-description.

Det här huvudet visas inte om den här filen aldrig har varit målet i en kopieringsfil åtgärd, eller om filen har ändrats efter en avslutad åtgärden Kopiera fil med hjälp av Ange filegenskaper eller Skapa fil.
x-ms-server-encrypted: true/false Version 2017-04-17 och senare. Värdet för det här huvudet är inställt på true om fildata och programmetadata är helt krypterade med hjälp av den angivna algoritmen. Värdet är inställt på false om filen är okrypterad eller om endast delar av filen eller programmetadata krypteras.
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 en fil.
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-file-file-id Version 2019-02-02 och senare. Fil-ID:t för filen.
x-ms-file-parent-id Version 2019-02-02 och senare. Filens överordnade fil-ID.
x-ms-lease-duration:infinite Version 2019-02-02 och senare. När en fil leasas anger att lånet är av oändlig varaktighet.
x-ms-lease-state:<available;leased;broken> Version 2019-02-02 och senare. När en fil hyrs anger du lånetillståndet för filen.
x-ms-lease-status:<locked;unlocked> Version 2019-02-02 och senare. När en fil hyrs anger du filens lånestatus.
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 x-ms-client-request-id-huvudet inte finns i begäran finns det inte i svaret.

Endast SMB-svarshuvuden

Svarsrubrik Beskrivning
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. Filsystemattributen för filen. Mer information finns i lista över tillgängliga attribut.

Endast NFS-svarshuvuden

Svarsrubrik Beskrivning
x-ms-mode Version 2025-05-05 och senare. Filens läge. Se POSIX-filbehörigheter (läge).
x-ms-owner Version 2025-05-05 och senare. Filägarens användaridentifierare (UID).
x-ms-group Version 2025-05-05 och senare. Filägarens gruppidentifierare (GID).
x-ms-link-count Version 2025-05-05 och senare. Länkantalet för filen.
x-ms-file-file-type Version 2025-05-05 och senare. Filtypen, de möjliga värdena är: Regular, Symlink.

Svarstext

Ingen.

Exempelsvar

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
x-ms-type: File  
x-ms-meta-m1: v1  
x-ms-meta-m2: v2  
Content-Length: 11  
Content-Type: text/plain; charset=UTF-8  
Date: <date>  
ETag: "0x8CB171DBEAD6A6B"  
Last-Modified: <date>  
x-ms-version: 2019-02-02  
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0  
x-ms-copy-id: 36650d67-05c9-4a24-9a7d-a2213e53caf6  
x-ms-copy-source: <url>  
x-ms-copy-status: success  
x-ms-copy-progress: 11/11  
x-ms-copy-completion-time: <date>  
x-ms-lease-duration: infinite   
x-ms-lease-state: leased 
x-ms-lease-status: locked

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.

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.

Se även

åtgärder på