Fájl letöltése

A Get File művelet felolvassa vagy letölt egy fájlt a rendszerből, beleértve annak metaadatait és tulajdonságait is. Ez a művelet támogatott a 2025-05-05-ös verzióban és későbbi verzióban NFS protokoll engedélyezett fájlmegosztásokhoz.

Protokoll rendelkezésre állása

Engedélyezett fájlmegosztási protokoll	Beszerezhető
SMB
NFS

Kérelem

A Get File kérés a következőképpen van felépítve. Javasoljuk, hogy HTTPS-t használjon.

Metódus	URI-kérés	HTTP-verzió
SZEREZZE MEG	https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile	HTTP/1.1

Cseréld le a kérés URI-ben látható útkomponenseket a sajátoddal, az alábbiak szerint:

Útkomponens	Description
myaccount	A tárfiók neve.
myshare	A fájlmegosztás neve.
mydirectorypath	Opcionális. Az út a könyvtárhoz.
myfile	A fájl neve.

Az útvonalnév korlátozásokról információért lásd: Név- és hivatkozási megosztások, könyvtárak, fájlok és metaadatok.

URI-paraméterek

Az alábbi további paraméterek megadhatók a kérés URI-n:

Paraméter	Description
timeout	Opcionális. A timeout paramétert másodpercben fejezzük ki. További információért lásd: Időtúllépések beállítása Azure Files műveletekhez.

HTTP-kérés fejlécek

A kötelező és opcionális kérés fejléceket az alábbi táblázatok írják le:

Gyakori kérésfejlécek

Kérések fejrész	Description
Authorization	Szükséges. Megadja az engedélyezési sémát, a fióknevet és az aláírást. További információ: Kérelmek engedélyezése az Azure Storage-.
Date vagy x-ms-date	Szükséges. A kérelem koordinált egyetemes idejét (UTC) adja meg. További információ: Kérelmek engedélyezése az Azure Storage-.
x-ms-version	Minden engedélyezett kéréshez szükséges. A kérelemhez használni kívánt művelet verzióját adja meg. Ez a művelet támogatott a 2025-05-05-ös verzióban és későbbi verzióban NFS protokoll engedélyezett fájlmegosztásokhoz. További információ: Verziószámozás az Azure Storage-szolgáltatásokhoz.
Range	Opcionális. Csak a megadott bájttartományból származó fájladatokat ad vissza.
x-ms-range	Opcionális. Csak a megadott bájttartományból származó fájladatokat ad vissza. Ha mindkettő Range és x-ms-range meg van jelölve, a szolgáltatás a értékét x-ms-rangehasználja. Ha egyik sem van megadva, az egész fájltartalom visszakerül. További információért lásd: Az Azure Files műveletekhez tartozó tartomány fejlécének megadása .
x-ms-range-get-content-md5: true	Opcionális. Ha ezt a fejlécet beállítjuk, true és a fejlécével Range együtt meg van jelölve, a szolgáltatás visszaadja az MD5 hash-et a tartományra, amennyiben a tartomány 4 mebibájt (MiB) méretű, legfeljebb annyi. Ha ez a fejléc cím nélkül Range van megadva, a szolgáltatás 400-as állapotkódot (Rossz kérés) ad. Ha ez a fejléc akkor van beállítva, true amikor a tartomány meghaladja a 4 MiB méretét, akkor a szolgáltatás 400 (Rossz kérés) állapotkódot ad vissza.
x-ms-lease-id:<ID>	Opcionális. 2019-02-02 verzió és újabb. Ha a fejléc meg van jelölve, a műveletet csak akkor hajtják végre, ha a fájl lízinge jelenleg aktív, és a kérésben megadott bérleti azonosító megegyezik a fájl bérleti azonosítójával. Ellenkező esetben a művelet meghibásodik a 412-es állapotkóddal (előfeltétel sikertelen). Ezt a fejlécet figyelmen kívül hagyják, ha a fájl egy NFS protokoll bekapcsolt fájlmegosztáson található, ami nem támogatja a fájlbérleteket.
x-ms-client-request-id	Opcionális. Ügyfél által generált, átlátszatlan értéket biztosít 1 kibibájtos (KiB) karakterkorláttal, amely a naplózás konfigurálásakor rögzítésre kerül a naplókban. Javasoljuk, hogy ezt a fejlécet használja az ügyféloldali tevékenységek és a kiszolgáló által fogadott kérések korrelálásához. További információt az Azure Files monitorozása című témakörben talál.
x-ms-file-request-intent	Szükséges, ha Authorization a fejléc OAuth tokent jelöl. Az elfogadható érték .backup Ez a fejléc megadja, hogy az Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action vagy Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action opciót akkor kell megadni, ha azok szerepelnek az RBAC szabályzatban, amely az adott fejlécen által engedélyezett Authorization személyazonossághoz van rendelve. Elérhető 2022-11-02 verzióban és későbbi verzióban.
x-ms-allow-trailing-dot: { <Boolean> }	Opcionális. 2022-11-02 verzió és újabb. A Boolean érték megadja, hogy a kérés URL-ben található utolsó pontot le kell-e vágni vagy sem. Ezt a fejlécet figyelmen kívül hagyják, ha a célpont egy NFS protokoll engedélyezett fájlmegosztáson található, ami alapértelmezetten támogatja a nyomott pontot. További információért lásd: Megosztások, könyvtárak, fájlok és metaadatok elnevezése és hivatkozása.
x-ms-structured-body	Opcionális. 2025-01-05 verzió és újabb. Ha ez megadja, a szolgáltatás visszaadja a fájltartalmat, amelyet strukturált test formátumban kódolnak. Ennek a fejlécnek az értéke tartalmazza az üzenetséma verzióját és tulajdonságait. Jelenleg az egyetlen támogatott érték , XSM/1.0; properties=crc64amely jelzi, hogy a válasz crc64 ellenőrzőösszeg szegmenseket fog használni a kódolt üzenetben. Ha az érték nem egyezik meg, a művelet 400-as hibakóddal (Rossz kérés) meghibásodik.

