Hämta filegenskaper

  • Artikel

Åtgärden Get File Properties returnerar alla användardefinierade metadata, http-standardegenskaper och systemegenskaper för filen. Det returnerar inte innehållet i filen.

Protokolltillgänglighet

Aktiverat filresursprotokoll Tillgängligt
SMB Ja
NFS No

Förfrågan

Begäran Get File Properties kan konstrueras på följande sätt. Vi rekommenderar att du använder HTTPS.

Metod URI för förfrågan 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 Description
myaccount Namnet på ditt lagringskonto.
myshare Namnet på filresursen.
mydirectorypath Valfritt. Sökvägen till den överordnade katalogen.
myfile Namnet på filen.

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

URI-parametrar

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

Parameter Beskrivning
sharesnapshot Valfritt. Version 2017-04-17 och senare. Parametern sharesnapshot är ett täckande DateTime-värde som när det finns anger resursögonblicksbilden för att fråga efter filegenskaperna.
timeout Valfritt. 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 tabell:

Begärandehuvud Beskrivning
Auktorisering 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-lease-id:<ID> Valfritt. 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 filens låne-ID. Om den inte matchar misslyckas åtgärden med statuskoden 412 (förhandsvillkoret misslyckades).
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 analysloggarna när Azure Lagringsanalys 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 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 RBAC-principen som tilldelats den identitet som har behörighet med huvudet Authorization . 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 statuskoden 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
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 ändringstiden.
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 Filens storlek i bitar. Det här huvudet returnerar värdet för x-ms-content-length rubriken som lagras med filen.
Content-Type Den innehållstyp som har angetts för filen. Om ingen innehållstyp anges är application/octet-streamstandardinnehållstypen .
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 Content-MD5 Om rubriken har angetts för filen Content-MD5 returneras svarshuvudet så att klienten kan söka efter meddelandets innehållsintegritet.
Content-Encoding Content-Encoding Om begärandehuvudet tidigare har angetts för filen Content-Encoding returneras värdet i det här huvudet.
Content-Language Content-Language Om begärandehuvudet tidigare har angetts för filen Content-Language returneras värdet i det här huvudet.
Cache-Control Cache-Control Om begärandehuvudet tidigare har angetts för filen Cache-Control returneras värdet 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 det att användaragenten inte ska visa svaret, men att det bör 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. Sluttiden för den senaste kopieringsfilen 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 den här filen har ändrats efter en avslutad kopieringsfilåtgärd 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-statusmisslyckas eller väntar. 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 den här filen har ändrats efter en avslutad kopieringsfilåtgärd med hjälp av Ange filegenskaper eller Skapa fil.
x-ms-copy-id: <id> Version 2015-02-21 och senare. Strängidentifieraren för den senaste kopieringsfilåtgärden 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 den här filen har ändrats efter en avslutad kopieringsfilåtgärd 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 i den senaste kopieringsfilåtgärden där den här filen var målfilen. Kan visa mellan 0 och antalet Content-Length kopierade byte. Det här huvudet visas inte om den här filen aldrig har varit målet i en kopieringsfilåtgärd , eller om den här filen har ändrats efter en avslutad kopieringsfilåtgärd 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 den senaste kopieringsfilen 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 den här filen har ändrats efter en avslutad kopieringsfilåtgärd 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-id, med följande värden:

- Framgång: Kopian har slutförts.
- Väntande: Kopieringen pågår. Kontrollera x-ms-copy-status-description om tillfälliga, icke-allvarliga fel hindrar kopieringsförloppet men inte orsakar fel.
- Avbröts: Kopiering avslutades av Avbryt kopieringsfil.
- Misslyckades: Kopiering misslyckades. Se x-ms-copy-status-description för felinformation.

Det här huvudet visas inte om den här filen aldrig har varit målet i en kopieringsfilåtgärd , eller om den här filen har ändrats efter en avslutad kopieringsfilåtgärd 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 anges till true om fildata och programmetadata är helt krypterade med hjälp av den angivna algoritmen. Värdet anges till false om filen är okrypterad eller om endast delar av filen eller programmetadata krypteras.
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. Filens filsystemattribut. Mer information finns i listan ö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 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. Filens fil-ID.
x-ms-file-parent-id Version 2019-02-02 och senare. Det överordnade fil-ID:t för filen.
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 leasas anger du lånestatus 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 x-ms-client-request-id för huvudet om det finns i begäran och värdet inte innehåller fler än 1 024 synliga ASCII-tecken. x-ms-client-request-id Om rubriken inte finns i begäran finns den inte i svaret.

Själva svaret

Inga.

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

Auktorisering

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

Se även

Åtgärder på Azure Files