Delen via

Bestandseigenschappen ophalen

  • Artikel

De Get File Properties-bewerking retourneert alle door de gebruiker gedefinieerde metagegevens, standaard-HTTP-eigenschappen en systeemeigenschappen voor het bestand. De inhoud van het bestand wordt niet geretourneerd. Deze bewerking wordt ondersteund in versie 2025-05-05 en hoger voor bestandsshares waarvoor het NFS-protocol is ingeschakeld.

Beschikbaarheid van protocol

Protocol voor bestandsshare ingeschakeld Beschikbaar
SMB Ja-
NFS Ja-

Verzoek

De Get File Properties aanvraag wordt als volgt samengesteld. U wordt aangeraden HTTPS te gebruiken.

Methode Aanvraag-URI HTTP-versie
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

Vervang als volgt de padonderdelen die worden weergegeven in de aanvraag-URI door uw eigen onderdelen:

Padonderdeel Beschrijving
myaccount De naam van uw opslagaccount.
myshare De naam van uw bestandsshare.
mydirectorypath Facultatief. Het pad naar de bovenliggende map.
myfile De naam van het bestand.

Zie Naam- en referentieshares, mappen, bestanden en metagegevensvoor meer informatie over naamgevingsbeperkingen voor paden.

URI-parameters

De volgende aanvullende parameters kunnen worden opgegeven op de aanvraag-URI:

Parameter Beschrijving
sharesnapshot Facultatief. Versie 2017-04-17 en hoger. De parameter sharesnapshot is een ondoorzichtige Datum/tijd-waarde die, indien aanwezig, de momentopname van de share specificeert om een query uit te voeren op de bestandseigenschappen.
timeout Facultatief. De parameter timeout wordt uitgedrukt in seconden. Zie Time-outs instellen voor Azure Files-bewerkingenvoor meer informatie.

Aanvraagheaders

De vereiste en optionele aanvraagheaders worden beschreven in de volgende tabellen:

Algemene aanvraagheaders

Aanvraagheader Beschrijving
Machtiging Vereist. Hiermee geeft u het autorisatieschema, de accountnaam en de handtekening op. Zie Aanvragen autoriseren voor Azure Storagevoor meer informatie.
Date of x-ms-date Vereist. Hiermee geeft u de Coordinated Universal Time (UTC) voor de aanvraag. Zie Aanvragen autoriseren voor Azure Storagevoor meer informatie.
x-ms-version Vereist voor alle geautoriseerde aanvragen. Hiermee geeft u de versie van de bewerking die moet worden gebruikt voor deze aanvraag. Deze bewerking wordt ondersteund in versie 2025-05-05 en hoger voor bestandsshares waarvoor het NFS-protocol is ingeschakeld.

Zie Versiebeheer voor de Azure Storage-servicesvoor meer informatie.
x-ms-lease-id:<ID> Facultatief. Versie 2019-02-02 en hoger. Als de header is opgegeven, wordt de bewerking alleen uitgevoerd als de lease van het bestand momenteel actief is en de lease-id die is opgegeven in de aanvraag overeenkomt met de lease-id van het bestand. Als deze niet overeenkomt, mislukt de bewerking met statuscode 412 (voorwaarde mislukt).

Deze header wordt genegeerd als het bestand zich op een bestandsshare bevindt waarvoor het NFS-protocol is ingeschakeld, wat geen ondersteuning biedt voor bestandsleases.
x-ms-client-request-id Facultatief. Biedt een door de client gegenereerde, ondoorzichtige waarde met een tekenlimiet van 1 kibibyte (KiB), die wordt vastgelegd in de analyselogboeken wanneer Logboekregistratie van Azure Storage Analytics is ingeschakeld. We raden u ten zeerste aan deze header te gebruiken wanneer u activiteiten aan de clientzijde correleert met aanvragen die door de server worden ontvangen. Zie Azure Blob Storage-bewaken voor meer informatie.
x-ms-file-request-intent Vereist als Authorization header een OAuth-token opgeeft. Acceptabele waarde is backup. Deze header geeft aan dat de Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action of Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action moeten worden verleend als ze zijn opgenomen in het RBAC-beleid dat is toegewezen aan de identiteit die is geautoriseerd met behulp van de Authorization-header. Beschikbaar voor versie 2022-11-02 en hoger.
x-ms-allow-trailing-dot: { <Boolean> } Facultatief. Versie 2022-11-02 en hoger. De Booleaanse waarde geeft aan of een volgpunt aanwezig in de aanvraag-URL moet worden ingekort of niet.