SMB csak fejléceket kér

Nincs.

Az NFS csak fejléceket kér

Nincs.

A kérés tartalma

Nincs.

Válasz

A válasz tartalmaz egy HTTP státuszkódot, egy válaszfejlécek készletét, valamint a válasz testét, amely tartalmazza a fájl tartalmát.

Állapotkód

Egy sikeres művelet a 200 (OK) állapotkódot adja vissza. Az állapotkódokkal kapcsolatos információkért lásd állapot- és hibakódokat.

Válaszfejlécek

A művelet válasza tartalmazza a fejléceket a következő táblázatokban. A válasz további szabványos HTTP-fejléceket is tartalmazhat. Minden szabványos fejléc megfelel a HTTP/1.1 protokoll specifikációjának.

Gyakori válaszfejlécek

Válaszfejléc	Description
Last-Modified	Visszaadja a dátumot és időt, amikor a fájlt utoljára módosították. A dátumformátum az RFC 1123-at követi. További információért lásd: Dátum/idő értékek reprezentálása fejlécekben. Minden olyan művelet, amely módosítja a fájlt vagy annak tulajdonságait, a legutóbbi módosítás időpontját frissíti.
x-ms-meta-name:value	A fájlhoz felhasználó által definiált metaadatokként társított név-érték párok készlete.
Content-Length	A választestben található bájtok száma.
Content-Type	A fájlhoz megadott tartalomtípus. Az alapértelmezett tartalomtípus a következő application/octet-stream.
Content-Range	A visszaadott bájttartomány, ha az ügyfél a fájl egy részhalmazát kérte a kérés fejlécének beállításával Range
ETag	Tartalmaz egy értéket, amellyel feltételesen végezhetsz műveleteket. Az érték idézőjelben van elfoglalva.
Content-MD5	Ha a fájlnak van MD5 hash, és a teljes fájl olvasását kérik, akkor ez a válaszfejléc kerül vissza, hogy az ügyfél ellenőrizhesse az üzenet tartalmának integritását. Ha a kérés egy meghatározott tartományt olvas, és a x-ms-range-get-content-md5 tartomány be truevan állítva, akkor a kérés MD5 hash-et ad a tartományra, amennyiben a tartomány mérete kisebb, mint 4 MiB. Ha egyik feltétel sem , trueakkor nem tér vissza a Content-MD5 fejléc értéke. Ha x-ms-range-get-content-md5 a tartomány fejléce nélkül van megadva, a szolgáltatás 400-as állapotkódot (Rossz kérés) ad. Ha x-ms-range-get-content-md5true a hatótávolság meghaladja a 4 MiB-t, akkor a szolgáltatás 400-as állapotkódot (Rossz kérés) ad.
Content-Encoding	Visszaadja azt az értéket, amely a Content-Encoding kérés fejlécéhez volt megadva.
Content-Language	Visszaadja azt az értéket, amely a Content-Language kérés fejlécéhez volt megadva.
Cache-Control	Visszakerül, ha korábban megadták a fájlhoz.
Content-Disposition	Visszaadja a fejléchez megadott x-ms-content-disposition értéket, és megadja, hogyan kell feldolgozni a választ. A Content-Disposition válaszfejléc mező további információkat közvetít a válasz hasznos raher feldolgozásáról, és további metaadatok csatolására is használható. Például, ha be van állítva attachment, Content-Disposition az azt jelenti, hogy a felhasználó-ügynöknek nem kell megjelenítenie a választ, hanem egy Mentés ablakot kell megjelenítenie.
x-ms-request-id	Egyedien azonosítja a kérést, és használható a kérés hibaelhárítására. További információ: API-műveletek hibaelhárítása.
x-ms-version	A szolgáltatási verzió, amelyet a kérés végrehajtásához használtak.
Accept-Ranges: bytes	Azt jelzi, hogy a szolgáltatás támogatja a részleges fájltartalomra vonatkozó kéréseket.
Date	Date
x-ms-copy-completion-time:<datetime>	2015-02-21 verzió és újabb. Az utolsó Fájl Másolási művelet befejezési ideje, ahol ez a fájl volt a célfájl. Ez az érték megadhatja a befejezett, megszakított vagy sikertelen másolási kísérlet időpontját. Ez a fejléc nem jelenik meg, ha egy másolat függőben van, ha ez a fájl soha nem volt a célpont egy Másolási Fájl műveletben, vagy ha ezt a fájlt módosították egy befejezett Fájl Másolás művelet után, amely a Fájl Tulajdonságok Beállítását vagy Fájl Létrehozását használta.
x-ms-copy-status-description: <error string>	2015-02-21 verzió és újabb. Csak akkor jelenik meg, ha x-ms-copy-statusnem volt sikeres vagy függőben van. Leírja a halálos vagy nem halálos másolati műveleti hiba okát. Ez a fejléc nem jelenik meg, ha ez a fájl soha nem volt a célpont egy Fájl Másolás műveletben, vagy ha a fájlt módosították egy befejezett Fájl Másolás művelet után, amely a Fájl Tulajdonságok Beállítását vagy Fájl Létrehozását használta.
x-ms-copy-id: <id>	2015-02-21 verzió és újabb. Az utolsó Fájl Másolási művelet stringazonosítója, ahol ez a fájl volt a célfájl. Ez a fejléc nem jelenik meg, ha a fájl soha nem volt a célállomás egy Fájl Másolás műveletben, vagy ha ezt a fájlt módosították egy lezárt Fájl Másolás művelet után, amely a Fájl Tulajdonságok Beállítását vagy Fájl Létrehozását használta.
x-ms-copy-progress: <bytes copied/bytes total>	2015-02-21 verzió és újabb. Tartalmazza a másolt bájtok számát és az összes bájtokat a forrásban az utolsó Fájl Másolási művelet során, ahol ez a fájl volt a célfájl. 0-tól a másolt Content-Length bájtok számától lehet megjeleníteni. Ez a fejléc nem jelenik meg, ha ez a fájl soha nem volt a célpont egy Fájl Másolás műveletben, vagy ha a fájlt módosították egy befejezett Fájl Másolás művelet után, amely a Fájl Tulajdonságok Beállítását vagy Fájl Létrehozását használta.
x-ms-copy-source: url	2015-02-21 verzió és újabb. Legfeljebb 2 KB hosszú URL, amely megadja azt a forrásfájlt, amelyet az utolsó Fájl Másolási műveletnél használtak, ahol ez a fájl volt a célfájl. Ez a fejléc nem jelenik meg, ha ez a fájl soha nem volt a célpont egy Fájl Másolás műveletben, vagy ha a fájlt módosították egy befejezett Fájl Másolás művelet után, amely a Fájl Tulajdonságok Beállítását vagy Fájl Létrehozását használta.
x-ms-copy-status: <pending ¦ success ¦ aborted ¦ failed>	2015-02-21 verzió és újabb. A másolási művelet állapota, amelyet , x-ms-copy-idaz alábbi értékekkel azonosít: - pending: A szöveg folyamatban van. Ellenőrizze, x-ms-copy-status-description hogy az időnkénti, nem halálos hibák akadályozza-e a másolás előrehaladását, de nem okoznak hibát. - success: A másolat sikeresen elkészült. - aborted: A másolatot megszakítás a Fájl megszakítása befejezte. - failed: A másolat meghibásodott. Nézd x-ms-copy-status-description meg a hiba részleteit. Ez a fejléc nem jelenik meg, ha ez a fájl soha nem volt a célállomás egy Fájl Másolás műveletben, vagy ha a fájlt módosították egy befejezett Fájl Másolás művelet után, amely a Fájl Tulajdonságok Beállítását vagy Fájl Létrehozását használta.
x-ms-content-md5	A 2016-05-31-es verziótól, ha a fájlnak MD5 hash van, és ha a kérés tartalmaz tartományfejlécet (range vagy x-ms-range), ez a válaszfejléc a teljes fájl MD5 értékének értékével érkezik vissza. Ez az érték lehet, hogy nem lehet megegyezni a fejlécben visszaadott értékkel Content-MD5 , amelyet a kért tartományból számítanak.
x-ms-server-encrypted: true/false	2017-04-17 verzió és újabb. Ennek a fejlécnek az értéke akkor van beállítva, true ha a fájladatok és az alkalmazás metaadatai teljesen titkosítva vannak a megadott algoritmussal. Ha a fájl titkosítatlan, vagy csak a fájl/alkalmazás metaadatának egy része van titkosítva, az érték .false
x-ms-file-creation-time	Az UTC dátum/időpont érték, amely a fájl létrehozási idő tulajdonságát képviseli.
x-ms-file-last-write-time	Az UTC dátum/időpont érték, amely a fájl utolsó írási idő tulajdonságát képviseli.
x-ms-file-change-time	Az UTC dátum/idő az érték, amely a fájl változási idő tulajdonságát képviseli.
x-ms-file-file-id	A fájl azonosítója.
x-ms-file-parent-id	A fájl szülői fájlazonosítója.
x-ms-lease-duration:infinite	2019-02-02 verzió és újabb. Amikor egy fájlt bérelnek, az előírja, hogy a bérleti szerződés végtelen időtartamú.
x-ms-lease-state: <available, leased, broken>	2019-02-02 verzió és újabb. Amikor egy fájlt bérelnek, megadja a fájl bérleti állapotát.
x-ms-lease-status: <locked, unlocked>	2019-02-02 verzió és újabb. Amikor egy fájlt bérelnek, megadja a fájl bérleti státuszát.
x-ms-client-request-id	A kérések és a hozzájuk tartozó válaszok hibaelhárítására használható. Ennek az élőfejnek az értéke megegyezik a x-ms-client-request-id fejléc értékével, ha az szerepel a kérelemben, és az érték legfeljebb 1024 látható ASCII-karaktert tartalmaz. Ha a x-ms-client-request-id fejléc nem szerepel a kérelemben, akkor az nem szerepel a válaszban.

