Bestand ophalen
De Get File bewerking leest of downloadt een bestand van het systeem, inclusief de metagegevens en eigenschappen.
Protocol beschikbaarheid
| Bestandsshareprotocol ingeschakeld | Beschikbaar |
|---|---|
| SMB |
|
| NFS |
|
Aanvraag
De Get File aanvraag kan als volgt worden samengesteld. U wordt aangeraden HTTPS te gebruiken.
| Methode | Aanvraag-URI | HTTP-versie |
|---|---|---|
GET |
https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile |
HTTP/1.1 |
Vervang de padonderdelen die worden weergegeven in de aanvraag-URI door uw eigen, als volgt:
| Padonderdeel | Description |
|---|---|
myaccount |
De naam van uw opslagaccount. |
myshare |
De naam van uw bestandsshare. |
mydirectorypath |
Optioneel. Het pad naar de map. |
myfile |
De naam van het bestand. |
Zie Naam en verwijzingsshares, mappen, bestanden en metagegevens voor meer informatie over padnaambeperkingen.
URI-parameters
De volgende aanvullende parameters kunnen worden opgegeven voor de aanvraag-URI:
| Parameter | Beschrijving |
|---|---|
timeout |
Optioneel. De timeout parameter wordt uitgedrukt in seconden. Zie Time-outs instellen voor Azure Files-bewerkingen voor meer informatie. |
Aanvraagheaders
De vereiste en optionele aanvraagheaders worden beschreven in de volgende tabel:
| Aanvraagheader | Beschrijving |
|---|---|
Authorization |
Vereist. Hiermee geeft u het autorisatieschema, de accountnaam en de handtekening op. Zie Aanvragen autoriseren voor Azure Storage voor meer informatie. |
Date of x-ms-date |
Vereist. Geef de Coordinated Universal Time (UTC) op voor de aanvraag. Zie Aanvragen autoriseren voor Azure Storage voor meer informatie. |
x-ms-version |
Vereist voor alle geautoriseerde aanvragen. Hiermee geeft u de versie van de bewerking te gebruiken voor deze aanvraag. Zie Versiebeheer voor de Azure Storage-services voor meer informatie. |
Range |
Optioneel. Retourneert alleen bestandsgegevens uit het opgegeven bytebereik. |
x-ms-range |
Optioneel. Retourneert alleen bestandsgegevens uit het opgegeven bytebereik. Als beide Range en 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 De bereikheader opgeven voor Azure Files bewerkingen voor meer informatie. |
x-ms-range-get-content-md5: true |
Optioneel. 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, mits het bereik kleiner is dan of gelijk is aan 4 mebibytes (MiB).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> |
Optioneel. 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. Anders mislukt de bewerking met statuscode 412 (Voorwaarde mislukt). |
x-ms-client-request-id |
Optioneel. Biedt een door de client gegenereerde, ondoorzichtige waarde met een limiet 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 Azure Files 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 moet worden verleend als deze 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> } |
Optioneel. Versie 2022-11-02 en hoger. De Booleaanse waarde geeft aan of een afsluitende punt die aanwezig is in de aanvraag-URL moet worden ingekort of niet. Zie Naamgeving en verwijzingen naar shares, mappen, bestanden en metagegevens voor meer informatie. |
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 foutcodes voor meer informatie over statuscodes.
Antwoordheaders
Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook extra standaard-HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.
| Antwoordheader | Description |
|---|---|
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 kopteksten voor meer informatie. Elke bewerking die het bestand of de eigenschappen ervan wijzigt, wordt de laatste wijzigingstijd bijgewerkt. |
x-ms-meta-name:value |
Een set naam-waardeparen die als door de gebruiker gedefinieerde metagegevens aan dit bestand zijn gekoppeld. |
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 aanvraagheader in te Range 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 de berichtinhoud. Als de aanvraag is bedoeld om een opgegeven bereik te 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, wordt trueer 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 Content-Disposition veld antwoordheader bevat aanvullende informatie over het verwerken van de nettolading van het antwoord en kan ook worden gebruikt om aanvullende metagegevens toe te voegen. Als deze bijvoorbeeld is ingesteld op attachment, Content-Disposition geeft aan dat de gebruikersagent het antwoord niet mag weergeven, maar in plaats daarvan een venster Opslaan als moet weergeven. |
x-ms-request-id |
Identificeert op unieke wijze de aanvraag die is gedaan en kan worden gebruikt om problemen met de aanvraag op te lossen. Zie Problemen met API-bewerkingen oplossen voor 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 21-02-2015 en hoger. De eindtijd van de laatste poging om bestand te kopiëren waarbij dit bestand het doelbestand was. Deze waarde kan het tijdstip opgeven van een voltooide, afgebroken of mislukte kopieerpoging. Deze koptekst wordt niet weergegeven als er een kopie in behandeling is, als dit bestand nooit het doel is geweest in een kopieerbestandbewerking of als dit bestand is gewijzigd na een voltooide kopieerbewerking waarbij Bestandseigenschappen instellen of Bestand maken is gebruikt. |
x-ms-copy-status-description: <error string> |
Versie 21-02-2015 en hoger. Wordt alleen weergegeven wanneer x-ms-copy-statusmislukt of in behandeling is. Beschrijft de oorzaak van een fatale of niet-fatale kopieerbewerkingsfout. Deze koptekst wordt niet weergegeven als dit bestand nooit het doel is geweest in een bestand kopiëren of als dit bestand is gewijzigd na een voltooide kopieerbewerking waarbij Bestandseigenschappen instellen of Bestand maken is gebruikt. |
x-ms-copy-id: <id> |
Versie 21-02-2015 en hoger. De tekenreeks-id voor de laatste poging om bestand te kopiëren waarbij dit bestand het doelbestand was. Deze header wordt niet weergegeven als het bestand nooit het doel is geweest in een bestand kopiëren of als dit bestand is gewijzigd na een voltooide kopieerbewerking waarbij Bestandseigenschappen instellen of Bestand maken is gebruikt. |
x-ms-copy-progress: <bytes copied/bytes total> |
Versie 21-02-2015 en hoger. Bevat het aantal bytes dat is gekopieerd en het totale aantal bytes in de bron in de laatste poging bestand kopiëren waarbij dit bestand het doelbestand was. Kan van 0 tot het aantal gekopieerde Content-Length bytes weergeven. Deze koptekst wordt niet weergegeven als dit bestand nooit het doel is geweest in een bestand kopiëren of als dit bestand is gewijzigd na een voltooide kopieerbewerking waarbij Bestandseigenschappen instellen of Bestand maken is gebruikt. |
x-ms-copy-source: url |
Versie 21-02-2015 en hoger. Een URL van maximaal 2 kB die het bronbestand aangeeft dat is gebruikt bij de laatste poging bestand kopiëren waarbij dit bestand het doelbestand was. Deze koptekst wordt niet weergegeven als dit bestand nooit het doel is geweest in een bestand kopiëren of als dit bestand is gewijzigd na een voltooide kopieerbewerking waarbij Bestandseigenschappen instellen of Bestand maken is gebruikt. |
x-ms-copy-status: <pending ¦ success ¦ aborted ¦ failed> |
Versie 21-02-2015 en hoger. De status van de kopieerbewerking die wordt geïdentificeerd door x-ms-copy-id, met deze waarden:- pending: Kopiëren wordt uitgevoerd. Controleer x-ms-copy-status-description of onregelmatige, niet-fatale fouten de kopieervoortgang belemmeren, maar geen fouten veroorzaken.- success: het kopiëren is voltooid.- aborted: Het kopiëren is beëindigd door Het kopieerbestand af te breken.- failed: Kopiëren is mislukt. Zie x-ms-copy-status-description voor foutdetails.Deze koptekst wordt niet weergegeven als dit bestand nooit het doel is geweest in een bestand kopiëren of als dit bestand is gewijzigd na een voltooide kopieerbewerking waarin Bestandseigenschappen instellen of Bestand maken is gebruikt. |
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 al dan niet gelijk aan de waarde die wordt geretourneerd in de Content-MD5 koptekst, 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 wordt ingesteld op true als de bestandsgegevens en metagegevens van de toepassing 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-permission-key |
De sleutel van de machtiging van het bestand. |
x-ms-file-attributes |
De kenmerken van het bestandssysteem in het bestand. Zie de lijst met beschikbare kenmerken voor meer informatie. |
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 UTC-datum/tijd-waarde die de eigenschap laatste schrijftijd voor het bestand vertegenwoordigt. |
x-ms-file-change-time |
De UTC-datum/-tijdwaarde 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 op dat de lease een oneindige duur heeft. |
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 de 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. |
Hoofdtekst van de reactie
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
Autorisatie
Alleen de accounteigenaar kan deze bewerking aanroepen.
Opmerkingen
Aanroepen Get File via een bereik dat nog geen inhoud heeft of dat is gewist, retourneert 0 voor die bytes.
Als u aanroept Get File 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 zonder inhoud retourneert 0 de service voor die bytes.
Een Get File bewerking mag twee minuten per MiB worden voltooid. Bewerkingen die gemiddeld langer dan twee minuten per MiB duren, krijgen een time-out.