Deze header wordt genegeerd als het doel zich op een bestandsshare bevindt waarvoor het NFS-protocol is ingeschakeld. Dit biedt standaard ondersteuning voor een volgpunt.

Zie Shares, mappen, bestanden en metagegevensvoor meer informatie.

Alleen aanvraagheaders voor SMB

Geen.

Alleen aanvraagheaders voor NFS

Geen.

Aanvraagbody

Geen.

Antwoord

Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.

Statuscode

Een geslaagde bewerking retourneert statuscode 200 (OK). Zie Status en foutcodesvoor meer informatie over statuscodes.

Antwoordheaders

Het antwoord voor deze bewerking bevat de headers in de volgende tabellen. Het antwoord kan ook aanvullende standaard HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.

Algemene antwoordheaders

Antwoordheader Beschrijving
Last-Modified Retourneert de datum en tijd waarop het bestand voor het laatst is gewijzigd. De datumnotatie volgt RFC 1123. Zie Datum-/tijdwaarden weergeven in koptekstenvoor meer informatie. Elke bewerking die het bestand of de eigenschappen ervan wijzigt, werkt de laatste wijzigingstijd bij.
x-ms-meta-name:value Een set naam-waardeparen die aan dit bestand zijn gekoppeld als door de gebruiker gedefinieerde metagegevens.
x-ms-type: <File> Retourneert het type File. Gereserveerd voor toekomstig gebruik.
Content-Length De grootte van het bestand in bytes. Deze header retourneert de waarde van de x-ms-content-length header die is opgeslagen met het bestand.
Content-Type Het inhoudstype dat is opgegeven voor het bestand. Als er geen inhoudstype is opgegeven, wordt het standaardinhoudstype application/octet-stream.
ETag De ETag bevat een waarde die u kunt gebruiken om bewerkingen voorwaardelijk uit te voeren. De waarde staat tussen aanhalingstekens.
Content-MD5 Als de Content-MD5 header is ingesteld voor het bestand, wordt de Content-MD5 antwoordheader geretourneerd, zodat de client kan controleren op integriteit van berichtinhoud.
Content-Encoding Als de Content-Encoding aanvraagheader eerder is ingesteld voor het bestand, wordt de Content-Encoding waarde geretourneerd in deze header.
Content-Language Als de Content-Language aanvraagheader eerder is ingesteld voor het bestand, wordt de Content-Language waarde geretourneerd in deze header.
Cache-Control Als de Cache-Control aanvraagheader eerder is ingesteld voor het bestand, wordt de Cache-Control waarde geretourneerd in deze header.
Content-Disposition Retourneert de waarde die is opgegeven voor de x-ms-content-disposition header en geeft aan hoe het antwoord moet worden verwerkt.