SMB válaszfejlécek

Válaszfejléc	Description
x-ms-file-permission-key	2019-02-02 verzió és újabb. Az aktába vonatkozó engedély kulcsa.
x-ms-file-attributes	2019-02-02 verzió és újabb. A fájl fájlrendszer attribútumja. További információért lásd az elérhető attribútumok listáját.

NFS válaszfejlécek

Válaszfejléc	Description
x-ms-mode	2025-05-05 verzió és újabb. A fájl módja. Lásd POSIX fájlengedélyeket (mód).
x-ms-owner	2025-05-05 verzió és újabb. A fájltulajdonos felhasználói azonosítója (UID).
x-ms-group	2025-05-05 verzió és újabb. A fájltulajdonos csoportazonosítója (GID).
x-ms-link-count	2025-05-05 verzió és újabb. A fájl linkszáma.

Válaszfejlécek (strukturált test)

A 2025-01-05 verziótól a következő fejléceket visszaküldik, ha a kérés érvényes x-ms-structured-body fejlécet küld.

Válaszfejléc	Description
Content-Length	A kódolt válasz hossza lesz (nem csak a visszaküldött fájltartalom hossza).
x-ms-structured-body	Ennek a fejlécnek az értéke megegyezik a kérésben elküldött értékkel, amelynek jelenleg annak kell lennie XSM/1.0; properties=crc64.
x-ms-structured-content-length	Ennek a fejlécnek az értéke a visszaküldött fájltartalom hossza, és az üzenetkódolás miatt mindig kisebb, mint a Content-Length fejléc értéke.

