Bestand ophalen

De Get File bewerking leest of downloadt een bestand van het systeem, inclusief de metagegevens en eigenschappen. 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
NFS

Verzoek

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

Methode	Aanvraag-URI	HTTP-versie
TOEVOEGEN	https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile	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 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
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
Authorization	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.
Range	Facultatief. Retourneert alleen bestandsgegevens uit het opgegeven bytebereik.
x-ms-range	Facultatief. Retourneert alleen bestandsgegevens uit het opgegeven bytebereik. Als zowel Range als x-ms-range zijn opgegeven, gebruikt de service de waarde van x-ms-range. Als geen van beide is opgegeven, wordt de volledige bestandsinhoud geretourneerd. Zie Geef de bereikheader op voor Azure Files-bewerkingen voor meer informatie.
x-ms-range-get-content-md5: true	Facultatief. Wanneer deze header is ingesteld op true en deze samen met de Range header wordt opgegeven, retourneert de service de MD5-hash voor het bereik, zolang het bereik kleiner is dan of gelijk is aan 4 mebibytes (MiB) in grootte. Als deze header is opgegeven zonder de Range header, retourneert de service statuscode 400 (Ongeldige aanvraag). Als deze header is ingesteld op true wanneer het bereik groter is dan 4 MiB, retourneert de service statuscode 400 (Ongeldige aanvraag).
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 in de aanvraag is opgegeven, overeenkomt met de lease-id van het bestand. Anders 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 logboeken wanneer logboekregistratie is geconfigureerd. We raden u ten zeerste aan deze header te gebruiken om activiteiten aan de clientzijde te correleren met aanvragen die de server ontvangt. Zie Monitor Azure Filesvoor 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, een set antwoordheaders en de hoofdtekst van het antwoord, die de inhoud van het bestand bevat.

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.
Content-Length	Het aantal bytes dat aanwezig is in de hoofdtekst van het antwoord.
Content-Type	Het inhoudstype dat is opgegeven voor het bestand. Het standaardinhoudstype is application/octet-stream.
Content-Range	Het bereik van bytes dat wordt geretourneerd als de client een subset van het bestand heeft aangevraagd door de Range aanvraagheader in te stellen.
ETag	Bevat een waarde die u kunt gebruiken om bewerkingen voorwaardelijk uit te voeren. De waarde staat tussen aanhalingstekens.
Content-MD5	Als het bestand een MD5-hash heeft en de aanvraag is om het volledige bestand te lezen, wordt deze antwoordheader geretourneerd, zodat de client kan controleren op integriteit van berichtinhoud. Als de aanvraag een opgegeven bereik moet lezen en de x-ms-range-get-content-md5 is ingesteld op true, retourneert de aanvraag een MD5-hash voor het bereik, zolang de bereikgrootte kleiner is dan of gelijk is aan 4 MiB. Als geen van deze sets voorwaarden is true, wordt er geen waarde geretourneerd voor de Content-MD5 header. Als x-ms-range-get-content-md5 is opgegeven zonder de bereikheader, retourneert de service statuscode 400 (Ongeldige aanvraag). Als x-ms-range-get-content-md5 is ingesteld op true wanneer het bereik groter is dan 4 MiB, retourneert de service statuscode 400 (Ongeldige aanvraag).
Content-Encoding	Retourneert de waarde die is opgegeven voor de Content-Encoding aanvraagheader.
Content-Language	Retourneert de waarde die is opgegeven voor de Content-Language aanvraagheader.
Cache-Control	Wordt geretourneerd als deze eerder is opgegeven voor het bestand.
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 geeft aanvullende informatie over het verwerken van de nettolading van het antwoord en kan ook worden gebruikt 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	De serviceversie die is gebruikt om de aanvraag uit te voeren.
Accept-Ranges: bytes	Geeft aan dat de service aanvragen voor gedeeltelijke bestandsinhoud ondersteunt.
Date	Date
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 kopieerbewerking bestand bewerking of als dit bestand is gewijzigd na een geconcludeerde bewerking Bestand kopiëren die 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. Beschrijft de oorzaak van een fatale of niet-fatale kopieerbewerking. Deze koptekst 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 gesloten bewerking Bestand kopiëren bewerking die 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 koptekst wordt niet weergegeven als het bestand nooit het doel is geweest in een bewerking Bestand kopiëren, of als dit bestand is gewijzigd na een voltooide bewerking Bestand kopiëren bewerking die 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 worden weergegeven van 0 tot het aantal gekopieerde Content-Length bytes. Deze koptekst 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 gesloten bewerking Bestand kopiëren bewerking die Bestandseigenschappen instellen of Bestand maken.
x-ms-copy-source: url	Versie 2015-02-21 en hoger. Een URL van maximaal 2 kB die het bronbestand aangeeft dat is gebruikt in de laatste poging bestand kopiëren bewerking waarbij dit bestand het doelbestand was. Deze koptekst wordt niet weergegeven als dit bestand nooit het doel is geweest in een bewerking Bestand kopiëren of als dit bestand is gewijzigd na een voltooide bewerking Bestand kopiëren bewerking die Bestandseigenschappen instellen of Bestand makenheeft gebruikt.
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: - pending: 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. - success: Kopiëren is voltooid. - aborted: Het kopiëren is beëindigd door Het kopieerbestandafgebroken. - failed: Kopiëren is mislukt. Zie x-ms-copy-status-description voor foutdetails. Deze header wordt niet weergegeven als dit bestand nooit het doel is geweest in een kopieerbewerking bestand, of als dit bestand is gewijzigd na een voltooide bestand kopiëren bewerking die Bestandseigenschappen instellen of Bestand maken.
x-ms-content-md5	Vanaf versie 2016-05-31, als het bestand een MD5-hash heeft en als de aanvraag een bereikheader (range of x-ms-range) bevat, wordt deze antwoordheader geretourneerd met de waarde van de MD5-waarde van het hele bestand. Deze waarde is mogelijk of niet gelijk aan de waarde die wordt geretourneerd in de Content-MD5 header, die wordt berekend op basis van het aangevraagde bereik.
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. Als het bestand niet is versleuteld of als alleen delen van de metagegevens van het bestand/de toepassing zijn versleuteld, wordt de waarde ingesteld op false.
x-ms-file-creation-time	De utc-datum/tijd-waarde die de eigenschap aanmaaktijd voor het bestand vertegenwoordigt.
x-ms-file-last-write-time	De datum/tijd-waarde van UTC die de eigenschap voor de laatste schrijftijd voor het bestand vertegenwoordigt.
x-ms-file-change-time	De UTC-datum/tijd die de waarde vertegenwoordigt die de eigenschap wijzigingstijd voor het bestand vertegenwoordigt.
x-ms-file-file-id	De bestands-id van het bestand.
x-ms-file-parent-id	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 voor het oplossen van problemen met aanvragen en de bijbehorende antwoorden. 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.

Hoofdtekst van antwoord

De hoofdtekst van het antwoord bevat de inhoud van het bestand.

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.

Opmerkingen

Het aanroepen van Get File via een bereik dat nog geen inhoud heeft of die is gewist, retourneert 0 voor die bytes.

Als u Get File aanroept zonder opgegeven bereik, retourneert de service het bereik van bytes tot de waarde die is opgegeven voor de x-ms-content-length header. Voor bereiken die geen inhoud bevatten, retourneert de service 0 voor die bytes.

Een Get File bewerking mag twee minuten per MiB worden voltooid. Bewerkingen die gemiddeld langer duren dan twee minuten per MiB.

Zie ook

bewerkingen voor bestanden