Het veld Content-Disposition antwoordheader bevat aanvullende informatie over het verwerken van de nettolading van het antwoord en u kunt dit gebruiken om extra metagegevens toe te voegen. Als deze bijvoorbeeld is ingesteld op attachment, geeft Content-Disposition aan dat de gebruikersagent het antwoord niet mag weergeven, maar in plaats daarvan een venster Opslaan als moet weergeven.
x-ms-request-id Identificeer de aanvraag die is gemaakt en kan worden gebruikt om problemen met de aanvraag op te lossen. Zie Problemen met API-bewerkingen oplossenvoor meer informatie.
x-ms-version Geeft de serviceversie aan die is gebruikt om de aanvraag uit te voeren.
Date Een UTC-datum/tijdwaarde die wordt gegenereerd door de service, wat de tijd aangeeft waarop het antwoord is gestart.
x-ms-copy-completion-time:<datetime> Versie 2015-02-21 en hoger. De eindtijd van de laatste poging Bestand kopiëren bewerking waarbij dit bestand het doelbestand was. Deze waarde kan de tijd opgeven van een voltooide, afgebroken of mislukte kopieerpoging. Deze koptekst wordt niet weergegeven als er een kopie in behandeling is, als dit bestand nog nooit de bestemming is geweest in een kopieerbestand bewerking of als dit bestand is gewijzigd na een geconcludeerde bewerking Bestand kopiëren met behulp van Bestandseigenschappen instellen of Bestand maken.
x-ms-copy-status-description: <error string> Versie 2015-02-21 en hoger. Wordt alleen weergegeven wanneer x-ms-copy-status is mislukt of in behandeling. Hierin wordt de oorzaak van een fatale of niet-fatale kopieerbewerking beschreven. Deze koptekst wordt niet weergegeven als er een kopie in behandeling is, als dit bestand nog nooit de bestemming is geweest in een kopieerbestand bewerking of als dit bestand is gewijzigd na een geconcludeerde bewerking Bestand kopiëren met behulp van Bestandseigenschappen instellen of Bestand maken.
x-ms-copy-id: <id> Versie 2015-02-21 en hoger. De tekenreeks-id voor de laatst geprobeerde kopieerbestand bewerking waarbij dit bestand het doelbestand was. Deze header wordt niet weergegeven als dit bestand nog nooit de bestemming is geweest in een bewerking Bestand kopiëren, of als dit bestand is gewijzigd na een voltooide bewerking Bestand kopiëren met behulp van Bestandseigenschappen instellen of Bestand maken.
x-ms-copy-progress: <bytes copied/bytes total> Versie 2015-02-21 en hoger. Bevat het aantal bytes dat is gekopieerd en het totale aantal bytes in de bron in de laatste poging om het bestand te kopiëren bewerking waarbij dit bestand het doelbestand was. Kan tussen 0 en het aantal gekopieerde Content-Length bytes worden weergegeven. Deze header wordt niet weergegeven als dit bestand nog nooit de bestemming is geweest in een bewerking Bestand kopiëren, of als dit bestand is gewijzigd na een voltooide bewerking Bestand kopiëren met behulp van Bestandseigenschappen instellen of Bestand maken.
x-ms-copy-source: url Versie 2015-02-21 en hoger. Een URL van maximaal 2 kB tekens waarmee het bronbestand wordt opgegeven dat in de laatste poging is gebruikt bestand kopiëren bewerking waarbij dit bestand het doelbestand was. Deze header wordt niet weergegeven als dit bestand nog nooit de bestemming is geweest in een bewerking Bestand kopiëren, of als dit bestand is gewijzigd na een voltooide bewerking Bestand kopiëren met behulp van Bestandseigenschappen instellen of Bestand maken.
x-ms-copy-status: <pending ¦ success ¦ aborted ¦ failed> Versie 2015-02-21 en hoger. De status van de kopieerbewerking die wordt geïdentificeerd door x-ms-copy-id, met de volgende waarden:

- geslaagd: Kopiëren is voltooid.
- in behandeling: Kopiëren wordt uitgevoerd. Controleer x-ms-copy-status-description als onregelmatige, niet-fatale fouten de voortgang van het kopiëren belemmeren, maar geen storing veroorzaken.
- afgebroken: Copy is beëindigd door Copy Fileafgebroken.
- mislukt: kopiëren is mislukt. Zie x-ms-copy-status-description voor foutdetails.