Válasz törzse

A választest tartalmazza a fájl tartalmát.

Mintaválasz

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

Authorization

Csak a fióktulajdonos hívhatja ezt a műveletet.

Fájlrendszer attribútumok

Attribute	Win32 fájl attribútuma	Definition
ReadOnly	FILE_ATTRIBUTE_READONLY	Egy csak olvasható fájl. Az alkalmazások el tudják olvasni a fájlt, de nem írhatnak vagy törölhetik azt.
Rejtett	FILE_ATTRIBUTE_HIDDEN	Az akta el van rejtve. Nem szerepel egy hagyományos könyvtárlistában.
System	FILE_ATTRIBUTE_SYSTEM	Egy fájl, amelynek az operációs rendszer egy részét használja vagy kizárólag használja.
None	FILE_ATTRIBUTE_NORMAL	Egy fájl, aminek nincs más attribútuma beállítva. Ez az attribútum csak akkor érvényes, ha önmagában használják.
Archívum	FILE_ATTRIBUTE_ARCHIVE	Egy fájl, ami egy archív fájl. Az alkalmazások általában ezt az attribútumot használják fájlok mentésére vagy eltávolítására történő jelölésére.
Temporary	FILE_ATTRIBUTE_TEMPORARY (ideiglenes fájlattribútum)	Egy fájl, amit ideiglenes tárolásra használnak.
Offline	FILE_ATTRIBUTE_OFFLINE	Egy fájl adatai nem elérhetők azonnal. Ez a fájlrendszer attribútumot elsősorban a Windows kompatibilitásának biztosítása érdekében mutatták be. Az Azure Files nem támogatja az offline tárolási lehetőségeket.
NotContentIndexed	FILE_ATTRIBUTE_NOT_CONTENT_INDEXED	A fájlt nem indexelheti a tartalomindexelő szolgáltatás.
NoScrubData	FILE_ATTRIBUTE_NO_SCRUB_DATA	A felhasználói adatfolyamot nem olvashatja a háttér adatintegritás-szkenner. Ez a fájlrendszer attribútumot elsősorban a Windows kompatibilitásának biztosítása érdekében mutatták be.

POSIX fájljogosultságok (mód)

A POSIX fájljogosultságok számosan megadhatók 12 bites numerikus oktális formátumban, vagy szimbolikus "rwx" formátumban. Examples:

• "0644" vagy "rw-r--r--": A felhasználó (fájltulajdonos) olvasási és írási engedélyt kap. A csoport olvasási engedélyt kapott. Mások olvasási engedélyt kaptak.
• "0755" vagy "rwxr-xr-x": A felhasználó (fájltulajdonos) olvasási, írási és végrehajtási engedélyt kap. A csoport olvasta és végrehajtotta a jogosultságot. Mások elolvasták és végrehajtották a jogosultságot.

Numerikus oktális formátum

A három legalacsonyabb rendű oktális szám a tulajdonos/felhasználó, csoport és mások jogosultságát képviseli, és egy oktális számmal (0-7) jelölik, amelyet '4' (Olvasás), '2' (Írás), '1' (Végrehajtás) bitenkénti kombinációjával alkotnak. A legmagasabb rendű oktális szám (0-7) a '4' (SetUID), '2' (SetGID), '1' (StickyBit) jogosultságok kombinációját jelöli.

Formátum	Engedély
0700	A felhasználó (fájltulajdonos) olvasási, írási és végrehajtási engedélyt kap.
0400	A felhasználónak olvasási engedélye van.
0200	A felhasználónak írási engedélye van.
0100	A felhasználónak végrehajtási engedélye van.
0070	A csoportnak olvasási, írási és végrehajtási engedélye van.
0040	A csoport olvasási engedélyt kapott.
0020	A csoportnak írási engedélye van.
0010	A csoportnak végrehajtási engedélye van.
0007	Mások olvasási, írási és végrehajtási engedélyt kaptak.
0004	Mások olvasási engedélyt kaptak.
0002	Másoknak írási engedélyük van.
0001	Másoknak végrehajtási engedélyük van.
4000	Állíts be hatékony felhasználói azonosítót a fájlban.
2000	Állítsd be az effektív csoportazonosítót a fájlban.
1000	Úgy állítva, hogy a fájlt csak a fájltulajdonos, a könyvtár tulajdonosa vagy gyökérfelhasználója törölheti vagy átnevezheti.