Deze header wordt niet weergegeven als dit bestand nog nooit de bestemming is geweest in een bewerking Bestand kopiëren, of als dit bestand is gewijzigd na een voltooide bewerking Bestand kopiëren met behulp van Bestandseigenschappen instellen of Bestand maken.
x-ms-server-encrypted: true/false Versie 2017-04-17 en hoger. De waarde van deze header is ingesteld op true als de bestandsgegevens en toepassingsmetagegevens volledig zijn versleuteld met behulp van het opgegeven algoritme. De waarde wordt ingesteld op false als het bestand niet is versleuteld of als alleen delen van het bestand of de metagegevens van de toepassing zijn versleuteld.
x-ms-file-creation-time Versie 2019-02-02 en hoger. De utc-datum/tijdwaarde die de eigenschap aanmaaktijd voor een bestand aangeeft.
x-ms-file-last-write-time Versie 2019-02-02 en hoger. De datum/tijd-waarde van UTC die de eigenschap voor de laatste schrijftijd voor het bestand vertegenwoordigt.
x-ms-file-change-time Versie 2019-02-02 en hoger. De utc-datum/tijd-waarde die de eigenschap wijzigingstijd voor het bestand vertegenwoordigt.
x-ms-file-file-id Versie 2019-02-02 en hoger. De bestands-id van het bestand.
x-ms-file-parent-id Versie 2019-02-02 en hoger. De bovenliggende bestands-id van het bestand.
x-ms-lease-duration:infinite Versie 2019-02-02 en hoger. Wanneer een bestand wordt geleased, geeft u aan dat de lease oneindig lang is.
x-ms-lease-state:<available;leased;broken> Versie 2019-02-02 en hoger. Wanneer een bestand wordt geleased, geeft u de leasestatus van het bestand op.
x-ms-lease-status:<locked;unlocked> Versie 2019-02-02 en hoger. Wanneer een bestand wordt geleased, geeft u de leasestatus van het bestand op.
x-ms-client-request-id Kan worden gebruikt om problemen met aanvragen en bijbehorende antwoorden op te lossen. De waarde van deze header is gelijk aan de waarde van de x-ms-client-request-id header als deze aanwezig is in de aanvraag en de waarde niet meer dan 1024 zichtbare ASCII-tekens bevat. Als de x-ms-client-request-id header niet aanwezig is in de aanvraag, is deze niet aanwezig in het antwoord.

Alleen SMB-antwoordheaders

Antwoordheader Beschrijving
x-ms-file-permission-key Versie 2019-02-02 en hoger. De sleutel van de machtiging van het bestand.
x-ms-file-attributes Versie 2019-02-02 en hoger. De bestandssysteemkenmerken van het bestand. Zie de lijst met beschikbare kenmerkenvoor meer informatie.

Alleen antwoordheaders van NFS

Antwoordheader Beschrijving
x-ms-mode Versie 2025-05-05 en hoger. De modus van het bestand. Zie POSIX-bestandsmachtigingen (modus).
x-ms-owner Versie 2025-05-05 en hoger. De gebruikers-id (UID) van de bestandseigenaar.
x-ms-group Versie 2025-05-05 en hoger. De groeps-id (GID) van de bestandseigenaar.
x-ms-link-count Versie 2025-05-05 en hoger. Het aantal koppelingen van het bestand.
x-ms-file-file-type Versie 2025-05-05 en hoger. Het type bestand, de mogelijke waarden zijn: Regular, Symlink.

Hoofdtekst van antwoord

Geen.

Voorbeeldantwoord

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

Machtiging

Alleen de accounteigenaar kan deze bewerking aanroepen.

Bestandssysteemkenmerken

Attribuut Win32-bestandskenmerk Definitie
ReadOnly FILE_ATTRIBUTE_READONLY Een bestand dat alleen-lezen is. Toepassingen kunnen het bestand lezen, maar kunnen er niet naar schrijven of verwijderen.
Verborgen FILE_ATTRIBUTE_HIDDEN Het bestand is verborgen. Het is niet opgenomen in een gewone lijst met mappen.
Systeem FILE_ATTRIBUTE_SYSTEM Een bestand waarvan het besturingssysteem een deel van of uitsluitend gebruikt.
Geen FILE_ATTRIBUTE_NORMAL Een bestand waarvoor geen andere kenmerken zijn ingesteld. Dit kenmerk is alleen geldig wanneer het alleen wordt gebruikt.
Archief FILE_ATTRIBUTE_ARCHIVE Een bestand dat een archiefbestand is. Toepassingen gebruiken dit kenmerk gewoonlijk om bestanden te markeren voor back-up of verwijdering.
Tijdelijk FILE_ATTRIBUTE_TEMPORARY Een bestand dat wordt gebruikt voor tijdelijke opslag.
Offline FILE_ATTRIBUTE_OFFLINE De gegevens van een bestand zijn niet onmiddellijk beschikbaar. Dit bestandssysteemkenmerk wordt voornamelijk gepresenteerd om compatibiliteit met Windows te bieden. Azure Files biedt geen ondersteuning voor offlineopslagopties.
NotContentIndexed FILE_ATTRIBUTE_NOT_CONTENT_INDEXED Het bestand moet niet worden geïndexeerd door de inhoudsindexeringsservice.
NoScrubData FILE_ATTRIBUTE_NO_SCRUB_DATA De gegevensstroom van de gebruiker hoeft niet te worden gelezen door de scanner voor gegevensintegriteit op de achtergrond. Dit bestandssysteemkenmerk wordt voornamelijk gepresenteerd om compatibiliteit met Windows te bieden.

POSIX-bestandsmachtigingen (modus)

POSIX-bestandsmachtigingen kunnen numeriek worden opgegeven in een 12-bits numerieke octale indeling of in een symbolische 'rwx'-indeling. Voorbeelden:

  • "0644" of "rw-r--r--": gebruiker (bestandseigenaar) heeft lees-, schrijfmachtigingen. De groep heeft leesmachtigingen. Anderen hebben leesmachtigingen.
  • "0755" of "rwxr-xr-x": gebruiker (bestandseigenaar) heeft lees-, schrijf- en uitvoermachtigingen. Groep heeft lees- en uitvoermachtigingen. Anderen hebben lees- en uitvoermachtigingen.

Numerieke octale notatie

De drie laagste octale getallen vertegenwoordigen de machtigingen voor eigenaar/gebruiker, groep en andere en worden aangegeven met behulp van een octaal getal (0-7), gevormd met behulp van een bitsgewijze combinatie van '4' (Lezen), '2' (Schrijven), '1' (Uitvoeren). Het hoogste octale getal (0-7) wordt gebruikt om een combinatie van '4' (SetUID), '2' (SetGID), '1' (StickyBit)-machtigingen aan te geven.

Formatteren Toestemming
0700 Gebruiker (bestandseigenaar) heeft lees-, schrijf- en uitvoermachtigingen.
0400 Gebruiker heeft leesmachtigingen.
0200 Gebruiker heeft schrijfmachtigingen.
0100 De gebruiker heeft een machtiging voor uitvoeren.
0070 Groep heeft lees-, schrijf- en uitvoermachtigingen.
0040 De groep heeft leesmachtigingen.
0020 De groep heeft schrijfmachtigingen.
0010 De groep heeft een machtiging voor uitvoeren.
0007 Anderen hebben lees-, schrijf- en uitvoermachtigingen.
0004 Anderen hebben leesmachtigingen.
0002 Anderen hebben schrijfmachtigingen.
0001 Anderen hebben een machtiging voor uitvoeren.
4000 Stel de effectieve gebruikers-id in het bestand in.
2000 Stel de effectieve groeps-id in voor het bestand.
1000 Ingesteld om aan te geven dat het bestand alleen kan worden verwijderd of hernoemd door bestandseigenaar, mapeigenaar of hoofdgebruiker.

Symbolische indeling 'rwx'

Machtigingen voor eigenaar/gebruiker, groep en andere worden aangegeven met behulp van een combinatie van 'r' (lezen), 'w' (schrijven) en 'x' (Uitvoeren).

Formatteren Toestemming
rwx------ Gebruiker (bestandseigenaar) heeft lees-, schrijf- en uitvoermachtigingen.
r-------- Gebruiker heeft leesmachtigingen.
-w------- Gebruiker heeft schrijfmachtigingen.
--x------ De gebruiker heeft een machtiging voor uitvoeren.
---wx--- Groep heeft lees-, schrijf- en uitvoermachtigingen.
---r----- De groep heeft leesmachtigingen.
----w---- De groep heeft schrijfmachtigingen.
-----x--- De groep heeft een machtiging voor uitvoeren.
------wx Anderen hebben lees-, schrijf- en uitvoermachtigingen.
------r- Anderen hebben leesmachtigingen.
-------w- Anderen hebben schrijfmachtigingen.
--------x Anderen hebben een machtiging voor uitvoeren.

Zie ook

bewerkingen voor bestanden