Szimbolikus "rwx" formátum

A tulajdonos/felhasználó, csoport és mások jogosultságait 'r' (Olvasás), 'w' (Írás) és 'x' (Végrehajtás) karakterek kombinációjával jelölik.

Formátum	Engedély
RWX------	A felhasználó (fájltulajdonos) olvasási, írási és végrehajtási engedélyt kap.
r--------	A felhasználónak olvasási engedélye van.
-W-------	A felhasználónak írási engedélye van.
--x------	A felhasználónak végrehajtási engedélye van.
---rwx---	A csoportnak olvasási, írási és végrehajtási engedélye van.
---r-----	A csoport olvasási engedélyt kapott.
----w----	A csoportnak írási engedélye van.
-----x---	A csoportnak végrehajtási engedélye van.
------rwx	Mások olvasási, írási és végrehajtási engedélyt kaptak.
------r--	Mások olvasási engedélyt kaptak.
-------v-	Másoknak írási engedélyük van.
--------x	Másoknak végrehajtási engedélyük van.

Megjegyzések

Ha olyan tartományt hívunk Get File , amelyen még nincs tartalom vagy amelyet töröltek, visszaadja 0 ezeket a bájtokat.

Ha megadva tartomány nélkül hívsz Get File , a szolgáltatás visszaadja a bájtok tartományát a fejléchez megadott x-ms-content-length értékig. Bármilyen tartomány esetén, amelyből hiányzik a tartalom, a szolgáltatás visszaadja 0 ezeket a bájtokat.

Egy Get File művelet MiB-enként két perc engedélyezett. Olyan műveletek, amelyek átlagosan több mint két percet tartanak MiB-enként.

Lásd még

Műveletek a fájlokon